XML 格式化文件 (SQL Server)

ゞ浴缸里的玫瑰 2023-09-24 12:16 156阅读 0赞

01/11/2019

![f0e0e6aeb62d71a961756e5447e11fd4.jpeg][]

![12bbf661f5921057dcb2abf90e4b834c.png][]

![OpenLocalizationService.png_size_32][]

![Saisang.png_size_32][]

适用于： ![是][cd87ca40cd14c7781f68cd1408b9d6bc.png]SQL Server(所有支持的版本) ![是][24eafc6842dff7e7cc27547d427d2850.png]Azure SQL 数据库 ![是][48dc77c806126b556bb9c0c933cb64d2.png]Azure SQL 托管实例 ![是][17211457eeb8b18bcb9d4512775dda7b.png]Azure Synapse Analytics ![是][a58c192438cb8f81815755317c55bac1.png]并行数据仓库

SQL Server 提供了一个 XML 架构，该架构定义了编写“XML 格式化文件”(用于将数据大容量导入到 SQL Server 表中)的语法。 XML 格式化文件必须符合用 XML 架构定义语言 (XSDL) 定义的这种架构。 只有当 SQL Server 工具和 SQL Server Native Client 一起安装后，才支持 XML 格式化文件。

可以结合使用 XML 格式化文件和 bcp 命令、BULK INSERT 语句或 INSERT...SELECT \* FROM OPENROWSET(BULK...) 语句。 使用 bcp 命令，你可以自动生成表的 XML 格式化文件；有关详细信息，请参阅 bcp Utility。

备注

大容量导出和导入支持两种类型的格式化文件： 非 XML 格式化文件 和 XML 格式化文件。 XML 格式化文件比非 XML 格式化文件更灵活，功能更强大。 有关非 XML 格式化文件的信息，请参阅 非 XML 格式化文件 (SQL Server)。

本主题内容：

XML 格式化文件的优点

XML 格式化文件的结构

XML 格式化文件的架构语法

XML 格式化文件示例

相关内容

XML 格式化文件是自描述型，因此易于阅读、 创建和扩展。 这些文件具有较强的可读性，这使您更容易理解在大容量操作过程中是如何解释数据的。

XML 格式化文件包含目标列的数据类型。 XML 编码清晰地描述了数据文件的数据类型和数据元素以及数据元素和表列之间的映射。

这可以将数据文件中数据的表示形式与文件中每个字段相关联的数据类型分离开来。 例如，如果数据文件包含字符表示形式的数据，则相应的 SQL 列类型会丢失。

XML 格式化文件允许从数据文件加载包含单一大型对象 (LOB) 数据类型的字段。

XML 格式化文件得以增强的同时，仍与早期版本保持兼容。 此外，XML 编码清晰，有利于为给定数据文件创建多个格式化文件。 这有助于将所有或某些数据字段映射到不同表或视图中的列。

XML 语法与操作的方向无关；即大容量导出和大容量导入中使用的语法相同。

使用 XML 格式化文件，可以将数据大容量导入表或非分区视图，并可以大容量导出数据。

对于 OPENROWSET(BULK...) 函数，指定目标表是可选的。 这是因为该函数依赖 XML 格式化文件从数据文件中读取数据。

备注

bcp 命令和 BULK INSERT 语句需要使用目标表，因为它们使用目标表列执行类型转换。

和非 XML 格式化文件一样，XML 格式化文件定义数据文件中数据字段的格式和结构，并将这些数据字段映射到单个目标表中的相应列。

XML 格式化文件有两个主要组件，即 和 ：

说明数据文件中存储的数据。

每个 元素包含一个或多个 元素。 这些元素与数据文件中的字段相对应。 基本语法如下：

\[ ...n \]

每个 元素说明特定数据字段的内容。 一个字段只能映射到表中的一列， 并不是所有字段都需要映射到列。

数据文件中字段的长度可以是固定或可变的，也可以由字符结尾。 字段值 可以表示为字符(使用单字节表示形式)、宽字符(使用 Unicode 双字节表示形式)、本机数据库格式或文件名。 如果字段值为文件名，则文件名指向包含目标表中 BLOB 列的值的文件。

说明在将数据从文件导入 SQL Server 表中时，如何构造数据文件中的数据行。

