通过

  • 项目

使用 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>

创建该架构的工作示例

  1. 复制上面的架构代码，并将它粘贴到文本文件中。将文件另存为 KeyFields1.xml。

  2. 复制以下模板，并将它粘贴到文本文件中。在保存 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 &lt; 3]
    </sql:xpath-query>
</ROOT>

    为映射架构 (KeyFields1.xml) 指定的目录路径是相对于模板保存目录的相对路径。也可以指定绝对路径，例如：

    mapping-schema="C:\MyDir\KeyFields1.xml"

  3. 创建并使用 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>

创建该架构的工作示例

  1. 复制上面的架构代码，并将它粘贴到文本文件中。将文件另存为 KeyFields2.xml。

  2. 复制以下模板，并将它粘贴到文本文件中。在保存 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"

  3. 创建并使用 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>