發行項
09/24/2010

使用 sql:max-depth 來指定遞迴關聯性的深度

在關聯式資料庫中，當某份資料表與本身具有關聯性時，它就稱為遞迴關聯性。例如，在監督者-被監督者的關聯性中，儲存員工記錄的資料表會與本身具有關聯。在此情況下，員工資料表在關聯性的一端扮演監督者的角色，而同一份資料表在另一端則扮演被監督者的角色。

對應結構描述可能包含遞迴關聯性，其中某個元素及其上階屬於相同的類型。

範例 A

請考慮下列資料表：

Emp (EmployeeID, FirstName, LastName, ReportsTo)

在這份資料表中，ReportsTo 資料行會儲存經理的員工識別碼。

假設您想要產生一種員工的 XML 階層，其中經理員工位於階層頂端，而且向經理報告的員工顯示在對應的階層中，如下列範例 XML 片段所示。這個片段顯示的內容就是員工 1 的「遞迴樹狀結構」(Recursive Tree)。

<?xml version="1.0" encoding="utf-8" ?> 
<root>
  <Emp FirstName="Nancy" EmployeeID="1" LastName="Devolio">
     <Emp FirstName="Andrew" EmployeeID="2" LastName="Fuller" /> 
     <Emp FirstName="Janet" EmployeeID="3" LastName="Leverling">
        <Emp FirstName="Margaret" EmployeeID="4" LastName="Peacock">
          <Emp FirstName="Steven" EmployeeID="5" LastName="Devolio">
...
...
</root>

在這個片段中，員工 5 會向員工 4 報告、員工 4 會向員工 3 報告，而員工 3 和 2 會向員工 1 報告。

若要產生這種結果，您可以使用下列 XSD 結構描述並針對它指定 XPath 查詢。此結構描述會描述屬於 EmployeeType 類型的 <Emp> 元素，其中包含屬於相同 EmployeeType 類型的 <Emp> 子元素。這就是遞迴關聯性 (元素及其上階屬於相同的類型)。此外，這個結構描述會使用 <sql:relationship> 來描述監督者與被監督者之間的父子式關聯性。請注意，在這個 <sql:relationship> 中，Emp 同時身為父資料表和子資料表。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:dt="urn:schemas-microsoft-com:datatypes"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:annotation>
    <xsd:appinfo>
      <sql:relationship name="SupervisorSupervisee"
                                  parent="Emp"
                                  parent-key="EmployeeID"
                                  child="Emp"
                                  child-key="ReportsTo" />
    </xsd:appinfo>
  </xsd:annotation>
  <xsd:element name="Emp" type="EmployeeType" 
                          sql:relation="Emp" 
                          sql:key-fields="EmployeeID" 
                          sql:limit-field="ReportsTo" />
  <xsd:complexType name="EmployeeType">
    <xsd:sequence>
      <xsd:element name="Emp" type="EmployeeType" 
                              sql:relation="Emp" 
                              sql:key-fields="EmployeeID"
                              sql:relationship="SupervisorSupervisee"
                              sql:max-depth="6" />
    </xsd:sequence> 
    <xsd:attribute name="EmployeeID" type="xsd:ID" />
    <xsd:attribute name="FirstName" type="xsd:string"/>
    <xsd:attribute name="LastName" type="xsd:string"/>
  </xsd:complexType>
</xsd:schema>

由於此關聯性是遞迴的，所以您需要某種方式來指定結構描述中的遞迴深度。否則，結果將是無止盡的遞迴 (員工向員工報告，依此類推)。sql:max-depth 註解可讓您指定遞迴的深度。在這個範例中，若要指定 sql:max-depth 的值，您必須知道公司中管理階層的深度。

[!附註]

此結構描述會指定 sql:limit-field 註解，但是不會指定 sql:limit-value 註解。這會將產生之階層中的最上層節點限制為不向任何人報告的員工 (ReportsTo 為 NULL)。指定 sql:limit-field 而不指定 sql:limit-value (預設為 NULL) 註解即可完成此目標。如果您想讓產生的 XML 包含每個可能的報告樹狀結構 (資料表中每位員工的報告樹狀結構)，請從結構描述中移除 sql:limit-field 註解。

[!附註]

