sys.fn_MSxe_read_event_stream (Transact-SQL)

Gilt für:SQL Server Azure SQL-Datenbank Verwaltete Azure SQL-Instanz

sys.fn_MSxe_read_event_stream gibt Binärdaten für die interne Verwendung durch die QueryableXEventData .NET-Klasse zurück. Die Benutzeroberfläche für erweiterte Ereignisse in SQL Server Management Studio (SSMS) verwendet diese Klasse zum Lesen von Ereignissitzungsdaten.

Verwenden Sie zum Anzeigen von lesbaren Ereignisdaten eine der folgenden Optionen, anstatt direkt aufzurufen sys.fn_MSxe_read_event_stream :

Benutzeroberfläche für erweiterte Ereignisse in SSMS.
sys.fn_xe_file_target_read_file Tabellenwertfunktion.

Transact-SQL-Syntaxkonventionen

Syntax

sys.fn_MSxe_read_event_stream ( source , source_option )

Argumente

Quelle

Die spezifische Quelle von Ereignisdaten, die von der Funktion zurückgegeben werden. Die Quelle ist nvarchar(260) ohne Standard.

Die Quelle wird je nach dem Wert von source_option unterschiedlich interpretiert:

source_option Interpretation der Quelle

0 Die Quelle ist der Name einer gestarteten Ereignissitzung.

1 Die Quelle ist der Pfad zu den zu lesenden Ereignissitzungsprotokolldateien.

Wenn sie mit Dateien im lokalen Dateisystem verwendet wird, muss die Quelle den Namen einer Ereignissitzungsprotokolldatei enthalten und kann als Wildcard enthalten * .

Bei Verwendung mit Blobs in einem Azure Storage-Container ist die Quelle eine HTTP-URL, die durch die Verkettung von zwei Teilen erstellt wird:

1. Der Pfad zu einem Azure Storage-Speichercontainer, gefolgt von einem Schrägstrich (/).
2. Ein allgemeines Präfix für die Namen von Blobs im Container, die gelesen werden sollen.

Die Verwendung https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session als Quelle ruft z. B. Daten aus allen Blobs ab, bei deren Namen beginnen xe_session, und zwar unabhängig vom Rest des Blobnamens einschließlich der Erweiterung. Wildcards können nicht angegeben werden. Ein Anmeldeinformation, der den Zugriff auf den Azure Storage-Container zulässt, muss vorhanden sein.

source_option	Interpretation der Quelle
`0`	Die Quelle ist der Name einer gestarteten Ereignissitzung.
`1`	Die Quelle ist der Pfad zu den zu lesenden Ereignissitzungsprotokolldateien. Wenn sie mit Dateien im lokalen Dateisystem verwendet wird, muss die Quelle den Namen einer Ereignissitzungsprotokolldatei enthalten und kann als Wildcard enthalten `` . Bei Verwendung mit Blobs in einem Azure Storage-Container ist die Quelle* eine HTTP-URL, die durch die Verkettung von zwei Teilen erstellt wird: 1. Der Pfad zu einem Azure Storage-Speichercontainer, gefolgt von einem Schrägstrich (`/`). 2. Ein allgemeines Präfix für die Namen von Blobs im Container, die gelesen werden sollen. Die Verwendung `https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session` als Quelle ruft z. B. Daten aus allen Blobs ab, bei deren Namen beginnen `xe_session`, und zwar unabhängig vom Rest des Blobnamens einschließlich der Erweiterung. Wildcards können nicht angegeben werden. Ein Anmeldeinformation, der den Zugriff auf den Azure Storage-Container zulässt, muss vorhanden sein.

source_option

Die Option, die den Typ der Ereignisdatenquelle bestimmt. Mögliche Werte sind:

Wert	BESCHREIBUNG
`0`	Gibt Ereignisdaten aus dem event_stream Ziel einer gestarteten Ereignissitzung zurück. Die Funktion wird unbegrenzt ausgeführt und gibt neue Ereignisdaten zurück, wenn die Sitzung sie erzeugt.
`1`	Gibt Ereignisdaten aus den erweiterten Ereignisprotokolldateien zurück, die von der Quelle angegeben werden.

Zurückgegebene Tabelle

Spaltenname	Datentyp	BESCHREIBUNG
Typ	Int	Der Ereignistyp. Lässt keine NULL-Werte zu.
data	image	Binäre Ereignisdaten. Lässt NULL-Werte zu.

Feedback

War diese Seite hilfreich?

Last updated on 2025-09-10