Share via

  • Статья

Элемент Session (XML для аналитики)

Использует заголовок SOAP в сообщении-запросе SOAP, чтобы идентифицировать существующий явный сеанс для экземпляра служб Microsoft SQL Server Службы Analysis Services.

Пространство имен   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: необязательный элемент, который может появляться только один раз.

Связи элемента

Связь

Элемент

Родительские элементы

Нет

Дочерние элементы

Нет

Атрибуты

Атрибут

Описание

SessionId

Необходим атрибут String, идентифицирующий сеанс, который будет использован. В службах Службы Analysis Services для уникальной идентификации сеанса используется идентификатор GUID.

Замечания

Элемент заголовка Session определяет существующий, явно запущенный сеанс экземпляра служб Службы Analysis Services. Элемент Session является частью заголовка SOAP для следующих типов сообщений.

  • Сообщение-ответ SOAP, содержащее элемент заголовка SOAP BeginSession.

  • SOAP-запрос на идентификацию сеанса, в котором следует запустить метод Discover или Execute.

Идентификатор сеанса не гарантирует того, что сеанс остается допустимым. У сеанса, заданного в элементе Session, может истечь срок действия. Например, срок действия сеанса может истечь, если будет превышено время ожидания или произойдет отключение соединения, связанного с этим сеансом. Если время сеанса истекает и он становится недействительным, служба Службы Analysis Services завершает сеанс и выполняет откат текущих транзакций. Все SOAP-сообщения, отправленные с идентификатором недействительного сеанса, возвращают ошибку SOAP, указывающую, что заданный сеанс не найден.

Если элемент Session не был послан в сообщении-запросе SOAP, то экземпляр служб Службы Analysis Services скрыто запускает сеанс на время выполнения вызова метода Discover или Execute, а после его завершения завершает данный сеанс.