共用方式為


記錄產生處理序 (SQLXML 4.0)

XML 大量載入會處理 XML 輸入資料,並在 Microsoft SQL Server 中為適當的資料表準備記錄。XML 大量載入的邏輯會判斷在何時產生新記錄,要複製哪種子元素或屬性值到記錄欄位中,以及記錄何時會完成並準備傳送到 SQL Server 以供插入之用。

XML 大量載入不會將整個 XML 輸入資料載入到記憶體中,也不會在將資料傳送到 SQL Server 之前產生完整的記錄集。這是因為 XML 輸入資料可以是大型文件,而且將整個文件載入到記憶體中的成本可能會很高。XML 大量載入會改為執行下列動作:

  1. 分析對應結構描述和準備需要的執行計畫。

  2. 將執行計畫套用到輸入資料流中的資料。

這個循序處理對於以特殊方式提供 XML 輸入資料而言很重要。您必須了解 XML 大量載入是如何分析對應結構描述,以及了解記錄產生處理序是如何發生的。有了這樣的了解,您就可以為 XML 大量載入提供會產生您想要結果的對應結構描述。

XML 大量載入會處理一般對應結構描述註解,包括資料行和資料表對應 (藉由使用註解明確指定,或透過預設對應隱含指定),並聯結關聯性。

[!附註]

假設您熟悉註解式 XSD 或 XDR 對應結構描述。如需有關結構描述的詳細資訊,請參閱<註解式 XSD 結構描述簡介 (SQLXML 4.0)>或<註解式 XDR 結構描述 (在 SQLXML 4.0 中已被取代)>。

了解記錄產生之前,需要先了解下列概念:

  • 節點範圍

  • 記錄產生規則

  • 記錄子集和索引鍵排列順序規則

  • 記錄產生規則的例外狀況

節點範圍

當 XML 大量載入在 XML 輸入資料流中遇到在 XML 文件中的節點 (元素或屬性) 時,則該節點會進入「範圍內」。如果是元素節點,元素的開始標記會將元素納入範圍中。如果是屬性節點,屬性名稱會將屬性納入範圍中。

當節點沒有更多資料時,就會離開範圍:可能是在結束標記 (在元素節點的狀況下),或是在屬性值的結尾 (在屬性節點的狀況下)。

記錄產生規則

當節點 (元素或屬性) 進入範圍內時,記錄可能會從該節點產生。只要相關聯的節點在範圍內,記錄就會一直存在。當節點離開範圍時,XML 大量載入會視為產生的記錄是完整的 (具有資料),並將它傳送到 SQL Server 供插入之用。

例如,請考慮下列 XSD 結構描述片段:

<xsd:schema xmlns:xsd="http://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>

結構描述會用 CustomerIDCompanyName 屬性指定 <Customer> 元素。sql:relation 註解會將 <Customer> 元素對應到「客戶」資料表。

請考慮這個 XML 文件的片段:

<Customer CustomerID="1" CompanyName="xyz" />
<Customer CustomerID="2" CompanyName="abc" />
...

當 XML 大量載入是由結構描述提供,而該結構描述在前面段落和 XML 資料中是描述為輸入時,則 XML 大量載入會在來源資料中處理節點 (元素和屬性),如下所示:

  • 第一個 <Customer> 元素的開始標記會將該元素納入範圍內。這個節點會對應到「客戶」資料表。因此,XML 大量載入會產生「客戶」資料表的記錄。

  • 在結構描述中,<Customer> 元素的所有屬性都會對應到「客戶」資料表的資料行。當這些屬性進入範圍內時,XML 大量載入會將屬性值複製到已由父範圍產生的客戶記錄中。

  • 當 XML 大量載入到達 <Customer> 元素的結束標記時,元素就會離開範圍。這會造成 XML 大量載入將記錄視為已完成並將之傳送到 SQL Server。

對於每一個後續的 <Customer> 元素,XML 大量載入都會遵循這個處理序。

重要事項重要事項

在這個模型中,因為在到達結束標記時 (或節點離開範圍時) 會插入記錄,所以您必須定義與在節點範圍內之記錄相關聯的所有資料。

記錄子集和索引鍵排列順序規則

當您指定使用 <sql:relationship> 的對應結構描述時,子集詞彙會參考在關聯性外部端上產生的記錄。在下列範例中,CustOrder 記錄是在外部端 <sql:relationship>。

