适用于:是SQL Server是Azure SQL 数据库否Azure SQL 数据仓库否并行数据仓库 XML 大容量加载处理 XML 输入数据并为 Microsoft SQL Server 中的相应表准备记录。 XML 大容量加载中的逻辑确定何时生成新记录、要将哪些子元素或属性值复制到记录的字段以及何时完成记录并可以发送到 SQL Server 以便插入。
XML 大容量加载不将整个 XML 输入数据加载到内存中,在将数据发送到 SQL Server 之前不生成完整的记录集。 这是因为 XML 输入数据可能是大文档,将整个文档加载到内存代价过大。 XML 大容量加载改为执行以下操作:
-
分析映射架构并准备必要的执行计划。
-
将执行计划应用到输入流中的数据。
这种顺序处理使得按特定方式提供 XML 输入数据很重要。 您必须了解 XML 大容量加载是如何分析映射架构以及是如何生成记录的, 这样才能为 XML 大容量加载提供映射架构以生成您所要的结果。
XML 大容量加载处理常见映射架构批注,包括列和表映射(通过使用批注显式指定或通过默认映射隐式指定)以及联接关系。
Note:
此处假定您熟悉带批注的 XSD 或 XDR 映射架构。 有关架构的详细信息,请参阅带批注的 XSD 架构简介(SQLXML 4.0) 或带批注的 XDR 架构(SQLXML 4.0 中不推荐使用)。
了解记录生成需要了解以下概念:
-
节点作用域
-
记录生成规则
-
记录子集和键排序规则
-
记录生成规则的例外情况
节点作用域
XML 文档中的节点 (元素或属性) 进入纳入范围XML 大容量加载在遇到时它在 XML 输入的数据流中。 对于元素节点,元素的开始标记使该元素进入作用域。 对于属性节点,属性名称使该属性进入作用域。
当在结束标记(对于元素节点)或属性值结尾(对于属性节点)没有更多数据用于节点时,则表示节点离开作用域。
记录生成规则
节点(元素或属性)进入作用域时,可能从该节点生成记录。 只要相关的节点在作用域中,该记录就存在。 当节点离开作用域时,XML 大容量加载认为生成的记录已完成(带数据)并将它发送到 SQL Server 以便进行插入。
例如,考虑下面的 XSD 架构片段:
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="Customer" sql:relation="Customers" >
<xsd:complexType>
<xsd:attribute name="CustomerID" type="xsd:string" />
<xsd:attribute name="CompanyName" type="xsd:string" />
</xsd:complexType>
</xsd:element>
</xsd:schema>
该架构指定**<客户 >** 具有元素CustomerID并CompanyName属性。 Sql: relation批注映射**<客户 >** 到 Customers 表的元素。
考虑 XML 文档的以下片段:
<Customer CustomerID="1" CompanyName="xyz" />
<Customer CustomerID="2" CompanyName="abc" />
...
将前文中所述的架构提供给 XML 大容量加载并使用 XML 数据作为输入,XML 大容量加载按以下方式处理源数据中的节点(元素和属性):
-
第一个开始标记**<客户 >** 元素使该元素进入作用域。 将此节点映射到 Customers 表。 因此,XML 大容量加载为 Customers 表生成一个记录。
-
在架构中的所有属性, <客户 > 元素映射到 Customers 表的列。 这些属性进入作用域时,XML 大容量加载将它们的值复制到父作用域已生成的客户记录。
-
当 XML 大容量加载到达的结束标记**<客户 >** 元素,该元素离开作用域。 这将导致 XML 大容量加载认为该记录已完成并将其发送到 SQL Server。
XML 大容量加载执行此过程为每个后续**<客户 >** 元素。
Important:
在此模型中,由于是在到达结束标记(或节点离开作用域)时插入记录,因此必须定义节点作用域内与该记录相关的所有数据。
记录子集和键排序规则
指定使用的映射架构时 <sql: relationship >,子集一词表示关系的外侧生成的记录集。 在以下示例中,CustOrder 记录是针对外键 <sql: relationship >。
例如,假定一个数据库包含以下各表:
-
Cust (CustomerID, CompanyName, City)
-
CustOrder (CustomerID, OrderID)
CustOrder 表中的 CustomerID 是外键,它引用 Cust 表中的 CustomerID 主键。
现在,请考虑在以下带批注的 XSD 架构中指定的 XML 视图。 此架构使用 <sql: relationship > 指定 Cust 和 CustOrder 表之间的关系。
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:annotation>
<xsd:appinfo>
<sql:relationship name="CustCustOrder"
parent="Cust"
parent-key="CustomerID"
child="CustOrder"
child-key="CustomerID" />
</xsd:appinfo>
</xsd:annotation>
<xsd:element name="Customers" sql:relation="Cust" >
<xsd:complexType>
<xsd:sequence>
<xsd:element name="CustomerID" type="xsd:integer" />
<xsd:element name="CompanyName" type="xsd:string" />
<xsd:element name="City" type="xsd:string" />
<xsd:element name="Order"
sql:relation="CustOrder"
sql:relationship="CustCustOrder" >
<xsd:complexType>
<xsd:attribute name="OrderID" type="xsd:integer" />
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
下面给出了示例 XML 数据和创建工作示例的步骤。
-
当**<客户 >** XML 数据文件中的元素节点进入作用域,则 XML 大容量加载将生成 Cust 表的记录。 然后,XML 大容量加载将必要的列值 (CustomerID、 CompanyName 和 City) 复制从 <CustomerID >, <公司名称 >,和**<城市 >** 与这些元素的子元素进入作用域。
-
当**<顺序 >** 元素节点进入作用域,则 XML 大容量加载将生成 CustOrder 表的记录。 XML 大容量加载将复制的值OrderID属性为此记录。 从获取客户 id 列所需的值 <CustomerID > 的子元素**<客户 >** 元素。 XML 大容量加载使用中指定的信息 <sql: relationship > 若要获取此记录的 CustomerID 外密钥值,除非CustomerID属性是中指定**<顺序 >** 元素。 一般规则是如果子元素显式指定外键属性的值,XML 大容量加载使用该值并不会获取值从父元素使用指定的 <sql: relationship >. 与此**<顺序 >** 元素节点离开作用域中,XML 大容量加载将记录发送到SQL Server然后再处理所有后续**<顺序 >** 元素节点相同的方式。
-
最后, <客户 > 元素节点离开作用域。 此时,XML 大容量加载将客户记录发送到 SQL Server。 XML 大容量加载为 XML 数据流中的所有后续客户执行此过程。
以下是有关映射架构的两点结论:
-
当架构满足"包容"规则 (例如,与客户和订单相关联的所有数据在关联的范围内都定义**<客户 >** 和 <顺序 > 元素节点),大容量加载成功。
-
在描述**<客户 >** 元素,以适当顺序指定了元素及其子项目。 在这种情况下, <CustomerID > 子元素指定之前**<顺序 >** 子元素。 这意味着,在输入 XML 数据文件中, <CustomerID > 元素的值是可用作外键时值**<顺序 >** 元素进入作用域。 首先指定键属性,此即“键排序规则”。
如果指定 <CustomerID > 子元素的后面**<顺序 >** 子元素,值不可用 <顺序 > 元素进入作用域。 当 </o > 然后读取结束标记、 CustOrder 表的记录视为完成并使用 NULL 值作为 CustomerID 列,这不是所需的结果在 CustOrder 表中插入。
创建工作示例
-
将在该示例中提供的架构另存为 SampleSchema.xml。
-
创建这些表:
CREATE TABLE Cust ( CustomerID int PRIMARY KEY, CompanyName varchar(20) NOT NULL, City varchar(20) DEFAULT 'Seattle') GO CREATE TABLE CustOrder ( OrderID int PRIMARY KEY, CustomerID int FOREIGN KEY REFERENCES Cust(CustomerID)) GO -
将以下示例 XML 输入数据另存为 SampleXMLData.xml:
<ROOT> <Customers> <CustomerID>1111</CustomerID> <CompanyName>Hanari Carnes</CompanyName> <City>NY</City> <Order OrderID="1" /> <Order OrderID="2" /> </Customers> <Customers> <CustomerID>1112</CustomerID> <CompanyName>Toms Spezialitten</CompanyName> <City>LA</City> <Order OrderID="3" /> </Customers> <Customers> <CustomerID>1113</CustomerID> <CompanyName>Victuailles en stock</CompanyName> <Order OrderID="4" /> </Customers> </ROOT> -
若要执行 XML 大容量加载,请保存并执行以下 Microsoft Visual Basic Scripting Edition (VBScript) 示例 (BulkLoad.vbs):
set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0") objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI" objBL.ErrorLogFile = "c:\error.log" objBL.CheckConstraints = True objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml" set objBL=Nothing
记录生成规则的例外情况
如果节点属于 IDREF 或 IDREFS 类型,则在它进入作用域时,XML 大容量加载不为该节点生成记录。 您必须确保在架构的同一位置存在记录的完整描述。 Dt: type ="nmtokens" 批注将被忽略,就像忽略 IDREFS 类型。
例如,考虑下面的 XSD 架构描述**<客户 >** 并**<顺序 >** 元素。 <客户 > 元素包含OrderList IDREFS 类型的属性。 <Sql: relationship > 标记指定的客户和订单列表之间的一个对多关系。
以下是架构:
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:annotation>
<xsd:appinfo>
<sql:relationship name="CustCustOrder"
parent="Cust"
parent-key="CustomerID"
child="CustOrder"
child-key="CustomerID" />
</xsd:appinfo>
</xsd:annotation>
<xsd:element name="Customers" sql:relation="Cust" >
<xsd:complexType>
<xsd:attribute name="CustomerID" type="xsd:integer" />
<xsd:attribute name="CompanyName" type="xsd:string" />
<xsd:attribute name="City" type="xsd:string" />
<xsd:attribute name="OrderList"
type="xsd:IDREFS"
sql:relation="CustOrder"
sql:field="OrderID"
sql:relationship="CustCustOrder" >
</xsd:attribute>
</xsd:complexType>
</xsd:element>
<xsd:element name="Order" sql:relation="CustOrder" >
<xsd:complexType>
<xsd:attribute name="OrderID" type="xsd:string" />
<xsd:attribute name="CustomerID" type="xsd:integer" />
<xsd:attribute name="OrderDate" type="xsd:date" />
</xsd:complexType>
</xsd:element>
</xsd:schema>
因为大容量加载忽略 IDREFS 类型的节点,则不生成记录时OrderList属性节点进入作用域。 如果要将订单记录添加到 Orders 表,必须在架构中的某个地方描述这些订单。 在此架构中,指定**<顺序 >** 元素可确保 XML 大容量加载将订单记录添加到订单表。 <顺序 > 元素描述填充 CustOrder 表的记录所需的所有属性。
您必须确保CustomerID并OrderID中的值**<客户 >** 元素中的值匹配 <顺序 > 元素。 由您负责维护引用完整性。
测试工作示例
-
创建这些表:
CREATE TABLE Cust ( CustomerID int PRIMARY KEY, CompanyName varchar(20) NOT NULL, City varchar(20) DEFAULT 'Seattle') GO CREATE TABLE CustOrder ( OrderID varchar(10) PRIMARY KEY, CustomerID int FOREIGN KEY REFERENCES Cust(CustomerID), OrderDate datetime DEFAULT '2000-01-01') GO -
将在该示例中提供的映射架构另存为 SampleSchema.xml。
-
将以下示例 XML 数据另存为 SampleXMLData.xml:
<ROOT> <Customers CustomerID="1111" CompanyName="Sean Chai" City="NY" OrderList="Ord1 Ord2" /> <Customers CustomerID="1112" CompanyName="Dont Know" City="LA" OrderList="Ord3 Ord4" /> <Order OrderID="Ord1" CustomerID="1111" OrderDate="1999-01-01" /> <Order OrderID="Ord2" CustomerID="1111" OrderDate="1999-02-01" /> <Order OrderID="Ord3" CustomerID="1112" OrderDate="1999-03-01" /> <Order OrderID="Ord4" CustomerID="1112" OrderDate="1999-04-01" /> </ROOT> -
若要执行 XML 大容量加载,请保存并执行此 VBScript 示例 (SampleVB.vbs):
set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0") objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI" objBL.ErrorLogFile = "c:\error.log" objBL.CheckConstraints=True objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml" set objBL=Nothing
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 douglaslMS)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
