Безусловно, количество опций ВСР весьма велико, поэтому ниже эти опции будут рассматриваться последовательно (к счастью, основная их часть является необязательной, поэтому обычно приходится включать в состав команды лишь ограниченное количество опций) (табл. 18.1).

Следует еще раз отметить, что обозначения многих опций утилиты ВСР являются чувствительными к регистру, а иногда при переходе в обозначении опции от прописной буквы к строчной, или наоборот, смысл этой опции полностью изменяется.

Таблица 18.1. Основные опции утилиты ВСР

Параметр

Описание

<database name>

<owner>

<table name>, <view name> или <query>

in data file out data file queryout data file format data file

Назначение этой опции полностью соответствует ее названию (имя базы данных). По существу, применяемое здесь имя базы данных является одной из составляющих стандартной четырехкомпонентной схемы именования. Если этот параметр не задан, то предполагается, что операция должна быть выполнена применительно к базе данных пользователя, заданной по умолчанию

Этот параметр соответствует еще одной составляющей четырехкомпонентной схемы именования. И в этом случае назначение опции полностью соответствует ее названию

В качестве значения этого параметра может быть задан только один из допустимых вариантов - таблица, представление или запрос.

Данный параметр обозначает назначение ввода либо источник вывода таблицы или представления.

Запрос SQL Server может использоваться только в качестве назначения вывода ВСР, причем лишь в том случае, если задан параметр queryout. Если запрос возвращает несколько результирующих наборов, то в ВСР используется только первый результирующий набор

И в этом случае может быть задан только один из допустимых вариантов. Если используется любой из этих параметров, необходимо также указать файл, который служит в качестве источника или назначения.

Этот параметр задает направление действия утилиты ВСР. Значение in указывает, что данные импортируются из исходного файла в таблицу или представление. Значение out говорит о том, что осуществляется экспорт данных из таблицы или представления в выходной файл. Значение queryout следует использовать только для вывода в файл назначения, применяя запрос в качестве источника. Значение format служит для создания файла формата на основе выбранного варианта формата. Необходимо задать не только параметр - f, но и опции формата (-п, -с, -w, -б, -с или -N), так как в противном случае появятся приглашения к вводу значений этих опций из интерактивного модуля ВСР.

Продолжение табл. 18.1

Параметр

Описание

-т <maximum errors>

-f <format file>

-e <error file>

-F first row

-L last row

Путь к источнику или назначению и имя файла задаются

в виде параметра <data f ile> и не могут включать больше

255 символов

Этот параметр позволяет указать максимальное количество допустимых ошибок, после превышения которого в СУБД SQL Server происходит отмена операции массового копирования; по умолчанию это значение составляет 10 ошибок. Каждый случай, в котором не удается скопировать одну строку с помощью утилиты ВСР, рассматривается как одна ошибка

Этот параметр позволяет указать файл формата, в котором сохраняются ответы, полученные от пользователя при выполнении предыдущей операции ВСР с той же таблицей или представлением. Данный параметр должен включать полное имя пути и имя файла, относящиеся к файлу формата. Следует отметить, что эта опция используется в основном с опциями in и format для определения пути и имени файла в том случае, если применяется или создается файл формата

Эта опция позволяет создать файл формата на основе XML вместо обычной текстовой версии, применяемой по умолчанию (версия, отличная от XML, предназначена для поддержки унаследованного программного обеспечения, но пока применяется по умолчанию). Обязательным требованием к применению этой опции является включение в командную строку также опций format и -f

Эта опция предоставляет возможность указать полный путь к файлу и имя файла ошибок для записи всех строк, которые не удалось передать с помощью утилиты ВСР. При отсутствии этого параметра файл ошибок не создается. Все сообщения об ошибках отображаются на экране клиентской станции

Эта опция используется, если есть необходимость указать первую строку, подлежащую копированию с помощью операции массового копирования. Если такая опция не задана, то в утилите ВСР по умолчанию принимается значение 1 и копирование начинается с первой строки в исходном файле данных. Следует отметить, что рассматриваемая опция может оказаться удобной, если решено разбить процедуру загрузки на несколько сеансов, поскольку она позволяет возобновить загрузку с той точки, в которой загрузка была остановлена в предыдущем сеансе

Эта опция является дополнительной по отношению к опции -F. Она предназначена для указания последней строки, которая должна быть загружена в ходе текущего сеанса выполнения утилиты ВСР. Если эта опция не задана, то в ВСР по умолчанию применяется значение 0, которое обозначает последнюю строку в исходном файле. При использовании в сочетании с -F эта опция позволяет загружать данные по одному фрагменту одновременно; в таком случае загрузка данных осуществляется в виде отдельных сеансов, причем в каждом последующем сеансе загрузка возобновляется с того места, где была остановлена в прошлый раз

Продолжение табл. 18.1

Параметр

Описание

-Ь batch size

-V ( 60

Эта опция позволяет задавать количество строк, копируемых в виде одного пакета. Пакет копируется как отдельная транзакция. Как и во всех транзакциях, предусмотрена фиксация операции копирования строк пакета по принципу все или ничего - либо фиксируются все строки, либо выполняется откат всей транзакции копирования пакета так, как если бы это копирование вообще не происходило. Аналогичная опция (rows per batch) предусмотрена в параметре -h (сокращение от hint - подсказка); параметр -he этой опцией следует рассматривать как взаимоисключающий по отношению к параметру -Ь (в вызове утилиты ВСР допускается либо не использовать ни один из этих параметров, либо один из них, но не оба одновременно)

Этот параметр указывает, что в операции копирования применяются собственные типы данных (типы данных SQL Server). При использовании этой опции исключается необходимость отвечать на вопросы, касающиеся типов данных, которые должны применяться при передаче (утилита выбирает только данные собственного типа и осуществляет операции с ними)

Этот параметр позволяет указать, что в текущей операции используются символьные данные (текст) для всех полей и что как таковая данная операция не требует задавать отдельно вопрос, касающийся типа данных, в отношении каждого поля. Если не используется опция -t, то в качестве разделителя полей применяется символ табуляции, а если не указан другой признак завершения строки с помощью опции -г, то в качестве такого признака применяется символ обозначения конца строки

Опция -W аналогична опции -с, но определяет, что для всех полей используется тип данных Unicode, а не ASCII. И в этом случае, если не указаны иные значения с помощью опций -t и -г, в качестве разделителя полей и обозначения конца строки применяются соответственно символ табуляции и символ новой строки. Эта опция не может использоваться в SQL Server 6.5 или более ранней версии

Этот параметр аналогичен параметру -w; он указывает, что для символьных данных применяется кодировка Unicode, а для представления данных, отличных от символьных, - собственные типы данных (типы данных базы данных). Эта опция позволяет добиться повышения производительности при обмене данными между разными экземплярами СУБД SQL Server. Как и опция -w, данная опция не может использоваться в SQL Server 6.5 или более ранней версии

Эта опция вынуждает утилиту ВСР применять форматы типов данных, которые были доступными только в предыдущих версиях SQL Server. Значение 60 указывает, что должны использоваться типы данных версии 6.0, значение 65 - типы данных версии 6.5, значение 70 - типы данных версии 7.0, значение 80 - типы данных версии 2000. Эта опция заменяет опцию -б