例如,假設資料庫包含下列資料表:

  • Cust (CustomerID、CompanyName、City)

  • CustOrder (CustomerID、OrderID)

在 CustOrder 資料表中的 CustomerID 是外部索引鍵,會參考在 Cust 資料表中的 CustomerID 主要索引鍵。

現在,請將 XML 檢視視為是在下列註解式 XSD 結構描述中所指定。這個結構描述使用 <sql:relationship> 指定 Cust 和 CustOrder 資料表之間的關聯性。

<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="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 資料檔案中的 <Customer> 元素節點進入範圍內時,XML 大量載入會產生 Cust 資料表的記錄。當 <CustomerID><CompanyName><City> 子元素進入範圍內時,XML 大量載入接著就會從這些元素複製需要的資料行值 (CustomerID、CompanyName 和 City)。

  • <Order> 元素節點進入範圍內時,XML 大量載入會產生 CustOrder 資料表的記錄。XML 大量載入會將 OrderID 屬性值複製到這個記錄。CustomerID 資料行所需要的值是從 <Customer> 元素的 <CustomerID> 子元素取得的。XML 大量載入會使用在 <sql:relationship> 中指定的資訊以取得這個記錄的 CustomerID 外部索引鍵值,除非 CustomerID 屬性是在 <Order> 元素中所指定。一般規則是,如果子元素明確指定外部索引鍵屬性的值,則 XML 大量載入會使用該值,而且不會藉由使用指定的 <sql:relationship> 從父元素取得值。當這個 <Order> 元素節點離開範圍時,XML 大量載入會傳送記錄到 SQL Server,然後以同樣方式處理所有後續 <Order> 元素節點。

  • 最後,<Customer> 元素節點會離開範圍。這時候,XML 大量載入會傳送客戶記錄到 SQL Server。對於 XML 資料流中的所有後續客戶,XML 大量載入都會遵循這個處理序。

以下是有關對應結構描述的兩個觀察:

  • 當結構描述符合「內含項目」規則 (例如,所有與客戶和訂單相關聯的資料定義在相關聯的 <Customer><Order> 元素節點範圍內) 時,則大量載入就會成功。

  • 在描述 <Customer> 元素時,其子元素是以適當的順序指定。在這個狀況下,<CustomerID> 子元素指定在 <Order> 子元素之前。這就表示在輸入 XML 資料檔案中,當 <Order> 元素進入範圍內時,<CustomerID> 元素值可以當成外部索引鍵來使用。根據「關鍵識別碼順序規則」,要先指定索引鍵屬性。

    如果您在 <Order> 子元素後指定 <CustomerID> 子元素,則當 <Order> 元素進入範圍內時,就無法使用這個值。當讀取 </Order> 結尾標記時,CustOrder 資料表的記錄會被視為已完成,而且插入到 CustomerID 資料行為 NULL 值的 CustOrder 資料表中,但是這不是所希望的結果。

建立工作範例

  1. 將這個範例所提供的結構描述儲存為 SampleSchema.xml。

  2. 建立這些資料表:

    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
    
  3. 儲存下列範例 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>
    
  4. 若要執行 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
    

記錄產生規則的例外狀況

當 XML 大量載入進入範圍內時,不會產生節點記錄 (如果該節點是 IDREF 或 IDREFS 類型的話)。 您必須確定完整的記錄描述會出現在結構描述中的某個地方。dt:type="nmtokens" 註解會被忽略,就像 IDREFS 類型也被忽略一樣。

例如,請考慮下列描述 <Customer><Order> 元素的 XSD 結構描述。<Customer> 元素包括 IDREFS 類型的 OrderList 屬性。<sql:relationship> 標記會在客戶和訂單清單之間指定一對多關聯性。

這是結構描述:

<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="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 屬性節點進入範圍內時,不會產生記錄。因此,如果您希望訂單記錄加入「訂單」資料表中,您必須描述那些在結構描述某處的訂單。在這個結構描述中,指定 <Order> 元素會確定 XML 大量載入會將訂單記錄加入到「訂單」資料表中。<Order> 元素會描述填滿 CustOrder 資料表的記錄時所需要的屬性。

您必須確定在 <Customer> 元素中的 CustomerIDOrderID 值與 <Order> 元素中的值是相符的。您必須負責維護參考完整性。

測試工作範例

  1. 建立這些資料表:

    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
    
  2. 將這個範例所提供的對應結構描述儲存為 SampleSchema.xml。

  3. 儲存下列範例 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>
    
  4. 若要執行 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