用戶端和伺服器端的 XML 格式化 (SQLXML 4.0)

發行項
04/26/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體

本主題描述 SQLXML 中用戶端與伺服器端 XML 格式化之間的一般差異。

用戶端格式中不支援多個資料列集查詢

當您使用用戶端 XML 格式化時，不支援會產生多個資料列集的查詢。例如，假設您有一個虛擬目錄，您已在其中指定用戶端格式。請考慮此範例範本，此範本在sql：query > 區塊中有兩個 < SELECT 語句：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <sql:query>  
     SELECT FirstName FROM Person.Contact FOR XML Nested;   
     SELECT LastName FROM Person.Contact FOR XML Nested    
  </sql:query>  
</ROOT>

您可以在應用程式的程式碼中執行這個範本，而且會傳回錯誤，因為用戶端 XML 格式化不支援多個資料列集的格式。如果您在兩個不同的< sql：query >區塊中指定查詢，您將取得所需的結果。

時間戳記在用戶端與伺服器端格式中的對應不同

在伺服器端 XML 格式中， 時間戳記 類型的資料庫資料行會在查詢) 中指定 XMLDATA 選項時，對應至 i8 XDR 類型 (。

在用戶端 XML 格式中， 時間戳記 類型的資料庫資料行會對應至 uri 或 bin.base64 XDR 類型 (，視查詢) 中是否指定二進位 base64 選項而定。如果您使用 updategram 和大量載入功能，bin.base64 XDR 類型會很有用，因為此類型會轉換成SQL Server時間戳記類型。如此一來，插入、更新或刪除作業都會成功。

伺服器端格式中會使用深入的 VARIANT

在伺服器端 XML 格式化中，會使用深入類型的 VARIANT 類型。如果您使用用戶端 XML 格式化，Variant 會轉換成 Unicode 字串，而且不會使用 VARIANT 的子類型。

NESTED 模式與 AUTO 模式的比較

用戶端 FOR XML 的 NESTED 模式類似於伺服器端 FOR XML 的 AUTO 模式，但是以下情況除外：

當您在伺服器端上使用 AUTO 模式來查詢檢視表時，檢視表名稱會當做產生之 XML 中的元素名稱傳回。

例如，假設在 AdventureWorksdatabase 的 Person.Contact 資料表上建立下列檢視：

CREATE VIEW ContactView AS (SELECT ContactID as CID,  
                               FirstName  as FName,  
                               LastName  as LName  
                        FROM Person.Contact)

下列範本會針對 ContactView 檢視表指定一個查詢，也會指定伺服器端 XML 格式化：

 <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <sql:query client-side-xml="0">  
    SELECT *  
    FROM   ContactView  
    FOR XML AUTO  
  </sql:query>  
</ROOT>

當您執行此範本時，將會傳回下列 XML (只會顯示部分結果。) 請注意，元素名稱是執行查詢的檢視名稱。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <ContactView CID="1" FName="Gustavo" LName="Achong" />   
  <ContactView CID="2" FName="Catherine" LName="Abel" />   
...  
</ROOT>

當您使用對應的 NESTED 模式指定用戶端 XML 格式化時，基底資料表名稱會當做產生之 XML 中的元素名稱傳回。例如，下列修訂的範本會執行相同的 SELECT 語句，但 XML 格式是在用戶端 (上執行，也就是在範本) 中 ，用戶端 xml 會設定為 true：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <sql:query client-side-xml="1">  
    SELECT *  
    FROM   ContactView  
    FOR XML NESTED  
  </sql:query>  
</ROOT>

執行這個範本會產生以下 XML。請注意，此案例中的元素名稱是基底資料表名稱。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <Person.Contact CID="1" FName="Gustavo" LName="Achong" />   
  <Person.Contact CID="2" FName="Catherine" LName="Abel" />   
...  
</ROOT>

當您使用伺服器端 FOR XML 的 AUTO 模式時，查詢中所指定的資料表別名會當做產生之 XML 中的元素名稱傳回。

例如，假設有以下的範本：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <sql:query client-side-xml="0">  
    SELECT FirstName as fname,  
           LastName as lname  
    FROM   Person.Contact C  
    FOR XML AUTO  
  </sql:query>  
</ROOT>

執行此範本會產生以下 XML：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <C fname="Gustavo" lname="Achong" />   
  <C fname="Catherine" lname="Abel" />   
...  
</ROOT>

當您使用用戶端 FOR XML 的 NESTED 模式時，資料表名稱會當做產生之 XML 中的元素名稱傳回 (查詢中指定的資料表別名不會使用。) 例如，請考慮此範本：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <sql:query client-side-xml="1">  
    SELECT FirstName as fname,  
           LastName as lname  
    FROM   Person.Contact C  
    FOR XML NESTED  
  </sql:query>  
</ROOT>

執行此範本會產生以下 XML：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <Person.Contact fname="Gustavo" lname="Achong" />   
  <Person.Contact fname="Catherine" lname="Abel" />   
...  
</ROOT>

如果您的查詢將資料行當做 dbobject 查詢傳回，您將無法針對這些資料行使用別名。

例如，假設有以下的範本，此範本所執行的查詢會傳回員工識別碼和相片。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
<sql:query client-side-xml="1">  
   SELECT ProductPhotoID, LargePhoto as P  
   FROM   Production.ProductPhoto  
   WHERE  ProductPhotoID=5  
   FOR XML NESTED, elements  
</sql:query>  
</ROOT>

執行這個範本會將 Photo 資料行當做 dbobject 查詢傳回。在此 dbobject 查詢中，@P 會參考不存在的資料行名稱。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <Production.ProductPhoto>  
    <ProductPhotoID>5</ProductPhotoID>  
    <LargePhoto>dbobject/Production.ProductPhoto[@ProductPhotoID='5']/@P</LargePhoto>  
  </Production.ProductPhoto>  
</ROOT>

如果在伺服器上完成 XML 格式設定， (用戶端 xml=「0」) ，即使您已) 指定別名，仍可使用傳回實際資料表和資料行名稱之 dbobject 查詢的別名 (。例如，下列範本會執行查詢，而且 XML 格式是在伺服器上完成， (未指定 用戶端 xml 選項，而且未針對虛擬根目錄) 選取 [ 執行 On Client ] 選項。此查詢也會指定 AUTO 模式 (而非用戶端 NESTED 模式)。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
<sql:query   
   SELECT ProductPhotoID, LargePhoto as P  
   FROM   Production.ProductPhoto  
   WHERE  ProductPhotoID=5  
   FOR XML AUTO, elements  
</sql:query>  
</ROOT>

當執行這個範本時，將會傳回下列 XML 文件 (請注意，LargePhoto 資料行的 dbobject 查詢中不會使用別名)。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <Production.ProductPhoto>  
    <ProductPhotoID>5</ProductPhotoID>  
    <LargePhoto>dbobject/Production.ProductPhoto[@ProductPhotoID='5']/@LargePhoto</LargePhoto>  
  </Production.ProductPhoto>  
</ROOT>

用戶端和伺服器端的 XPath

用戶端 XPath 和伺服器端 XPath 的運作方式相同，但是有下列幾項差異：

當您使用用戶端 XPath 查詢時所套用的資料轉換與使用伺服器端 XPath 查詢時所套用的資料轉換不同。用戶端 XPath 會使用 CAST，而非 CONVERT 模式 126。
當您在範本中指定 client-side-xml=「0」 (false) 時，您要求伺服器端 XML 格式設定。因此，您無法指定 FOR XML NESTED，因為伺服器無法辨識 NESTED 選項。這樣會產生錯誤。您必須使用伺服器可辨識的 AUTO、RAW 或 EXPLICIT 模式。
當您在範本中指定 client-side-xml=「1」 (true) 時，您要求用戶端 XML 格式設定。在此情況下，您可以指定 FOR XML NESTED。如果您指定 FOR XML AUTO，則會在伺服器端發生 XML 格式設定，但用戶端 xml=「1」 是在範本中指定。

另請參閱

FOR XML 安全性考量 (SQLXML 4.0)
用戶端 XML 格式 (SQLXML 4.0)
伺服器端 XML 格式 (SQLXML 4.0)