Программа bcp

Синтаксис

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

Аргументы

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

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

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

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

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

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

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

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

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

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

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

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

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

  Важно!
  В качестве значения параметра format необходимо указать nul: data_file (formatnul).

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

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

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

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

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

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

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

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

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

  Примечание
  Для использования аргумента командной строки -x необходима версия клиента bcp 10.0. Дополнительные сведения об использовании клиента bcp 10,0 см. в приведенном ниже разделе «Примечания».

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

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

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

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

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

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

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

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

  Дополнительные сведения см. в разделе Управление пакетами для массового импорта данных.

• -ddatabase_name
  Указывает базу данных, с которой надо соединиться. По умолчанию программа bcp.exe соединяется с пользовательской базой данных по умолчанию.

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

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

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

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

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

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

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

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

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

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

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

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

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

  70 = SQL Server 7.0

  80 = SQL Server 2000

  90 = SQL Server 2005

  Например, чтобы сформировать данные для типов, не поддерживаемых SQL Server 7.0, но введенных в более поздних версиях SQL Server (например, bigint, sql_variant и xml), используйте параметр -V70.

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

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

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

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

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

• -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).

  Дополнительные сведения см. в разделе Копирование данных между различными параметрами сортировки.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• **-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 производит принудительную проверку данных, которые могут привести к ошибкам в работе существующих сценариев, если файлы данных будут содержать недопустимые данные.

    Примечание
    Параметр -mmax_errors не применяется при проверке ограничений.

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

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

    Дополнительные сведения см. в разделе Управление выполнением триггеров при массовом импорте данных.

Замечания

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

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

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

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

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

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

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

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

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

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

Разрешения

Для операции 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.

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

USE AdventureWorks2008R2;
GO
SELECT * FROM Sales.Currency2;

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

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

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

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

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

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

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

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

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

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

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

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

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

Дополнительные сведения см. в разделе Основные сведения о XML-файлах форматирования.

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

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

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

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

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

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

Следующие разделы содержат примеры использования программы bcp:

• Копирование данных между различными параметрами сортировки

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

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

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

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

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

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

• Применение символьного формата при импорте и экспорте данных

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

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

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

См. также

Справочник

Основные понятия

Другие ресурсы