Программа bcp

Служебная программа bcp выполняет массовое копирование данных между экземпляром Microsoft SQL Server и файлом данных в указанном пользователем формате. С помощью программы bcp можно выполнять импорт большого количества новых строк в таблицы SQL Server или экспорт данных из таблиц в файлы данных. За исключением случаев использования параметра queryout, применение программы не требует знания языка Transact-SQL. Чтобы выполнить импорт данных в таблицу, необходимо или использовать файл форматирования, созданный для этой таблицы, либо изучить структуру таблицы и типов данных, допустимых для ее столбцов.

Сведения о синтаксических обозначениях в программе bcp см. в разделе Синтаксические обозначения в Transact-SQL (Transact-SQL).

Примечание

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

Синтаксис

  
   bcp [database_name.] schema.{table_name | view_name | "query" {indata_file | outdata_file | queryoutdata_file | format nul}  
  
[-apacket_size]  
[-bbatch_size]  
[-c]  
[-C { ACP | OEM | RAW | code_page } ]  
[-ddatabase_name]  
[-eerr_file]  
[-E]  
[-fformat_file]  
[-Ffirst_row]  
[-h"hint [,...n]"]   
[-iinput_file]  
[-k]  
[-Kapplication_intent]  
[-Llast_row]  
[-mmax_errors]  
[-n]  
[-N]  
[-ooutput_file]  
[-Ppassword]  
[-q]  
[-rrow_term]  
[-R]  
[-S [server_name[\instance_name]]  
[-tfield_term]  
[-T]  
[-Ulogin_id]  
[-v]  
[-V (80 | 90 | 100 | 110)]  
[-w]  
[-x]  
/?  

Аргументы

data_file
Полный путь файла данных. После выполнения массового импорта данных в SQL Serverфайл данных содержит данные, которые будут скопированы в указанную таблицу или представление. После выполнения массового экспорта данных из SQL Serverфайл данных содержит данные, скопированные из таблицы или представления. Путь может содержать от 1 до 255 символов. Файл данных может содержать не более 2⁶³ –1 строк.

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

Можно также явным образом указать имя базы данных с помощью параметра d-.

inфайл_данных | outфайл_данных | queryoutфайл_данных | format nul.
Указывает направление массового копирования следующим образом:

• in — копирует данные из файла в таблицу или представление базы данных.

• out — копирует данные из таблицы или представления базы данных в файл. Если указать существующий файл, то файл перезаписывается. При извлечении данных обратите внимание, что программа bcp представляет пустую строку как строку NULL, а строку NULL — как пустую строку.

• queryout — копирует данные из запроса. Этот аргумент может быть указан только при массовом копировании данных из запроса.

• format создает файл форматирования на основе указанного параметра (-n, -c, -wили -N) и разделителей таблицы или представления. При массовом копировании данных команда bcp может ссылаться на файл форматирования, что избавляет вас от повторного ввода сведений о формате в интерактивном режиме. Параметр format требует наличия параметра -f . Для создания XML-файла форматирования, кроме того, необходим параметр -x . Дополнительные сведения см. в статье Создание файла форматирования (SQL Server). В качестве значения необходимо указать nul (format nul).

Владелец
Имя владельца таблицы или представления. Можно не указывать необязательный параметрowner , если пользователь, выполняющий операцию, является владельцем указанной таблицы или представления. Если владелец не указан и пользователь, выполняющий операцию, не владеет указанной таблицей или представлением, SQL Server возвращает сообщение об ошибке, и операция отменяется.

"query"
Запрос Transact-SQL, возвращающий результирующий набор. Если запрос возвращает несколько результирующих наборов, то в файл данных будет скопирован только первый результирующий набор. Последующие результирующие наборы не учитываются. Используйте двойные кавычки для запроса и одинарные кавычки для выражений, внедренных в запрос. При выполнении массового копирования данных из запроса необходимо, помимо прочего, указывать аргументqueryout .

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

table_name
Имя целевой таблицы при импорте данных в SQL Server (in) или таблицы-источника при экспорте данных из SQL Server (out).

view_name
Имя целевого представления при копировании данных в SQL Server (in) или представления-источника при копировании данных из SQL Server (out). В качестве целевых представлений могут выступать только те представления, в которых все столбцы ссылаются на одну таблицу. Дополнительные сведения об ограничениях, накладываемых на копирование данных в представления, см. в статье Инструкция INSERT (Transact-SQL).

-aразмер_пакета
Указывает число байтов в каждом сетевом пакете, отправляемом от сервера и к серверу. Параметр конфигурации сервера можно задать с помощью среды SQL Server Management Studio (или системной хранимой процедуры sp_configure ). Однако параметр конфигурации сервера в отдельных случаях можно изменить с помощью этого параметра. Значениеpacket_size может находиться в пределах от 4096 до 65535 байт, значение по умолчанию равно 4096.

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

-bbatch_size
Указывает количество строк в каждом пакете импортированных данных. Каждый пакет импортируется и регистрируется как отдельная транзакция, которая фиксируется после выполнения импорта всего пакета. По умолчанию импорт всех строк в файле данных выполняется в одном пакете. Чтобы распределить строки между несколькими пакетами, укажите значение batch_size меньшее, чем количество строк в файле данных. Если транзакция пакета завершится неудачно, то будет выполнен откат только операций вставки в текущем пакете. Произошедшая ошибка не затрагивает пакеты, импорт которых уже выполнен зафиксированными транзакциями.

Не используйте этот параметр в сочетании с параметром **-h "**ROWS_PER_BATCH=bb".

-c
Выполняет операцию, используя символьный тип данных. Этот параметр не запрашивает каждое поле; он использует в char качестве типа хранилища без префиксов и с \t (символ табуляции) в качестве разделителя полей и \r\n (символ новой строки) в качестве признака конца строки. Параметр -c несовместим с параметром -w.

Дополнительные сведения см. в разделе Использование символьного формата для импорта и экспорта данных (SQL Server).

-C { ACP | OEM | RAW | code_page }
Указывает кодовую страницу данных в файле данных. code_page имеет значение, только если данные содержат столбцы char, varcharили text со значениями символов больше 127 или меньше 32.

Примечание

Рекомендуется указывать имя параметров сортировки для каждого столбца в файле форматирования.

Значение кодовой страницы	Описание
ACP	ANSI/Microsoft Windows (ISO 1252).
OEM	Кодовая страница, используемая клиентом по умолчанию. Это кодовая страница, используемая по умолчанию, если не указан параметр -C .
RAW	Преобразование из одной кодовой страницы в другую не выполняется. Этот параметр обеспечивает высокую производительность, так как преобразование не выполняется.
code_page	Определенный номер кодовой страницы, например 850. ** Важно !* SQL Server не поддерживает кодовую страницу 65001 (кодировка UTF-8).

-ddatabase_name
Указывает базу данных, с которой надо соединиться. По умолчанию программа bcp.exe соединяется с пользовательской базой данных по умолчанию. Если -ddatabase_name и указано имя из трех частей (database_name.schema.table, переданное в качестве первого параметра в bcp.exe), возникнет ошибка, так как имя базы данных невозможно указать дважды. Если database_name начинается с дефиса (-) или косой черты (/), не добавляйте пробел между -d и именем базы данных.

-eerr_file
Указывает полный путь к файлу ошибок, используемому для хранения строк, которые служебная программа bcp не может передать из файла в базу данных. Сообщения об ошибках команды bcp поступают на рабочую станцию пользователя. Если этот параметр не используется, то файл ошибок не создается.

Если параметр err_file начинается с дефиса (-) или косой черты (/), не ставьте пробел между -e и значением err_file .

-E
Указывает, что значение или значения идентификаторов в файле импортированных данных будут использоваться для столбца идентификаторов. Если аргумент -E не указан, значения идентификаторов для этого столбца в импортируемом файле данных не учитываются, и SQL Server автоматически назначает уникальные значения на основе начального значения и значения приращения, указанных во время создания таблицы.

Если файл данных не содержит значений для столбца идентификаторов в таблице или представлении, то с помощью файла форматирования укажите, что столбец идентификаторов в таблице или представлении должен быть пропущен при импорте данных. SQL Server автоматически присвоит столбцу уникальные значения. Дополнительные сведения см. в разделе DBCC CHECKIDENT (Transact-SQL).

Для использования параметра -E необходимы специальные разрешения. Дополнительные сведения см. в подразделе «Примечания» далее в этом разделе.

-fformat_file
Указывает полный путь к файлу форматирования. Назначение этого параметра зависит от окружения, в котором он используется (см. далее):

• Если параметр -f используется с параметром format , для указанной таблицы или представления создается файл с именем format_file . Чтобы создать XML-файл форматирования, укажите параметр -x . Дополнительные сведения см. в статье Создание файла форматирования (SQL Server).

• При использовании параметра in или out для -f должен существовать файл форматирования.

  Примечание

  Необязательно использовать файл форматирования с параметром in или out . Если параметр -f отсутствует, если параметр -n, -c, , -wили -N не указан, команда запрашивает сведения о форматировании и позволяет сохранять ответы в файле форматирования (имя файла по умолчанию — Bcp.fmt).

Если параметр format_file начинается с дефиса (-) или косой черты (/), не ставьте пробел между -e и значением format_file .

-Ffirst_row
Указывает номер первой строки для экспорта из таблицы или импорта из файла данных. Значение параметра должно быть больше (>) 0, но меньше (<) или равно (=) общему количеству строк. Если параметр отсутствует, по умолчанию используется первая строка файла.

Параметрfirst_row может иметь положительное целое значение до 2^63-1. Аргумент -Fпервая_строка имеет нумерацию, которая начинается с 1.

-h"hint[ ,... n] "
Указывает одну или несколько подсказок для использования во время выполнения массового импорта данных в таблицу или представление.

ORDER**(column[ASC | DESC] [,... n]) **
Порядок сортировки данных в файле данных. Производительность массового импорта увеличивается, если импортируемые данные упорядочены согласно кластеризованному индексу таблицы (при наличии). Если файл данных отсортирован в порядке, отличном от порядка ключа кластеризованного индекса, или если в таблице отсутствует кластеризованный индекс, то предложение ORDER пропускается. В целевой таблице должны быть указаны имена столбцов. По умолчанию программа bcp предполагает, что файл данных не упорядочен. Для оптимизированного массового импорта SQL Server , помимо прочего, проверяет сортировку импортируемых данных.

ROWS_PER_BATCH =bb
Количество строк данных в каждом пакете (значение bb). Используется в случае, если не указан параметр -b , что приводит к тому, что весь файл данных отправляется на сервер в ходе одной транзакции. Сервер оптимизирует массовую загрузку в соответствии со значением bb. По умолчанию значение аргумента ROWS_PER_BATCH неизвестно.

KILOBYTES_PER_BATCH =cc
Приблизительный объем данных в каждом пакете в килобайтах (значение cc). По умолчанию, значение KILOBYTES_PER_BATCH неизвестно.

TABLOCK
Указывает, что при выполнении массового обновления на период операции массовой загрузки будет получена блокировка на уровне таблицы. В противном случае запрашивается блокировка на уровне строки. Применение этого указания значительно повышает производительность, так как удержание блокировки в течение операции массового копирования уменьшает вероятность состязаний блокировок в таблице. Если таблица не имеет индексов и указано ключевое слово TABLOCK , загрузка в таблицу может производиться параллельно несколькими клиентами. По умолчанию работа блокировки определяется параметром таблицы table lock on bulk load.

CHECK_CONSTRAINTS
Указывает, что при выполнении операции массового импорта будет выполняться проверка всех ограничений целевой таблицы или представления. Если указание CHECK_CONSTRAINTS не задано, то все ограничения CHECK и FOREIGN KEY пропускаются, и после выполнения операции ограничение таблицы отмечается как ненадежное.

Примечание

Ограничения UNIQUE, PRIMARY KEY и NOT NULL проверяются в любом случае.

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

Отключение проверки ограничений (настройка по умолчанию) может потребоваться в тех ситуациях, когда входные данные содержат строки, нарушающие эти ограничения. Импорт данных можно выполнить с отключенными ограничениями CHECK, после чего использовать инструкции языка Transact-SQL для удаления недопустимых значений.

Примечание

bcp производит проверку данных, которые могут привести к ошибкам в работе существующих скриптов, если файлы данных будут содержать недопустимые данные.

Примечание

Параметр -mмаксимальное_количество_ошибок не применяется при проверке ограничений.

FIRE_TRIGGERS
Применяется вместе с аргументом in и указывает, что в течение операции массового копирования будут работать триггеры Insert, определенные в целевой таблице. Если параметр FIRE_TRIGGERS не указан, то триггеры Insert выполняться не будут. Параметр FIRE_TRIGGERS для аргументов out, queryoutи format не учитывается.

-iвходной_файл
Указывает имя файла ответов, содержащего ответы на вопросы командной строки для каждого поля данных, когда массовое копирование выполняется в интерактивном режиме (не указано значение -n, -c, -wили -N ).

Если параметр input_file начинается с дефиса (-) или косой черты (/), не ставьте пробел между -e и значением input_file .

-k
Указывает, что пустые столбцы во время данной операции должны сохранить значение NULL вместо любых вставляемых значений столбцов по умолчанию. Дополнительные сведения см. в разделе Сохранение значений Null или использование значений по умолчанию при массовом импорте данных (SQL Server).

-Kapplication_intent
Объявляет тип рабочей нагрузки приложения при соединении с сервером. Единственным возможным значением является ReadOnly. Если параметр -K не указан, программа bcp не будет поддерживать соединение с вторичной репликой в группе доступности AlwaysOn. Дополнительные сведения см. в разделе Активные вторичные реплики для чтения (группы доступности AlwaysOn).

-Llast_row
Указывает номер последней строки для экспорта из таблицы или импорта из файла данных. Значение параметра должно быть больше (>) 0, но меньше (<) или равно (=) номеру последней строки. Если параметр отсутствует, по умолчанию используется последняя строка файла.

Параметрlast_row может иметь положительное целое значение до 2^63-1.

-mmax_errors
Указывает максимальное количество синтаксических ошибок, которые могут произойти до отмены операции bcp . Синтаксическая ошибка подразумевает ошибку преобразования данных в целевой тип данных. В общее количество ошибок max_errors не включаются ошибки, которые могут быть обнаружены только на сервере, например нарушения ограничений.

Строка, которую нельзя скопировать с помощью программы bcp , не обрабатывается и считается одной ошибкой. Если параметр не указан, то используется значение по умолчанию, равное 10.

Примечание

Параметр -m также не применяется к преобразованию money типов данных или bigint .

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

Дополнительные сведения см. в разделе Использование собственного формата для импорта и экспорта данных (SQL Server).

-N
Выполняет операцию массового копирования, используя собственные типы данных (базы данных) для несимвольных данных и символы Юникода для символьных данных. Этот параметр обеспечивает более высокую производительность, чем -w вариант , и предназначен для передачи данных из одного экземпляра SQL Server в другой с помощью файла данных. Он не запрашивает тип данных каждого поля. Используйте этот параметр при передаче данных, которые содержат символы национального алфавита ANSI, а также, чтобы повысить производительность работы в собственном режиме.

Дополнительные сведения см. в разделе Использование собственного формата Юникод для импорта и экспорта данных (SQL Server).

При экспорте и импорте данных в ту же схему таблицы с помощью bcp.exe с параметром -N может появиться предупреждение об усечении, если имеется столбец символов фиксированной длины, отличный от Юникода (например, char(10)).

Это предупреждение можно пропустить. Одним из способов его устранения является применение аргумента командной строки -n вместо -N.

-oвыходной_файл
Указывает имя файла, который принимает перенаправленные из командной строки выходные данные.

Если параметр output_file начинается с дефиса (-) или косой черты (/), не ставьте пробел между -e и значением output_file .

-Pпароль
Указывает пароль для идентификатора имени входа. Если данный параметр не указан, команда bcp запрашивает пароль. Если этот параметр используется в конце командной строки без указания пароля, программа bcp применяет пароль по умолчанию (NULL).

Важно!

Не используйте пустые пароли. Выбирайте надежные пароли.

Чтобы скрыть пароль, не указывайте параметр -P вместе с параметром -U . Вместо этого после ввода команды bcp с параметром -U и другими параметрами (не указывая -P) нажмите клавишу ВВОД, и команда предложит ввести пароль. Этот метод обеспечивает скрытие пароля при вводе.

Если параметр password начинается с дефиса (-) или косой черты (/), не включайте пробел между -P и значением password .

-q
Выполняет инструкцию SET QUOTED_IDENTIFIERS ON в соединении между служебной программой bcp и экземпляром SQL Server. Используйте этот параметр для указания базы данных, владельца, таблицы или имени представления, содержащих пробел или одинарную кавычку. Заключите все имя таблицы или представления, состоящее из трех частей, в кавычки ("").

Чтобы указать имя базы данных, содержащее пробел или одинарные кавычки, следует использовать параметр -q.

-q не применяется к значениям, переданным в -d.

Дополнительные сведения см. в подразделе «Примечания» далее в этом разделе.

-rrow_term
Указывает признак конца строки. Значением по умолчанию является \n (символ перевода строки). Используйте этот параметр, чтобы переопределить признак конца строки по умолчанию. Дополнительные сведения см. в разделе Определение признаков конца поля и строки (SQL Server).

Если в команде bcp.exe указан признак конца строки в шестнадцатеричном виде, то значение будет усечено до 0x00. Например, если указать значение 0x410041, то будет использовано значение 0x41.

Если параметр row_term начинается с дефиса (-) или косой черты (/), не ставьте пробел между -r и значением row_term .

-R
Указывает, что массовое копирование в SQL Server данных в денежном формате, в формате даты и времени выполняется с помощью регионального формата, определенного настройками локали клиентского компьютера. По умолчанию региональные настройки не учитываются.

-Sимя_сервера[ \имя_экземпляра]
Указывает экземпляр SQL Server, к которому выполняется подключение. Если сервер не указан, программа bcp выполняет подключение к экземпляру SQL Server по умолчанию на локальном компьютере. Этот параметр необходим, если команда bcp выполняется с удаленного компьютера в сети или с локального именованного экземпляра. Чтобы подключиться к экземпляру по умолчанию SQL Server на сервере, укажите только server_name. Чтобы подключиться к именованным экземпляру SQL Server, укажите server_name*\*instance_name.

-tfield_term
Указывает признак конца поля. Значением по умолчанию является \t (символ табуляции). Используйте этот параметр, чтобы переопределить признак конца поля по умолчанию. Дополнительные сведения см. в разделе Определение признаков конца поля и строки (SQL Server).

Если в команде bcp.exe указан признак конца поля в шестнадцатеричном виде, то значение будет усечено до 0x00. Например, если указать значение 0x410041, то будет использовано значение 0x41.

Если field_term начинается с дефиса (-) или косой черты (/), не включайте пробел между -tи значением field_term .

-T
Указывает, что программа bcp устанавливает доверительное соединение с SQL Server с использованием встроенной безопасности. Не требуются учетные данные безопасности для сетевого пользователя, параметры login_idи password . Если параметр -T не указан, для входа необходимо указать -U и -P .

-Uидентификатор_входа
Указывает идентификатор входа, используемый для соединения с SQL Server.

Важно!

Если программа bcp подключается к SQL Server с помощью доверенного соединения, используя встроенную безопасность, укажите параметр -T (доверенное соединение) вместо сочетания параметров user name и password .

-v
Выводит номер версии и сведения об авторских правах для служебной программы bcp .

-V (80 | 90 | 100| 110)
Выполняет операцию массового копирования, используя типы данных более ранней версии SQL Server. Этот параметр не запрашивает тип данных каждого поля, он использует значения по умолчанию.

80 = SQL Server 2000

90 = SQL Server 2005 г.

100 = SQL Server 2008 и SQL Server 2008 R2

110 = SQL Server 2012 г.

Например, для создания данных для типов, не поддерживаемых SQL Server 2000, но появившихся в более поздних версиях SQL Server, используйте параметр -V80.

Дополнительные сведения см. в разделе Импорт данных в собственном и символьном формате из предыдущих версий SQL Server.

-w
Выполняет операцию массового копирования, используя символы Юникода. Этот параметр не запрашивает каждое поле; он использует в nchar качестве типа хранилища, без префиксов, \t (символ табуляции) в качестве разделителя полей и \n (символ новой строки) в качестве признака конца строки. Параметр -w несовместим с параметром -c.

Дополнительные сведения см. в разделе Использование символьного формата Юникод для импорта и экспорта данных (SQL Server).

-x
При использовании вместе с параметрами format и -fфайл_формата приводит к созданию файла форматирования на основе XML. По умолчанию создается файл форматирования в формате, отличном от XML. Параметр -x не работает при импорте или экспорте данных. Применение этого параметра без параметров format и -fфайл_формата приведет к ошибке.

Комментарии

Клиент bcp 12.0 устанавливается при установке средств MicrosoftSQL Server 2014. Если средства установлены как для SQL Server 2014, так и для более ранней версии SQL Server, в зависимости от значения переменной среды PATH, возможно, вместо клиента bcp 12.0 используется более ранний клиент bcp. Переменная среды определяет набор каталогов, используемых Windows для поиска исполняемых файлов. Чтобы определить используемую версию, запустите в командной строке Windows команду bcp /v . Сведения о настройке пути для команды в переменной среды PATH см. в справке Windows.

XML-файлы форматирования поддерживаются только при установке средств SQL Server вместе с собственным клиентом SQL Server .

Сведения о том, как найти и запустить программу bcp, а также соглашения о синтаксисе программ командной строки см. в статье Справочник по программе командной строки (ядро СУБД).

Дополнительные сведения о подготовке данных к массовому импорту или экспорту см. в статье Подготовка данных к массовому экспорту или импорту (SQL Server).

Сведения о том, когда в журнале транзакций регистрируются операции вставки строк, выполняемые при массовом импорте, см. в разделе Предварительные условия для минимального протоколирования массового импорта данных.

Поддержка собственного формата файлов данных

В SQL Server 2014 г. служебная программа bcp поддерживает собственные файлы данных, совместимые с SQL Server 2000, SQL Server 2005, SQL Server 2008, SQL Server 2008 R2 и SQL Server 2012.

Вычисляемые столбцы и столбцы типа timestamp

Значения в файле данных, импортируемые для вычисляемых столбцов, timestamp игнорируются, и SQL Server автоматически присваивает значения. Если файл данных не содержит значений для вычисляемых столбцов или timestamp столбцов в таблице, используйте файл форматирования, чтобы указать, что вычисляемые столбцы или timestamp столбцы в таблице должны быть пропущены при импорте данных; SQL Server автоматически присваивает значения столбцу.

Вычисляемые столбцы и timestamp массово копируются из SQL Server в файл данных, как обычно.

Указание идентификаторов, содержащих пробелы или кавычки

SQL Server могут содержать такие символы, как внедренные пробелы и кавычки. Такие идентификаторы должны обрабатываться следующим образом.

• Если идентификатор или имя файла содержит пробел или кавычку в командной строке, заключите идентификатор в двойные кавычки ("").

  Например, следующая команда bcp out создает файл данных с именем Currency Types.dat:

  bcp AdventureWorks2012.Sales.Currency out "Currency Types.dat" -T -c  
  

• Чтобы указать имя базы данных, содержащее пробел или кавычки, необходимо использовать параметр -q.

• Для имен владельца, таблицы или представления, содержащих внедренные пробелы или кавычки, также можно:

  • указать параметр -q; или

  • заключить имя владельца, таблицы или представления в квадратные скобки ([]) внутри кавычек.

Проверка данных

bcp производит проверку данных, которые могут привести к ошибкам в работе существующих скриптов, если файлы данных будут содержать недопустимые данные. Например, программа bcp проверяет, что:

• собственные представления типов данных float или real являются допустимыми;

• Данные в Юникоде имеют четную длину.

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

Массовый экспорт или импорт документов SQLXML

Чтобы выполнить массовый экспорт или импорт SQLXML-данных используйте один из следующих типов данных в файле форматирования:

Тип данных	Действие
SQLCHAR или SQLVARYCHAR	Данные отправляются в кодовой странице клиента или кодовой странице, определенной параметрами сортировки. Результат тот же, что и при указании параметра -c без указания файла форматирования.
SQLNCHAR или SQLNVARCHAR	Данные отправляются в Юникоде. Результат тот же, что и при указании параметра -w без указания файла форматирования.
SQLBINARY или SQLVARYBIN	Данные отправляются без преобразования.

Разрешения

Для операции bcpout необходимо разрешение SELECT на исходную таблицу.

Для операции bcpin необходимы как минимум разрешения SELECT/INSERT на целевую таблицу. Кроме того, разрешение ALTER TABLE необходимо в следующих случаях.

• Ограничения существуют, а указание CHECK_CONSTRAINTS не задано.

  Примечание

  Ограничения отключены по умолчанию. Чтобы явно включить ограничения, используйте параметр -h с подсказкой CHECK_CONSTRAINTS.

• Триггеры существуют, а указание FIRE_TRIGGER не задано.

  Примечание

  По умолчанию, триггеры не срабатывают. Чтобы запустить триггеры явно, используйте параметр -h с подсказкой FIRE_TRIGGERS.

• Используйте параметр -E , чтобы выполнить импорт значений идентификаторов из файла данных.

Примечание

Требование разрешения ALTER TABLE для целевой таблицы появилось в SQL Server 2005 году. Если у учетной записи пользователя нет разрешений ALTER на целевую таблицу, это новое требование может привести к ошибке скриптов bcp , не применяющих принудительно триггеры и проверку ограничений.

Рекомендации для символьного режима (-c) и собственного режима (-n)

Этот раздел содержит рекомендации для символьного режима (-c) и собственного режима (-n).

• (Администратор/пользователь) Если возможно, используйте собственный формат (-n) во избежание проблем с разделением. Используйте собственный формат для экспорта и импорта с помощью SQL Server. Экспортируйте данные из SQL Server с помощью параметра - c или -w, если данные планируется импортировать в базу данных, отличную отSQL Server .

• (Администратор) Проверьте данные при использовании BCP OUT. Например, при использовании BCP OUT, BCP IN, а затем BCP OUT убедитесь, что данные экспортируются правильно и значения признака конца не используются как часть какого-либо значения данных. Попробуйте переопределить признаки конца по умолчанию (с помощью параметров -t и - r) на случайные шестнадцатеричные значения, чтобы избежать конфликта между значениями признака конца и значениями данных.

• (Пользователь) Используйте длинные и уникальные признаки конца (любая последовательность байт или символов), чтобы свести к минимуму возможность конфликта с фактическим строковым значением. Это можно выполнить с помощью параметров -t и -r.

Примеры

Этот раздел содержит следующие примеры.

• A. Копирование строк из таблицы в файл данных (с помощью доверительного соединения)

• Б. Копирование строк из таблицы в файл данных (в смешанном режиме проверки подлинности)

• В. Копирование данных из файла в таблицу

• Г. Копирование отдельного столбца в файл данных

• Д. Копирование отдельной строки в файл данных

• Е. Копирование данных из запроса в файл данных

• Ж. Создание файла форматирования в формате, отличном от XML

• H. Создание XML-файла форматирования

• И. Использование файла форматирования для массового импорта данных c помощью программы bcp

A. Копирование строк из таблицы в файл данных (с помощью доверительного соединения)

В следующем примере показано применение параметра out к таблице AdventureWorks2012.Sales.Currency . В этом примере создается файл данных с именем Currency.dat и в него копируются данные таблицы в символьном формате. В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное подключение к экземпляру сервера, на котором запускается команда bcp .

В командной строке введите следующую команду:

bcp AdventureWorks2012.Sales.Currency out Currency.dat -T -c  

Б. Копирование строк из таблицы в файл данных (в смешанном режиме проверки подлинности)

В следующем примере показано применение параметра out к таблице AdventureWorks2012.Sales.Currency . В этом примере создается файл данных с именем Currency.dat и в него копируются данные таблицы в символьном формате.

В этом примере предполагается, что применяется смешанный режим проверки подлинности. Для указания идентификатора входа необходимо использовать параметр -U . Кроме того, за исключением случаев, когда выполняется соединение с экземпляром, не являющимся экземпляром SQL Server по умолчанию на локальном компьютере, нужно использовать параметр -S , чтобы указать системное имя и (при необходимости) имя экземпляра.

bcp AdventureWorks2012.Sales.Currency out Currency.dat -c -U<login_id> -S<server_name\instance_name>  

Система предложит ввести пароль.

В. Копирование данных из файла в таблицу

В следующем примере показано применение параметра in с файлом, созданным в предыдущем примере (Currency.dat). Тем не менее, сначала в этом примере создается пустая копия таблицы AdventureWorks2012 Sales.Currency, Sales.Currency2, в которую копируются данные. В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное подключение к экземпляру сервера, на котором запускается команда bcp .

Чтобы создать пустую таблицу, введите следующую команду в редакторе запросов:

USE AdventureWorks2012;  
GO  
SELECT * INTO AdventureWorks2012.Sales.Currency2   
FROM AdventureWorks2012.Sales.Currency WHERE 1=2;  

Для массового копирования символьных данных в новую таблицу, то есть для импорта данных, введите в командной строке следующую команду:

bcp AdventureWorks2012.Sales.Currency2 in Currency.dat -T -c  

Чтобы убедиться в успешном выполнении команды, отобразите в редакторе запросов содержимое таблицы и введите:

USE AdventureWorks2012;  
GO  
SELECT * FROM Sales.Currency2  

Г. Копирование отдельного столбца в файл данных

Чтобы выполнить копирование конкретного столбца, можно использовать параметр queryout . Следующий пример копирует в файл данных из таблицы Name только столбец Sales.Currency . В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное подключение к экземпляру сервера, на котором запускается команда bcp .

В командной строке Windows введите:

bcp "SELECT Name FROM AdventureWorks.Sales.Currency" queryout Currency.Name.dat -T -c  

Д. Копирование отдельной строки в файл данных

Чтобы выполнить копирование конкретной строки, можно использовать параметр queryout . В следующем примере копируется только строка контакта с именем Jarrod Rana из таблицы AdventureWorks2012.Person.Person в файл данных (Jarrod Rana.dat). В этом примере предполагается, что используется проверка подлинности Windows и существует доверенное соединение с экземпляром сервера, на котором запускается команда bcp.

В командной строке Windows введите:

bcp "SELECT * FROM AdventureWorks2012.Person.Person WHERE FirstName='Jarrod' AND LastName='Rana' "  queryout "Jarrod Rana.dat" -T -c  

Е. Копирование данных из запроса в файл данных

Результирующий набор инструкции Transact-SQL копируется в файл данных с помощью параметра queryout . Следующий пример копирует имена из таблицы AdventureWorks2012.Person.Person , упорядоченные по фамилии и далее по имени, в файл данных Contacts.txt . В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное подключение к экземпляру сервера, на котором запускается команда bcp .

В командной строке Windows введите:

bcp "SELECT FirstName, LastName FROM AdventureWorks2012.Person.Person ORDER BY LastName, Firstname" queryout Contacts.txt -c -T  

Ж. Создание файла форматирования в формате, отличном от XML

В следующем примере создается файл форматирования, отличный от XML, Currency.fmt, для Sales.Currency таблицы в базе данных AdventureWorks2012 . В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное подключение к экземпляру сервера, на котором запускается команда bcp .

В командной строке Windows введите:

bcp AdventureWorks2012.Sales.Currency format nul -T -c  -f Currency.fmt  

Дополнительные сведения см. в разделе Файлы форматирования, отличные от XML (SQL Server).

H. Создание XML-файла форматирования

В следующем примере создается XML-файл Currency.xml форматирования для Sales.Currency таблицы в базе данных AdventureWorks2012 . В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное подключение к экземпляру сервера, на котором запускается команда bcp .

В командной строке Windows введите:

bcp AdventureWorks2012.Sales.Currency format nul -T -c -x -f Currency.xml  

Примечание

Для использования параметра -x необходима версия клиента bcp 9.0. Сведения об использовании клиента bcp 9.0 см. в разделе "Примечания".

Дополнительные сведения см. в разделе Xml Format Files (SQL Server).

И. Использование файла форматирования для массового импорта данных c помощью программы bcp

Чтобы использовать ранее созданный файл форматирования при выполнении импорта данных в экземпляр SQL Server, укажите параметр -f и параметр in . Например, следующая команда выполняет массовое копирование содержимого файла данных Currency.dat в копию таблицы Sales.Currency (Sales.Currency2) с помощью ранее созданного файла форматирования (Currency.xml). В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное подключение к экземпляру сервера, на котором запускается команда bcp .

В командной строке Windows введите:

bcp AdventureWorks2012.Sales.Currency2 in Currency.dat -T -f Currency.xml  

Примечание

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

Дополнительные примеры

В следующих разделах приведены примеры использования bcp:

• Создание файла форматирования (SQL Server)

• Примеры массового импорта и экспорта XML-документов (SQL Server)

• Сохранение значений идентификаторов при массовом импорте данных (SQL Server)

• Сохранение значений NULL или использование значений по умолчанию при массовом импорте данных (SQL Server)

• Определение признаков конца поля и строки (SQL Server)

• Использование файла форматирования для массового импорта данных (SQL Server)

• Использование символьного формата для импорта или экспорта данных (SQL Server)

• Использование собственного формата для импорта или экспорта данных (SQL Server)

• Использование символьного формата Юникода для импорта и экспорта данных (SQL Server)

• Использование собственного формата Юникода для импорта или экспорта данных (SQL Server)

См. также:

Подготовка данных к массовому экспорту или импорту (SQL Server)
BULK INSERT (Transact-SQL)
OPENROWSET (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
sp_configure (Transact-SQL)
sp_tableoption (Transact-SQL)
Файлы форматирования для импорта или экспорта данных (SQL Server)