sys.fn_trace_getinfo (Transact-SQL)
Se aplica a: SQL Server
Devuelve información acerca de un seguimiento especificado o de todas los seguimientos existentes.
Importante
Esta característica se quitará en una versión futura de 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.
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 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 para todos los seguimientos de la instancia de SQL Server.
Tablas devueltas
Nombre de la columna | Tipo de datos | Descripción |
---|---|---|
traceid | int | Id. del seguimiento. |
propiedad | int | Propiedad del seguimiento: 1= Opciones de seguimiento. Para obtener más información, consulte @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 información sobre cómo definir un seguimiento, consulte sp_trace_create (Transact-SQL). Para obtener información similar sobre los filtros de seguimiento, consulte sys.fn_trace_getfilterinfo (Transact-SQL).
Para obtener un ejemplo completo del uso de procedimientos almacenados de seguimiento, consulte Creación de 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
Consulte también
Crear un seguimiento (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)