客户端 XML 格式与服务器端 XML 格式设置（SQLXML 4.0）

2017-03-06

本主题介绍 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 格式中，类型的数据库列 timestamp 映射到 i8 XDR 类型（在查询中指定 XMLDATA 选项时）。

在客户端 XML 格式中，类型的数据库列 timestamp 映射到 uribin.base64 XDR 类型（具体取决于查询中是否指定了二进制 base64 选项）。 bin.base64如果使用 updategram 和大容量加载功能，则 XDR 类型非常有用，因为此类型将转换为 SQL Server timestamp 类型。这样，插入、更新或删除作将成功。

深度 VARIANT 用于服务器端格式设置

在服务器端 XML 格式中，将使用 VARIANT 类型的深层类型。如果使用客户端 XML 格式，则变体将转换为 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 格式时，基表名称（s）将作为生成的 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 查询返回的查询，则不能对这些列使用别名。

例如，请考虑以下模板，该模板执行返回员工 ID 和照片的查询。

<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>

执行此模板会将照片列作为 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”），则可以对返回实际表和列名称的列使用别名（即使指定了别名）。例如，以下模板执行查询，并在服务器上执行 XML 格式设置（未指定 客户端 XML 选项，并且未为虚拟根选择 “运行客户端 ”选项）。查询还指定 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。
在模板中指定 客户端 xml=“0” （false），请求服务器端 XML 格式。因此，无法指定 FOR XML NESTED，因为服务器无法识别 NESTED 选项。这会生成错误。必须使用服务器可识别的 AUTO、RAW 或 EXPLICIT 模式。
在模板中指定 客户端 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）

通过