Синтаксис схемы для 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");
}

См. также

Справочник

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