下列程序會使用 tempdb 資料庫。

若要針對結構描述測試範例 XPath 查詢

在虛擬根目錄指向的 tempdb 資料庫中建立名為 Emp 的範例資料表。

USE tempdb
CREATE TABLE Emp (
       EmployeeID int primary key, 
       FirstName  varchar(20), 
       LastName   varchar(20), 
       ReportsTo int)

加入這個範例資料：

INSERT INTO Emp values (1, 'Nancy', 'Devolio',NULL)
INSERT INTO Emp values (2, 'Andrew', 'Fuller',1)
INSERT INTO Emp values (3, 'Janet', 'Leverling',1)
INSERT INTO Emp values (4, 'Margaret', 'Peacock',3)
INSERT INTO Emp values (5, 'Steven', 'Devolio',4)
INSERT INTO Emp values (6, 'Nancy', 'Buchanan',5)
INSERT INTO Emp values (7, 'Michael', 'Suyama',6)

複製上述的結構描述程式碼，並將其貼到文字檔中。將檔案儲存為 maxDepth.xml。
複製下列範本，並將其貼到文字檔中。將檔案儲存為 maxDepthT.xml，並放在與儲存 maxDepth.xml 相同的目錄中。此範本中的查詢會傳回 Emp 資料表中的所有員工。
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:xpath-query mapping-schema="maxDepth.xml">
    /Emp
  </sql:xpath-query>
