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

 

Применимо к: SQL Server 2016 Preview

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

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

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

ХарактеристикаОписание
Тип данных и длинаNone
Значение по умолчаниюNone
Количество элементов0—1: необязательный элемент, который может появляться только один раз.
СвязьЭлемент
Родительские элементыNone
Дочерние элементыВозможность

Элемент 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.

Управление соединениями и сеансами (XMLA)
Заголовки (XMLA)

Добавления сообщества

Показ: