Monitorando rastreamentos (XMLA)
Você pode usar o comando Assinar no XMLA (XML for Analysis) para monitorar um rastreamento existente definido em uma instância do Microsoft SQL Server SQL Server Analysis Services. O comando Assinar 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 de SQL Server Analysis Services ou um rastreamento em uma instância de SQL Server Analysis Services. Se a propriedade Object não for especificada ou um identificador de rastreamento não for especificado na propriedade Object , o comando Subscribe monitorará o rastreamento de sessão padrão para a sessão explícita especificada no cabeçalho SOAP para o comando.
Retornando resultados
O comando Assinar retorna um conjunto de linhas que contém os eventos de rastreamento capturados pelo rastreamento especificado. O comando Assinar 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 | Cadeia de caracteres | 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: 0: Êxito 1: Informações 2: Aviso 3: Erro |
| Sucesso | Booliano | 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 | Cadeia de caracteres | O domínio do Windows do usuário associado ao evento. |
| ClientHostName | Cadeia de caracteres | 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 | Cadeia de caracteres | O nome do aplicativo cliente que criou a conexão com a instância SQL Server 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 | Cadeia de caracteres | 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 | Cadeia de caracteres | 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 do SQL Server Analysis Services instância para a qual o evento ocorreu. |
| RequestParameters | Cadeia de caracteres | Os parâmetros da consulta parametrizada ou do comando XMLA para os quais o evento ocorreu. |
| RequestProperties | Cadeia de caracteres | As propriedades do método XMLA para o qual o evento ocorreu. |