Pacchetti degli Eventi estesi

Si applica a: SQL Server, Database SQL di Azure e Istanza gestita di SQL di Azure

Un pacchetto è un contenitore per oggetti Eventi estesi nel motore di database di SQL Server. Ad esempio, i seguenti pacchetti esistono in qualsiasi motore di database che supporta gli eventi estesi:

I pacchetti sono identificati da un nome, da un GUID e dal modulo binario che contiene il pacchetto. Un modulo può essere un file eseguibile o una libreria a collegamento dinamico (DLL). Per altre informazioni, vedere sys.dm_xe_packages.

Un pacchetto può contenere alcuni o tutti gli oggetti seguenti, che vengono discussi in maggior dettaglio più avanti in questo articolo:

• Eventi
• Target
• Azioni
• Tipi
• Predicati
• Mappe

Oggetti da pacchetti diversi possono essere combinati in una sessione dell'evento. Per altre informazioni, vedere Sessioni di Eventi estesi.

Contenuto del pacchetto

La figura seguente illustra gli oggetti che possono esistere in un pacchetto.

Eventi

Gli eventi monitorano i punti di interesse nel percorso di esecuzione di un programma, ad esempio SQL Server. Quando viene generato un evento, contiene il fatto che il punto di interesse è stato raggiunto e fornisce informazioni sullo stato derivanti dall'ora in cui l'evento è stato generato.

Gli eventi possono essere utilizzati solamente per scopi di traccia o per azioni di trigger. Queste azioni possono essere sincrone o asincrone.

Un set di eventi in un pacchetto non può essere modificato dopo che il pacchetto viene registrato con gli eventi estesi.

A tutti gli eventi è associato uno schema con versione che ne definisce il contenuto. Questo schema è costituito da colonne di evento con tipi definiti. Un evento di un tipo specifico deve sempre fornire i propri dati nell'ordine esatto specificato nello schema. Una destinazione dell'evento non deve tuttavia utilizzare tutti i dati forniti.

Categorizzazione dell'evento

Negli eventi estesi viene utilizzato un modello di categorizzazione dell'evento simile a Analisi eventi per Windows (ETW). Due proprietà dell'evento sono utilizzate per categorizzazione, canale e parola chiave. L'utilizzo di queste proprietà supporta l'integrazione degli eventi estesi con ETW e i suoi strumenti.

Un canale identifica il pubblico per un evento. I canali sono descritti nella tabella seguente.

Una parola chiave è specifica dell'applicazione e abilita un raggruppamento più preciso di eventi correlati, ciò rende più facile specificare e recuperare un evento che si desidera utilizzare in una sessione. È possibile utilizzare la seguente query ottenere informazioni sulla parola chiave:

SELECT map_value AS Keyword
FROM sys.dm_xe_map_values
WHERE name = 'keyword_map';

Target

Le destinazioni sono consumer di eventi. Le destinazioni elaborano gli eventi, in modo sincrono nel thread che genera l'evento o in modo asincrono in un thread fornito dal sistema. Gli eventi estesi forniscono diversi tipi di destinazione che è possibile utilizzare in base alle proprie esigenze per indirizzare l'output dell'evento. Per ulteriori informazioni, vedere Destinazioni per gli Eventi estesi.

La clausola ADD TARGET consente di aggiungere destinazioni a una sessione eventi.

Azioni

Un'azione è una risposta o una serie di risposte a un evento a livello di programmazione. Le azioni sono associate a un evento e a ogni evento può essere associato il proprio set di azioni.

Un'azione associata a un evento viene richiamata in modo sincrono sul thread che ha attivato l'evento. Vi sono molti tipi di azioni e hanno un'ampia gamma di funzionalità. Le azioni possono:

• Acquisire un backup del processo
• Archiviare informazioni sullo stato in un contesto locale utilizzando l'archiviazione variabile
• Aggregare dati dell'evento
• Accodare dati ai dati dell'evento

Alcuni esempi di utilizzo delle azioni sono:

• Raccogliere il testo SQL di una query eseguita dalla conversazione che genera l'evento
• Raccogliere l'handle del piano di query, l'hash della query e l'hash del piano di query
• Raccogliere gli attributi di una sessione che causa la generazione dell'evento, tra cui nome host client, nome dell'entità di sicurezza, ID connessione e così via.
• Raccoglie lo stack di chiamate
• Acquisire un backup di processo quando si verifica un errore specifico

La clausola ACTION consente di aggiungere azioni a una sessione eventi.

Predicati

I predicati rappresentano un set di regole logiche utilizzate per valutare gli eventi quando vengono elaborati. I predicati consentono all'utente degli eventi estesi di acquisire selettivamente i dati dell'evento in base a criteri specifici.

I predicati possono archiviare i dati in un contesto locale che può essere usato per creare predicati che restituiscono True ogni n minuti o ogni n volte che un evento viene generato. È possibile usare questa archiviazione del contesto locale anche per aggiornare dinamicamente il predicato, sopprimendo con ciò le generazioni future dell'evento se l'evento contiene dati simili.

I predicati hanno la possibilità di recuperare informazioni sul contesto, ad esempio l'ID del thread, così come dati specifici sull'evento. I predicati sono valutati come espressioni booleane complete e supportano operazioni di corto circuito nel primo punto dove viene individuato che l'intera l'espressione è falsa.

La clausola WHERE consente di aggiungere predicati a una sessione eventi.

Tipi

In un pacchetto ogni oggetto Eventi estesi ha un tipo. Di seguito sono elencati i tipi usati:

• action
• event
• message
• pred_compare
• pred_source
• target
• type

Per altre informazioni, vedere sys.dm_xe_objects.

Mappe

Una tabella della mappa esegue il mapping di un valore interno a una stringa e ciò consente a un utente di conoscere ciò che rappresenta il valore. Anziché essere in grado di ottenere solo un valore numerico, un utente può ottenere una descrizione significativa del valore interno. Nella query seguente si illustra come ottenere valori della mappa.

SELECT map_key,
       map_value
FROM sys.dm_xe_map_values
WHERE name = 'lock_mode';

La query precedente produce l'output seguente:

Utilizzare tabella come esempio, supponendo di avere una lock_mode di colonna denominata il cui valore è 5. La tabella indica che è stato eseguito il mapping di 5 aXX, ovvero il tipo di blocco è Esclusivo.

Contenuto correlato

• Sessioni degli Eventi estesi
• Motore degli Eventi estesi
• Destinazioni degli Eventi estesi