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

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

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

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

Примечание

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

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

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

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

bcptable_or_viewформат nul -fformat_file_name

Примечание

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

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

Примеры

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

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

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

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

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

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

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

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

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

Квалификаторы	Описание
format_file 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).

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

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

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

Квалификаторы	Описание
format_file 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).

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

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

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

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

Г. Создание файла форматирования в формате, отличном от 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 , например:

bcptable_or_viewформат nul-fformat_file_name-x

Примечание

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

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

Примеры

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

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

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

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

Примечание

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

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

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

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

Квалификаторы	Описание
formatnul-fformat_file-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).

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

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

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

Квалификаторы	Описание
formatnul-fformat_file-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файл форматирования надлежащим образом отображает все столбцы таблицы. Его можно изменить, переставив или исключив некоторые из строк. Это позволяет согласовать файл форматирования с файлом данных, если поля в нем не сопоставлены непосредственно со столбцами таблицы. Дополнительные сведения см. в следующих разделах:

• Пропуск столбца таблицы с помощью файла форматирования (SQL Server)

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

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

См. также:

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