sys.fn_trace_getinfo (Transact-SQL)

Aplica-se a: SQL Server

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

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use Eventos Estendidos.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

trace_id
É a identificação do rastreamento. trace_id é int. As entradas válidas são o número de ID de um rastreamento, NULL, 0 ou DEFAULT. NULL, 0 e DEFAULT são valores equivalentes neste contexto. Especifique NULL, 0 ou DEFAULT para retornar informações para todos os rastreamentos na 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 ID 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, consulte sp_trace_create (Transact-SQL). Para obter informações semelhantes sobre filtros de rastreamento, consulte sys.fn_trace_getfilterinfo (Transact-SQL).

Para obter um exemplo completo do uso de procedimentos armazenados de rastreamento, consulte 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  

Confira também

Criar um rastreamento (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)
sys.fn_trace_getfilterinfo (Transact-SQL)
sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_gettable (Transact-SQL)