sys.fn_trace_getfilterinfo (Transact-SQL)

Artikel
03/12/2024

Gibt Informationen über die auf eine angegebene Ablaufverfolgung angewendeten Filter 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

  
fn_trace_getfilterinfo ( trace_id )

Argumente

trace_id
Die ID der Ablaufverfolgung. trace_id ist "int" ohne Standard.

Zurückgegebene Tabellen

Gibt die folgenden Informationen zurück. Weitere Informationen zu den Spalten finden Sie unter sp_trace_setfilter (Transact-SQL).

Spaltenname	Datentyp	Beschreibung
Columnid	int	Die ID der Spalte, auf die der Filter angewendet wird
logical_operator	int	Gibt an, ob der Operator AND oder OR angewendet wird
comparison_operator	int	Gibt die Art des Vergleichs an: 0 = Gleich 1 = Ungleich 2 = Größer als 3 = Kleiner als 4 = Größer als oder gleich 5 = Kleiner als oder gleich 6 = Wie 7 = Nicht wie
value	sql_variant	Gibt den Wert an, auf den der Filter angewendet wird

Hinweise

Der Benutzer legt trace_id Wert fest, um die Ablaufverfolgung zu identifizieren, zu ändern und zu steuern. Wenn die ID einer bestimmten Ablaufverfolgung übergeben wird, gibt fn_trace_getfilterinfo Informationen zu jedem Filter für diese Ablaufverfolgung zurück. Wenn die angegebene Ablaufverfolgung keinen Filter aufweist, gibt diese Funktion ein leeres Rowset zurück. Wird eine ungültige ID übergeben, gibt die Funktion ein leeres Rowset zurück. Ähnliche Informationen zu Ablaufverfolgungen finden Sie unter sys.fn_trace_getinfo (Transact-SQL).

Berechtigungen

Erfordert die ALTER TRACE-Berechtigung auf dem Server.

Beispiele

Das folgende Beispiel gibt Informationen zu allen Filtern der Ablaufverfolgung Nummer 2 zurück.

SELECT * FROM fn_trace_getfilterinfo(2) ;  
GO

Weitere Informationen

Erstellen einer Ablaufverfolgung (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setstatus (Transact-SQL)
sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_getinfo (Transact-SQL)
sys.fn_trace_gettable (Transact-SQL)