sys.fn_trace_getinfo (Transact-SQL)

Artikel
03/12/2024

Gibt Informationen zu einer angegebene Ablaufverfolgung oder zu alle vorhandenen Ablaufverfolgungen zurück.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen erweiterte Ereignisse.

Transact-SQL-Syntaxkonventionen

Syntax

  
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )

Argumente

trace_id
Die ID der Ablaufverfolgung. trace_id ist int. Gültige Eingaben sind die ID-Nummer einer Ablaufverfolgung, NULL, 0 oder DEFAULT. NULL, 0 und DEFAULT sind in diesem Kontext gleichwertig. Geben Sie NULL, 0 oder DEFAULT an, um Informationen für alle Ablaufverfolgungen in der SQL Server-Instanz zurückzugeben.

Zurückgegebene Tabellen

Spaltenname	Datentyp	Beschreibung
traceid	int	ID der Ablaufverfolgung.
property	int	Eigenschaft der Ablaufverfolgung: 1= Ablaufverfolgungsoptionen. Weitere Informationen finden Sie in @optionssp_trace_create (Transact-SQL). 2 = Dateiname 3 = Maximale Größe 4 = Beendigungszeit 5 = Aktueller Status der Ablaufverfolgung 0 = beendet. 1 = aktiv
value	sql_variant	Informationen zur Eigenschaft der angegebenen Ablaufverfolgung.

Hinweise

Wenn die ID einer bestimmten Ablaufverfolgung übergeben wird, gibt fn_trace_getinfo Informationen zu dieser Ablaufverfolgung zurück. Wird eine ungültige ID übergeben, gibt die Funktion ein leeres Rowset zurück.

fn_trace_getinfo fügt eine TRC-Erweiterung an den Namen einer Ablaufverfolgungsdatei an, die in ihrem Resultset enthalten ist. Informationen zum Definieren einer Ablaufverfolgung finden Sie unter sp_trace_create (Transact-SQL). Ähnliche Informationen zu Ablaufverfolgungsfiltern finden Sie unter sys.fn_trace_getfilterinfo (Transact-SQL).

Ein vollständiges Beispiel für die Verwendung gespeicherter Ablaufverfolgungsprozeduren finden Sie unter Erstellen einer Ablaufverfolgung (Transact-SQL).For a complete example of using trace stored procedures, see Create a Trace (Transact-SQL).

Berechtigungen

Erfordert die ALTER TRACE-Berechtigung auf dem Server.

Beispiele

Das folgende Beispiel gibt Informationen zu allen aktiven Ablaufverfolgungen zurück.

SELECT * FROM sys.fn_trace_getinfo(0) ;  
GO

Weitere Informationen

Erstellen einer Ablaufverfolgung (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)