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

Область применения:даSQL Server Analysis ServicesдаAzure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesyesAzure Analysis ServicesИспользует заголовок SOAP в сообщении SOAP-запроса для определения возможностей протокола между экземпляром MicrosoftMicrosoft SQL ServerSQL Server Службы Analysis ServicesAnalysis Services и клиентским приложением. Uses the SOAP header in a SOAP request message to identify protocol capabilities between an instance of MicrosoftMicrosoft SQL ServerSQL Server Службы Analysis ServicesAnalysis Services and a client application.

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

СинтаксисSyntax


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

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

ХарактеристикаCharacteristic DescriptionDescription
Тип данных и длинаData type and length NoneNone
Значение по умолчаниюDefault value NoneNone
Количество элементовCardinality 0-1: необязательный элемент, который может встречаться только один раз.0-1: Optional element that can occur once and only once.

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

СвязьRelationship ЭлементElement
Родительские элементыParent elements NoneNone
Дочерние элементыChild elements ВозможностьCapability

RemarksRemarks

ProtocolCapabilities элемент позволяет клиентским приложениям согласовать возможности протокола, например двоичного XML или поддержки сжатия с Службы Analysis ServicesAnalysis Services экземпляра в любое время.The ProtocolCapabilities element enables client applications to negotiate protocol capabilities, such as binary XML or compression support, with an Службы Analysis ServicesAnalysis Services instance at any time. Согласование протокола включает следующие шаги.Protocol negotiation involves the following steps:

  1. Клиентское приложение определяет возможности своего протокола с помощью отправки запроса SOAP, включающего элемент ProtocolCapabilities , как часть заголовка SOAP.The client application identifies its protocol capability by sending a SOAP request that includes the ProtocolCapabilities element as part of the SOAP header.

  2. Экземпляр служб Службы Analysis ServicesAnalysis Services получает и обрабатывает запрос SOAP.The Службы Analysis ServicesAnalysis Services instance receives and processes the SOAP request.

  3. Если Службы Analysis ServicesAnalysis Services возможности протокола, который содержит экземпляр, он отправляет ответ SOAP, включающий тот же ProtocolCapabilities элемент, отправляемых в запросе SOAP, а протокол была успешно согласован.If the Службы Analysis ServicesAnalysis Services instance has the same protocol capability as that requested, the instance sends a SOAP response that includes the same ProtocolCapabilities element sent in the SOAP request, and the protocol has been successfully negotiated. В противном случае возможности протокола не согласуются и экземпляр возвращает ошибку SOAP.Otherwise, the protocol capabilities are not successfully negotiated, and the instance returns a SOAP fault.

    После успешного согласования возможностей протокола длительность клиентское приложение и Службы Analysis ServicesAnalysis Services используйте экземпляр определенного протокола зависит от сеанса явной или неявной:After successfully negotiating protocol capabilities, how long the client application and the Службы Analysis ServicesAnalysis Services instance use a particular protocol depends upon whether the session is explicit or implicit:

  • Явный сеанс является запрос, который создается с помощью BeginSession элемент заголовка.An explicit session is one that is created using the BeginSession header element. В явном сеансе протокол используется, пока клиентское приложение не отправит новый элемент ProtocolCapabilities или не завершится сеанс.For an explicit session, the negotiated protocol is used until either the client application sends a new ProtocolCapabilities element or the session ends.

  • Неявный сеанс создается экземпляром служб Службы Analysis ServicesAnalysis Services и не задается явно клиентским приложением при приеме запроса SOAP.An implicit session is one that is created by an Службы Analysis ServicesAnalysis Services instance and not explicitly specified by the client application when submitting a SOAP request. В неявном сеансе согласованный протокол используется только до завершения запроса SOAP.For an implicit session, the negotiated protocol is used only until the SOAP request is completed.

    Возможности протокола не обязательно согласовывать явно.Protocol capabilities do not have to be explicitly negotiated. То есть клиентскому приложению не обязательно включать элемент ProtocolCapabilities , как часть запроса.That is, a client application does not have to include a ProtocolCapabilities element as part of the SOAP request. Если запрос SOAP не включает ProtocolCapabilities элемент, Службы Analysis ServicesAnalysis Services экземпляр отвечает, используя тот же формат запроса SOAP.If a SOAP request does not include a ProtocolCapabilities element, the Службы Analysis ServicesAnalysis Services instance responds using the same format as the SOAP request.

См. также:See Also

Управление ( соединений и сеансов XML для Аналитики ) Managing Connections and Sessions (XMLA)
Заголовки ( XML для Аналитики )Headers (XMLA)