sys.fn_trace_gettable (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Gibt den Inhalt mindestens einer Ablaufverfolgungsdatei in Tabellenform 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_gettable ( 'filename' , number_files )

Argumente

'filename'
Gibt die erste Ablaufverfolgungsdatei an, die gelesen werden soll. Filename is nvarchar(256), with no default.

number_files
Gibt die Anzahl der zu lesenden Rolloverdateien an. Diese Zahl enthält die ursprüngliche Datei, die im Dateinamen angegeben ist. number_files ist ein Int.

Hinweise

Wenn number_files standardmäßig angegeben ist, liest fn_trace_gettable alle Rolloverdateien, bis sie das Ende der Ablaufverfolgung erreicht. fn_trace_gettable gibt eine Tabelle zurück, deren Spalten für die angegebene Ablaufverfolgung gültig sind. Weitere Informationen finden Sie unter sp_trace_setevent (Transact-SQL).For more information, see sp_trace_setevent (Transact-SQL).

Beachten Sie, dass die fn_trace_gettable-Funktion keine Rolloverdateien lädt (wenn diese Option mithilfe des Arguments number_files angegeben wird), wobei der ursprüngliche Ablaufverfolgungsdateiname mit einem Unterstrich und einem numerischen Wert endet. (Dies gilt nicht für den Unterstrich und die Nummer, die automatisch angefügt wird, wenn eine Datei überrollt.) Als Problemumgehung können Sie die Ablaufverfolgungsdateien umbenennen, um die Unterstriche im ursprünglichen Dateinamen zu entfernen. Wenn die Originaldatei beispielsweise Trace_Oct_5.trc benannt ist und die Rolloverdatei Trace_Oct_5_1.trc heißt, können Sie die Dateien in TraceOct5.trc und TraceOct5_1.trc umbenennen.

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 AdventureWorks2022;  
GO  
SELECT * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.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 AdventureWorks2022;  
GO  
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);  
GO

Weitere Informationen

sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)