sql:is-constant を使用した、定数要素の作成 (SQLXML 4.0)

適用対象: SQL Server Azure SQL データベース

定数要素 (つまり、データベース テーブルまたは列にマップされない XSD スキーマ内の要素) を指定するには、 sql:is-constant 注釈を使用できます。 この注釈はブール値 (0 = false、1 = true) をとります。 指定できる値は 0、1、true、false です。 sql:is-constant注釈は、属性を持たない要素に対して指定できます。 この注釈を値 true (または 1) と共に要素に指定した場合、その要素は XML ドキュメント内に表示されますが、データベースにはマップされなくなります。

sql:is-constant注釈は、次の場合に使用できます。

• 最上位要素を XML ドキュメントに追加する。 XML では、ドキュメントに 1 つの最上位要素 (ルート要素) が必要です。

• すべての注文をラップする <Orders> 要素などのコンテナー要素の作成。

sql:is-constant注釈は、<complexType> 要素に追加できます。

例

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

A. sql:is-constant を指定してコンテナー要素を追加する

この注釈付き XSD スキーマでは、 <CustomerOrders> は、値が 1 の sql:is-constant 属性を指定することによって定数要素として定義されます。 したがって、 <CustomerOrders> はどのデータベース テーブルまたは列にもマップされません。 この定数要素は、 <Order> 子要素で構成されます。

<CustomerOrders>はデータベース テーブルまたは列にマップされませんが、結果の XML には、<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="CustOrders"  
        parent="Sales.Customer"  
        parent-key="CustomerID"  
        child="Sales.SalesOrderHeader"  
        child-key="CustomerID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Customer" sql:relation="Sales.Customer" >  
   <xsd:complexType>  
     <xsd:sequence>  
        <xsd:element name="CustomerOrders" sql:is-constant="1" >  
          <xsd:complexType>  
            <xsd:sequence>  
              <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"  
                           sql:relationship="CustOrders"   
                           maxOccurs="unbounded" >  
                <xsd:complexType>  
                   <xsd:attribute name="SalesOrderID" type="xsd:integer" />  
                   <xsd:attribute name="OrderDate" type="xsd:date" />  
                   <xsd:attribute name="CustomerID" type="xsd:string" />  
                </xsd:complexType>  
              </xsd:element>  
            </xsd:sequence>  
           </xsd:complexType>  
          </xsd:element>  
         </xsd:sequence>  
          <xsd:attribute name="CustomerID" type="xsd:string" />  
     </xsd:complexType>  
  </xsd:element>  
</xsd:schema>  

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

1. 上のスキーマのコードをコピーして、テキスト ファイルに貼り付け、 isConstant.xml として保存します。

2. 次のテンプレートをコピーして、テキスト ファイルに貼り付け、 isConstant.xml を保存したディレクトリに isConstantT.xml として保存します。

   <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
       <sql:xpath-query mapping-schema="isConstant.xml">  
           Customer[@CustomerID=1]  
       </sql:xpath-query>  
   </ROOT>  
   

   マッピング スキーマ (isConstant.xml) に指定するディレクトリ パスは、テンプレートを保存するディレクトリに対する相対パスです。 次のように、絶対パスを指定することもできます。

   mapping-schema="C:\MyDir\isConstant.xml"  
   

3. SQLXML 4.0 テスト スクリプト (sqlxml4test.vbs) を作成し、それを使用してテンプレートを実行します。

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

これは部分的な結果セットです。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">   
<Customer CustomerID="1">   
  <CustomerOrders>   
    <Order SalesOrderID="43860" OrderDate="2001-08-01" CustomerID="1" />   
    <Order SalesOrderID="44501" OrderDate="2001-11-01" CustomerID="1" />   
    <Order SalesOrderID="45283" OrderDate="2002-02-01" CustomerID="1" />   
    <Order SalesOrderID="46042" OrderDate="2002-05-01" CustomerID="1" />   
    ...  
  </CustomerOrders>   
</Customer>   
</ROOT>