Dela via

sys.dm_xe_objects (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-databas i Microsoft Fabric

Returnerar en rad för varje objekt som exponeras av ett händelsepaket. Objekt kan vara ett av följande:

  • Evenemang. Händelser indikerar intressanta punkter i en avrättningsväg. Alla evenemang innehåller information om en intressant punkt.

  • Åtgärder. Handlingar körs synkront när händelser utlöses. En åtgärd kan lägga till körtidsdata till en händelse.

  • Mål. Mål konsumerar händelser, antingen synkront på tråden som utlöser händelsen eller asynkront på en systemtillhandahållen tråd.

  • Predikat. Predikatkällor hämtar värden från händelsekällor för användning i jämförelseoperationer. Predikatjämförelser jämför specifika datatyper och returnerar ett boolesk värde.

  • Typer. Typer kapslar in längden och egenskaperna hos bytesamlingen, vilket krävs för att tolka datan.

Kolumnnamn Datatyp Description
name nvarchar(60) Namnet på objektet. namnet är unikt inom ett paket för en specifik objekttyp. Får inte vara ogiltig.
object_type nvarchar(60) Typ av objekt. object_type är en av följande:

händelse

åtgärd

mål

pred_source

pred_compare

type

Får inte vara ogiltig.
package_guid uniqueidentifier GUID för paketet som exponerar denna åtgärd. Det finns en många-till-en-relation med sys.dm_xe_packages.package_id. Får inte vara ogiltig.
beskrivning nvarchar(256) En beskrivning av handlingen. Beskrivningen ställs in av paketförfattaren. Får inte vara ogiltig.
capabilities int En bitmap som beskriver objektets kapaciteter. Kan inte vara null.
capabilities_desc nvarchar(256) Listar alla objektets kapaciteter. Kan inte vara null.

Kapabiliteter som gäller för alla objekttyper

-
Privat. Det enda objektet som är tillgängligt för intern användning, och som inte kan nås via CREATE/ALTER EVENT SESSION DDL. Revisionshändelser och mål faller inom denna kategori utöver ett fåtal objekt som används internt.

===============

Händelsekapabiliteter

-
No_block. Händelsen befinner sig i en kritisk kodväg som inte kan blockeras av någon anledning. Händelser med denna funktion får inte läggas till i någon händelsesession som specificerar NO_EVENT_LOSS.

===============

Kapabiliteter som gäller för alla objekttyper

-
Process_whole_buffers. Målet förbrukar buffertar av händelser åt gången, istället för händelse för händelse.

-
Singel. Endast en instans av målet kan existera i en process. Även om flera händelsesessioner kan referera till samma enskilda mål finns det egentligen bara en instans, och den instansen ser varje unik händelse bara en gång. Detta är viktigt om målet läggs till i flera sessioner som alla samlar in samma händelse.

-
Synkront. Målet exekveras på tråden som producerar händelsen, innan kontrollen återlämnas till den anropande kodraden.
type_name nvarchar(60) Namnet på pred_source och pred_compare objekt. Kan inte vara null.
type_package_guid uniqueidentifier GUID:n för paketet som exponerar typen som detta objekt arbetar med. Kan inte vara null.
type_size int Storleken, i bytes, för datatypen. Detta gäller endast giltiga objekttyper. Kan inte vara null.

Permissions

Kräver behörighet VIEW SERVER STATE på servern.

Behörigheter för SQL Server 2022 och senare

Kräver BEHÖRIGHET FÖR VISNINGSSERVERNS PRESTANDATILLSTÅND på servern.

Relations kardinaliteter

Från Till Förhållande
sys.dm_xe_objects.package_guid sys.dm_xe_packages.guid Många-till-en

Nästa steg

Läs mer om relaterade begrepp i följande artiklar:

  • Last updated on