Форматирование XML на стороне клиента (SQLXML 4.0)

Применимо к:база данныхSQL Server Azure SQL Управляемый экземпляр SQL Azure

В этом разделе содержатся сведения о форматировании XML на стороне клиента. Форматирование на стороне означает форматирование XML на среднем уровне.

Примечание

В этом разделе содержатся дополнительные сведения об использовании предложения FOR XML на стороне клиента и предполагается предварительное знакомство с предложением FOR XML. Дополнительные сведения о FOR XML см. в разделе Создание XML с помощью FOR XML.

SQLNCLI11 была первой версией поставщика SQL Server, полностью распознав типы данных, представленные в SQL Server 2005 (9.x). Поведение for XML на стороне клиента с поставщиком SQLOLEDB будет рассматривать типы данных xml как строки.

Важно!

SQL Server Native Client (часто сокращенный SNAC) удален из SQL Server 2022 (16.x) и SQL Server Management Studio 19 (SSMS). SQL Server Native Client (SQLNCLI или SQLNCLI11) и устаревший поставщик MICROSOFT OLE DB для SQL Server (SQLOLEDB) не рекомендуется для разработки новых приложений. В дальнейшем перейдите на новый драйвер Microsoft OLE DB (MSOLEDBSQL) для SQL Server или последнюю версию Microsoft ODBC Driver для SQL Server. Сведения о SQLNCLI, который поставляется в качестве компонента ядра СУБД SQL Server (версии 2012–2019), см. в этом исключении жизненного цикла поддержки.

Форматирование XML-документов на стороне клиента

Предположим, клиентское приложение выполняет следующий запрос.

SELECT FirstName, LastName  
FROM   Person.Contact  
FOR XML RAW  

Только этот фрагмент запроса будет отправлен на сервер.

SELECT FirstName, LastName  
FROM   Person.Contact  

Сервер выполняет запрос и возвращает клиенту набор строк (который содержит firstName и LastNamecolumns). Затем средний уровень применяет к набору строк преобразование FOR XML и возвращает XML-форматирование клиенту.

Аналогичным образом, при выполнении запроса XPath сервер возвращает клиенту набор строк, а затем к набору строк на стороне клиента применяется преобразование FOR XML EXPLICIT, создавая нужное XML-форматирование.

В следующей таблице приведены режимы, которые могут быть заданы для FOR XML на стороне клиента.

Режим FOR XML на стороне клиента	Комментировать
RAW	Выдает одинаковый результат при указании в FOR XML на стороне клиента или сервера.
NESTED	Похож на режим FOR XML AUTO на стороне сервера.
EXPLICIT	Похож на режим FOR XML EXPLICIT на стороне сервера.

Примечание

Если указать режим AUTO и запросить XML-форматирование на стороне клиента, то запрос будет целиком отправлен на сервер, то есть XML-форматирование будет выполняться на сервере. Это сделано для удобства, но обратите внимание, что режим NESTED возвращает имена базовых таблиц в созданном в XML-документе как имена элементов. Для некоторых создаваемых пользователем приложений могут потребоваться имена базовых таблиц. Например, можно выполнить хранимую процедуру и загрузить полученные данные в набор данных (в microsoft платформа .NET Framework), а затем создать DiffGram для обновления данных в таблицах. В таком случае потребуются сведения о базовой таблице, и поэтому придется использовать режим NESTED.

Преимущества форматирования XML-кода на стороне клиента

Ниже приведены некоторые преимущества форматирования XML-кода на стороне клиента.

При наличии на сервере хранимых процедур, которые возвращают единственный набор строк, можно для создания XML запросить преобразование FOR XML на стороне клиента.

Например, рассмотрим следующую хранимую процедуру. Она возвращает имена и фамилии сотрудников из таблицы Person.Contact в базе AdventureWorks.

IF EXISTS (SELECT name FROM sysobjects  
   WHERE name = 'GetContacts' AND type = 'P')  
   DROP PROCEDURE GetContacts  
GO  
CREATE PROCEDURE GetContacts  
AS  
    SELECT   FirstName, LastName  
    FROM     Person.Contact  

Следующий образец XML-шаблона выполняет хранимую процедуру. Предложение FOR XML указывается после имени хранимой процедуры.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <sql:query client-side-xml="1">  
    EXEC GetContacts FOR XML NESTED  
  </sql:query>  
</ROOT>  

Так как в шаблоне атрибуту client-side-xml задано значение 1 (true), хранимая процедура выполняется на сервере, а набор строк из двух столбцов, возвращаемый сервером, преобразуется в XML на среднем уровне и возвращается клиенту. (здесь показан только фрагмент результата).

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

Примечание

При использовании поставщика SQLXMLOLEDB или управляемых классов SQLXML можно использовать свойство ClientSideXml для запроса форматирования XML на стороне клиента.

Рабочая нагрузка лучше сбалансирована

Поскольку клиент выполняет XML-форматирование, рабочая нагрузка будет балансироваться между сервером и клиентом, высвобождая серверные ресурсы для выполнения других задач.

Поддержка форматирования XML-кода на стороне клиента

Поддержку форматирования XML-кода на стороне клиента обеспечивают следующие компоненты SQLXML:

• SQLXMLOLEDB, поставщик

• управляемые классы SQLXML

• Улучшенная поддержка XML-шаблонов

• Свойство SqlXmlCommand.ClientSideXml

  Установив это свойство управляемых классов SQLXML в значение true, можно задать форматирование на стороне клиента.

Улучшенная поддержка XML-шаблонов

Начиная с SQL Server 2005 (9.x), xml-шаблон в SQL Server был усовершенствован с добавлением атрибута client-side-xml. Если значение этого атрибута установлено в значение true, то XML-форматирование выполняется на стороне клиента. Обратите внимание, что этот атрибут шаблона по функциональности идентичен свойству ClientSideXMLML, относящееся к поставщику SQLXML.

Примечание

Если вы выполняете xml-шаблон в приложении ADO, использующее поставщик SQLXMLOLEDB, и указываете атрибут client-side-xml в шаблоне и свойство ClientSideXML поставщика, значение, указанное в шаблоне, имеет приоритет.

См. также:

Архитектура форматирования XML на стороне клиента и сервера (SQLXML 4.0)
FOR XML (SQL Server)
Вопросы безопасности FOR XML (SQLXML 4.0)
Поддержка типов данных xml в SQLXML 4.0
Управляемые классы SQLXML
Форматирование XML-кода на клиенте и на сервере (SQLXML 4.0)
Объект SqlXmlCommand (управляемые классы SQLXML)
XML-данные (SQL Server)