次の方法で共有

Session 要素 (XMLA)

  • [アーティクル]

SOAP 要求メッセージで SOAP ヘッダーを使用して、Analysis Services のインスタンス上の既存の明示的なセッションを識別します。

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

構文

  
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
   <soap:Header>  
      ...  
      <Session  
         xmlns="urn:schemas-microsoft-com:xml-analysis"  
         SessionId="string" />  
      ...  
   </soap:Header>  
   <soap:Body>  
      ...  
   </soap:Body>  
</soap:Envelope>

要素の特性

特徴 説明
データ型と長さ なし
既定値 なし
カーディナリティ 0-1 : 省略可能な要素で、出現する場合は 1 回だけの出現が可能です

要素の関係

リレーションシップ 要素
親要素 なし
子要素 なし

属性

属性 説明
SessionId 使用するセッションを識別する必須の 文字列 属性です。 サーバーインスタンスは、グローバル一意識別子 (GUID) を使用してセッションを識別します。

注釈

セッションヘッダー要素は、インスタンスで明示的に開始された既存のセッションを識別します。 Session要素は、次の種類のメッセージの SOAP ヘッダーに含まれています。

  • Beginsession soap ヘッダー要素を含む soap 応答。

  • DiscoverまたはExecuteメソッドを実行するセッションを識別するための SOAP 要求。

セッション識別子は、そのセッションが引き続き有効であることを保証するものではありません。 Session要素で指定されたセッションの有効期限が切れます。 たとえば、セッションがタイムアウトになるか、セッションに関連した接続が切断された場合には、セッションが有効期限切れになることがあります。 セッションの有効期限が切れ、が有効でなくなった場合、サーバーはセッションを終了し、現在処理中のすべてのトランザクションをロールバックします。 無効なセッション識別子を使用して送信された SOAP メッセージは失敗し、指定されたセッションが見つからないことを示す SOAP エラーが報告されます。

セッション要素が SOAP 要求の一部として送信されない場合、インスタンスは、 DiscoverまたはExecuteメソッド呼び出しの間、暗黙的にセッションを開始し、メソッド呼び出しの完了後にそのセッションを終了します。