使用 sql:key-fields 标识键列 (SQLXML 4.0)
针对 XSD 架构指定 XPath 查询时,大多数情况下必须有键信息才能获得结果中的正确嵌套。指定 sql:key-fields 批注是一种确保生成正确层次结构的方式。
注意 |
---|
若要确保正确的嵌套,建议您为映射到表的元素指定 sql:key-fields。所生成的 XML 对于基础结果集的排序敏感。如果不指定 sql:key-fields,则所生成的 XML 的格式可能不正确。 |
sql:key-fields 的值用于标识唯一标识关系中的行的列。如果需要多个列才能唯一标识某行,则用空格分隔列值。
如果元素包含的 <sql:relationship> 是在元素和子元素之间定义的,但元素没有提供在父元素中指定的表的主键,则必须使用 sql:key-fields 批注。
示例
若要创建使用以下示例的工作示例,必须满足一些要求。有关详细信息,请参阅运行 SQLXML 示例的要求。
A. 当 <sql:relationship> 未提供足够的信息时生成正确的嵌套
该示例显示必须指定 sql:key-fields 的地方。
请考虑以下架构。此架构指定 <Order> 元素与 <Customer> 元素之间的层次结构,在该层次结构中 <Order> 元素是父元素,而 <Customer> 元素是子元素。
<sql:relationship> 标记用于指定父子关系。它将 Sales.SalesOrderHeader 表中的 CustomerID 标识为父键,该父键引用 Sales.Customer 表中的 CustomerID 子键。<sql:relationship> 中提供的信息不足以唯一标识父表 (Sales.SalesOrderHeader) 中的行。因此,如果没有 sql:key-fields 批注,则生成的层次结构不准确。
使用在 <Order> 上指定的 sql:key-fields,此批注唯一地标识父(Sales.SalesOrderHeader 表)中的行,并且其子元素出现在其父元素的下面。
架构如下:
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:annotation>
<xsd:appinfo>
<sql:relationship name="OrdCust"
parent="Sales.SalesOrderHeader"
parent-key="CustomerID"
child="Sales.Customer"
child-key="CustomerID" />
</xsd:appinfo>
</xsd:annotation>
<xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"
sql:key-fields="SalesOrderID">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Customer" sql:relation="Sales.Customer"
sql:relationship="OrdCust" >
<xsd:complexType>
<xsd:attribute name="CustID" sql:field="CustomerID" />
<xsd:attribute name="SoldBy" sql:field="SalesPersonID" />
</xsd:complexType>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="SalesOrderID" type="xsd:integer" />
<xsd:attribute name= "CustomerID" type="xsd:string" />
</xsd:complexType>
</xsd:element>
</xsd:schema>
创建该架构的工作示例
复制上面的架构代码,并将它粘贴到文本文件中。将文件另存为 KeyFields1.xml。
复制以下模板,并将它粘贴到文本文件中。在保存 KeyFields1.xml 的相同目录中将该文件另存为 KeyFields1T.xml。此模板中的 XPath 查询将返回 CustomerID 小于 3 的所有 <Order> 元素。
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> <sql:xpath-query mapping-schema="KeyFields1.xml"> /Order[@CustomerID < 3] </sql:xpath-query> </ROOT>
为映射架构 (KeyFields1.xml) 指定的目录路径是相对于模板保存目录的相对路径。也可以指定绝对路径,例如:
mapping-schema="C:\MyDir\KeyFields1.xml"
创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。
有关详细信息,请参阅使用 ADO 执行 SQLXML 查询。
部分结果集如下:
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<Order SalesOrderID="43860" CustomerID="1">
<Customer CustID="1" SoldBy="280"/>
</Order>
<Order SalesOrderID="44501" CustomerID="1">
<Customer CustID="1" SoldBy="280"/>
</Order>
<Order SalesOrderID="45283" CustomerID="1">
<Customer CustID="1" SoldBy="280"/>
</Order>
.....
</ROOT>
B. 指定 sql:key-fields 以便在结果中生成正确的嵌套
在以下架构中,不存在使用 <sql:relationship> 指定的层次结构。此架构仍然需要指定 sql:key-fields 批注才能唯一标识 HumanResources.Employee 表中的雇员。
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="HumanResources.Employee" sql:key-fields="EmployeeID" >
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Title">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="xsd:string">
<xsd:attribute name="EmployeeID" type="xsd:integer" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
创建该架构的工作示例
复制上面的架构代码,并将它粘贴到文本文件中。将文件另存为 KeyFields2.xml。
复制以下模板,并将它粘贴到文本文件中。在保存 KeyFields2.xml 的相同目录中将该文件另存为 KeyFields2T.xml。此模板中的 XPath 查询将返回所有 <HumanResources.Employee> 元素:
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> <sql:xpath-query mapping-schema="KeyFields2.xml"> /HumanResources.Employee </sql:xpath-query> </ROOT>
为映射架构 (KeyFields2.xml) 指定的目录路径是相对于模板保存目录的相对路径。也可以指定绝对路径,例如:
mapping-schema="C:\MyDir\KeyFields2.xml"
创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。
有关详细信息,请参阅使用 ADO 执行 SQLXML 查询。
结果如下:
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<HumanResources.Employee>
<Title EmployeeID="1">Production Technician - WC60</Title>
</HumanResources.Employee>
<HumanResources.Employee>
<Title EmployeeID="2">Marketing Assistant</Title>
</HumanResources.Employee>
<HumanResources.Employee>
<Title EmployeeID="3">Engineering Manager</Title>
</HumanResources.Employee>
...
</ROOT>