sys.fn_trace_getinfo (Transact-SQL)
Retorna informações sobre um rastreamento especificado ou todos os rastreamentos existentes.
.gif "Observação importante") Importante |
|---|
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Usar eventos estendidos. |
.gif "Ícone de vínculo de tópico")
Convenções da 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 neste 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 a ID é transmitida 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, veja sp_trace_create (Transact-SQL). Para obter informações similares sobre filtros de rastreamento, consulte sys.fn_trace_getfilterinfo (Transact-SQL).
Para obter um exemplo completo de como usar 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
Consulte também
Tarefas
Criar um rastreamento (Transact-SQL)
Referência
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)