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

XML 一括読み込みの例 (SQLXML 4.0)

以下の例では、Microsoft SQL Server の XML 一括読み込み機能について示します。それぞれの例では、XSD スキーマと、同等の XDR スキーマを提供します。

一括読み込みスクリプト (ValidateAndBulkload.vbs)

次の Microsoft Visual Basic Scripting Edition (VBScript) スクリプトでは、XML ドキュメントが XML DOM に読み込まれてスキーマと照合され、有効であった場合は XML 一括読み込みによって SQL Server テーブルに読み込まれます。このスクリプトは、後に示す個々の例で使用できます。

注意
XML 一括読み込みでは、データファイルから内容がアップロードされなくても警告またはエラーは返されません。このため、一括読み込み操作を実行する前に XML データファイルを検証することをお勧めします。

Dim FileValid

set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0")
objBL.ConnectionString = "provider=SQLOLEDB;data source=MyServer;database=tempdb;integrated security=SSPI"
objBL.ErrorLogFile = "c:\error.log"

'Validate the data file prior to bulkload
Dim sOutput 
sOutput = ValidateFile("SampleXMLData.xml", "", "SampleSchema.xml")
WScript.Echo sOutput

If FileValid Then
   ' Check constraints and initiate transaction (if needed)
   ' objBL.CheckConstraints = True
   ' objBL.Transaction=True
  'Execute XML bulkload using file.
  objBL.Execute "SampleSchema.xml", "SampleXMLData.xml"
  set objBL=Nothing
End If

Function ValidateFile(strXmlFile,strUrn,strXsdFile)
    
   ' Create a schema cache and add SampleSchema.xml to it.
   Dim xs, fso, sAppPath
   Set fso = CreateObject("Scripting.FileSystemObject") 
   Set xs = CreateObject("MSXML2.XMLSchemaCache.6.0")
   sAppPath = fso.GetFolder(".") 
   xs.Add strUrn, sAppPath & "\" & strXsdFile

   ' Create an XML DOMDocument object.
   Dim xd 
   Set xd = CreateObject("MSXML2.DOMDocument.6.0")

   ' Assign the schema cache to the DOM document.
   ' schemas collection.
   Set xd.schemas = xs

   ' Load XML document as DOM document.
   xd.async = False
   xd.Load sAppPath & "\" & strXmlFile

   ' Return validation results in message to the user.
   If xd.parseError.errorCode <> 0 Then
        ValidateFile = "Validation failed on " & _
             strXmlFile & vbCrLf & _
             "=====================" & vbCrLf & _
             "Reason: " & xd.parseError.reason & _
             vbCrLf & "Source: " & _
             xd.parseError.srcText & _
             vbCrLf & "Line: " & _
             xd.parseError.Line & vbCrLf
             FileValid = False
    Else
        ValidateFile = "Validation succeeded for " & _
             strXmlFile & vbCrLf & _
             "======================" & _
             vbCrLf & "Contents to be bulkloaded" & vbCrLf
             FileValid = True
    End If
End Function

A. 単一テーブルでの XML の一括読み込み

この例では、ConnectionString プロパティ (MyServer) で指定されている SQL Server インスタンスへの接続を確立します。ここでは、ErrorLogFile プロパティも指定しており、エラー出力は指定したファイル ("C:\error.log") に保存されます。ファイルの保存場所は変更することもできます。Execute メソッドには、パラメータとしてマッピングスキーマファイル (SampleSchema.xml) と XML データファイル (SampleXMLData.xml) の両方が指定されている点に注意してください。一括読み込みを実行すると、tempdb データベース内に作成した Cust テーブルに、XML データファイルの内容に基づいて新しいレコードが格納されます。

一括読み込みのサンプルをテストするには

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

CREATE TABLE Cust(CustomerID  int PRIMARY KEY,
                  CompanyName varchar(20),
                  City        varchar(20))
GO

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに次の XSD スキーマを追加します。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
   <xsd:element name="ROOT" sql:is-constant="1" >
     <xsd:complexType>
       <xsd:sequence>
         <xsd:element name="Customers" sql:relation="Cust" maxOccurs="unbounded">
           <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:sequence>
           </xsd:complexType>
         </xsd:element>
       </xsd:sequence>
      </xsd:complexType>
     </xsd:element>
</xsd:schema>

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleXMLData.xml として保存します。このファイルに次の XML ドキュメントを追加します。

<ROOT>
  <Customers>
    <CustomerID>1111</CustomerID>
    <CompanyName>Sean Chai</CompanyName>
    <City>New York</City>
  </Customers>
  <Customers>
    <CustomerID>1112</CustomerID>
    <CompanyName>Tom Johnston</CompanyName>
     <City>Los Angeles</City>
  </Customers>
  <Customers>
    <CustomerID>1113</CustomerID>
    <CompanyName>Institute of Art</CompanyName>
    <City>Chicago</City>
  </Customers>
</ROOT>

