sys.fn_xe_file_target_read_file (Transact-SQL)

  • Artikel

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

VorsichtshinweisVorsicht

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.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

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

  • mdpath
    Der Pfad zur Metadatendatei, die der Datei oder den Dateien entspricht, die vom path-Argument angegeben werden. mdpath ist nvarchar(260). Es gibt keinen Standardwert.

    HinweisHinweis

    SQL Server 2012 erfordert keinen 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, die aus path gelesen werden soll. initial_file_name ist 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
    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 als Argument angegeben wird, wird die gesamte Datei gelesen.

Zurückgegebene Tabelle

Spaltenname

Datentyp

Beschreibung

module_guid

uniqueidentifier

Die Ereignismodul-GUID. NULL ist nicht zulässig.

package_guid

uniqueidentifier

Die Ereignispaket-GUID. NULL ist nicht zulässig.

object_name

nvarchar(256)

Der Name des Ereignisses. NULL ist nicht zulässig.

event_data

nvarchar(max)

Der Ereignisinhalt im XML-Format. NULL ist nicht zulässig.

file_name

nvarchar(260)

Der Name der Datei, die das Ereignis enthält. NULL ist nicht zulässig.

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);

Siehe auch

Verweis

Dynamische Verwaltungssichten für erweiterte Ereignisse

Katalogsichten für erweiterte Ereignisse (Transact-SQL)

Konzepte

Erweiterte Ereignisse