Compartilhar via


Monitorando rastreamentos (XMLA)

Você pode usar o comando Subscribe no XMLA (XML for Analysis) para monitorar um rastreamento existente definido em uma instância do Microsoft SQL Server Analysis Services. O comando Subscribe retorna os resultados de um rastreamento como um conjunto de linhas.

Especificando um rastreamento

A propriedade Object do comando Subscribe deve conter uma referência de objeto para uma instância do Analysis Services ou para um rastreamento em uma instância do Analysis Services. Se a propriedade Object não for especificada, ou se o identificador do rastreamento não for especificado na propriedade Object, o comando Subscribe vai monitorar o rastreamento padrão de sessão para a sessão explícita especificada no cabeçalho SOAP do comando.

Retornando resultados

O comando Subscribe retorna um conjunto de linhas que contém os eventos de rastreamento capturados pelo rastreamento especificado. O comando Subscribe retorna resultados de rastreamento até ser cancelado pelo comando Cancel.

O conjunto de linhas contém as colunas listadas na tabela a seguir.

Coluna

Tipo de dados

Descrição

EventClass

Integer

A classe de evento do evento recebido pelo rastreamento.

EventSubclass

Long integer

A subclasse do evento recebido pelo rastreamento.

CurrentTime

Datetime

O horário no qual o evento foi iniciado, quando disponível. Para filtragem, os formatos esperados são 'AAAA-MM-DD' e 'AAAA-MM-DD HH:MM:SS'.

StartTime

Datetime

O horário no qual o evento foi iniciado, quando disponível. Para filtragem, os formatos esperados são 'AAAA-MM-DD' e 'AAAA-MM-DD HH:MM:SS'.

EndTime

Datetime

O horário de término evento, quando disponível. Para filtragem, os formatos esperados são 'AAAA-MM-DD' e 'AAAA-MM-DD HH:MM:SS'.

Esta coluna não é preenchida para classes de evento que descrevem o início de um processo ou de uma ação.

Duration

Long integer

O tempo total (em milissegundos) decorrido no evento.

CPUTime

Long integer

O tempo de processador (em milissegundos) decorrido no evento.

JobID

Long integer

O identificador de trabalho para o processo.

SessionID

String

O identificador da sessão para a qual o evento ocorreu.

SessionType

String

O tipo da sessão para a qual o evento ocorreu.

ProgressTotal

Long integer

O número total ou a quantidade de progresso informados pelo evento.

IntegerData

Long integer

Dados inteiros associados ao evento. O conteúdo desta coluna depende da classe de evento e da subclasse do evento.

ObjectID

String

O identificador do objeto para o qual o evento ocorreu.

ObjectType

String

O tipo do objeto especificado em ObjectName.

ObjectName

String

O nome do objeto para o qual o evento ocorreu.

ObjectPath

String

O caminho hierárquico do objeto para o qual o evento ocorreu. O caminho é representado como uma cadeia de caracteres delimitada por vírgulas de identificadores de objetos para os pais do objeto especificado em ObjectName.

ObjectReference

String

A representação XML da referência de objeto para o objeto especificado em ObjectName.

NestLevel

Integer

O nível da transação para a qual o evento ocorreu.

NumSegments

Long integer

O número de segmentos de dados afetados ou acessados pelo comando para o qual o evento ocorreu.

Severity

Integer

O nível de severidade de uma exceção para o evento. A coluna pode conter um dos seguintes valores:

ValorDescrição
0Êxito
1Informações
2Aviso
3Erro

Êxito

Boolean

Indica se um comando teve êxito ou se falhou.

Erro

Long integer

O número do erro do evento, se aplicável.

ConnectionID

String

O identificador da conexão para a qual o evento ocorreu.

DatabaseName

String

O nome do banco de dados para o qual o evento ocorreu.

NTUserName

String

O nome de usuário do Windows associado ao evento.

NTDomainName

String

O domínio do Windows do usuário associado ao evento.

ClientHostName

String

O nome do computador em que o aplicativo cliente está sendo executado. Essa coluna é preenchida com os valores passados pelo aplicativo cliente.

ClientProcessID

Long integer

O identificador de processo do aplicativo cliente.

ApplicationName

String

O nome do aplicativo cliente que criou a conexão com a instância do Analysis Services. Essa coluna é preenchida com os valores passados pelo aplicativo cliente e não com o nome exibido do programa.

NTCanonicalUserName

String

O nome de usuário canônico do Windows associado ao evento.

SPID

String

A SPID (ID de processo do servidor) da sessão para a qual o evento ocorreu. O valor dessa coluna corresponde diretamente à ID de sessão especificada no cabeçalho SOAP da mensagem XMLA para a qual o evento ocorreu.

TextData

String

Os dados de texto associados ao evento. O conteúdo desta coluna depende da classe de evento e da subclasse do evento.

ServerName

String

O nome da instância do Analysis Services para a qual o evento ocorreu.

RequestParameters

String

Os parâmetros da consulta parametrizada ou do comando XMLA para os quais o evento ocorreu.

RequestProperties

String

As propriedades do método XMLA para o qual o evento ocorreu.