sys.fn_trace_getinfo (Transact-SQL)
Gibt Informationen zu einer angegebene Ablaufverfolgung oder zu allen vorhandenen Ablaufverfolgungen zurück.
Wichtig |
---|
Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird. 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 vom Datentyp int. Gültige Eingaben sind die ID einer Ablaufverfolgung, NULL, 0 und DEFAULT. NULL, 0 und DEFAULT sind in diesem Kontext gleichwertig. Geben Sie NULL, 0 oder DEFAULT an, wenn Informationen zu allen Ablaufverfolgungen in der Instanz von SQL Server zurückgegeben werden sollen.
Zurückgegebene Tabellen
Spaltenname |
Datentyp |
Beschreibung |
---|---|---|
traceid |
int |
ID der Ablaufverfolgung. |
property |
int |
Eigenschaft der Ablaufverfolgung: 1= Ablaufverfolgungsoptionen. Weitere Informationen finden Sie im Abschnitt @options unter sp_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
Wird die ID einer bestimmten Ablaufverfolgung übergeben, 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 die Erweiterung *.trc an den Namen jeder Ablaufverfolgungsdatei an, die im 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 zum Verwenden gespeicherter Prozeduren der Ablaufverfolgung finden Sie unter Erstellen einer Ablaufverfolgung (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
Siehe auch
Aufgaben
Erstellen einer Ablaufverfolgung (Transact-SQL)
Verweis
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)