sys.fn_trace_getinfo (Transact-SQL)
Devuelve información acerca de un seguimiento especificado o de todos los seguimientos existentes.
.gif "Nota importante") Importante |
|---|
Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Use eventos extendidos en su lugar. |
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )
Argumentos
- trace_id
Es el identificador de seguimiento. trace_id es de tipo int. Las entradas válidas son el número de identificador de un seguimiento, NULL, 0 o DEFAULT. NULL, 0 y DEFAULT son valores equivalentes en este contexto. Especifique NULL, 0 o DEFAULT para devolver información de todos los seguimientos en la instancia de SQL Server.
Tablas devueltas
Nombre de columna |
Tipo de datos |
Descripción |
|---|---|---|
traceid |
int |
Identificador de seguimiento. |
property |
int |
Propiedad del seguimiento: 1= Opciones de seguimiento. Para obtener más información, vea @options en sp_trace_create (Transact-SQL). 2 = Nombre de archivo 3 = Tamaño máximo 4 = Hora de detención 5 = Estado actual del seguimiento. 0 = detenido. 1 = en ejecución. |
value |
sql_variant |
Información acerca de la propiedad de seguimiento especificado. |
Comentarios
Cuando se ha pasado el identificador de un seguimiento específico, fn_trace_getinfo devuelve información acerca del seguimiento. Si se pasa un Id. no válido, esta función devuelve un conjunto de filas vacío.
fn_trace_getinfo anexa una extensión .trc al nombre de un archivo de seguimiento incluido en su conjunto de resultados. Para obtener más información acerca de cómo definir un seguimiento, vea sp_trace_create (Transact-SQL). Para obtener información similar sobre los filtros de seguimiento, vea sys.fn_trace_getfilterinfo (Transact-SQL).
Para obtener un ejemplo completo de cómo utilizar procedimientos almacenados de seguimiento, vea Crear un seguimiento (Transact-SQL).
Permisos
Requiere el permiso ALTER TRACE en el servidor.
Ejemplos
En el siguiente ejemplo se devuelve información acerca de todos los seguimientos activos.
SELECT * FROM sys.fn_trace_getinfo(0) ;
GO
Vea también
Tasks
Crear un seguimiento (Transact-SQL)
Referencia
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)