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)