Элемент Session (XML для аналитики)
Использует заголовок SOAP в сообщении-запросе SOAP, чтобы идентифицировать существующий явный сеанс для экземпляра служб MicrosoftSQL ServerAnalysis 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, а после его завершения завершает данный сеанс.
См. также