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 deve conter uma referência de objeto para uma instância do Analysis Services ou um rastreamento em uma instância do Subscribe 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 Subscribe comando retorna resultados de rastreamento até que o comando seja cancelado pelo comando Cancelar .
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. |
| Severidade | Integer | O nível de severidade de uma exceção para o evento. A coluna pode conter um dos seguintes valores: Valor: 0 = Êxito Valor: 1 = Informações Valor: 2 = Aviso Valor: 3 = Erro |
| Ê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. |