例: ELEMENT ディレクティブとエンティティのエンコードを指定する
適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance
この例では、 ELEMENT ディレクティブと XML ディレクティブの違いを説明します。 ELEMENT ディレクティブを指定した場合はデータがエンティティとしてエンコードされますが、 XML ディレクティブを指定した場合はその処理が行われません。 このクエリでは、<Summary>
要素に、<Summary>This is summary description</Summary>
のように XML が割り当てられています。
次のクエリについて考えてみます。
USE AdventureWorks2022;
GO
SELECT 1 as Tag,
0 as Parent,
ProductModelID as [ProductModel!1!ProdModelID],
Name as [ProductModel!1!Name],
NULL as [Summary!2!SummaryDescription!ELEMENT]
FROM Production.ProductModel
WHERE ProductModelID=19
UNION ALL
SELECT 2 as Tag,
1 as Parent,
ProductModelID,
NULL,
'<Summary>This is summary description</Summary>'
FROM Production.ProductModel
WHERE ProductModelID = 19
FOR XML EXPLICIT;
結果は次のとおりです。 概要説明がエンティティとしてエンコードされています。
<ProductModel ProdModelID="19" Name="Mountain-100">
<Summary>
<SummaryDescription><Summary>This is summary description</Summary></SummaryDescription>
</Summary>
</ProductModel>
ここで、 のように、列名に ELEMENT Summary!2!SummaryDescription!XML
ディレクティブではなく XML ディレクティブを指定すると、概要情報のエンコード処理が行われません。
<ProductModel ProdModelID="19" Name="Mountain-100">
<Summary>
<SummaryDescription>
<Summary>This is summary description</Summary>
</SummaryDescription>
</Summary>
</ProductModel>
次のクエリでは、静的な XML 値を割り当てる代わりに、xml 型の query()
メソッドを使用して、xml 型の CatalogDescription 列から製品モデルの概要情報を取得します。 この場合、結果は xml 型であることがわかっているので、エンコード処理が適用されません。
SELECT 1 as Tag,
0 as Parent,
ProductModelID as [ProductModel!1!ProdModelID],
Name as [ProductModel!1!Name],
NULL as [Summary!2!SummaryDescription]
FROM Production.ProductModel
WHERE CatalogDescription is not null
UNION ALL
SELECT 2 as Tag,
1 as Parent,
ProductModelID,
Name,
(SELECT CatalogDescription.query('
declare namespace pd="http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
/pd:ProductDescription/pd:Summary'))
FROM Production.ProductModel
WHERE CatalogDescription is not null
ORDER BY [ProductModel!1!ProdModelID],Tag
FOR XML EXPLICIT;