sys.fn_MSxe_read_event_stream (Transact-SQL)

platí pro: SQL Server Azure SQL DatabaseAzure SQL Managed Instance

sys.fn_MSxe_read_event_stream vrátí binární data pro interní použití třídy QueryableXEventData .NET. Uživatelské rozhraní rozšířených událostí v aplikaci SQL Server Management Studio (SSMS) používá tuto třídu ke čtení dat relace událostí.

Pokud chcete zobrazit data událostí čitelných pro člověka, použijte místo přímého volání sys.fn_MSxe_read_event_stream jednu z následujících možností:

• Uživatelské rozhraní rozšířených událostí v nástroji SSMS
• sys.fn_xe_file_target_read_file tabulkové funkce.

Transact-SQL konvence syntaxe

Syntaxe

sys.fn_MSxe_read_event_stream ( source , source_option )

Arguments

zdroj

Konkrétní zdroj dat událostí vrácených funkcí. Zdroj je nvarchar(260) bez výchozího nastavení.

Zdroj se interpretuje odlišně v závislosti na hodnotě source_option:

source_option	Interpretace zdroje
0	Zdroj je název spuštěné relace událostí.
1	Zdroj je cesta k souborům protokolu relace událostí ke čtení. Při použití se soubory v místním systému souborů musí zdroj obsahovat název souboru protokolu relace událostí a může obsahovat * jako zástupný znak. Při použití s objekty blob v kontejneru Azure Storage je zdrojem adresa URL HTTP používaná zřetězením dvou částí: 1. Cesta ke kontejneru úložiště Azure Storage následovaná lomítkem (/). 2. Běžná předpona pro názvy objektů blob v kontejneru, které by se měly číst. Například použití https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session jako zdroje načte data ze všech objektů blob s názvy začínajícími xe_sessionna a bez ohledu na zbytek názvu objektu blob včetně rozšíření. Zástupné cardy nelze zadat. Přihlašovací údaje umožňující přístup ke kontejneru Azure Storage musí existovat.

source_option

Možnost, která určuje typ zdroje dat události. Možné hodnoty:

Hodnota	Description
0	Vrátí data události z event_stream cíle spuštěné relace událostí. Funkce se spustí po neomezenou dobu a vrací nová data událostí, jakmile je relace vytvoří.
1	Vrátí data události z rozšířených souborů protokolu událostí určených zdrojem.

Vrácená tabulka

Název sloupce	Datový typ	Description
typ	int	Typ události. Nelze použít hodnotu null.
data	image	Binární data událostí. Je nullable.

Související obsah

• Zobrazení dynamické správy rozšířených událostí
• Zobrazení katalogu rozšířených událostí (Transact-SQL)
• přehled rozšířených událostí