[アーティクル]
04/01/2012

sql:relationship とキーの順序付け規則 (SQLXML 4.0)

XML 一括読み込みでは、ノードがスコープ内に入るときにレコードが生成され、ノードがスコープ外に出るときに、これらのレコードが Microsoft SQL Server に送信されます。したがって、レコードのデータはノードのスコープ内に存在する必要があります。

例として、次の XSD スキーマでは 1 人の顧客が複数の注文を送信でき、<Customer> 要素と <Order> 要素の間に <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: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>

<Customer> 要素がスコープに入ると、XML 一括読み込みでは顧客レコードが生成されます。このレコードは、XML 一括読み込みで </Customer> が読み込まれるまで残ります。<Order> 要素には CustomerID 属性が指定されていないため、<Order> 要素ノードの処理では、<sql:relationship> に従って、親要素 <Customer> から CustOrder テーブルの CustomerID 外部キー列の値が取得されます。つまり、<Customer> 要素の定義でスキーマ内に CustomerID を指定してから、<sql:relationship> を指定する必要があります。この方法で指定しないと、XML 一括読み込みでは <Order> 要素がスコープに入ったときに CustOrder テーブルにレコードが生成され、</Order> 終了タグに達したときに、CustomerID 外部キー列に値がない状態でレコードが SQL Server に送信されます。

この例のスキーマを SampleSchema.xml として保存します。

実際のサンプルをテストするには

次のテーブルを作成します。

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))
GO

次のサンプルデータを SampleXMLData.xml として保存します。

<ROOT>  
  <Customers>
    <CompanyName>Hanari Carnes</CompanyName>
    <City>NY</City>
    <Order OrderID="1" />
    <Order OrderID="2" />
    <CustomerID>1111</CustomerID>
  </Customers>
  <Customers>
    <CompanyName>Toms Spezialitten</CompanyName>
     <City>LA</City>  
    <Order OrderID="3" />
    <CustomerID>1112</CustomerID>
  </Customers>
  <Customers>
    <CompanyName>Victuailles en stock</CompanyName>
    <Order OrderID="4" />
    <CustomerID>1113</CustomerID>
  </Customers>
</ROOT>

XML 一括読み込みを実行するには、次の Microsoft Visual Basic Scripting Edition (VBScript) の例を MySample.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.Transaction=True
objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml"
set objBL=Nothing
```
この結果、XML 一括読み込みでは CustOrder テーブルの CustomerID 外部キー列に NULL 値が挿入されます。XML サンプルデータを編集し、<CustomerID> 子要素を <Order> 子要素の前に移動すると、XML 一括読み込みでは指定した外部キー値が列に挿入されます。

XDR スキーマの場合は次のようになります。

<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data" 
        xmlns:dt="urn:schemas-microsoft-com:xml:datatypes"  
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" > 
   <ElementType name="CustomerID"  />
   <ElementType name="CompanyName" />
   <ElementType name="City"        />

   <ElementType name="root" sql:is-constant="1">
      <element type="Customers" />
   </ElementType>

   <ElementType name="Customers" sql:relation="Cust" >
      <element type="CustomerID" sql:field="CustomerID" />
      <element type="CompanyName" sql:field="CompanyName" />
      <element type="City" sql:field="City" />
      <element type="Order" >
                 <sql:relationship
                        key-relation    ="Cust"
                        key             ="CustomerID"
                        foreign-key     ="CustomerID"
                        foreign-relation="CustOrder" />
      </element>
   </ElementType>
    <ElementType name="Order" sql:relation="CustOrder" >
      <AttributeType name="OrderID" />
      <AttributeType name="CustomerID" />
      <attribute type="OrderID" />
      <attribute type="CustomerID" />
    </ElementType>
</Schema>

次の方法で共有

sql:relationship とキーの順序付け規則 (SQLXML 4.0)

実際のサンプルをテストするには

その他のリソース