sql:mapped を使用した、結果の XML からのスキーマ要素の除外 [SQLXML 4.0]
既定のマッピングでは、XSD スキーマのすべての要素と属性が、データベースのテーブルまたはビューと列にマップされます。XSD スキーマで、データベース テーブル (ビュー) または列にマップせず、XML に表示しない要素を作成する場合は、sql:mapped 注釈を指定できます。
sql:mapped 注釈は、データベースに格納されていないデータがスキーマにあり、そのスキーマを変更できない場合や、そのスキーマが他のソースからの XML の検証に使用されている場合に特に便利です。sql:mapped 注釈は、マップされない要素と属性が XML ドキュメントに表示されないという点で、sql:is-constant と異なります。
sql:mapped 注釈はブール値 (0 = false、1 = true) をとります。指定できる値は 0、1、true、false です。
例
次の例を使用した実際のサンプルを作成するには、特定の条件を満たす必要があります。詳細については、「SQLXML のサンプル実行のための必要条件」を参照してください。
A. sql:mapped 注釈を指定する
他のソースからの XSD スキーマがあるとします。この XSD スキーマは、ContactID、FirstName、LastName、HomeAddress 属性が指定された <Person.Contact> 要素で構成されています。
Employees テーブルには従業員の自宅の住所は格納されていないので、この XSD スキーマを AdventureWorks データベース内の Person.Contact テーブルにマップする場合は、HomeAddress 属性に sql:mapped を指定します。この結果、マッピング スキーマに対して Xpath クエリを指定すると、属性はデータベースにマップされず、結果の XML ドキュメント内に返されません。
スキーマの残りの部分に対しては、既定のマッピングが適用されます。<Person.Contact> 要素は Person.Contact テーブルにマップされ、すべての属性は Person.Contact テーブルの同じ名前の列にマップされます。
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="Person.Contact">
<xsd:complexType>
<xsd:attribute name="ContactID" type="xsd:string"/>
<xsd:attribute name="FirstName" type="xsd:string" />
<xsd:attribute name="LastName" type="xsd:string" />
<xsd:attribute name="HomeAddress" type="xsd:string"
sql:mapped="false" />
</xsd:complexType>
</xsd:element>
</xsd:schema>
スキーマに対してサンプル XPath クエリをテストするには
上のスキーマのコードをコピーして、テキスト ファイルに貼り付け、sql-mapped.xml として保存します。
次のテンプレートをコピーして、テキスト ファイルに貼り付け、sql-mapped.xml を保存したディレクトリに sql-mappedT.xml として保存します。
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> <sql:xpath-query mapping-schema="sql-mapped.xml"> /Person.Contact[@ContactID < 10] </sql:xpath-query> </ROOT>マッピング スキーマ (MySchema.xml) に指定するディレクトリ パスは、テンプレートを保存するディレクトリに対する相対パスです。次のように、絶対パスを指定することもできます。
mapping-schema="C:\MyDir\sql-mapped.xml"SQLXML 4.0 テスト スクリプト (sqlxml4test.vbs) を作成し、それを使用してテンプレートを実行します。
詳細については、「ADO を使用した SQLXML クエリの実行」を参照してください。
次に結果セットを示します。
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<Person.Contact ContactID="1" FirstName="Gustavo" LastName="Achong" />
<Person.Contact ContactID="2" FirstName="Catherine" LastName="Abel" />
<Person.Contact ContactID="3" FirstName="Kim" LastName="Abercrombie" />
<Person.Contact ContactID="4" FirstName="Humberto" LastName="Acevedo" />
<Person.Contact ContactID="5" FirstName="Pilar" LastName="Ackerman" />
<Person.Contact ContactID="6" FirstName="Frances" LastName="Adams" />
<Person.Contact ContactID="7" FirstName="Margaret" LastName="Smith" />
<Person.Contact ContactID="8" FirstName="Carla" LastName="Adams" />
<Person.Contact ContactID="9" FirstName="Jay" LastName="Adams" />
</ROOT>
マッピング スキーマで sql:mapped 属性に 0 を指定しているので、ContactID と FirstName、Lastname は存在しますが、HomeAddress は存在しないことに注意してください。
参照
関連項目
XSD 要素および属性の、テーブルおよび列への既定のマッピング [SQLXML 4.0]