元素包含一组 元素。 这些元素与表列相对应。 基本语法如下：

\[ ...n \]

每个 元素均只能映射到数据文件中的一个字段。 元素中 元素的顺序定义了其在批量操作中返回的顺序。 XML 格式化文件为每个 元素分配了一个本地名称，该名称与批量导入操作的目标表中的列没有关系。

本节概要介绍 XML 格式化文件的 XML 架构的元素和属性。 格式化文件的语法与操作的方向无关；即大容量导出和大容量导入中使用的语法相同。 本部分还介绍批量导入如何使用 和 元素以及如何将元素的 xsi:type 值放入数据集。

若要查看该语法与实际的 XML 格式化文件的对应关系，请参阅本主题后面的 XML 格式化文件示例。

备注

您可以修改格式化文件，以便从字段编号和/或顺序与表列的编号和/或顺序不同的数据文件进行大容量导入。 有关详细信息，请参阅 用来导入或导出数据的格式化文件 (SQL Server)。

本节内容：

XML 架构的基本语法

批量导入如何使用 元素

将 xsi:type 值放入数据集

此语法语句仅显示元素( 、 、 、 和 )及其基本属性。

备注

对于其他与 或 元素中的 xsi:type 值相关的属性，将在本主题后面部分予以介绍。

本节内容：

架构元素

元素的属性(和 元素的 xsi:type 值)

架构元素

本节总结了 XML 架构为 XML 格式化文件定义的每个元素的作用。 本主题在后面有单独的章节介绍这些属性。

即格式化文件元素。它定义给定数据文件的记录结构及其与表中某行的各列的对应关系。

定义包含一个或多个 元素的复杂元素。 在格式化文件中声明的字段的顺序与那些字段在数据文件中出现的顺序相同。

定义数据文件中的字段，用来容纳数据。

本主题将在后面的 元素的属性中讨论此元素的属性。

定义包含一个或多个 元素的复杂元素。 元素的顺序与 RECORD 定义中 元素的顺序无关。 但是， 元素在格式化文件中的顺序决定了所生成行集的列的顺序。 数据字段的加载将按照相应的 元素在 元素中的声明顺序进行。

有关详细信息，请参阅本主题后面的批量导入如何使用 元素。

将列定义为元素 ( )。 每个 元素对应一个 元素(其 ID 在 元素的 SOURCE 属性中指定)。

本主题将在后面的 元素的属性中讨论此元素的属性。 另请参阅本主题后面的批量导入如何使用 元素。

用于结束格式化文件。

元素的属性

本部分介绍 元素的属性，现将其架构语法总结如下：

ID =" fieldID "

xsi : type =" fieldType "

\[ LENGTH =" n " \]

\[ PREFIX\_LENGTH =" p " \]

\[ MAX\_LENGTH =" m " \]

\[ COLLATION =" collationName " \]

\[ TERMINATOR =" terminator " \]

每个 元素都与其他元素无关。 字段是通过下列属性进行描述的：

FIELD 属性

说明

可选/

必选

ID =" fieldID "

指定数据文件中的字段的逻辑名称。 字段的 ID 是用于引用字段的键。

映射到

必选

xsi:type =" fieldType "

这是一个 XML 构造，用法类似于属性。它定义元素实例的类型。 fieldType 的值决定了给定实例中需要下面哪个可选属性。

必需(取决于数据类型)

LENGTH =" n "

此属性定义固定长度的数据类型实例的长度。

n 值必须是正整数。

除非是 xsi:type 值所必需，否则可选。

PREFIX\_LENGTH =" p "

此属性定义二进制数据表示形式的前缀的长度。 PREFIX\_LENGTH 值 p 必须是下列值之一：1、2、4 或 8。

除非是 xsi:type 值所必需，否则可选。

MAX\_LENGTH =" m "

此属性为给定字段中可以存储的最大字节数。 如果没有目标表，列的最大长度就是未知的。 MAX\_LENGTH 属性限定输出字符列的最大长度，从而限制为列值分配的存储空间。 当在 SELECT FROM 子句中使用了 OPENROWSET 函数的 BULK 选项时，使用该属性将带来极大的方便。

