範例:指定 XMLTEXT 指示詞
適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體
此範例說明如何在使用 EXPLICIT 模式的 陳述式中,使用 XMLTEXT SELECT
指示詞將溢位資料行中的資料定址。
假設有 Person
資料表。 此資料表有一個 Overflow
資料行,可用來儲存 XML 文件的未消耗部分。
USE tempdb;
GO
CREATE TABLE Person(PersonID varchar(5), PersonName varchar(20), Overflow nvarchar(200));
GO
INSERT INTO Person VALUES
('P1','Joe',N'<SomeTag attr1="data">content</SomeTag>')
,('P2','Joe',N'<SomeTag attr2="data"/>')
,('P3','Joe',N'<SomeTag attr3="data" PersonID="P">content</SomeTag>');
此查詢從 Person
資料表擷取資料行。 對於 Overflow
資料行,並未指定 AttributeName,但指示詞會將 XMLTEXT
設為提供通用資料表資料行名稱的一部分。
SELECT 1 as Tag, NULL as parent,
PersonID as [Parent!1!PersonID],
PersonName as [Parent!1!PersonName],
Overflow as [Parent!1!!XMLTEXT] -- No AttributeName; XMLTEXT directive
FROM Person
FOR XML EXPLICIT;
在產生的 XML 文件中:
因為
Overflow
資料行未指定 AttributeName,但指定xmltext
指示詞,所以<overflow>
元素中的屬性會附加到封閉式<Parent>
元素的屬性清單。因為
<xmltext>
元素中的PersonID
屬性與在相同元素層級上擷取的PersonID
屬性衝突,所以即使PersonID
為 NULL,還是會忽略<xmltext>
元素中的屬性。 一般而言,屬性會覆寫溢位中相同名稱的屬性。
以下是結果:
<Parent PersonID="P1" PersonName="Joe" attr1="data">content</Parent>
<Parent PersonID="P2" PersonName="Joe" attr2="data"></Parent>
<Parent PersonID="P3" PersonName="Joe" attr3="data">content</Parent>
如果溢位資料有子元素而且指定相同的查詢,則 Overflow
資料行中的子元素將會新增為封閉式 <Parent>
元素的子元素。
例如,變更 Person
資料表中的資料,讓 Overflow
資料行現在擁有子元素。
USE tempdb;
GO
TRUNCATE TABLE Person;
GO
INSERT INTO Person VALUES
('P1','Joe',N'<SomeTag attr1="data">content</SomeTag>')
,('P2','Joe',N'<SomeTag attr2="data"/>')
,('P3','Joe',N'<SomeTag attr3="data" PersonID="P"><name>PersonName</name></SomeTag>');
如果執行相同的查詢,則 <xmltext>
元素中的子元素將會新增為封閉式 <Parent>
元素的子元素:
SELECT 1 as Tag, NULL as parent,
PersonID as [Parent!1!PersonID],
PersonName as [Parent!1!PersonName],
Overflow as [Parent!1!!XMLTEXT] -- no AttributeName, XMLTEXT directive
FROM Person
FOR XML EXPLICIT;
以下是結果:
<Parent PersonID="P1" PersonName="Joe" attr1="data">content</Parent>
<Parent PersonID="P2" PersonName="Joe" attr2="data"></Parent>
<Parent PersonID="P3" PersonName="Joe" attr3="data">
<name>PersonName</name>
</Parent>
如果以 xmltext
指示詞指定 AttributeName,則 <overflow>
元素的屬性將會新增為封閉式 <Parent>
元素的子元素屬性。 為 AttributeName 所指定的名稱將成為子元素的名稱。
在此查詢中,AttributeName (<overflow>
) 會與 xmltext
指示詞一起指定*:*
SELECT 1 as Tag, NULL as parent,
PersonID as [Parent!1!PersonID],
PersonName as [Parent!1!PersonName],
Overflow as [Parent!1!overflow!XMLTEXT] -- Overflow is AttributeName
-- XMLTEXT is a directive
FROM Person
FOR XML EXPLICIT;
以下是結果:
<Parent PersonID="P1" PersonName="Joe">
<overflow attr1="data">content</overflow>
</Parent>
<Parent PersonID="P2" PersonName="Joe">
<overflow attr2="data" />
</Parent>
<Parent PersonID="P3" PersonName="Joe">
<overflow attr3="data" PersonID="P">
<name>PersonName</name>
</overflow>
</Parent>
在此查詢元素中, 屬性指定為 directive PersonName
。 PersonName
的這個結果將會新增為封閉式 <Parent>
元素的子元素。 <xmltext>
的屬性仍然會附加到封閉式 <Parent>
元素。 <overflow>
元素的內容 (子元素) 將會附加到封閉式 <Parent>
元素的其他子元素前面。
SELECT 1 AS Tag, NULL as parent,
PersonID AS [Parent!1!PersonID],
PersonName AS [Parent!1!PersonName!element], -- element directive
Overflow AS [Parent!1!!XMLTEXT]
FROM Person
FOR XML EXPLICIT;
以下是結果:
<Parent PersonID="P1" attr1="data">content<PersonName>Joe</PersonName>
</Parent>
<Parent PersonID="P2" attr2="data">
<PersonName>Joe</PersonName>
</Parent>
<Parent PersonID="P3" attr3="data">
<name>PersonName</name>
<PersonName>Joe</PersonName>
</Parent>
如果 XMLTEXT
資料行資料包含根元素的屬性,這些屬性不會顯示於 XML 資料結構描述中,而且 MSXML 剖析器並不會驗證產生的 XML 文件片段。 例如:
SELECT 1 AS Tag,
0 AS Parent,
N'<overflow a="1"/>' AS 'overflow!1!!xmltext'
FOR XML EXPLICIT, xmldata;
以下是結果。 在傳回的結構描述中,結構描述已經遺漏 a
溢位屬性:
<Schema name="Schema2"
xmlns="urn:schemas-microsoft-com:xml-data"
xmlns:dt="urn:schemas-microsoft-com:datatypes">
<ElementType name="overflow" content="mixed" model="open">`
</ElementType>`
</Schema>`
<overflow xmlns="x-schema:#Schema2" a="1">
</overflow>