Поделиться через

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

  • Статья

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

SQL Server поддерживает два типа файлов форматирования: файлы форматирования в формате, отличном от XML, и XML-файлы форматирования. Файл форматирования не в формате XML поддерживается более ранними версиями SQL Server.

Как правило, XML-файлы и файлы форматирования в формате, отличном от XML взаимозаменяемы. Однако рекомендуется пользоваться XML-синтаксисом новых файлов форматирования, так как он обеспечивает ряд преимуществ перед файлами форматирования в формате, отличном от XML.

Примечание.

Версия служебной программы bcp (Bcp.exe), которая используется для чтения файла форматирования, должна соответствовать версии, используемой при создании этого файла форматирования, или более поздней версии. Например, sql Server 2012 bcp может прочитать файл формата версии 10.0, созданный sql Server 2008 bcp, но SQL Server 2008bcp не может прочитать файл формата версии 11.0, созданный SQL Server 2012bcp.

В этом разделе описано применение программы bcp для создания файла форматирования для таблицы. Файл форматирования основан на заданных параметрах типов данных (-n, -c, -wили -N) и разделителях таблиц или представлений.

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

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

bcp таблица_или_представление format nul -fимя_файла_формата

Примечание.

Для файлов форматирования в формате, отличном от XML рекомендуется использовать расширение FMT, например MyTable.fmt.

Сведения о структуре и полях файлов форматирования, отличных от XML, см. в разделе "Файлы форматирования, отличные от XML(SQL Server)".

Примеры

В этом разделе приведены следующие примеры, которые показывают, как пользоваться командами bcp для создания файлов форматирования в формате, отличном от XML:

  • А. Создание файла форматирования в формате, отличном от XML для данных в собственном формате

  • B. Создание файла форматирования в формате, отличном от XML для символьных данных

  • C. Создание файла форматирования в формате, отличном от XML для данных в собственном формате в кодировке Юникод

  • D. Создание файла форматирования в формате, отличном от XML для символьных данных в кодировке Юникод

В примерах используется HumanResources.Department таблица в примере базы данных AdventureWorks2012 . Таблица HumanResources.Department содержит четыре столбца: DepartmentID, Name, GroupNameи ModifiedDate.

А. Создание файла форматирования в формате, отличном от XML для данных в собственном формате

В следующем примере создается XML-файл Department-n.xmlформатирования для таблицы AdventureWorks2012HumanResources.Department . в котором используются собственные типы данных. Содержимое созданного файла форматирования приведено после команды.

Команда bcp содержит следующие квалификаторы:

Квалификаторы Description
formatnul-f формат_файла Задает файл форматирования в формате, отличном от XML.
-n Указывает собственные типы данных.
-T Указывает, что служебная программа bcp подключается к SQL Server с доверенным подключением с помощью интегрированной безопасности. Если параметр -T не указан, для входа необходимо указать параметры -U и -P .

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

bcp AdventureWorks2012.HumanResources.Department format nul -T -n -f Department-n.fmt

Созданный файл форматирования Department-n.fmtсодержит следующие данные:

12.0  
4  
1       SQLSMALLINT   0       2       ""   1     DepartmentID                 ""  
2       SQLNCHAR      2       100     ""   2     Name                         SQL_Latin1_General_CP1_CI_AS  
3       SQLNCHAR      2       100     ""   3     GroupName                    SQL_Latin1_General_CP1_CI_AS  
4       SQLDATETIME   0       8       ""   4     ModifiedDate                 ""

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

B. Создание файла форматирования в формате, отличном от XML для символьных данных

В следующем примере создается XML-файл Department.fmtформатирования для таблицы AdventureWorks2012HumanResources.Department . Файл форматирования использует формат символьных данных и признак конца поля, отличный от установленного по умолчанию (,). Содержимое созданного файла форматирования приведено после команды.

Команда bcp содержит следующие квалификаторы:

Квалификаторы Description
formatnul-f формат_файла Задает файл форматирования в формате, отличном от XML.
-c Задает символьные данные.
-T Указывает, что служебная программа bcp подключается к SQL Server с доверенным подключением с помощью интегрированной безопасности. Если параметр -T не указан, для входа необходимо указать параметры -U и -P .

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

bcp AdventureWorks2012.HumanResources.Department format nul -c -f Department-c.fmt -T

Созданный файл форматирования Department-c.fmtсодержит следующие данные:

12.0  
4  
1       SQLCHAR       0       7       "\t"     1     DepartmentID                 ""  
2       SQLCHAR       0       100     "\t"     2     Name                         SQL_Latin1_General_CP1_CI_AS  
3       SQLCHAR       0       100     "\t"     3     GroupName                    SQL_Latin1_General_CP1_CI_AS  
4       SQLCHAR       0       24      "\r\n"   4     ModifiedDate                 ""

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

