BeginSession 要素 (XMLA)
Microsoft SQL Server Analysis Services のインスタンス上で新しいセッションを開始するために、SOAP 要求メッセージ内で SOAP ヘッダーを使用します。
名前空間 urn:schemas-microsoft-com:xml-analysis
構文
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
...
<BeginSession
xmlns="urn:schemas-microsoft-com:xml-analysis" />
...
</soap:Header>
<soap:Body>
...
</soap:Body>
</soap:Envelope>
要素の特性
特性 |
説明 |
|---|---|
データ型と長さ |
なし |
既定値 |
なし |
カーディナリティ |
0-1 : 省略可能な要素で、出現する場合は 1 回だけの出現が可能です |
要素の関係
関係 |
要素 |
|---|---|
親要素 |
なし |
子要素 |
なし |
説明
BeginSession ヘッダー要素は Analysis Services インスタンスに送信される SOAP 要求の一部分で、インスタンス上で新しいセッションを明示的に開始します。SOAP 応答によって返される SOAP ヘッダーには、新しいセッションを識別する Session 要素が含まれます。この新しいセッション識別子は保存され、後続の SOAP 要求内で Session ヘッダー要素を使用して送信されます。
BeginSession ヘッダー要素が送信されない場合、セッションは明示的に開始されません。セッションが明示的に開始されない場合、そのセッション上のトランザクションを管理することはできません。つまり、XML for Analysis (XMLA) コマンド BeginTransaction、CommitTransaction、および RollbackTransaction は使用できません。暗黙的に開始されたセッションで実行されるすべての XMLA メソッドおよびコマンドは、アトミックなトランザクションと見なされます。