Gestire sessioni di eventi in Esplora oggetti

Si applica a:SQL Serverdatabase SQL di AzureAzure SQL Istanza gestitaDatabase SQL in Microsoft Fabric

In questo argomento vengono illustrate le azioni eseguibili in Esplora oggetti che influiscono su Eventi estesi:

• Creare una sessione di eventi estesi

• Avviare o arrestare una sessione di Extended Events

• Esportare una sessione di Extended Events

• Importare un modello di sessione di Extended Events

• Modificare una sessione Eventi estesi

• Eliminare una sessione di Eventi estesi

Creare una sessione di eventi estesi

Per altre informazioni sulla creazione di una sessione Eventi estesi, vedere Create an Extended Events Session(Creare una sessione Eventi estesi).

Avviare o arrestare una sessione di Extended Events

È possibile avviare o arrestare una sessione eventi estesi tramite l'Editor di query usando l'istruzione ALTER EVENT SESSION oppure usando il nodo Eventi estesi di Esplora oggetti.

Quando si arresta una sessione di eventi, la sessione non è più elencata tra le sessioni attive nella visualizzazione a gestione dinamica (DMV) sys.dm_xe_sessions. La definizione della sessione rimane tuttavia intatta ed è possibile riavviare la sessione. Per rimuovere completamente una definizione di sessione, è necessario eliminare la sessione.

Per avviare o arrestare una sessione eventi estesi, è necessario disporre dell'autorizzazione ALTER ANY EVENT SESSION .

Quando si arresta una sessione che usa una destinazione in memoria, ad esempio buffer circolare, bucketing, associazione di eventi o destinazioni del contatore eventi sincrono, tutte le informazioni memorizzate nel buffer della sessione (nella colonna target_data della DMV sys.dm_xe_session_targets) verranno perse. Per accedere ai dati degli eventi dopo aver arrestato la sessione, è necessario salvare i dati prima dell'arresto della sessione oppure configurare la sessione in modo che venga utilizzata la destinazione file.

Avviare o arrestare una sessione di Extended Events usando l'Editor query

Per avviare una sessione, eseguire le istruzioni seguenti sostituendo session_name con il nome della sessione Eventi estesi:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = START  

Per arrestare una sessione, eseguire le istruzioni seguenti sostituendo session_name con il nome della sessione Eventi estesi:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = STOP  

Avviare o arrestare una sessione Eventi estesi in Esplora oggetti

Per avviare o arrestare una sessione Eventi estesi in Esplora oggetti, espandere i nodi Gestione, Eventi estesie Sessioni , fare clic con il pulsante destro del mouse su una sessione, quindi scegliere Avvia sessione o Arresta sessione.

Esportare un modello di sessione Eventi estesi

È possibile esportare una sessione Eventi estesi usando Esplora oggettie salvarla come file modello xml. Ad esempio, è possibile esportare una sessione, quindi applicare il modello a una nuova sessione eventi usando la Creazione guidata nuova sessione o la procedura guidata Nuova sessione .

Quando si esporta una sessione, assicurarsi di salvare il file modello in un percorso che utilizza il file system NTFS e di limitare l'accesso agli utenti autorizzati a visualizzare le informazioni.

Per esportare una sessione Eventi estesi in Esplora oggetti:

1. Espandere i nodi Gestione, Eventi estesi, quindi Sessioni .

2. Fare clic con il pulsante destro del mouse sulla sessione che si vuole esportare e selezionare Esporta sessione.

3. Nella finestra di dialogo Salva con nome selezionare un percorso in cui salvare il file, digitare il nome del file nella casella Nome file , quindi fare clic su Salva.

   Se si salva il file nel percorso predefinito dei modelli di SQL Server Management Studio, il modello verrà visualizzato nell'elenco a discesa dei modelli predefiniti quando si utilizza la Creazione guidata Nuova sessione e la finestra di dialogo Nuova sessione.

Importare un modello di sessione di Extended Events

Usando Esplora oggettiè possibile importare un modello per una sessione Eventi estesi. È possibile, ad esempio, effettuare questa operazione per creare una sessione da un modello esportato da un'altra istanza di SQL Server.

Per importare una sessione eventi estesi, è necessario disporre delle autorizzazioni ALTER ANY EVENT SESSION necessarie.

Prima di importare un file modello, verificare che il file provenga da una fonte attendibile. È necessario salvare i file modello in un percorso che utilizza il file system NTFS e in cui l'accesso è limitato agli utenti autorizzati a visualizzare le informazioni.

Per importare una sessione di Eventi estesi:

1. In Esplora oggetti, espandere i nodi Gestione e quindi Eventi estesi.

2. Fare clic con il pulsante destro del mouse su Sessioni e selezionare Nuova sessione.

3. Specificare un nome per la sessione.

4. Espandi il menu a discesa Template.

5. Fare clic su Apri file < da...> e cercare la sessione (file XML) da importare.

La sessione verrà visualizzata nel nodo Sessioni . Per impostazione predefinita,la sessione non viene avviata.

Modificare una sessione Eventi estesi

È possibile modificare una sessione Eventi estesi in Esplora oggetti.

Per modificare una sessione Extended Events:

1. In Esplora oggettiespandere i nodi Gestione, Eventi estesi, quindi Sessioni .

2. Fare clic con il pulsante destro del mouse su una sessione e selezionare Proprietà.

3. Nella sezione Selezione pagina selezionare la pagina o le pagine che si vuole modificare.

4. Dopo aver terminato di rivedere la sessione dell'evento, fare clic su OK.

Creare uno script per la definizione di una sessione eventi tramite Transact-SQL

Sia nella Creazione guidata Nuova sessione sia nella finestra di dialogo Nuova sessione è disponibile un'opzione Script che consente di generare il codice Transact-SQL che definisce la sessione Eventi estesi.

È possibile accedere al Transact-SQL di una sessione Eventi estesi esistente facendo clic con il pulsante destro del mouse sul nome della sessione, selezionando Crea script sessione come e quindi Crea in.

Eliminare una sessione di Eventi estesi

È possibile eliminare una sessione Eventi estesi:

• In Editor di query con DROP EVENT SESSION.

• In Esplora oggetti.

Quando si elimina una sessione eventi, tutte le informazioni di configurazione vengono rimosse e la definizione della sessione non viene più visualizzata nella vista del catalogo sys.server_event_sessions.

Per eliminare una sessione eventi estesi, è necessario disporre dell'autorizzazione ALTER ANY EVENT SESSION .

Per eliminare una sessione Eventi estesi in Esplora oggetti:

1. Espandere i nodi Gestione, Eventi estesi, quindi Sessioni .

2. Fare clic con il pulsante destro del mouse su una sessione e selezionare Elimina.

3. Nella finestra di dialogo Elimina oggetto fare clic su OK.

4. Dopo aver terminato di rivedere la sessione dell'evento, fare clic su OK.

Per eliminare una sessione Eventi estesi nell' Editor di query, eseguire le istruzioni seguenti, sostituendo session_name con il nome della sessione Eventi estesi da eliminare:

DROP EVENT SESSION [session_name]  
ON SERVER