OPENXML 内でのメタプロパティの指定

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL データベース

XML ドキュメントに含まれるメタプロパティ属性は、XML アイテム (要素、属性、その他の DOM ノードなど) のプロパティを示す属性です。 これらの属性は、物理的に XML ドキュメントのテキスト内に存在するものではありません。 ただし、OPENXML では、すべての XML アイテムに、これらのメタプロパティが提供されます。 これらのメタプロパティを使用すると、XML ノードの情報 (ローカルの位置や名前空間の情報など) を抽出できます。 これらの情報からは、テキストで表現されている情報よりも詳細な情報を得られます。

これらのメタプロパティは、 ColPattern パラメーターを使用して OPENXML ステートメント内の行セットの列にマップできます。 これらの列には、その列がマップされたメタプロパティの値が含まれます。 OPENXML の構文の詳細については、「OPENXML (Transact-SQL)」を参照してください。

これらのメタプロパティ属性にアクセスするために、SQL Server 固有の名前空間が提供されています。 この名前空間、urn:schemas-microsoft-com:xml-metaprop によって、ユーザーがメタプロパティ属性にアクセスできるようになります。 OPENXML クエリの結果がエッジ テーブル形式で返される場合、そのエッジ テーブルには、xmltext メタプロパティ以外のメタプロパティ属性ごとに 1 つの列が含まれます。

一部のメタプロパティ属性は、処理の目的で使用されます。 たとえば xmltext メタプロパティ属性は、オーバーフロー処理のために使用されます。 オーバーフロー処理では、ドキュメントに含まれる未使用および未処理データを参照します。 OPENXML によって生成された行セット内の列の 1 つは、オーバーフロー列として識別されるようにすることができます。 ある列がオーバーフロー列として識別されるようにするには、xmltext パラメーターを使用して、この列を メタプロパティにマップします。 このマッピングを行うと、列はオーバーフロー データを受け取ります。 列に含まれるのが未使用データだけなのかすべてのデータなのかは flags パラメーターによって判断します。

次の表に、解析されたそれぞれの XML 要素が所有するメタプロパティ属性を示します。 これらのメタプロパティ属性には、名前空間 urn:schemas-microsoft-com:xml-metaprop を使用してアクセスできます。 ただし、ユーザーがこれらのメタプロパティを使用して XML ドキュメントに直接設定した値は無視されます。

次の表には、用意されている追加の親プロパティを示します。これらのプロパティを使用すると、階層情報を取得できます。

例

次に、OPENXML を使用してさまざまな行セット ビューを作成する方法の例を示します。

A. OPENXML 行セット列をメタプロパティにマッピングする

この例では、OPENXML を使用して、サンプルの XML ドキュメントの行セット ビューを作成します。 具体的には、 ColPattern パラメーターを使用して、OPENXML ステートメントで各種のメタプロパティ属性を行セットの列にマップする方法を示します。

この OPENXML ステートメントは、次のことを表します。

• id 列が @mp:id メタプロパティ属性にマップされ、システムによって生成された要素の一意な XML ID がこの列に含まれることを示しています。

• parent 列が @mp:parentid にマップされ、要素の親要素の XML ID がこの列に含まれることを示しています。

• parentLocalName 列が @mp:parentlocalname にマップされ、親のローカル名がこの列に含まれることを示しています。

SELECT ステートメントは OPENXML で提供された行セットを返します。

DECLARE @idoc int;
DECLARE @doc nvarchar(1000);
-- Sample XML document
SET @doc = N'<root>
  <Customer cid= "C1" name="Janine" city="Issaquah">
      <Order oid="O1" date="1/20/1996" amount="3.5" />
      <Order oid="O2" date="4/30/1997" amount="13.4">Customer was very satisfied</Order>
   </Customer>
   <Customer cid="C2" name="Ursula" city="Oelde" >
      <Order oid="O3" date="7/14/1999" amount="100" note="Wrap it blue white red">
          <Urgency>Important</Urgency>
      </Order>
      <Order oid="O4" date="1/20/1996" amount="10000"/>
   </Customer>
</root>';
-- Create an internal representation of the XML document.
EXEC sp_xml_preparedocument @idoc OUTPUT, @doc;

-- Execute a SELECT statement using OPENXML rowset provider.
SELECT *
FROM OPENXML (@idoc, '/root/Customer/Order', 9)
      WITH (id int '@mp:id',
            oid char(5),
            date datetime,
            amount real,
            parentIDNo int '@mp:parentid',
            parentLocalName varchar(40) '@mp:parentlocalname');
EXEC sp_xml_removedocument @idoc;

結果を次に示します。

id   oid         date                amount    parentIDNo  parentLocalName
--- ------- ---------------------- ---------- ------------ ---------------
6    O1    1996-01-20 00:00:00.000     3.5         2        Customer
10   O2    1997-04-30 00:00:00.000     13.4        2        Customer
19   O3    1999-07-14 00:00:00.000     100.0       15       Customer
25   O4    1996-01-20 00:00:00.000     10000.0     15       Customer

