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

Основной синтаксис XML-схемы

Данные инструкции синтаксиса показывают только элементы (<BCPFORMAT>, <RECORD>, <FIELD>, <ROW> и <COLUMN>) и их основные атрибуты.

<BCPFORMAT ...>

   <RECORD>

      <FIELD ID = "fieldID" xsi:type = "fieldType" [...]

      />

   </RECORD>

   <ROW>

      <COLUMN SOURCE = "fieldID" NAME = "columnName" xsi:type = "columnType" [...]

      />

   </ROW>

</BCPFORMAT>

Примечание
Дополнительные атрибуты, связанные со значением типа xsi:type в элементах <FIELD> или <COLUMN>, описаны ниже в этом подразделе.

Описание элементов схемы

Атрибуты элемента <FIELD>

Атрибуты элемента <COLUMN>

В этом разделе описываются атрибуты элемента <COLUMN>, которые обобщены в следующем синтаксисе схемы:

<COLUMN

   SOURCE = "fieldID"

   NAME = "columnName"

   xsi:type = "columnType"

   [ LENGTH = "n" ]

   [ PRECISION = "n" ]

   [ SCALE = "value" ]

   [ NULLABLE = { "YES"

"NO" } ]

/>

Поле сопоставлено со столбцом целевой таблицы с использованием следующих атрибутов:

Атрибут COLUMN	Описание	Необязательный или обязательный
SOURCE ="fieldID"	Задает идентификатор поля, сопоставляемого со столбцом. <COLUMN SOURCE="fieldID"/> сопоставляется с <FIELD ID="fieldID"/>	Обязательный
NAME = "columnName"	Задает имя столбца в наборе строк, представленном файлом форматирования. Это имя столбца используется для идентификации столбца в результирующем наборе, и оно не обязательно должно соответствовать имени столбца целевой таблицы.	Обязательный
xsi:type ="ColumnType"	Это конструкция XML (используется как атрибут), которая указывает тип данных экземпляра элемента. Значение атрибута ColumnType определяет, какой из необязательных атрибутов (см. ниже) необходим в данном экземпляре. Примечание Возможные значения ColumnType и связанные с ними атрибуты перечислены в следующей таблице.	Необязательный
LENGTH ="n"	Определяет длину для экземпляра типа данных фиксированной длины. Атрибут LENGTH используется только в том случае, если значение xsi:type является строковым типом данных. Значение n должно быть положительным целым числом.	Необязательный (доступен только в том случае, если значение xsi:type является строковым типом данных)
PRECISION ="n"	Указывает количество цифр в числе. Например, число 123,45 имеет точность 5. Значение должно быть положительным целым числом.	Необязательный (доступен только в том случае, если значение xsi:type является переменным числовым типом данных)
SCALE ="int"	Указывает количество цифр справа от десятичной запятой в числе. Например, число 123,45 имеет масштаб 2. Значением должно быть целое число.	Необязательный (доступен только в том случае, если значение xsi:type является переменным числовым типом данных)
NULLABLE = { "YES" "NO" }	Указывает, может ли столбец принимать значение NULL. Этот атрибут полностью независим от FIELDS. Однако, если столбец не NULLABLE и в поле указано значение NULL (значение не указано), результатом будет ошибка выполнения. Атрибут NULLABLE используется только в простой инструкции SELECT FROM OPENROWSET(BULK...).	Необязательный (доступен для любого типа данных)

Значения Xsi:type элемента <COLUMN>

Значение xsi:type — это конструкция XML, используемая как атрибут и определяющая тип данных экземпляра элемента. Сведения по применению этой конструкции см. в пункте «Размещение значения xsi:type в наборе данных» ниже в этом разделе.

Элемент <COLUMN> поддерживает следующие собственные типы данных SQL:

Категория типа	Типы данных <COLUMN>	Обязательные XML-атрибуты для типа данных	Необязательные XML-атрибуты для типа данных
Фиксированный	SQLBIT, SQLTINYINT, SQLSMALLINT, SQLINT, SQLBIGINT, SQLFLT4, SQLFLT8, SQLDATETIME, SQLDATETIM4, SQLDATETIM8, SQLMONEY, SQLMONEY4, SQLVARIANT и SQLUNIQUEID	Нет	NULLABLE
Переменное число	SQLDECIMAL и SQLNUMERIC	Нет	NULLABLE, PRECISION, SCALE
Большой объект (LOB)	SQLIMAGE, CharLOB, SQLTEXT и SQLUDT	Нет	NULLABLE
Большой символьный объект (CLOB)	SQLNTEXT	Нет	NULLABLE
Двоичная строка	SQLBINARY и SQLVARYBIN	Нет	NULLABLE, LENGTH
Строка символов	SQLCHAR, SQLVARYCHAR, SQLNCHAR и SQLNVARCHAR	Нет	NULLABLE, LENGTH

Важно!
Для массового экспорта или импорта данных SQLXML используется один из следующих типов данных в файле форматирования: SQLCHAR или SQLVARYCHAR (данные посылаются в кодовой странице клиента или в кодовой странице, предполагаемой параметрами сортировки), SQLNCHAR или SQLNVARCHAR (данные посылаются в формате Юникод) и SQLBINARY или SQLVARYBIN (данные посылаются без преобразования).

Дополнительные сведения о типах данных SQL Server см. в разделе Типы данных (Transact-SQL).

Как массовый импорт использует элемент &lt;ROW&gt;

Элемент <ROW> не учитывается в определенных контекстах. Влияние элемента <ROW> на операцию массового импорта зависит от того, как выполняется операция.

• Команда bcp

  При загрузке данных в целевую таблицу команда bcp не учитывает компонент <ROW>. Вместо этого команда bcp загружает данные на основании типов столбцов целевой таблицы.

• Инструкции Transact-SQL (команда BULK INSERT и поставщик массового набора строк OPENROWSET)

  При массовом импорте данных в таблицу инструкции Transact-SQL используют компонент <ROW> для формирования входного набора строк. Инструкции Transact-SQL также выполняют соответствующие преобразования типов, основываясь на типах столбцов, указанных для элемента <ROW> и соответствующего столбца в целевой таблице. При несовпадении типов столбцов в файле форматирования и в целевой таблице производится дополнительное преобразование типов, которое может привести к некоторым несовпадениям (то есть потере точности) в поведении команды BULK INSERT или поставщика массового набора строк OPENROWSET по сравнению с командой bcp.

  Сведения в элементе <ROW> позволяют построить строку без дополнительных сведений. По этой причине набор строк можно сформировать при помощи инструкции SELECT (SELECT * FROM OPENROWSET(BULK datafile FORMATFILE=xmlformatfile).

  Примечание
  Чтобы использовать предложение OPENROWSET BULK, необходим файл форматирования (обратите внимание, что преобразование типа данных поля в тип данных столбца доступно только при наличии XML-файла форматирования).

Как массовый импорт использует элемент &lt;COLUMN&gt;

Для массового импорта данных в таблицу элементы <COLUMN> в файле форматирования сопоставляют поле файла данных со столбцами таблицы, указывая:

• позицию каждого поля в строке файла данных;

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

Если с полем не сопоставлено ни одного столбца, поле не копируется в сформированные строки. Такое поведение позволяет файлам данных формировать строки с различными столбцами (в разных таблицах).

Аналогично, для массового экспорта данных из таблицы каждый элемент <COLUMN> в файле форматирования сопоставляет столбец строки входной таблицы с соответствующим полем выходного файла данных.

Помещение значения xsi:type в набор данных

Если XML-документ проверяется при помощи языка определения XML-схемы (XSD), значение xsi:type не помещается в набор данных. Тем не менее, сведения xsi:type можно поместить в набор данных, загрузив XML-файл форматирования в XML-документ, например myDoc, как показано в следующем фрагменте кода:

...;
myDoc.LoadXml(xmlFormat);
XmlNodeList ColumnList = myDoc.GetElementsByTagName("COLUMN");
for(int i=0;i<ColumnList.Count;i++)
{
   Console.Write("COLUMN: xsi:type=" +ColumnList[i].Attributes["type",
      "http://www.w3.org/2001/XMLSchema-instance"].Value+"\n");
}

См. также

Справочник

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