• Artigo

fn_trace_getinfo (Transact-SQL)

Retorna informações sobre um rastreamento especificado ou todos os rastreamentos existentes.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )

Argumentos

  • trace_id
    É a identificação do rastreamento. trace_id é int. Entradas válidas são o número da ID de um rastreamento, NULL, 0 ou DEFAULT. NULL, 0 e DEFAULT são valores equivalentes nesse contexto. Especifique NULL, 0 ou DEFAULT para retornar informações para todos os rastreamentos da instância do SQL Server.

Tabelas retornadas

Nome da coluna

Tipo de dados

Descrição

traceid

int

Identificação do rastreamento.

property

int

Propriedade do rastreamento.

1 = Opções de rastreamento. Para obter mais informações, consulte @options em sp_trace_create (Transact-SQL).

2 = Nome do arquivo

3 = Tamanho máximo

4 = Hora da parada

5 = Status do rastreamento atual. 0 = parado; 1 - em execução.

value

sql_variant

Informações sobre a propriedade do rastreamento especificado.

Comentários

Quando é passada a identificação de um rastreamento específico, fn_trace_getinfo retorna informações sobre esse rastreamento. Quando é passada uma identificação inválida, a função retorna um conjunto de linhas vazio.

fn_trace_getinfo acrescenta uma extensão .trc ao nome de qualquer arquivo de rastreamento incluído no conjunto de resultados. Para obter informações sobre como definir um rastreamento, veja sp_trace_create (Transact-SQL). Para obter informações similares sobre filtros de rastreamento, consulte fn_trace_getfilterinfo (Transact-SQL).

Para obter um exemplo completo de como usar procedimentos armazenados de rastreamento, consulte Como criar um rastreamento (Transact-SQL).

Permissões

Requer a permissão ALTER TRACE no servidor.

Exemplos

O exemplo a seguir retorna informações sobre todos os rastreamentos ativos.

SELECT * FROM sys.fn_trace_getinfo(0) ;
GO