sql:overflow-field を使用した、未使用データの取得 [SQLXML 4.0]

[アーティクル]
12/15/2008

Transact-SQL OPENXML 関数を使用して XML ドキュメントからデータベースにレコードを挿入するときに、ソース XML ドキュメントのすべての未使用データを 1 つの列に格納することができます。注釈付きスキーマを使用してデータベースからデータを取得するときには、sql:overflow-field 属性を指定して、オーバーフローデータを格納するテーブルの列を指定できます。sql:overflow-field 属性は <element> に指定できます。

データは次のように取得されます。

オーバーフロー列に格納された属性が、sql:overflow-field 注釈を含む要素に追加されます。
データベースのオーバーフロー列に格納された子要素とその子孫が、スキーマで明示的に指定されたコンテンツの後に子要素として追加されます。このとき、順序は維持されません。

例

次の例を使用した実際のサンプルを作成するには、特定の条件を満たす必要があります。詳細については、「SQLXML のサンプル実行のための必要条件」を参照してください。

A. 要素に sql:overflow-field を指定する

この例では、次のスクリプトを実行して tempdb データベースにテーブル Customers2 が作成済みであることを前提としています。

USE tempdb
CREATE TABLE Customers2 (
CustomerID       VARCHAR(10), 
ContactName    VARCHAR(30), 
AddressOverflow    NVARCHAR(500))

GO
INSERT INTO Customers2 VALUES (
'ALFKI', 
'Joe',
'<Address>
  <Address1>Maple St.</Address1>
  <Address2>Apt. E105</Address2>
  <City>Seattle</City>
  <State>WA</State>
  <Zip>98147</Zip>
 </Address>')
GO

さらに、tempdb データベース用の仮想ディレクトリと、"template" という名前の、template 型のテンプレート仮想名を作成する必要があります。

次の例では、マッピングスキーマで、Customers2 テーブルの AddressOverflow 列に格納されている未使用データを取得します。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">

  <xsd:element name="Customers2" sql:overflow-field="AddressOverflow" >
    <xsd:complexType>
      <xsd:attribute name="CustomerID"  type="xsd:integer"/>
      <xsd:attribute name="ContactName"  type="xsd:string" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

スキーマに対してサンプル XPath クエリをテストするには

上のスキーマのコードをコピーして、テキストファイルに貼り付け、Overflow.xml として保存します。
次のテンプレートをコピーして、テキストファイルに貼り付け、Overflow.xml を保存したディレクトリに OverflowT.xml として保存します。このテンプレートのクエリでは、Customers2 テーブルのレコードが選択されます。
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
    <sql:xpath-query mapping-schema="Overflow.xml">
        /Customers2
    </sql:xpath-query>
</ROOT>
```
マッピングスキーマ (Overflow.xml) に指定するディレクトリパスは、テンプレートを保存するディレクトリに対する相対パスです。次のように、絶対パスを指定することもできます。
```
mapping-schema="C:\SqlXmlTest\Overflow.xml"
```
SQLXML 4.0 テストスクリプト (sqlxml4test.vbs) を作成し、それを使用してテンプレートを実行します。

詳細については、「ADO を使用した、SQLXML 4.0 クエリの実行」を参照してください。

次に結果セットを示します。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <Customers2 CustomerID="ALFKI" ContactName="Joe">
    <Address1>Maple St.</Address1> 
    <Address2>Apt. E105</Address2> 
    <City>Seattle</City> 
    <State>WA</State> 
    <Zip>98147</Zip> 
  </Customers2>
</ROOT>

次の方法で共有

sql:overflow-field を使用した、未使用データの取得 [SQLXML 4.0]

例

A. 要素に sql:overflow-field を指定する

その他のリソース