C. Создание файла форматирования в формате, отличном от XML для данных в собственном формате в кодировке Юникод

Чтобы создать для таблицы HumanResources.Department файл форматирования в формате, отличном от XML для данных в собственном формате с кодировкой Юникод, используется следующая команда:

bcp AdventureWorks2012.HumanResources.Department format nul -T -N -f Department-n.fmt

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

D. Создание файла форматирования в формате, отличном от XML для символьных данных в кодировке Юникод

Чтобы создать для таблицы HumanResources.Department файл форматирования в формате, отличном от XML для символьных данных в кодировке Юникод, использующий признак конца по умолчанию, применяется следующая команда:

bcp AdventureWorks2012.HumanResources.Department format nul -T -w -f Department-w.fmt

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

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

Чтобы создать файл форматирования с помощью служебной программы bcp , укажите аргумент format , а вместо пути файла данных задайте значение nul . Параметр format всегда требует наличия параметра -f , а чтобы создать XML-файл форматирования, необходимо задать параметр -x , например:

bcp таблица_или_представление format nul-f имя_файла_формата -x

Примечание.

Для XML-файлов форматирования рекомендуется использовать расширение XML, например MyTable.xml.

Сведения о структуре и полях XML-файлов форматирования см. в разделе XML Format Files (SQL Server).

Примеры

В этом разделе содержатся следующие примеры использования команд bcp для создания XML-файлов форматирования.

  • А. Создание XML-файла форматирования для символьных данных

  • B. Создание XML-файла форматирования для данных в собственном формате

В примерах используется HumanResources.Department таблица в примере базы данных AdventureWorks2012 . Таблица HumanResources.Department содержит четыре столбца: DepartmentID, Name, GroupNameи ModifiedDate.

Примечание.

Компания Adventure Works Cycles — это вымышленная производственная компания, которая используется для демонстрации концепций баз данных и сценариев работы с ними.

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

В следующем примере создается XML-файл Department.xmlформатирования для таблицы AdventureWorks2012HumanResources.Department . Файл форматирования использует формат символьных данных и признак конца поля, отличный от установленного по умолчанию (,). Содержимое созданного файла форматирования приведено после команды.

Команда bcp содержит следующие квалификаторы:

Квалификаторы Description
formatnul-f формат_файла -x Задает XML-файл форматирования.
-c Задает символьные данные.
-t , Задает запятую (,) в качестве признака конца поля.

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

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

bcp AdventureWorks2012.HumanResources.Department format nul -c -x -f Department-c..xml -t, -T

Созданный файл форматирования Department-c.xmlсодержит следующие XML-элементы:

<?xml version="1.0"?>  
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
 <RECORD>  
  <FIELD ID="1" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="7"/>  
  <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="4" xsi:type="CharTerm" TERMINATOR="\r\n" MAX_LENGTH="24"/>  
 </RECORD>  
 <ROW>  
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>  
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>  
 </ROW>  
</BCPFORMAT>

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

B. Создание XML-файла форматирования для данных в собственном формате

В следующем примере создается XML-файл форматирования Department-n.xmlдля таблицы HumanResources.Department . в котором используются собственные типы данных. Содержимое созданного файла форматирования приведено после команды.

Команда bcp содержит следующие квалификаторы:

Квалификаторы Description
formatnul-f формат_файла -x Задает XML-файл форматирования.
-n Указывает собственные типы данных.
-T Указывает, что служебная программа bcp подключается к SQL Server с доверенным подключением с помощью интегрированной безопасности. Если параметр -T не указан, для входа необходимо указать параметры -U и -P .

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

bcp AdventureWorks2012.HumanResources.Department format nul -x -f Department-n..xml -n -T

Созданный файл форматирования Department-n.xmlсодержит следующие XML-элементы:

<?xml version="1.0"?>  
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
 <RECORD>  
  <FIELD ID="1" xsi:type="NativeFixed" LENGTH="2"/>  
  <FIELD ID="2" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="3" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="4" xsi:type="NativeFixed" LENGTH="8"/>  
 </RECORD>  
 <ROW>  
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>  
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>  
 </ROW>  
</BCPFORMAT>

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

Сопоставление полей данных со столбцами таблицы

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

См. также

bcp Utility
Использование файла форматирования для сопоставления столбцов таблицы с полями файла данных (SQL Server)
Использование файла форматирования для пропуска столбца таблицы (SQL Server)
Использование файла форматирования для пропуска поля данных (SQL Server)
Файлы форматирования, отличные от XML (SQL Server)
XML-файлы форматирования (SQL Server)