• Статья

Элемент ProtocolCapabilities (XML для аналитики)

Использует заголовок SOAP в сообщении запроса SOAP для определения возможностей протокола между экземпляром служб Microsoft SQL Server Службы Analysis Services и клиентским приложением.

Пространство имен https://schemas.microsoft.com/analysisservices/2003/engine

Синтаксис

<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      ...
      <ProtocolCapabilities xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">
         <Capability>...</Capability>
      </ProtocolCapabilities>
      ...
   </soap:Header>
   <soap:Body>
      ...
   </soap:Body>
</soap:Envelope>

Характеристики элемента

Характеристика

Описание

Тип данных и длина

Нет

Значение по умолчанию

Нет

Количество элементов

0-1: необязательный элемент, который может появляться только один раз.

Связи элемента

Связь

Элемент

Родительские элементы

Нет

Дочерние элементы

Capability

Замечания

Элемент ProtocolCapabilities позволяет клиентскому приложению в любой момент согласовать возможности протокола, например двоичного XML или поддержки сжатия, с экземпляром служб Службы Analysis Services. Согласование протокола включает следующие шаги.

  1. Клиентское приложение определяет возможности своего протокола с помощью отправки запроса SOAP, включающего элемент ProtocolCapabilities, как часть заголовка SOAP.

  2. Экземпляр служб Службы Analysis Services получает и обрабатывает запрос SOAP.

  3. Если экземпляр служб Службы Analysis Services имеет требуемые возможности протокола, он отправляет ответ SOAP, включающий тот же элемент ProtocolCapabilities, который присутствовал в запросе SOAP, в результате чего протокол будет успешно согласован. В противном случае возможности протокола не согласуются и экземпляр возвращает ошибку SOAP.

После успешного согласования возможностей протокола длительность его использования клиентским приложением и экземпляром служб Службы Analysis Services зависит от того, является ли сеанс явным или неявным.

  • Явный сеанс создается с помощью элемента заголовка BeginSession. В явном сеансе протокол используется, пока клиентское приложение не отправит новый элемент ProtocolCapabilities или не завершится сеанс.

  • Неявный сеанс создается экземпляром служб Службы Analysis Services и не задается явно клиентским приложением при приеме запроса SOAP. В неявном сеансе согласованный протокол используется только до завершения запроса SOAP.

Возможности протокола не обязательно согласовывать явно. То есть клиентскому приложению не обязательно включать элемент ProtocolCapabilities, как часть запроса. Если запрос SOAP не включает элемент ProtocolCapabilities, экземпляр служб Службы Analysis Services отвечает, используя формат запроса SOAP.