Delen via

sys.fn_MSxe_read_event_stream (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

sys.fn_MSxe_read_event_stream retourneert binaire gegevens voor intern gebruik door de klasse QueryableXEventData .NET. De gebruikersinterface voor uitgebreide gebeurtenissen in SQL Server Management Studio (SSMS) gebruikt deze klasse om gebeurtenissessiegegevens te lezen.

Als u door mensen leesbare gebeurtenisgegevens wilt bekijken, gebruikt u een van de volgende opties in plaats van rechtstreeks aan te roepen sys.fn_MSxe_read_event_stream :

Transact-SQL syntaxis-conventies

Syntaxis

sys.fn_MSxe_read_event_stream ( source , source_option )

Arguments

bron

De specifieke bron van gebeurtenisgegevens die door de functie worden geretourneerd. Bron is nvarchar(260) zonder standaardwaarde.

De bron wordt anders geïnterpreteerd, afhankelijk van de waarde van source_option:

source_option Interpretatie van bron
0 Bron is de naam van een gestarte gebeurtenissessie.
1 Bron is het pad naar de logboekbestanden van de gebeurtenissessie die moeten worden gelezen.

Wanneer de bron wordt gebruikt met bestanden in het lokale bestandssysteem, moet de bron de naam van een gebeurtenissessielogboekbestand bevatten en kan deze bevatten * als een jokerteken.

Wanneer deze wordt gebruikt met blobs in een Azure Storage-container, is de bron een HTTP-URL die is samengesteld door de samenvoeging van twee delen:

1. Het pad naar een Azure Storage-opslagcontainer, gevolgd door een slash (/).
2. Een gemeenschappelijk voorvoegsel voor de namen van blobs in de container die moet worden gelezen.

Als u bijvoorbeeld als bron gebruikt, https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session worden gegevens opgehaald uit alle blobs met namen die beginnen metxe_session, en ongeacht de rest van de blobnaam, inclusief de extensie. Jokertekens kunnen niet worden opgegeven. Er moet een referentie zijn die toegang tot de Azure Storage-container toestaat.

source_option

De optie waarmee het type gebeurtenisgegevensbron wordt bepaald. Mogelijke waarden zijn:

Waarde Description
0 Retourneert gebeurtenisgegevens van het event_stream doel van een gestarte gebeurtenissessie. De functie wordt voor onbepaalde tijd uitgevoerd en retourneert nieuwe gebeurtenisgegevens terwijl de sessie deze produceert.
1 Retourneert gebeurtenisgegevens uit de uitgebreide gebeurtenislogboekbestanden die zijn opgegeven door de bron.

Tabel geretourneerd

Kolomnaam Gegevenstype Description
type int Het gebeurtenistype. Niet nullable.
gegevens image Binaire gebeurtenisgegevens. Is null-waarde.

Verwante inhoud