</ROOT>
```
針對對應結構描述 (maxDepth.xml) 指定的目錄路徑，相對於儲存範本的目錄。您也可以指定絕對路徑，例如：
```
mapping-schema="C:\MyDir\maxDepth.xml"
```
建立及使用 SQLXML 4.0 測試指令碼 (Sqlxml4test.vbs) 來執行範本。如需詳細資訊，請參閱＜使用 ADO 執行 SQLXML 4.0 查詢＞。

結果如下：

<?xml version="1.0" encoding="utf-8" ?> 
<root>
  <Emp FirstName="Nancy" EmployeeID="1" LastName="Devolio">
  <Emp FirstName="Andrew" EmployeeID="2" LastName="Fuller" /> 
    <Emp FirstName="Janet" EmployeeID="3" LastName="Leverling">
      <Emp FirstName="Margaret" EmployeeID="4" LastName="Peacock">
        <Emp FirstName="Steven" EmployeeID="5" LastName="Devolio">
          <Emp FirstName="Nancy" EmployeeID="6" LastName="Buchanan">
            <Emp FirstName="Michael" EmployeeID="7" LastName="Suyama" /> 
          </Emp>
        </Emp>
      </Emp>
    </Emp>
  </Emp>
</root>

[!附註]

若要在結果中產生不同的階層深度，請在結構描述中變更 sql:max-depth 註解的值，然後在每次變更之後再次執行此範本。

在先前的結構描述中，所有 <Emp> 元素都具有完全相同的屬性集 (EmployeeID、FirstName 和 LastName)。下列結構描述已經稍微修改過，可針對向經理報告的所有 <Emp> 元素傳回額外的 ReportsTo 屬性。

例如，這個 XML 片段會顯示員工 1 的部屬：

<?xml version="1.0" encoding="utf-8" ?> 
<root>
<Emp FirstName="Nancy" EmployeeID="1" LastName="Devolio">
  <Emp FirstName="Andrew" EmployeeID="2" 
       ReportsTo="1" LastName="Fuller" /> 
  <Emp FirstName="Janet" EmployeeID="3" 
       ReportsTo="1" LastName="Leverling">
...
...

這是已修訂的結構描述：

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:dt="urn:schemas-microsoft-com:datatypes"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:annotation>
    <xsd:documentation>
      Customer-Order-Order Details Schema
      Copyright 2000 Microsoft. All rights reserved.
    </xsd:documentation>
    <xsd:appinfo>
      <sql:relationship name="SupervisorSupervisee" 
                  parent="Emp"
                  parent-key="EmployeeID"
                  child="Emp"
                  child-key="ReportsTo" />
    </xsd:appinfo>
  </xsd:annotation>
  <xsd:element name="Emp" 
                   type="EmpType" 
                   sql:relation="Emp" 
                   sql:key-fields="EmployeeID" 
                   sql:limit-field="ReportsTo" />
  <xsd:complexType name="EmpType">
    <xsd:sequence>
       <xsd:element name="Emp" 
                    type="EmpType" 
                    sql:relation="Emp" 
                    sql:key-fields="EmployeeID"
                    sql:relationship="SupervisorSupervisee"
                    sql:max-depth="6"/>
    </xsd:sequence> 
    <xsd:attribute name="EmployeeID" type="xsd:int" />
    <xsd:attribute name="FirstName" type="xsd:string"/>
    <xsd:attribute name="LastName" type="xsd:string"/>
    <xsd:attribute name="ReportsTo" type="xsd:int" />
  </xsd:complexType>
</xsd:schema>

sql:max-depth 註解

在包含遞迴關聯性的結構描述中，遞迴的深度必須明確指定於結構描述中。這是成功產生可傳回要求結果之對應 FOR XML EXPLICIT 查詢的必要條件。

您可以在結構描述中使用 sql:max-depth 註解，以便指定結構描述所描述之遞迴關聯性的遞迴深度。sql:max-depth 註解的值是正整數 (1 到 50)，表示遞迴的數目：值為 1 會在指定 sql:max-depth 註解的元素處停止遞迴，值為 2 會在指定 sql:max-depth 之元素的下一個階層處停止遞迴，依此類推。

[!附註]

在基礎實作中，針對對應結構描述所指定的 XPath 查詢會轉換成 SELECT ... FOR XML EXPLICIT 查詢。這個查詢會要求您指定有限的遞迴深度。您針對 sql:max-depth 指定的值越高，產生的 FOR XML EXPLICIT 查詢就越大。這可能會降低擷取速度。

[!附註]

Updategram 和 XML 大量載入會忽略 max-depth 註解。這表示，不論您針對 max-depth 指定的值為何，都會進行遞迴更新或插入。

在複雜元素上指定 sql:max-depth

您可以在任何複雜內容元素上指定 sql:max-depth 註解。

遞迴元素

如果您同時在遞迴關聯性中的父元素和子元素上指定了 sql:max-depth，就會優先使用在父系上指定的 sql:max-depth 註解。例如，在下列結構描述中，同時在父和子員工元素上指定了 sql:max-depth 註解。在此情況下，就會優先使用在 <Emp> 父元素 (扮演監督者的角色) 上指定的 sql:max-depth=4。在 <Emp> 子元素 (扮演被監督者的角色) 上指定的 sql:max-depth 則會被忽略。

範例 B

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:dt="urn:schemas-microsoft-com:datatypes"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:annotation>
    <xsd:appinfo>
      <sql:relationship name="SupervisorSupervisee"
                                  parent="Emp"
                                  parent-key="EmployeeID"
                                  child="Emp"
                                  child-key="ReportsTo" />
    </xsd:appinfo>
  </xsd:annotation>
  <xsd:element name="Emp" type="EmployeeType" 
                          sql:relation="Emp" 
                          sql:key-fields="EmployeeID" 
                          sql:limit-field="ReportsTo" 
                          sql:max-depth="3" />
  <xsd:complexType name="EmployeeType">
    <xsd:sequence>
      <xsd:element name="Emp" type="EmployeeType" 
                              sql:relation="Emp" 
                              sql:key-fields="EmployeeID"
                              sql:relationship="SupervisorSupervisee"
                              sql:max-depth="2" />
    </xsd:sequence> 
    <xsd:attribute name="EmployeeID" type="xsd:ID" />
    <xsd:attribute name="FirstName" type="xsd:string"/>
    <xsd:attribute name="LastName" type="xsd:string"/>
  </xsd:complexType>
</xsd:schema>

若要測試這個結構描述，請遵循本主題前面針對「範例 A」所提供的步驟。

非遞迴元素

如果您在結構描述中不會導致任何遞迴的元素上指定了 sql:max-depth 註解，系統就會忽略此註解。在下列結構描述中，<Emp> 元素是由 <Constant> 子元素所組成，而後者又具有 <Emp> 子元素。

在這個結構描述中，系統會忽略在 <Constant> 元素上指定的 sql:max-depth 註解，因為 <Emp> 父元素與 <Constant> 子元素之間沒有任何遞迴。但是，<Emp> 上階與 <Emp> 子系之間存在遞迴。此結構描述會同時在這兩個項目上指定 sql:max-depth 註解。因此，就會優先使用在上階 (監督者角色中的 <Emp>) 上指定的 sql:max-depth 註解。

範例 C

<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="SupervisorSupervisee" 
                  parent="Emp" 
                  child="Emp" 
                  parent-key="EmployeeID" 
                  child-key="ReportsTo"/>
    </xsd:appinfo>
  </xsd:annotation>
  <xsd:element name="Emp" 
               sql:relation="Emp" 
               type="EmpType"
               sql:limit-field="ReportsTo"
               sql:max-depth="1" />
    <xsd:complexType name="EmpType" >
      <xsd:sequence>
       <xsd:element name="Constant" 
                    sql:is-constant="1" 
                    sql:max-depth="20" >
         <xsd:complexType >
           <xsd:sequence>
            <xsd:element name="Emp" 
                         sql:relation="Emp" type="EmpType"
                         sql:relationship="SupervisorSupervisee" 
                         sql:max-depth="3" />
         </xsd:sequence>
         </xsd:complexType>
         </xsd:element>
      </xsd:sequence>
      <xsd:attribute name="EmployeeID" type="xsd:int" />
    </xsd:complexType>
</xsd:schema>

若要測試這個結構描述，請遵循本主題前面針對「範例 A」所提供的步驟。

限制所衍生的複雜類型

如果您擁有 <restriction> 所衍生的複雜類型，對應之基底複雜類型的元素就無法指定 sql:max-depth 註解。在這些情況下，您可以將 sql:max-depth 註解加入至衍生類型的元素。

另一方面，如果您擁有 <extension> 所衍生的複雜類型，對應之基底複雜類型的元素就可以指定 sql:max-depth 註解。

例如，下列 XSD 結構描述會產生錯誤，因為在基底類型上指定了 sql:max-depth 註解。由 <restriction> 從其他類型所衍生的類型不支援這個註解。若要修正這個問題，您必須變更此結構描述並且在衍生類型的元素上指定 sql:max-depth 註解。

範例 D

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:dt="urn:schemas-microsoft-com:datatypes"
            xmlns:msdata="urn:schemas-microsoft-com:mapping-schema">
  <xsd:complexType name="CustomerBaseType"> 
    <xsd:sequence>
       <xsd:element name="CID" msdata:field="CustomerID" />
       <xsd:element name="CompanyName"/>
       <xsd:element name="Customers" msdata:max-depth="3">
         <xsd:annotation>
           <xsd:appinfo>
             <msdata:relationship
                     parent="Customers"
                     parent-key="CustomerID"
                     child-key="CustomerID"
                     child="Customers" />
           </xsd:appinfo>
         </xsd:annotation>
       </xsd:element>
    </xsd:sequence>
  </xsd:complexType>
  <xsd:element name="Customers" type="CustomerType"/>
  <xsd:complexType name="CustomerType">
    <xsd:complexContent>
       <xsd:restriction base="CustomerBaseType">
          <xsd:sequence>
            <xsd:element name="CID" 
                         type="xsd:string"/>
            <xsd:element name="CompanyName" 
                         type="xsd:string"
                         msdata:field="CName" />
            <xsd:element name="Customers" 
                         type="CustomerType" />
          </xsd:sequence>
       </xsd:restriction>
    </xsd:complexContent>
  </xsd:complexType>
</xsd:schema>

在此結構描述中，sql:max-depth 指定於 CustomerBaseType 複雜類型上。此結構描述也會指定 CustomerType 類型 (衍生自 CustomerBaseType) 的 <Customer> 元素。在這類結構描述上指定的 XPath 查詢將會產生錯誤，因為定義於限制基底類型中的元素不支援 sql:max-depth。

具有深度階層的結構描述

您可能會擁有一個包括深度階層的結構描述，其中某個元素包含子元素，而後者又包含其他子元素，依此類推。如果在這類結構描述中指定的 sql:max-depth 註解產生了包含超過 500 個層級之階層的 XML 文件 (最上層元素位於第 1 層，其子系位於第 2 層，依此類推)，系統就會傳回錯誤。

共用方式為