• Artikel

sys.fn_xe_file_target_read_file (Transact-SQL)

Liest Dateien, die vom asynchronen Dateiziel von Extended Events erstellt werden. Pro Zeile wird ein Ereignis im XML-Format zurückgegeben.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • path
    Der Pfad der zu lesenden Dateien. path kann Platzhalter und den Namen einer Datei enthalten. path ist vom Datentyp nvarchar(260). Es gibt keinen Standardwert.

  • mdpath
    Der Pfad der Metadatendatei, die zu der mit dem path-Argument angegebenen Datei bzw. Dateigruppe gehört. mdpath ist vom Datentyp nvarchar(260). Es gibt keinen Standardwert.

  • initial_file_name
    Die erste zu lesende Datei unter path. initial_file_name ist vom Datentyp nvarchar(260). Es gibt keinen Standardwert. Wenn null als Argument angegeben wird, werden alle in path gefundenen Dateien gelesen.

    HinweisHinweis

    initial_file_name und initial_offset sind 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
    Der Offset in der ersten Datei, bei dem der Lesevorgang beginnt. initial_offset ist vom Datentyp bigint. Wenn null als Argument angegeben wird, wird die gesamte Datei gelesen.

Zurückgegebene Tabelle

Spaltenname

Datentyp

Beschreibung

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_name

nvarchar(256)

Der Name des Ereignisses. Lässt keine NULL-Werte zu.

event_data

nvarchar(max)

Der Ereignisinhalt im XML-Format. Lässt keine NULL-Werte zu.

file_name

nvarchar(260)

Der Name der Datei, die das Ereignis enthält. Lässt keine NULL-Werte zu.

file_offset

bigint

Der Offset des Blocks in der Datei, der das Ereignis enthält. Lässt keine NULL-Werte zu.

Berechtigungen

Erfordert die VIEW SERVER STATE-Berechtigung auf dem Server.

Beispiele

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)