sys.fn_xe_file_target_read_file (Transact-SQL)
Liest Dateien, die vom asynchronen Dateiziel der erweiterten Ereignisse erstellt werden. Pro Zeile wird ein Ereignis im XML-Format zurückgegeben.
Vorsicht |
---|
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. |
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.Hinweis 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.Hinweis 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)