任意のテキストエディタまたは XML エディタでファイルを作成し、ValidateAndBulkload.vbs として保存します。このファイルに、このトピックの最初で提供されている VBScript を追加します。接続文字列は、適切なサーバー名に変更します。Execute メソッドへのパラメータとして指定される、ファイルの適切なパスを指定します。
VBScript コードを実行します。XML 一括読み込みによって、XML が Cust テーブルに読み込まれます。

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" dt:type="int" />
   <ElementType name="CompanyName" dt:type="string" />
   <ElementType name="City" dt:type="string" />

   <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" />

   </ElementType>
</Schema>

B. 複数テーブルでの XML データの一括読み込み

この例では、XML ドキュメントに <Customer> 要素と <Order> 要素が含まれています。

<ROOT>
  <Customers>
    <CustomerID>1111</CustomerID>
    <CompanyName>Sean Chai</CompanyName>
    <City>NY</City>
    <Order OrderID="1" />
    <Order OrderID="2" />
  </Customers>
  <Customers>
    <CustomerID>1112</CustomerID>
    <CompanyName>Tom Johnston</CompanyName>
     <City>LA</City>  
    <Order OrderID="3" />
  </Customers>
  <Customers>
    <CustomerID>1113</CustomerID>
    <CompanyName>Institute of Art</CompanyName>
    <Order OrderID="4" />
  </Customers>
</ROOT>

この例では、2 つのテーブル Cust および CustOrder に XML データの一括読み込みを行います。

Cust(CustomerID, CompanyName, City)
CustOrder(OrderID, CustomerID)

次の XSD スキーマでは、これらのテーブルの XML ビューが定義されています。このスキーマでは、<Customer> 要素と <Order> 要素の間に親子リレーションシップが指定されています。

<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" >
          <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:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

XML 一括読み込みでは、上で指定されている <Cust> 要素と <CustOrder> 要素間の主キー/外部キーのリレーションシップを使用して、2 つのテーブルへのデータの一括読み込みを行います。

一括読み込みのサンプルをテストするには

tempdb データベース内に次の 2 つのテーブルを作成します。

USE tempdb
CREATE TABLE Cust(
       CustomerID  int PRIMARY KEY,
       CompanyName varchar(20),
       City        varchar(20))
CREATE TABLE CustOrder(        OrderID     int PRIMARY KEY, 
        CustomerID int FOREIGN KEY REFERENCES Cust(CustomerID))

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに、この例で提供されている XSD スキーマを追加します。
任意のテキストエディタまたは XML エディタでファイルを作成し、SampleData.xml として保存します。このファイルに、この例の最初で提供されている XML ドキュメントを追加します。
任意のテキストエディタまたは XML エディタでファイルを作成し、ValidateAndBulkload.vbs として保存します。このファイルに、このトピックの最初で提供されている VBScript を追加します。接続文字列は、適切なサーバー名とデータベース名に変更します。Execute メソッドへのパラメータとして指定される、ファイルの適切なパスを指定します。
上の VBScript コードを実行します。XML 一括読み込みによって、XML ドキュメントが Cust テーブルと CustOrder テーブルに読み込まれます。

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" dt:type="int" />
   <ElementType name="CompanyName" dt:type="string" />
   <ElementType name="City" dt:type="string" />

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

C. スキーマでチェーンリレーションシップを使用して XML の一括読み込みを行う

この例では、XML 一括読み込みにおいて、マッピングスキーマで指定されている M:N リレーションシップを使用し、M:N リレーションシップを表すテーブルにデータを読み込む方法を示します。

たとえば、次の XSD スキーマを考えてみます。

<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="OrderOD"
          parent="Ord"
          parent-key="OrderID"
          child="OrderDetail"
          child-key="OrderID" />

    <sql:relationship name="ODProduct"
          parent="OrderDetail"
          parent-key="ProductID"
          child="Product"
          child-key="ProductID" 
          inverse="true"/>
  </xsd:appinfo>
</xsd:annotation>

  <xsd:element name="ROOT" sql:is-constant="1" >
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="Order" 
                     sql:relation="Ord" 
                     sql:key-fields="OrderID" >
          <xsd:complexType>
            <xsd:sequence>
             <xsd:element name="Product"
                          sql:relation="Product" 
                          sql:key-fields="ProductID"
                          sql:relationship="OrderOD ODProduct">
               <xsd:complexType>
                 <xsd:attribute name="ProductID" type="xsd:int" />
                 <xsd:attribute name="ProductName" type="xsd:string" />
               </xsd:complexType>
             </xsd:element>
           </xsd:sequence>
           <xsd:attribute name="OrderID"   type="xsd:integer" /> 
           <xsd:attribute name="CustomerID"   type="xsd:string" />
         </xsd:complexType>
       </xsd:element>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

このスキーマでは、<Order> 要素と <Product> 子要素が指定されています。<Order> 要素はデータベースの Ord テーブルにマップされ、<Product> 要素は Product テーブルにマップされます。<Product> 要素に指定されているチェーンリレーションシップでは、OrderDetail テーブルで表される M:N リレーションシップが指定されています。つまり、1 つの注文には複数の製品が含まれ、1 つの製品は複数の注文に含まれるという関係です。

このスキーマで XML ドキュメントの一括読み込みを行うと、Ord テーブル、Product テーブル、および OrderDetail テーブルにレコードが追加されます。

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

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

