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>