Compartir vía

sys.fn_trace_getinfo (Transact-SQL)

  • Artículo

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)