Share via

  • [アーティクル]

Session 要素 (XMLA)

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

名前空間 urn:schemas-microsoft-com:xml-analysis

構文

<soap:Envelope xmlns:soap="https://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

使用されるセッションを識別する、String 型の必須の属性。Analysis Services はグローバル一意識別子 (GUID) を使用してセッションを識別します。

説明

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

  • SOAP ヘッダー要素 BeginSession を含む SOAP 応答

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

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

Session 要素が SOAP 要求の一部分として送信されない場合、Analysis Services インスタンスは Discover または Execute メソッド呼び出しの存続期間に対応するセッションを暗黙的に開始し、メソッド呼び出しが完了した時点でそのセッションを終了します。