CREATE TABLE Ord (
         OrderID     int  PRIMARY KEY,
         CustomerID  varchar(5))
GO
CREATE TABLE Product (
         ProductID   int PRIMARY KEY,
         ProductName varchar(20))
GO
CREATE TABLE OrderDetail (
       OrderID     int FOREIGN KEY REFERENCES Ord(OrderID),
       ProductID   int FOREIGN KEY REFERENCES Product(ProductID),
                   CONSTRAINT OD_key PRIMARY KEY (OrderID, ProductID))
GO

この例の最初で提供されているスキーマを SampleSchema.xml として保存します。

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

<ROOT>  
  <Order OrderID="1" CustomerID="ALFKI">
    <Product ProductID="1" ProductName="Chai" />
    <Product ProductID="2" ProductName="Chang" />
  </Order>
  <Order OrderID="2" CustomerID="ANATR">
    <Product ProductID="3" ProductName="Aniseed Syrup" />
    <Product ProductID="4" ProductName="Gumbo Mix" />
  </Order>
</ROOT>

任意のテキストエディタまたは XML エディタでファイルを作成し、ValidateAndBulkload.vbs として保存します。このファイルに、このトピックの最初で提供されている VBScript を追加します。接続文字列は、適切なサーバー名とデータベース名に変更します。この例のソースコードで、次の行のコメント指定をはずします。
```
objBL.CheckConstraints = True
objBL.Transaction=True
```
VBScript コードを実行します。XML 一括読み込みによって、XML ドキュメントが Ord テーブルと Product テーブルに読み込まれます。

D. ID 型の列に一括読み込みを行う

この例では、一括読み込みでの ID 型列の扱いについて説明します。この例では、3 つのテーブル (Ord、Product、OrderDetail) にデータの一括読み込みが行われます。

これらのテーブルには、次の条件が設定されています。

Ord テーブルの OrderID は ID 型の列です。
Product テーブルの ProductID は ID 型の列です。
OrderDetail の OrderID および ProductID 列は、Ord テーブルおよび Product テーブル内の対応する主キー列を参照する外部キー列です。

この例のテーブルスキーマを次に示します。

Ord (OrderID, CustomerID)
Product (ProductID, ProductName)
OrderDetail (OrderID, ProductID)

この XML 一括読み込みの例では、BulkLoad オブジェクトモデルの KeepIdentity プロパティは false に設定されています。このため、SQL Server では、Product テーブルおよび Ord テーブルの ProductID 列および OrderID 列に ID 値がそれぞれ生成されます。一括読み込みの対象ドキュメントで指定されている値は無視されます。

この場合、XML 一括読み込みでは、テーブル間の主キー/外部キーのリレーションシップが識別されます。一括読み込みでは、主キーのあるテーブルにレコードが挿入された後、SQL Server で生成された ID 値が、外部キー列のあるテーブルに格納されます。次の XML 一括読み込みの例では、次の順序でテーブルにデータが挿入されます。

Product
Ord

OrderDetail

注意
この処理ロジックでは、Products テーブルと Orders テーブルで生成された ID 値を後で OrderDetails テーブルに挿入できるよう、XML 一括読み込みによってこれらの値が保持されます。これにはまず、XML 一括読み込みで中間テーブルが作成され、このテーブルにデータが格納されます。格納された値は、後で削除されます。

この処理ロジックでは、Products テーブルと Orders テーブルで生成された ID 値を後で OrderDetails テーブルに挿入できるよう、XML 一括読み込みによってこれらの値が保持されます。これにはまず、XML 一括読み込みで中間テーブルが作成され、このテーブルにデータが格納されます。格納された値は、後で削除されます。

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

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

CREATE TABLE Ord (
         OrderID     int identity(1,1)  PRIMARY KEY,
         CustomerID  varchar(5))
GO
CREATE TABLE Product (
         ProductID   int identity(1,1) PRIMARY KEY,
         ProductName varchar(20))
GO
CREATE TABLE OrderDetail (
       OrderID     int FOREIGN KEY REFERENCES Ord(OrderID),
       ProductID   int FOREIGN KEY REFERENCES Product(ProductID),
                   CONSTRAINT OD_key PRIMARY KEY (OrderID, ProductID))
GO

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに次の XSD スキーマを追加します。

<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="OrderOD"
          parent="Ord"
          parent-key="OrderID"
          child="OrderDetail"
          child-key="OrderID" />
    <sql:relationship name="ODProduct"
          parent="OrderDetail"
          parent-key="ProductID"
          child="Product"
          child-key="ProductID" 
          inverse="true"/>
   </xsd:appinfo>
 </xsd:annotation>

  <xsd:element name="Order" sql:relation="Ord" 
                            sql:key-fields="OrderID" >
   <xsd:complexType>
     <xsd:sequence>
        <xsd:element name="Product" sql:relation="Product" 
                     sql:key-fields="ProductID"
                     sql:relationship="OrderOD ODProduct">
          <xsd:complexType>
             <xsd:attribute name="ProductID" type="xsd:int" />
             <xsd:attribute name="ProductName" type="xsd:string" />
          </xsd:complexType>
        </xsd:element>
     </xsd:sequence>
        <xsd:attribute name="OrderID"   type="xsd:integer" /> 
        <xsd:attribute name="CustomerID"   type="xsd:string" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

