fn_trace_gettable (Transact-SQL)
Gibt den Inhalt von mindestens einer Ablaufverfolgungsdatei in Tabellenform zurück.
.gif "Themenlink (Symbol)")
Transact-SQL-Syntaxkonventionen
Syntax
fn_trace_gettable ( filename , number_files )
Argumente
- filename
Gibt die erste zu lesende Ablaufverfolgungsdatei an. filename ist vom Datentyp nvarchar(256) und weist keinen Standardwert auf.
- number_files
Gibt die Anzahl der zu lesenden Rolloverdateien an. Diese Anzahl schließt die in filename angegebene erste Datei ein. number_files ist vom Datentyp int.
Hinweise
Wenn number_files als default angegeben wird, liest fn_trace_gettable alle Rolloverdateien, bis das Ende der Ablaufverfolgung erreicht ist. fn_trace_gettable gibt eine Tabelle mit allen für die angegebene Ablaufverfolgung gültigen Spalten zurück. Weitere Informationen finden Sie unter sp_trace_setevent (Transact-SQL).
Diese Funktion kann eine Ablaufverfolgung lesen, die noch auf der Instanz aktiv ist, auf der sie ausgeführt wird.
Berechtigungen
Erfordert die ALTER TRACE-Berechtigung auf dem Server.
Beispiele
A. Verwenden von fn_trace_gettable zum Importieren von Zeilen aus einer Ablaufverfolgungsdatei
Im folgenden Beispiel wird fn_trace_gettable innerhalb der FROM-Klausel einer SELECT...INTO-Anweisung aufgerufen.
USE AdventureWorks;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\my_trace.trc', default);
GO
B. Verwenden von fn_trace_gettable zum Zurückgeben einer Tabelle mit einer IDENTITY-Spalte, die in eine SQL Server-Tabelle geladen werden kann
Im folgenden Beispiel wird die Funktion als Teil einer SELECT...INTO-Anweisung aufgerufen. Die Funktion gibt eine Tabelle mit einer IDENTITY-Spalte zurück, die in die temp_trc-Tabelle geladen werden kann.
USE AdventureWorks;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\my_trace.trc', default);
GO
Siehe auch
Verweis
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)