sys.fn_xe_file_target_read_file (Transact-SQL)sys.fn_xe_file_target_read_file (Transact-SQL)

GILT FÜR: jaSQL ServerjaAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Liest Dateien, die vom asynchronen Dateiziel der erweiterten Ereignisse erstellt werden.Reads files that are created by the Extended Events asynchronous file target. Pro Zeile wird ein Ereignis im XML-Format zurückgegeben.One event, in XML format, is returned per row.

Warnung

SQL Server 2008SQL Server 2008 und SQL Server 2008 R2SQL Server 2008 R2 akzeptieren im XEL-und XEM generierte Ablaufverfolgungsergebnisse.and SQL Server 2008 R2SQL Server 2008 R2 accept trace results generated in XEL and XEM format. SQL Server 2012 (11.x)SQL Server 2012 (11.x) Erweiterte Ereignisse-unterstützen nur Ablaufverfolgungsergebnisse im XEL-Format.Extended Events only support trace results in XEL format. Verwenden Sie SQL Server Management Studio, um Ablaufverfolgungsergebnisse im XEL-Format lesen zu können.We recommend that you use SQL Server Management Studio to read trace results in XEL format.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

pathpath
Der Pfad zu den zu lesenden Dateien.The path to the files to read. Pfad kann Platzhalter und enthalten den Namen einer Datei enthalten.path can contain wildcards and include the name of a file. Pfad ist nvarchar(260) .path is nvarchar(260). Es gibt keinen Standardwert.There is no default. Im Kontext von Azure SQL-Datenbank ist dieser Wert eine HTTP-URL in eine Datei im Azure-Speicher.In the context of Azure SQL Database, this value is an HTTP URL to a file in Azure Storage.

mdpathmdpath
Der Pfad zur Metadatendatei, die der angegebenen Datei bzw. Dateigruppe von entspricht, dem Pfad Argument.The path to the metadata file that corresponds to the file or files specified by the path argument. Mdpath ist nvarchar(260) .mdpath is nvarchar(260). Es gibt keinen Standardwert.There is no default. Ab SQL Server 2016 wird kann dieser Parameter als null angegeben werden.Starting with SQL Server 2016, this parameter can be given as null.

Hinweis

SQL Server 2012 (11.x)SQL Server 2012 (11.x) erfordert keine der Mdpath Parameter.does not require the mdpath parameter. Er wird jedoch beibehalten, um die Abwärtskompatibilität für in früheren Versionen von SQL Server erstellte Protokolldateien aufrechtzuerhalten.However, it is maintained for backward compatibility for log files generated in previous versions of SQL Server.

initial_file_nameinitial_file_name
Die erste Datei zum Lesen aus Pfad.The first file to read from path. ' initial_file_name ' ist nvarchar(260) .initial_file_name is nvarchar(260). Es gibt keinen Standardwert.There is no default. Wenn null angegeben ist, als das Argument, das alle Dateien finden Sie in Pfad gelesen werden.If null is specified as the argument all the files found in path are read.

Hinweis

' initial_file_name ' und Initial_offset sind paarargumente.initial_file_name and initial_offset are paired arguments. Wenn Sie einen Wert für eines der beiden Argumente angeben, müssen Sie auch einen Wert für das andere Argument angeben.If you specify a value for either argument you must specify a value for the other argument.

initial_offsetinitial_offset
Wird verwendet, um den letzten zuvor gelesenen Offset anzugeben und überspringt alle Ereignisse bis (einschließlich) des Offsets.Used to specify last offset read previously and skips all events up to the offset (inclusive). Die Ereignisenumeration startet nach dem angegebenen Offset.Event enumeration starts after the offset specified. Initial_offset ist Bigint.initial_offset is bigint. Wenn null wird angegeben, wie das Argument die gesamte Datei gelesen werden.If null is specified as the argument the entire file will be read.

Zurückgegebene TabelleTable Returned

SpaltennameColumn name DatentypData type BeschreibungDescription
module_guidmodule_guid uniqueidentifieruniqueidentifier Die Ereignismodul-GUID.The event module GUID. Lässt keine NULL-Werte zu.Is not nullable.
package_guidpackage_guid uniqueidentifieruniqueidentifier Die Ereignispaket-GUID.The event package GUID. Lässt keine NULL-Werte zu.Is not nullable.
object_nameobject_name nvarchar(256)nvarchar(256) Der Name des Ereignisses.The name of the event. Lässt keine NULL-Werte zu.Is not nullable.
event_dataevent_data nvarchar(max)nvarchar(max) Der Ereignisinhalt im XML-Format.The event contents, in XML format. Lässt keine NULL-Werte zu.Is not nullable.
file_namefile_name nvarchar(260)nvarchar(260) Der Name der Datei, die das Ereignis enthält.The name of the file that contains the event. Lässt keine NULL-Werte zu.Is not nullable.
file_offsetfile_offset bigintbigint Der Offset des Blocks in der Datei, der das Ereignis enthält.The offset of the block in the file that contains the event. Lässt keine NULL-Werte zu.Is not nullable.
timestamp_utctimestamp_utc datetime2datetime2 Gilt für: SQL Server 2017 (14.x)SQL Server 2017 (14.x) bis SQL Server 2017SQL Server 2017 und Azure SQL-DatenbankAzure SQL Database.Applies to: SQL Server 2017 (14.x)SQL Server 2017 (14.x) through SQL Server 2017SQL Server 2017 and Azure SQL-DatenbankAzure SQL Database.

Das Datum und Uhrzeit (UTC-Zeitzone) des Ereignisses.The date and time (UTC timezone) of the event. Lässt keine NULL-Werte zu.Is not nullable.

HinweiseRemarks

Das Lesen großer Resultsets wird festgelegt, indem Sie Ausführung fn_xe_file_target_read_file in Management StudioManagement Studio kann zu einem Fehler führen.Reading large result sets by executing sys.fn_xe_file_target_read_file in Management StudioManagement Studio may result in an error. Verwenden der Ergebnisse in Datei Modus (STRG + UMSCHALT + F) große Resultsets in eine Datei exportieren, und Lesen Sie stattdessen die Datei mit einem anderen Tool.Use the Results to File mode (Ctrl+Shift+F) to export large result sets to a file and read the file with another tool instead.

BerechtigungenPermissions

Erfordert die VIEW SERVER STATE-Berechtigung auf dem Server.Requires VIEW SERVER STATE permission on the server.

BeispieleExamples

A.A. Abrufen von Daten aus DateizielenRetrieving data from file targets

Im folgenden Beispiel werden alle Zeilen aus allen Dateien abgerufen.The following example gets all the rows from all the files. In dieser Beispieldatei befinden sich die Dateiziele und Metadateien im Ablaufverfolgungsordner auf dem Laufwerk C:.In this example the file targets and metafiles are located in the trace folder on the C:\ drive.

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

Siehe auchSee Also

Dynamische Verwaltungssichten für erweiterte Ereignisse Extended Events Dynamic Management Views
Katalogsichten für erweiterte Ereignisse (Transact-SQL) Extended Events Catalog Views (Transact-SQL)
Erweiterte EreignisseExtended Events