<ROOT>  
  <Order OrderID="11" CustomerID="ALFKI">
    <Product ProductID="11" ProductName="Chai" />
    <Product ProductID="22" ProductName="Chang" />
  </Order>
  <Order OrderID="22" CustomerID="ANATR">
     <Product ProductID="33" ProductName="Aniseed Syrup" />
    <Product ProductID="44" ProductName="Gumbo Mix" />
  </Order>
</ROOT>

任意のテキストエディタまたは XML エディタでファイルを作成し、ValidateAndBulkload.vbs として保存します。このファイルに次の VBScript コードを追加します。接続文字列は、適切なサーバー名とデータベース名に変更します。Execute メソッドへのパラメータとして使用される、ファイルの適切なパスを指定します。
```
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 = False
objBL.KeepIdentity = False
objBL.Execute "SampleSchema.xml", "SampleXMLData.xml"
Set objBL = Nothing
MsgBox "Done."
```
VBScript コードを実行します。XML 一括読み込みによって、適切なテーブルにデータが読み込まれます。

E. 一括読み込み前にテーブルスキーマを生成する

一括読み込み前にテーブルが存在しない場合、XML 一括読み込みでテーブルを作成するように指定できます。これには、SQLXMLBulkLoad オブジェクトの SchemaGen プロパティを TRUE に設定します。SGDropTables プロパティを TRUE に設定して、XML 一括読み込みで既存のテーブルを削除し、テーブルを再作成することもできます。次の VBScript の例では、これらのプロパティの使用法を示します。

また、この例では、これらの他に次の 2 つのプロパティを TRUE に設定します。

CheckConstraints。このプロパティを TRUE に設定すると、テーブルに指定されている制約違反が、テーブルに挿入されるデータによって発生するのを回避できます。この場合の制約は、Cust テーブルと CustOrder テーブル間に指定されている PRIMARY KEY/FOREIGN KEY 制約です。制約違反が発生すると、一括読み込みは失敗します。
XMLFragment。サンプル XML ドキュメント (データソース) はフラグメントであり、単一の最上位要素が含まれていません。したがって、このプロパティを TRUE に設定する必要があります。

この VBScript コードは次のとおりです。

Dim objBL 
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.XMLFragment = True
objBL.SchemaGen = True
objBL.SGDropTables = True

objBL.Execute "SampleSchema.xml", "SampleXMLData.xml"
Set objBL = Nothing

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

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに、前の例「スキーマでチェーンリレーションシップを使用して XML の一括読み込みを行う」で提供されている XSD スキーマを追加します。
任意のテキストエディタまたは XML エディタでファイルを作成し、SampleXMLData.xml として保存します。このファイルに、前の例「スキーマでチェーンリレーションシップを使用して XML の一括読み込みを行う」で提供されている XML ドキュメントを追加します。ドキュメントをフラグメントにするため、<ROOT> 要素を削除します。
任意のテキストエディタまたは XML エディタでファイルを作成し、ValidateAndBulkload.vbs として保存します。このファイルに、この例で提供されている VBScript コードを追加します。接続文字列は、適切なサーバー名とデータベース名に変更します。Execute メソッドへのパラメータとして指定される、ファイルの適切なパスを指定します。
VBScript コードを実行します。XML 一括読み込みによって、指定されたマッピングスキーマを基に必要なテーブルが作成され、このテーブルにデータの一括読み込みが行われます。

F. ストリームから一括読み込みを行う

XML 一括読み込みオブジェクトモデルの Execute メソッドでは、次の 2 つのパラメータが使用されます。最初のパラメータはマッピングスキーマファイルであり、もう 1 つのパラメータは、データベースに読み込まれる XML データを指定するものです。XML 一括読み込みの Execute メソッドに XML データを渡すには、次の 2 つの方法があります。

ファイル名をパラメータとして指定する。
XML データを含むストリームを渡す。

この例では、ストリームから一括読み込みを行う方法を示します。

VBScript はまず SELECT ステートメントが実行され、Northwind データベースの Customers テーブルから顧客情報が取得されます。SELECT ステートメントには、FOR XML 句 (と ELEMENTS オプション) が指定されているため、クエリを実行すると、次の形式の、要素中心の XML ドキュメントが返されます。

<Customer>
  <CustomerID>..</CustomerID>
  <CompanyName>..</CompanyName>
  <City>..</City>
</Customer>
...

次に、スクリプトでは Execute メソッドの 2 つ目のパラメータに、XML がストリームとして渡されます。Execute メソッドでは、Cust テーブルにデータの一括読み込みが行われます。

このスクリプトでは、SchemaGen プロパティと SGDropTables プロパティが両方とも TRUE に設定されているため、XML 一括読み込みを実行すると、指定されたデータベースに Cust テーブルが作成されます。テーブルが存在する場合は、最初にテーブルが削除された後に再作成されます。

この VBScript の例を次に示します。

Set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0")
Set objCmd = CreateObject("ADODB.Command")
Set objConn = CreateObject("ADODB.Connection")
Set objStrmOut = CreateObject ("ADODB.Stream")

objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI"
objBL.ErrorLogFile     = "c:\error.log"
objBL.CheckConstraints = True
objBL.SchemaGen        = True
objBL.SGDropTables     = True
objBL.XMLFragment      = True
' Open a connection to the instance of SQL Server to get the source data.

objConn.Open "provider=SQLOLEDB;server=(local);database=tempdb;integrated security=SSPI"
Set objCmd.ActiveConnection = objConn
objCmd.CommandText = "SELECT CustomerID, CompanyName, City FROM Customers FOR XML AUTO, ELEMENTS"

' Open the return stream and execute the command.
Const adCRLF = -1
Const adExecuteStream = 1024
objStrmOut.Open
objStrmOut.LineSeparator = adCRLF
objCmd.Properties("Output Stream").Value = objStrmOut
objCmd.Execute , , adExecuteStream
objStrmOut.Position = 0

' Execute bulk load. Read source XML data from the stream.
objBL.Execute "SampleSchema.xml", objStrmOut

Set objBL = Nothing

次の XSD マッピングスキーマでは、テーブルの作成に必要な情報が指定されます。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="ROOT" sql:is-constant="true" >
  <xsd:complexType>
    <xsd:sequence>
      <xsd:element ref="Customers"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:element>
<xsd:element name="Customers" sql:relation="Cust" >
  <xsd:complexType>
    <xsd:sequence>
      <xsd:element name="CustomerID"
                   type="xsd:string"
                   sql:datatype="nvarchar(5)"/>
      <xsd:element name="CompanyName"
                   type="xsd:string"
                   sql:datatype="nvarchar(40)"/>
      <xsd:element name="City"
                   type="xsd:string"
                   sql:datatype="nvarchar(40)"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:element>
</xsd:schema>

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" dt:type="int" />
   <ElementType name="CompanyName" dt:type="string" />
   <ElementType name="City" dt:type="string" />

   <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" />
    </ElementType>
</Schema>

既存のファイルのストリームを開く

既存の XML データファイルの名前をパラメータとして渡すのではなく、ファイルのストリームを開き、そのストリームをパラメータとして Execute メソッドに渡すことができます。

ストリームをパラメータとして渡す Visual Basic の例を次に示します。

Private Sub Form_Load()
Dim objBL As New SQLXMLBulkLoad
Dim objStrm As New ADODB.Stream
Dim objFileSystem As New Scripting.FileSystemObject
Dim objFile As Scripting.TextStream

MsgBox "Begin BulkLoad..."
objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI"
objBL.ErrorLogFile = "c:\error.log"
objBL.CheckConstraints = True
objBL.SchemaGen = True
objBL.SGDropTables = True
' Here again a stream is specified that contains the source data 
' (instead of the file name). But this is just an illustration.
' Usually this is useful if you have an XML data 
' stream that is created by some other means that you want to bulk 
' load. This example starts with an XML text file, so it may not be the 
' best to use a stream (you can specify the file name directly).
' Here you could have specified the file name itself. 
Set objFile = objFileSystem.OpenTextFile("c:\SampleData.xml")
objStrm.Open
objStrm.WriteText objFile.ReadAll
objStrm.Position = 0
objBL.Execute "c:\SampleSchema.xml", objStrm

Set objBL = Nothing
MsgBox "Done."
End Sub

アプリケーションをテストするには、次の XML ドキュメントをファイル (SampleData.xml) に保存し、この例で提供されている XSD スキーマと共に使用します。