m 值必须是正整数。 默认情况下， char 列的最大长度为 8000 个字符， nchar 列的最大长度为 4000 个字符。

可选

COLLATION =" collationName "

COLLATION 仅适用于字符字段。 有关 SQL 排序规则名称的列表，请参阅 SQL Server 排序规则名称 (Transact SQL)。

可选

TERMINATOR =" terminator "

此属性指定数据字段的终止符。 该终止符可以是任意字符。 该字符必须是数据中没有的唯一字符。

默认情况下，该字段的终止符为制表符(用 表示)。 若要表示段落标记，请使用 \\r

。

仅和需要该属性的字符数据 xsi:type 一起使用。

元素的 xsi:type 值

xsi:type 值是标识元素实例的数据类型的 XML 构造(用法同属性)。 本节后面将介绍有关“在数据集中包含 xsi:type 值”的信息。

元素的 xsi:type 值支持下列数据类型。

xsi:type 值

数据类型

的可选 XML 属性

数据类型

的可选 XML 属性

NativeFixed

LENGTH

无。

NativePrefix

PREFIX\_LENGTH

MAX\_LENGTH

CharFixed

LENGTH

COLLATION

NCharFixed

LENGTH

COLLATION

CharPrefix

PREFIX\_LENGTH

MAX\_LENGTH、COLLATION

NCharPrefix

PREFIX\_LENGTH

MAX\_LENGTH、COLLATION

CharTerm

TERMINATOR

MAX\_LENGTH、COLLATION

NCharTerm

TERMINATOR

MAX\_LENGTH、COLLATION

有关 Microsoft SQL Server 数据类型的详细信息，请参阅数据类型 (Transact-SQL)。

元素的属性

本部分介绍 元素的属性，现将其架构语法总结如下：

SOURCE="fieldID"

NAME="columnName"

xsi:type="columnType"

\[ LENGTH="n" \]

\[ PRECISION="n" \]

\[ SCALE="value" \]

\[ NULLABLE=\{ "YES"

"NO" \} \]

使用下列属性将字段映射到目标表中的列：

COLUMN 属性

说明

可选/

必选

SOURCE =" fieldID "

指定映射到列的字段 ID。

映射到

必选

NAME="columnName"

指定格式化文件所表示的行集中的列名。 此列名用于标识结果集中的列，并且该列不需要与目标表中使用的列名相对应。

必选

xsi : type =" ColumnType "

这是一个 XML 构造，用法类似于属性。它定义元素实例的数据类型。 ColumnType 的值决定了给定实例中需要下面哪个可选属性。

注意： 元素的 xsi:type 值部分中的 元素表列出了 ColumnType 的可能值及其相关属性。

可选

LENGTH =" n "

定义固定长度的数据类型实例的长度。 仅当 xsi:type 为字符串数据类型时，才使用 LENGTH。

n 值必须是正整数。

可选(仅当 xsi:type 是字符串数据类型时才可用)

PRECISION =" n "

指示数字的位数。 例如，数 123.45 精度为 5。

该值必须是正整数。

可选(仅在 xsi:type 是变量数字数据类型时才可用)

SCALE =" int "

指示数字中小数点右边的位数。 例如，数字 123.45 的小数位数为 2。

该值必须为整数。

可选(仅在 xsi:type 是变量数字数据类型时才可用)

NULLABLE = \{ " YES "

" NO " \}

指示列是否可以接受 NULL 值。 此属性与 FIELDS 完全无关。 但是，如果列不可为空值，而字段指定为 NULL(未指定任何值)，将产生运行时错误。

NULLABLE 属性仅在您只执行普通 SELECT FROM OPENROWSET(BULK...) 语句时才使用。

可选(任何数据类型均可用)

元素的 xsi:type 值

xsi:type 值是标识元素实例的数据类型的 XML 构造(用法同属性)。 本节后面将介绍有关“在数据集中包含 xsi:type 值”的信息。

元素支持下列本机 SQL 数据类型：

类型类别

数据类型

的可选 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

字符 LOB

SQLNTEXT

无。

NULLABLE

二进制字符串

SQLBINARY 和 SQLVARYBIN

无。

NULLABLE、LENGTH

字符串

