sys.fn_xe_file_target_read_file (Transact-SQL)

 

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)jaAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse

Liest Dateien, die vom asynchronen Dateiziel der erweiterten Ereignisse erstellt werden. Pro Zeile wird ein Ereignis im XML-Format zurückgegeben.

System_CAPS_ICON_warning.jpg Warnung


SQL Server 2008 und SQL Server 2008 R2 akzeptieren im XEL- und XEM-Format generierte Ablaufverfolgungsergebnisse. SQL Server 2012Erweiterte Ereignisse unterstützen nur Ablaufverfolgungsergebnisse im XEL-Format. Verwenden Sie SQL Server Management Studio, um Ablaufverfolgungsergebnisse im XEL-Format lesen zu können.

Topic link icon Transact-SQL-Syntaxkonventionen

  
sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )  

Pfad
Der Pfad zu den zu lesenden Dateien. Pfad kann Platzhalter und enthalten den Namen einer Datei. Pfad ist nvarchar(260). Es gibt keinen Standardwert. Im Kontext der Azure SQL-Datenbank ist dieser Wert eine HTTP-URL in eine Datei im Azure-Speicher.

mdpath
Der Pfad zur Metadatendatei, die die Datei oder die angegebenen Dateien entspricht der Pfad Argument. Mdpath ist nvarchar(260). Es gibt keinen Standardwert. Beginnend mit SQL Server 2016, kann dieser Parameter als null angegeben werden.

System_CAPS_ICON_note.jpg Hinweis


SQL Server 2012erfordert keine der Mdpath Parameter. Er wird jedoch beibehalten, um die Abwärtskompatibilität für in früheren Versionen von SQL Server erstellte Protokolldateien aufrechtzuerhalten.

"initial_file_name"
Die erste Datei zum Lesen aus Pfad. "initial_file_name" ist nvarchar(260). Es gibt keinen Standardwert. Wenn null wird angegeben, wie das Argument, das alle Dateien aus Pfad gelesen werden.

System_CAPS_ICON_note.jpg Hinweis


"initial_file_name" und Initial_offset werden paarargumente. Wenn Sie einen Wert für eines der beiden Argumente angeben, müssen Sie auch einen Wert für das andere Argument angeben.

initial_offset
Wird verwendet, um den letzten zuvor gelesenen Offset anzugeben und überspringt alle Ereignisse bis (einschließlich) des Offsets. Die Ereignisenumeration startet nach dem angegebenen Offset. Initial_offset ist "bigint". Wenn null wird angegeben, wie das Argument die gesamte Datei gelesen werden.

SpaltennameDatentypDescription
module_guid"uniqueidentifier"Die Ereignismodul-GUID. Lässt keine NULL-Werte zu.
package_guid"uniqueidentifier"Die Ereignispaket-GUID. Lässt keine NULL-Werte zu.
object_namenvarchar (256)Der Name des Ereignisses. Lässt keine NULL-Werte zu.
event_datanvarchar(max)Der Ereignisinhalt im XML-Format. Lässt keine NULL-Werte zu.
file_namenvarchar(260)Der Name der Datei, die das Ereignis enthält. Lässt keine NULL-Werte zu.
file_offsetbigintDer Offset des Blocks in der Datei, der das Ereignis enthält. Lässt keine NULL-Werte zu.

Das Lesen großer Resultsets durch Ausführen legt fn_xe_file_target_read_file in Management Studio kann zu einem Fehler führen. Verwenden der Ergebnisse in Datei Modus (STRG + UMSCHALT + F) großen Resultsets in eine Datei exportieren und Lesen Sie die Datei mit einem anderen Tool stattdessen.

Erfordert die VIEW SERVER STATE-Berechtigung auf dem Server.

A. Abrufen von Daten aus Dateizielen

Im folgenden Beispiel werden alle Zeilen aus allen Dateien abgerufen. In dieser Beispieldatei befinden sich die Dateiziele und Metadateien im Ablaufverfolgungsordner auf dem Laufwerk C:.

SELECT * FROM sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null);  

Dynamische Verwaltungssichten für erweiterte Ereignisse
Katalogsichten für erweiterte Ereignisse (Transact-SQL)
Erweiterte Ereignisse

Community-Beiträge

HINZUFÜGEN
Anzeigen: