BeginSession 要素 (XMLA)

SOAP 要求メッセージで SOAP ヘッダーを使用して、Analysis Services のインスタンスで新しいセッションを開始します。

名前空間 urn: スキーマ-microsoft-com: xml 分析

構文

  
<soap:Envelope xmlns:soap="http://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ヘッダー要素は、サーバーインスタンスに送信される SOAP 要求の一部であり、インスタンスで新しいセッションを明示的に開始します。 SOAP 応答によって返される SOAP ヘッダーには、新しいセッションを識別する session 要素が含まれています。 この新しいセッション識別子は、 セッション ヘッダー要素を使用して、後続の SOAP 要求で格納および送信されます。

Beginsessionヘッダー要素が送信されない場合、セッションは明示的に開始されません。 セッションが明示的に開始されない場合、そのセッション上のトランザクションを管理することはできません。 言い換えると、次の XML for Analysis (XMLA) コマンドは使用できません: BeginTransaction、 committransaction、および RollbackTransaction。 暗黙的に開始されたセッションで実行されるすべての XMLA メソッドおよびコマンドは、アトミックなトランザクションと見なされます。