• 아티클

ProtocolCapabilities 요소(XMLA)

SOAP 요청 메시지의 SOAP 헤더를 사용하여 MicrosoftSQL ServerAnalysis 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 요소는 클라이언트 응용 프로그램이 언제든지 Analysis Services 인스턴스로 이진 XML 또는 압축 지원과 같은 프로토콜 기능을 협상할 수 있게 해 줍니다. 프로토콜 협상에는 다음과 같은 단계가 포함됩니다.

  1. 클라이언트 응용 프로그램이 SOAP 헤더의 일부로 ProtocolCapabilities 요소를 포함하는 SOAP 요청을 전송하여 해당 프로토콜 기능을 식별합니다.

  2. Analysis Services 인스턴스가 SOAP 요청을 받고 처리합니다.

  3. Analysis Services 인스턴스에 요청된 것과 동일한 프로토콜 기능이 있으면 인스턴스가 SOAP 요청에서 전송된 것과 동일한 ProtocolCapabilities 요소를 포함하는 SOAP 응답을 보내고 프로토콜이 성공적으로 협상됩니다. 그렇지 않으면 프로토콜이 성공적으로 협상되지 않으며 인스턴스가 SOAP 오류를 반환합니다.

프로토콜이 성공적으로 협상된 후 클라이언트 응용 프로그램 및 Analysis Services 인스턴스에서 특정 프로토콜을 사용하는 기간은 세션이 명시적인지 또는 암시적인지에 따라 달라집니다.

  • 명시적 세션은 BeginSession 헤더 요소에서 만드는 세션입니다. 명시적 세션의 경우 협상된 프로토콜은 클라이언트 응용 프로그램에서 새로운 ProtocolCapabilities 요소를 보내거나 세션이 종료될 때까지 사용됩니다.

  • 암시적 세션은 Analysis Services 인스턴스에 의해 생성되며 클라이언트 응용 프로그램에서 SOAP 요청을 전송할 때 명시적으로 지정하지 않은 세션입니다. 암시적 세션의 경우 협상된 프로토콜은 SOAP 요청이 완료될 때까지만 사용됩니다.

프로토콜 기능은 명시적으로 협상될 필요가 없습니다. 즉 클라이언트 응용 프로그램은 SOAP 요청의 일부로 ProtocolCapabilities 요소를 포함하지 않아도 됩니다. SOAP 요청에 ProtocolCapabilities 요소가 포함되지 않은 경우 Analysis Services 인스턴스는 SOAP 요청과 동일한 형식을 사용하여 응답합니다.

참고 항목

개념

연결 및 세션 관리(XMLA)

관련 자료

헤더(XMLA)