Dela via


sys.fn_MSxe_read_event_stream (Transact-SQL)

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

sys.fn_MSxe_read_event_stream returnerar binära data för intern användning av klassen QueryableXEventData .NET. Användargränssnittet för utökade händelser i SQL Server Management Studio (SSMS) använder den här klassen för att läsa händelsesessionsdata.

Om du vill visa händelsedata som kan läsas av människor använder du något av följande i stället för att anropa sys.fn_MSxe_read_event_stream direkt:

Transact-SQL syntaxkonventioner

Syntax

sys.fn_MSxe_read_event_stream ( source , source_option )

Arguments

källa

Den specifika källan för händelsedata som returneras av funktionen. Källan är nvarchar(260) utan standard.

Källan tolkas på olika sätt beroende på värdet för source_option:

source_option Tolkning av källa
0 Källan är namnet på en startad händelsesession.
1 Källan är sökvägen till loggfilerna för händelsesessionen som ska läsas.

När den används med filer i det lokala filsystemet måste källan innehålla namnet på en händelsesessionsloggfil och kan innehålla * som jokertecken.

När den används med blobar i en Azure Storage-container är källan en HTTP-URL som skapas av sammanlänkningen av två delar:

1. Sökvägen till en Azure Storage-lagringscontainer följt av ett snedstreck (/).
2. Ett vanligt prefix för namnen på blobar i containern som ska läsas.

Om du till exempel använder https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session som källa hämtas data från alla blobar med namn som börjar med xe_session, och oavsett resten av blobnamnet inklusive tillägget. Jokertecken kan inte anges. Det måste finnas en autentiseringsuppgift som ger åtkomst till Azure Storage-containern.

source_option

Det alternativ som avgör typen av händelsedatakälla. Möjliga värden är:

Värde Description
0 Returnerar händelsedata från event_stream mål för en startad händelsesession. Funktionen körs på obestämd tid och returnerar nya händelsedata när sessionen genererar den.
1 Returnerar händelsedata från de utökade händelseloggfiler som anges av källan.

Tabellen returnerades

Kolumnnamn Datatyp Description
type int Händelsetypen. Inte nullbar.
data image Binära händelsedata. Kan inte vara null.