XML ソースデータ (SampleData.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 CustomerID= "4444" OrderID="4" />
</Customers>
</ROOT>

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="Order" sql:relation="CustOrder" >
      <AttributeType name="OrderID" />
      <AttributeType name="CustomerID" />
      <attribute type="OrderID" />
      <attribute type="CustomerID" />
    </ElementType>

   <ElementType name="CustomerID" dt:type="int" />
   <ElementType name="CompanyName" dt:type="string" />
   <ElementType name="City" dt:type="string" />

   <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>
</Schema>

G. オーバーフロー列に一括読み込みを行う

マッピングスキーマで、sql:overflow-field 注釈によってオーバーフロー列が指定されている場合、XML 一括読み込みではソースドキュメントからこの列にすべての未使用データがコピーされます。

次の XSD スキーマについて考えてみます。

<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"
                                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" >
         <xsd:complexType>
          <xsd:attribute name="OrderID" type="xsd:integer" />
          <xsd:attribute name="CustomerID" type="xsd:integer" />
         </xsd:complexType>
       </xsd:element>
     </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

このスキーマでは、Cust テーブルにオーバーフロー列 (OverflowColumn) が指定されています。この結果、各 <Customer> 要素のすべての未使用 XML データはこの列に追加されます。

注意
abstract="true" が指定されているすべての abstract 要素と、prohibited="true" が指定されているすべての禁止属性は、XML 一括読み込みでオーバーフローと解釈され、オーバーフロー列の指定がある場合は、この列に追加されます。それ以外の場合は無視されます。

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

tempdb データベース内に次の 2 つのテーブルを作成します。

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

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに、この例で提供されている XSD スキーマを追加します。

<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>
     <![CDATA[LA]]> 
    <!-- <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 エディタでファイルを作成し、ValidateAndBulkload.vbs として保存します。このファイルに次の Microsoft Visual Basic Scripting Edition (VBScript) コードを追加します。接続文字列は、適切なサーバー名とデータベース名に変更します。Execute メソッドへのパラメータとして指定される、ファイルの適切なパスを指定します。
```
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 "SampleSchema.xml", "SampleXMLData.xml"
set objBL=Nothing
```
VBScript コードを実行します。

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="Order" sql:relation="CustOrder" >
      <AttributeType name="OrderID" />
      <AttributeType name="CustomerID" />
      <attribute type="OrderID" />
      <attribute type="CustomerID" />
    </ElementType>

   <ElementType name="CustomerID" dt:type="int" />
   <ElementType name="CompanyName" dt:type="string" />
   <ElementType name="City" dt:type="string" />

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

   <ElementType name="Customers" sql:relation="Cust" 
                       sql:overflow-field="OverflowColumn"  >
      <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>
</Schema>

H. トランザクションモードで一時ファイル用のファイルパスを指定する

トランザクションモードで一括読み込みを行うとき (Transaction プロパティが TRUE に設定されているとき)、次のいずれかに当てはまる場合は、TempFilePath プロパティも設定する必要があります。

リモートサーバーに一括読み込みを行う。
トランザクションモードで作成される一時ファイルの格納に、TEMP 環境変数で指定されているパスとは別のローカルドライブまたはフォルダを使用する。

たとえば、次の VBScript コードでは、SampleXMLData.xml ファイルからデータベーステーブルに、トランザクションモードでデータの一括読み込みが行われます。ここでは TempFilePath プロパティが設定され、トランザクションモードで生成される一時ファイルのパスが指定されています。

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.TempFilePath="\\Server\MyDir"
objBL.Execute "SampleSchema.xml", "SampleXMLData.xml"
set objBL=Nothing

注意
一時ファイルのパスは、対象の SQL Server インスタンスのサービスアカウントと、一括読み込みアプリケーションを実行するアカウントからの共有アクセスが可能な場所にする必要があります。ローカルサーバーで一括読み込みを行う場合以外は、一時ファイルのパスには \\servername\sharename などの UNC パスを指定してください。

一時ファイルのパスは、対象の SQL Server インスタンスのサービスアカウントと、一括読み込みアプリケーションを実行するアカウントからの共有アクセスが可能な場所にする必要があります。ローカルサーバーで一括読み込みを行う場合以外は、一時ファイルのパスには \\servername\sharename などの UNC パスを指定してください。

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

tempdb データベース内に次のテーブルを作成します。

USE tempdb
CREATE TABLE Cust (     CustomerID uniqueidentifier, 
      LastName  varchar(20))
GO

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに次の XSD スキーマを追加します。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:element name="ROOT" sql:is-constant="true" >
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element ref="Customers" />
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>

  <xsd:element name="Customers" sql:relation="Cust" >
   <xsd:complexType>
     <xsd:attribute name="CustomerID"  type="xsd:string" />
     <xsd:attribute name="LastName" type="xsd:string" />
   </xsd:complexType>
  </xsd:element>
</xsd:schema>

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleXMLData.xml として保存します。このファイルに次の XML ドキュメントを追加します。
```
<ROOT>
<Customers CustomerID="6F9619FF-8B86-D011-B42D-00C04FC964FF" 
           LastName="Smith" />
</ROOT>
```
任意のテキストエディタまたは XML エディタでファイルを作成し、ValidateAndBulkload.vbs として保存します。このファイルに次の VBScript コードを追加します。接続文字列は、適切なサーバー名とデータベース名に変更します。Execute メソッドへのパラメータとして指定される、ファイルの適切なパスを指定します。また、TempFilePath プロパティに適切なパスを指定します。
```
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.TempFilePath="\\server\folder"
objBL.Execute "SampleSchema.xml", "SampleXMLData.xml"
set objBL=Nothing
```

VBScript コードを実行します。

CustomerID の値が次のように中かっこ ({ と }) 付きの GUID として指定されている場合、このスキーマでは CustomerID 属性に、対応する sql:datatype を指定する必要があります。

<ROOT>
<Customers CustomerID="{6F9619FF-8B86-D011-B42D-00C04FC964FF}" 
           LastName="Smith" />
</ROOT>

変更後のスキーマは次のようになります。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:element name="ROOT" sql:is-constant="true" >
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element ref="Customers" />
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>

  <xsd:element name="Customers" sql:relation="Cust" >
   <xsd:complexType>
     <xsd:attribute name="CustomerID"  type="xsd:string" 
                    sql:datatype="uniqueidentifier" />
     <xsd:attribute name="LastName" type="xsd:string" />
   </xsd:complexType>
  </xsd:element>
</xsd:schema>

sql:datatype で列の型が uniqueidentifier として指定されている場合、一括読み込み操作では、CustomerID の値から中かっこ ({ と }) が削除されてから、列に値が挿入されます。

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

<?xml version="1.0" ?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data" 
        xmlns:dt="urn:schemas-microsoft-com:datatypes"  
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" >
<ElementType name="ROOT" sql:is-constant="1">
      <element type="Customers" />
</ElementType>
<ElementType name="Customers" sql:relation="Cust" >
  <AttributeType name="CustomerID"  sql:datatype="uniqueidentifier" />
  <AttributeType name="LastName"   />

  <attribute type="CustomerID" />
  <attribute type="LastName"   />
</ElementType>
</Schema>

I. 既存のデータベース接続で ConnectionCommand プロパティを使用する

既存の ADO 接続を使用して、XML の一括読み込みを行うことができます。これは、データソースに実行する多くの操作のうちの 1 つとして XML 一括読み込みを行う場合に便利です。

ADO コマンドオブジェクトを使用して既存の ADO 接続を使用するには、ConnectionCommand プロパティを使用します。この Visual Basic の例を次に示します。

Private Sub Form_Load()
Dim objBL As New SQLXMLBulkLoad4
Dim objCmd As New ADODB.Command
Dim objConn As New ADODB.Connection

'Open a connection to an instance of SQL Server.
objConn.Open "provider=SQLOLEDB;data source=(local);database=tempdb;integrated security=SSPI"
'Ask the Command object to use the connection just established.
Set objCmd.ActiveConnection = objConn

'Tell Bulk Load to use the active command object that is using the Connection obj.
objBL.ConnectionCommand = objCmd
objBL.ErrorLogFile = "c:\error.log"
objBL.CheckConstraints = True
'The Transaction property must be set to True if you use ConnectionCommand.
objBL.Transaction = True
objBL.Execute "SampleSchema.xml", "SampleXMLData.xml"
Set objBL = Nothing
End Sub

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

tempdb データベース内に次の 2 つのテーブルを作成します。

USE tempdb
CREATE TABLE Cust(
               CustomerID   varchar(5) PRIMARY KEY,
               CompanyName  varchar(30),
               City         varchar(20))
GO
CREATE TABLE CustOrder(
               CustomerID  varchar(5) references Cust (CustomerID),
               OrderID     varchar(5) PRIMARY KEY)
GO

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに次の XSD スキーマを追加します。

<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="true" >
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element ref="Customers" />
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  <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:attribute name="CustomerID" type="xsd:integer" />
         </xsd:complexType>
       </xsd:element>
     </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

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

Visual Basic (標準 EXE) アプリケーションと、上のコードを作成し、プロジェクトに次の参照を追加します。
```
Microsoft XML BulkLoad for SQL Server 4.0 Type Library
Microsoft ActiveX Data objects 2.6 Library
```
アプリケーションを実行します。

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" dt:type="int" />
   <ElementType name="CompanyName" dt:type="string" />
   <ElementType name="City" dt:type="string" />

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

J. xml データ型の列に一括読み込みを行う

マッピングスキーマで、sql:datatype="xml" 注釈によって xml データ型の列が指定されている場合、XML 一括読み込みではソースドキュメントからこの列に、マップされるフィールドの XML 子要素をコピーできます。

次の XSD スキーマを考えてみます。この XSD スキーマでは、サンプルデータベース AdventureWorks の Production.ProductModel テーブルのビューがマップされます。ここでは、テーブル内で sql:field および sql:datatype="xml" 注釈により、xml データ型の CatalogDescription フィールドが <Desc> 要素にマップされます。

<?xml version="1.0" encoding="utf-8" ?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
           xmlns:sql="urn:schemas-microsoft-com:mapping-schema"
           xmlns="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription"> 
  <xsd:element name="ProductModel"  sql:relation="Production.ProductModel" >
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="Name" type="xs:string"></xsd:element>
        <xsd:element name="Desc" sql:field="CatalogDescription" sql:datatype="xml">
        <xsd:complexType>
          <xsd:sequence>
            <xsd:element name="ProductDescription">
              <xsd:complexType>
                <xsd:sequence>
                  <xsd:element name="Summary" type="xs:anyType"/>
                </xsd:sequence>
              </xsd:complexType>
            </xsd:element>
          </xsd:sequence>
        </xsd:complexType>
        </xsd:element> 
     </xsd:sequence>
     <xsd:attribute name="ProductModelID" sql:field="ProductModelID" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

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

サンプルデータベース AdventureWorks がインストールされていることを確認します。

詳細については、「AdventureWorks サンプルデータベース」を参照してください。
任意のテキストエディタまたは XML エディタでファイルを作成し、SampleSchema.xml として保存します。このファイルに上の XSD スキーマをコピーして貼り付け、ファイルを保存します。

任意のテキストエディタまたは XML エディタでファイルを作成し、SampleXMLData.xml として保存します。このファイルに次の XML ドキュメントをコピーして貼り付け、前の手順と同じフォルダに保存します。

<ProductModel ProductModelID="2005">
    <Name>Mountain-100 (2005 model)</Name>
    <Desc><?xml-stylesheet href="ProductDescription.xsl" type="text/xsl"?>
        <p1:ProductDescription xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription" 
              xmlns:wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain" 
              xmlns:wf="https://www.adventure-works.com/schemas/OtherFeatures" 
              xmlns:html="http://www.w3.org/1999/xhtml" 
              >
            <p1:Summary>
                <html:p>Our top-of-the-line competition mountain bike. 
      Performance-enhancing options include the innovative HL Frame, 
      super-smooth front suspension, and traction for all terrain.
                        </html:p>
            </p1:Summary>
            <p1:Manufacturer>
                <p1:Name>AdventureWorks</p1:Name>
                <p1:Copyright>2002-2005</p1:Copyright>
                <p1:ProductURL>HTTP://www.Adventure-works.com</p1:ProductURL>
            </p1:Manufacturer>
            <p1:Features>These are the product highlights. 
                 <wm:Warranty>
                    <wm:WarrantyPeriod>3 years</wm:WarrantyPeriod>
                    <wm:Description>parts and labor</wm:Description>
                </wm:Warranty><wm:Maintenance>
                    <wm:NoOfYears>10 years</wm:NoOfYears>
                    <wm:Description>maintenance contract available through your dealer or any AdventureWorks retail store.</wm:Description>
                </wm:Maintenance><wf:wheel>High performance wheels.</wf:wheel><wf:saddle>
                    <html:i>Anatomic design</html:i> and made from durable leather for a full-day of riding in comfort.</wf:saddle><wf:pedal>
                    <html:b>Top-of-the-line</html:b> clipless pedals with adjustable tension.</wf:pedal><wf:BikeFrame>Each frame is hand-crafted in our Bothell facility to the optimum diameter 
      and wall-thickness required of a premium mountain frame. 
      The heat-treated welded aluminum frame has a larger diameter tube that absorbs the bumps.</wf:BikeFrame><wf:crankset> Triple crankset; alumunim crank arm; flawless shifting. </wf:crankset></p1:Features>
            <!-- add one or more of these elements... one for each specific product in this product model -->
            <p1:Picture>
                <p1:Angle>front</p1:Angle>
                <p1:Size>small</p1:Size>
                <p1:ProductPhotoID>118</p1:ProductPhotoID>
            </p1:Picture>
            <!-- add any tags in <specifications> -->
            <p1:Specifications> These are the product specifications.
                   <Material>Almuminum Alloy</Material><Color>Available in most colors</Color><ProductLine>Mountain bike</ProductLine><Style>Unisex</Style><RiderExperience>Advanced to Professional riders</RiderExperience></p1:Specifications>
        </p1:ProductDescription>
    </Desc>
</ProductModel>

任意のテキストエディタまたは XML エディタでファイルを作成し、BulkloadXml.vbs として保存します。このファイルに次の VBScript コードをコピーして貼り付け、前の XML データファイルとスキーマファイルを保存したフォルダに保存します。

set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0")
objBL.ConnectionString = "provider=SQLOLEDB;data source=MyServer;database=AdventureWorks;integrated security=SSPI"

Dim fso, sAppPath
Set fso = CreateObject("Scripting.FileSystemObject") 
sAppPath = fso.GetFolder(".") 

objBL.ErrorLogFile = sAppPath & "\error.log"

'Execute XML bulkload using file.
objBL.Execute "SampleSchema.xml", "SampleXMLData.xml"
set objBL=Nothing

スクリプト BulkloadXml.vbs を実行します。

次の方法で共有

XML 一括読み込みの例 (SQLXML 4.0)

一括読み込みスクリプト (ValidateAndBulkload.vbs)

A. 単一テーブルでの XML の一括読み込み

一括読み込みのサンプルをテストするには

B. 複数テーブルでの XML データの一括読み込み

一括読み込みのサンプルをテストするには

C. スキーマでチェーンリレーションシップを使用して XML の一括読み込みを行う

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

D. ID 型の列に一括読み込みを行う

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

E. 一括読み込み前にテーブルスキーマを生成する

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

F. ストリームから一括読み込みを行う

既存のファイルのストリームを開く

G. オーバーフロー列に一括読み込みを行う

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

H. トランザクションモードで一時ファイル用のファイルパスを指定する

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

I. 既存のデータベース接続で ConnectionCommand プロパティを使用する

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

J. xml データ型の列に一括読み込みを行う

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

その他のリソース

次の方法で共有

XML 一括読み込みの例 (SQLXML 4.0)

一括読み込みスクリプト (ValidateAndBulkload.vbs)

A. 単一テーブルでの XML の一括読み込み

一括読み込みのサンプルをテストするには

B. 複数テーブルでの XML データの一括読み込み

一括読み込みのサンプルをテストするには

C. スキーマでチェーン リレーションシップを使用して XML の一括読み込みを行う

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

D. ID 型の列に一括読み込みを行う

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

E. 一括読み込み前にテーブル スキーマを生成する

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

F. ストリームから一括読み込みを行う

既存のファイルのストリームを開く

G. オーバーフロー列に一括読み込みを行う

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

H. トランザクション モードで一時ファイル用のファイル パスを指定する

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

I. 既存のデータベース接続で ConnectionCommand プロパティを使用する

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

J. xml データ型の列に一括読み込みを行う

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

その他のリソース

C. スキーマでチェーンリレーションシップを使用して XML の一括読み込みを行う

E. 一括読み込み前にテーブルスキーマを生成する

H. トランザクションモードで一時ファイル用のファイルパスを指定する