[アーティクル]
09/28/2010

sql:overflow-field (SQLXML 4.0)

スキーマでは、XML ドキュメントからのすべての未使用データを受け取るオーバーフロー列を指定することができます。この列は、スキーマ内で sql:overflow-field 注釈により指定します。オーバーフロー列は複数指定することもできます。

sql:overflow-field 注釈が定義されている XML ノード (要素または属性) がスコープ内に入るとオーバーフロー列がアクティブになり、未使用データがこの列に挿入されます。ノードがスコープ外に出ると、オーバーフロー列はアクティブではなくなります。それまでのオーバーフローフィールドがある場合は、XML 一括読み込みによってそのフィールドがアクティブになります。

XML 一括読み込みでは、オーバーフロー列へのデータの格納時に、sql:overflow-field が定義されている親要素の開始タグと終了タグも格納されます。

たとえば、次のスキーマでは <Customers> および <CustOrder> 要素が記述されており、これらの要素それぞれに、オーバーフロー列が指定されています。

<?xml version="1.0" ?>
<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="ROOT" sql:is-constant="1">
  <xsd:complexType>
    <xsd:sequence> 
      <xsd:element name="Customers" 
                   sql:relation="Cust"
                   sql:overflow-field="OverflowColumn">
        <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"
                          sql:overflow-field="OverflowColumn">
               <xsd:complexType>
                 <xsd:attribute name="OrderID"/>
                 <xsd:attribute name="CustomerID"/>
               </xsd:complexType>
             </xsd:element>
          </xsd:sequence> 
        </xsd:complexType>
      </xsd:element>
    </xsd:sequence>
  </xsd:complexType>
 </xsd:element>
</xsd:schema>

このスキーマでは、<Customer> 要素は Cust テーブルにマップされ、<Order> 要素は CustOrder テーブルにマップされます。

ここでは、<Customer> および <Order> 要素の両方に、オーバーフロー列が指定されています。したがって、XML 一括読み込みでは <Customer> 要素の未使用の子要素と属性がすべて Cust テーブルのオーバーフロー列に格納され、<Order> 要素の未使用の子要素と属性がすべて CustOrder テーブルのオーバーフロー列に格納されます。

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

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

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

CREATE TABLE Cust (
          CustomerID     int         PRIMARY KEY,
          CompanyName    varchar(20) NOT NULL,
          City           varchar(20) DEFAULT 'Seattle',
          OverflowColumn nvarchar(200))
GO
CREATE TABLE CustOrder (
          OrderID        int         PRIMARY KEY,
          CustomerID     int         FOREIGN KEY REFERENCES
                                          Cust(CustomerID),
          OverflowColumn nvarchar(200))
GO

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

<ROOT>
  <Customers>
    <CustomerID>1111</CustomerID>
    <CompanyName>Hanari Carnes</CompanyName>
    <City><![CDATA[NY]]> </City>
      <Junk>garbage in overflow</Junk>
    <Order OrderID="1" />
    <Order OrderID="2" />
 </Customers>
 <Customers>
   <CustomerID>1112</CustomerID>
   <CompanyName>Toms Spezialitten</CompanyName>
   <City><![CDATA[LA]]> </City>
   <xyz><address>111 Maple, Seattle</address></xyz>   
   <Order OrderID="3" />
 </Customers>
   <Customers>
   <CustomerID>1113</CustomerID>
   <CompanyName>Victuailles en stock</CompanyName>
   <Order OrderID="4" />
  </Customers>
</ROOT>

XML 一括読み込みを実行するには、この Microsoft Visual Basic Scripting Edition (VBScript) の例を Sample.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

次の方法で共有

sql:overflow-field (SQLXML 4.0)

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

その他のリソース