B. XML ドキュメント全体を取得する

この例では、OPENXML を使用して、サンプルの XML ドキュメントの 1 列の行セット ビューが作成されます。 この列 Col1 は xmltext メタプロパティにマップされ、オーバーフロー列になります。 そのため、この列は未使用データを受け取ります。 この例の場合、この列には、ドキュメント全体が格納されます。

SELECT ステートメントは行セット全体を返します。

DECLARE @idoc int;
DECLARE @doc nvarchar(1000);
SET @doc = N'<?xml version="1.0"?>
<root>
  <Customer cid= "C1" name="Janine" city="Issaquah">
      <Order oid="O1" date="1/20/1996" amount="3.5" />
      <Order oid="O2" date="4/30/1997" amount="13.4">Customer was very
             satisfied</Order>
   </Customer>
   <Customer cid="C2" name="Ursula" city="Oelde" >
      <Order oid="O3" date="7/14/1999" amount="100" note="Wrap it blue
             white red">
     <MyTag>Testing to see if all the subelements are returned</MyTag>
          <Urgency>Important</Urgency>
      </Order>
      <Order oid="O4" date="1/20/1996" amount="10000"/>
   </Customer>
</root>';
-- Create an internal representation of the XML document.
EXEC sp_xml_preparedocument @idoc OUTPUT, @doc;

-- Execute a SELECT statement using OPENXML rowset provider.
SELECT *
FROM OPENXML (@idoc, '/')
   WITH (Col1 ntext '@mp:xmltext')

XML 宣言を使用しないでドキュメント全体を取得するには、クエリを次のように指定します。

SELECT *
FROM OPENXML (@idoc, '/root')
   WITH (Col1 ntext '@mp:xmltext')
EXEC sp_xml_removedocument @idoc;

クエリはルート要素を返し、これには名前のルートおよびルート要素に含まれるデータが含まれます。

C: xmltext メタプロパティの指定による列内の未使用データの取得

この例では、OPENXML を使用して、サンプルの XML ドキュメントの行セット ビューを作成します。 この例では、OPENXML 内の行セットの列に xmltext メタプロパティ属性をマップすることによって、未使用の XML データを取得する方法について説明します。

comment 列は、@mp:xmltext メタプロパティにマッピングすることによって、オーバーフロー列として識別されます。 flags パラメーターは 9 (XML_ATTRIBUTE and XML_NOCOPY) に設定されています。 この設定は、attribute-centric マッピングであり、未使用データのみがオーバーフロー列にコピーされることを示しています。

SELECT ステートメントは OPENXML で提供される行セットを返します。

この例では、OPENXML によって生成された行セット内の列 (@mp:parentlocalname) に対して ParentLocalName メタプロパティが設定されます。 その結果、この列には親要素のローカル名が含まれます。

行セットには他に 2 つの列 (parent と comment) が指定されています。 parent 列が @mp:parentid にマップされ、この列に、要素の親要素の XML ID が含まれることを示します。 comment 列は、 @mp:xmltext メタプロパティ以外のメタプロパティ属性ごとに 1 つの列が含まれます。

DECLARE @idoc int;
DECLARE @doc nvarchar(1000);
-- sample XML document
SET @doc = N'<root>
  <Customer cid= "C1" name="Janine" city="Issaquah">
      <Order oid="O1" date="1/20/1996" amount="3.5" />
      <Order oid="O2" date="4/30/1997" amount="13.4">Customer was very satisfied</Order>
   </Customer>
   <Customer cid="C2" name="Ursula" city="Oelde" >
      <Order oid="O3" date="7/14/1999" amount="100" note="Wrap it blue white red">
          <Urgency>Important</Urgency>
      </Order>
      <Order oid="O4" date="1/20/1996" amount="10000"/>
   </Customer>
</root>
';
-- Create an internal representation of the XML document.
EXEC sp_xml_preparedocument @idoc OUTPUT, @doc;

-- Execute a SELECT statement using OPENXML rowset provider.
SELECT *
FROM OPENXML (@idoc, '/root/Customer/Order', 9)
      WITH (oid char(5),
            date datetime,
            comment ntext '@mp:xmltext');
EXEC sp_xml_removedocument @idoc;

結果は次のとおりです。 oid 列と date 列は既に使用されているので、それらはオーバーフロー列には表示されません。

oid   date                        comment
----- --------------------------- ----------------------------------------
O1    1996-01-20 00:00:00.000     <Order amount="3.5"/>
O2    1997-04-30 00:00:00.000     <Order amount="13.4">Customer was very
                                   satisfied</Order>
O3    1999-07-14 00:00:00.000     <Order amount="100" note="Wrap it blue
                                   white red"><Urgency>
                                   Important</Urgency></Order>
O4    1996-01-20 00:00:00.000     <Order amount="10000"/>

関連項目

• OPENXML(Transact-SQL)
• OPENXML (SQL Server)