SQLCHAR、 SQLVARYCHAR、 SQLNCHAR 和 SQLNVARCHAR

无。

NULLABLE、LENGTH

重要

若要大容量导出或导入 SQLXML 数据，请在格式化文件中使用下列数据类型之一：SQLCHAR 或 SQLVARYCHAR(数据以客户端代码页或排序规则隐含的代码页的形式发送)、SQLNCHAR 或 SQLNVARCHAR(数据以 Unicode 的形式发送)或者 SQLBINARY 或 SQLVARYBIN(数据不经任何转换直接发送)。

有关值数据类型 SQL Server 的详细信息，请参阅 数据类型 (Transact-SQL)。

在某些上下文中可以忽略 元素。 元素是否影响批量导入操作取决于操作的执行方式：

bcp 命令

在目标表加载数据时，bcp 忽略 组件。 相反， bcp 根据目标表的列类型来加载数据。

Transact-SQL 语句(BULK INSERT 和 OPENROWSET 的大容量行集访问接口)

在将数据批量导入表中时，Transact-SQL 语句使用 组件来生成输入行集。 此外，Transact-SQL 语句还将根据 下指定的列类型和目标表中的对应列，进行适当的类型转换。 如果格式化文件和目标表中指定的列类型之间存在不匹配，还将进行额外的类型转换。 与 bcp 相比，此额外的类型转换可能引起 BULK INSERT 或 OPENROWSET 的 BULK 行集提供程序中的行为出现某些差异(即损失精度)。

