Программа bcp

Статья
01/21/2014

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

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

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

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

Синтаксис

bcp [database_name.] schema.{table_name | view_name | "query" {in data_file | out data_file | queryout data_file | format nul}

   [-a packet_size]
   [-b batch_size]
   [-c]
   [-C { ACP | OEM | RAW | code_page } ]
   [-d database_name]
   [-e err_file]
   [-E]
   [-f format_file]
   [-F first_row]
   [-h"hint [,...n]"] 
   [-i input_file]
   [-k]
   [-K application_intent]
   [-L last_row]
   [-m max_errors]
   [-n]
   [-N]
   [-o output_file]
   [-P password]
   [-q]
   [-r row_term]
   [-R]
   [-S [server_name[\instance_name]]
   [-t field_term]
   [-T]
   [-U login_id]
   [-v]
   [-V (80 | 90 | 100 )]
   [-w]
   [-x]
   /?

Аргументы

data_file
Полный путь файла данных. После массового импорта данных в SQL Server этот файл данных содержит данные, которые должны быть скопированы в указанную таблицу или представление. После массового экспорта данных из SQL Server этот файл данных содержит данные, скопированные из таблицы или представления. Путь может содержать от 1 до 255 символов. Файл данных может содержать максимум (263 - 1) строк.
database_name
Имя базы данных, в которой находится указанная таблица или представление. Эта база данных будет по умолчанию использоваться для пользователя, если не указано иное.

Можно также явным образом указать имя базы данных с помощью параметра d-.
in data_file | outdata_file | queryoutdata_file | format nul
Указывает направление массового копирования следующим образом:
- in — выполняется копирование из файла в таблицу или представление базы данных.
- out — выполняется копирование из таблицы или представления базы данных в файл; Если указать существующий файл, то файл перезаписывается. При извлечении данных обратите внимание, что программа bcp представляет пустую строку как строку NULL, а строку NULL — как пустую строку.
- queryout — выполняется копирование из запроса. Этот аргумент может быть указан только при выполнении массового копирования данных из запроса.
- format создается файл форматирования, основанный на указанных параметрах (-n, -c, -w и -N) и разделителях таблиц или представлений. При выполнении массового копирования данных программа bcp может обратиться к файлу форматирования, что позволяет избежать повторного ввода данных о формате в интерактивном режиме. Параметр format требует наличия параметра -f. Для создания XML-файла форматирования также необходим параметр -x. Дополнительные сведения см. в разделе Создание файла форматирования (SQL Server). Необходимо указать nul как значение (format nul).
owner
Имя владельца таблицы или представления. Можно не указывать необязательный параметр owner, если пользователь, выполняющий операцию, является владельцем указанной таблицы или представления. SQL Server вернет сообщение об ошибке и операция завершится, если аргумент owner не указан, а пользователь, выполняющий операцию, не является владельцем указанной таблицы или представления.
" 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 packet_size
Указывает число байтов в каждом сетевом пакете, отправляемом от сервера и к серверу. Параметр конфигурации сервера можно задать с помощью среды Среда SQL Server Management Studio (или системной хранимой процедуры sp_configure). Однако параметр конфигурации сервера в отдельных случаях можно изменить с помощью этого параметра. Значение packet_size может находиться в пределах от 4 096 до 65 535 байт, значение по умолчанию равно 4 096.

Увеличение размера пакета может повысить производительность операций массового копирования. Если был запрошен пакет большего размера, но он не может быть предоставлен, то используется значение по умолчанию. Статистика производительности, формируемая программой bcp, показывает используемый размер пакета.
-b batch_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).

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

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

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

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

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

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

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

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

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

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

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

Параметр first_row может иметь положительное целое значение до 2^63-1. Аргумент -F first_row имеет нумерацию, которая начинается с 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 max_errors не применяется при проверке ограничений.

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

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

Если параметр input_file начинается с дефиса (-) или косой черты (/), не ставьте пробел между -i и значением input_file.
-k
Указывает, что пустые столбцы во время данной операции должны сохранить значение NULL вместо любых вставляемых значений столбцов по умолчанию. Дополнительные сведения см. в разделе Сохранение значений NULL или использование значений по умолчанию при массовом импорте данных (SQL Server).
-K application_intent
Объявляет тип рабочей нагрузки приложения при соединении с сервером. Единственным возможным значением является ReadOnly. Если параметр -K не указан, программа bcp не будет поддерживать соединение с вторичной репликой в группе доступности AlwaysOn. Дополнительные сведения см. в разделе Активные вторичные реплики: Доступ к вторичным репликам только для чтения (группы доступности AlwaysOn).
-L last_row
Указывает номер последней строки для экспорта из таблицы или импорта из файла данных. Значение параметра должно быть больше (>) 0, но меньше (<) или равно (=) номеру последней строки. Если параметр отсутствует, по умолчанию используется последняя строка файла.

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

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

Примечание

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

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

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

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

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

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

Примечание по безопасности

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

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

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

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

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

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

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

Если параметр row_term начинается с дефиса (-) или косой черты (/), не ставьте пробел между -r и значением row_term.
-R
Указывает, что массовое копирование в SQL Server данных в денежном формате, в формате даты и времени выполняется с помощью регионального формата, определенного настройками локали клиентского компьютера. По умолчанию региональные настройки не учитываются.
-S server_name[ **\instance_name]
Указывает экземпляр SQL Server, к которому выполняется подключение. Если сервер не указан, программа bcp выполняет подключение к экземпляру SQL Server по умолчанию на локальном компьютере. Этот параметр необходим, если команда bcp запускается с удаленного компьютера в сети или с локального именованного экземпляра. Чтобы подключиться к экземпляру по умолчанию SQL Server на сервере, укажите только server_name. Чтобы подключиться к именованному экземпляру SQL Server, укажите server_name\**instance_name.
-t field_term
Указывает признак конца поля. Значением по умолчанию является \t (символ табуляции). Используйте этот параметр, чтобы переопределить признак конца поля по умолчанию. Дополнительные сведения см. в разделе Определение признаков конца поля и строки (SQL Server).

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

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

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

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

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

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

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

80 = SQL Server 2000

90 = SQL Server 2005

100 = SQL Server 2008 и SQL Server 2008 R2

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

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

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

Замечания

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

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

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

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

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

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

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

Вычисляемые столбцы и столбцы типа 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	Данные отправляются без преобразования.

Разрешения

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

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

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

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

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

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

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

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

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

Примеры

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

А. Копирование строк из таблицы в файл данных (с помощью доверительного соединения)
Б. Копирование строк из таблицы в файл данных (в смешанном режиме проверки подлинности)
В. Копирование данных из файла в таблицу
Г. Копирование отдельного столбца в файл данных
Д. Копирование отдельной строки в файл данных
Е. Копирование данных из запроса в файл данных
Ж. Создание файла форматирования в формате, отличном от XML
З. Создание XML-файла форматирования
И. Использование файла форматирования для массового импорта данных c помощью программы bcp

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

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

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

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

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

В этом примере предполагается, что используется смешанный режим проверки подлинности. Для указания идентификатора входа необходимо использовать параметр -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. Следующий пример копирует в файл данных из таблицы Sales.Currency только столбец Name. В этом примере предполагается, что используется проверка подлинности Windows и существует доверительное соединение с экземпляром сервера, на котором запускается команда bcp.