Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Retorna informações sobre um rastreamento especificado ou todos os rastreamentos existentes.
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. Use Eventos Estendidos.
Aplica-se a: SQL Server (SQL Server 2008 à versão atual). |
.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)