无需任何其他信息，仅利用 元素中的信息即可构造行。 因此，可以使用 SELECT 语句 (SELECT \* FROM OPENROWSET(BULK datafile FORMATFILE=xmlformatfile) 来生成行集。

备注

OPENROWSET BULK 子句需要格式化文件(请注意，将字段的数据类型转换为列的数据类型只能使用 XML 格式化文件进行)。

为了将数据批量导入表中，格式化文件中的 元素将数据文件字段映射到表列，方法是指定：

行中每个字段在数据文件中的位置。

列类型，用于将字段数据类型转换为所需的列数据类型。

如果没有列映射到某个字段，该字段将不会被复制到生成的行。 此行为使得数据文件能够在不同的表中生成含有不同列的行。

同样，为了将数据从表中批量导出，格式化文件中的各个 将输入表行的列映射到输出数据文件中与之对应的字段。

当通过 XML 架构定义 (XSD) 语言验证 XML 文档时，xsi:type 值不放入数据集。 但是，通过将 XML 格式化文件加载到 XML 文档(如 )中，可以将 xsi:type 信息放入数据集。如下列代码段所示：

本节包含在各种情况下使用 XML 格式化文件的信息，并提供了一个 Adventure Works 示例。

备注

在下列示例所示的数据文件中， 表示数据文件中的一个制表符， 表示一个回车符。

这些示例说明了使用 XML 格式化文件的各个主要方面，如下所述：

对字符数据字段和表列进行相同的排序

对数据字段和表列进行不同的排序

省略数据字段

将各种类型的字段映射到列

将 XML 数据映射到表

导入固定长度或固定宽度的字段

其他示例

备注

有关创建格式化文件的信息，请参阅 创建格式化文件 (SQL Server)。

下面的示例显示了一个 XML 格式化文件，该文件描述一个包含三个字符数据字段的数据文件。 格式化文件将数据文件映射到包含三列的表中。 数据字段与表中的列一一对应。

表(行)： Person (Age int, FirstName varchar(20), LastName varchar(30))

数据文件(记录)： Age Firstname Lastname

以下 XML 格式化文件从数据文件读取数据到表中。

在 元素中，格式化文件将所有三个字段中的数据值表示为字符数据。 对于每个字段， 属性指示位于数据值后面的终止符。

数据字段与表中的列一一对应。 在 元素中，格式化文件将 列映射到第一个字段，将 列映射到第二个字段，将 列映射到第三个字段。

备注

有关等效的 AdventureWorks2012 示例，请参阅 创建格式化文件 (SQL Server)。

下面的示例显示了一个 XML 格式化文件，该文件描述一个包含三个字符数据字段的数据文件。 格式化文件将数据文件映射到包含三列(与数据文件的字段排序方式不同)的表中。

表(行)： Person (Age int, FirstName varchar(20), LastName varchar(30))

数据文件(记录)：Age Lastname Firstname

在 元素中，格式化文件将所有三个字段中的数据值表示为字符数据。

在 元素中，格式化文件将 列映射到第一个字段，将 列映射到第三个字段，将 列映射到第二个字段。

备注

有关等效的 AdventureWorks2012 示例，请参阅 使用格式化文件将表列映射到数据文件字段 (SQL Server)。

下面的示例显示了一个 XML 格式化文件，该文件描述一个包含四个字符数据字段的数据文件。 格式化文件将数据文件映射到包含三列的表中。 第二个数据字段不与任何表列对应。

表(行)： Person (Age int, FirstName Varchar(20), LastName Varchar(30))

数据文件(记录)： Age employeeID Firstname Lastname

在 元素中，格式化文件将所有四个字段中的数据值表示为字符数据。 对于每个字段，TERMINATOR 属性指示位于数据值后面的终止符。

在 元素中，格式化文件将 列映射到第一个字段，将 列映射到第三个字段，将 列映射到第四个字段。

备注

有关等效的 AdventureWorks2012 示例，请参阅 使用格式化文件跳过数据字段 (SQL Server)。

下面的示例显示了各种类型的字段及其与列的映射。

下面的示例创建了一个空的两列表 ()，表中的第一列映射到 数据类型，第二列映射到 数据类型。

以下 XML 格式化文件将数据文件加载到表 中。

下面的示例分别介绍包含 个或 个字符的固定字段。 格式化文件将这些字段的长度/宽度分别表示为 和 。 数据文件中的每行都以回车符-换行符组合 \{CR\}\{LF\} 结束，格式化文件将这表示为 。

有关非 XML 格式化文件和 XML 格式化文件的其他示例，请参阅下列主题：

使用格式化文件跳过表列 (SQL Server)

使用格式化文件跳过数据字段 (SQL Server)

使用格式化文件将表列映射到数据文件字段 (SQL Server)

创建格式化文件 (SQL Server)

使用格式化文件批量导入数据 (SQL Server)

使用格式化文件跳过表列 (SQL Server)

使用格式化文件跳过数据字段 (SQL Server)

使用格式化文件将表列映射到数据文件字段 (SQL Server)

无。

批量导入和导出数据 (SQL Server)

数据类型 (Transact-SQL)

非 XML 格式化文件 (SQL Server)

用来导入或导出数据的格式化文件 (SQL Server)

还有其他反馈吗？

反馈将发送到 Microsoft：按“提交”按钮，你的反馈将用于改进 Microsoft 产品和服务。 隐私策略。

谢谢。

旧版文档

博客

参与

隐私和 Cookie

使用条款

商标

? Microsoft 2021

[f0e0e6aeb62d71a961756e5447e11fd4.jpeg]: https://img-blog.csdnimg.cn/img_convert/f0e0e6aeb62d71a961756e5447e11fd4.jpeg
[12bbf661f5921057dcb2abf90e4b834c.png]: https://img-blog.csdnimg.cn/img_convert/12bbf661f5921057dcb2abf90e4b834c.png
[OpenLocalizationService.png_size_32]: https://github.com/OpenLocalizationService.png?size=32
[Saisang.png_size_32]: https://github.com/Saisang.png?size=32
[cd87ca40cd14c7781f68cd1408b9d6bc.png]: https://img-blog.csdnimg.cn/img_convert/cd87ca40cd14c7781f68cd1408b9d6bc.png
[24eafc6842dff7e7cc27547d427d2850.png]: https://img-blog.csdnimg.cn/img_convert/24eafc6842dff7e7cc27547d427d2850.png
[48dc77c806126b556bb9c0c933cb64d2.png]: https://img-blog.csdnimg.cn/img_convert/48dc77c806126b556bb9c0c933cb64d2.png
[17211457eeb8b18bcb9d4512775dda7b.png]: https://img-blog.csdnimg.cn/img_convert/17211457eeb8b18bcb9d4512775dda7b.png
[a58c192438cb8f81815755317c55bac1.png]: https://img-blog.csdnimg.cn/img_convert/a58c192438cb8f81815755317c55bac1.png