Verwalten von Ereignissitzungen im Objekt-Explorer

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzSQL-Datenbank in Microsoft Fabric

In diesem Thema werden die Aktionen erläutert, die Sie im Objekt-Explorer ausführen können und die sich auf erweiterte Ereignisse auswirken:

• Erstellen einer Extended Events-Sitzung

• Starten oder Beenden einer Extended Events-Sitzung

• Exportieren einer Sitzung für erweiterte Ereignisse

• Eine Vorlage für eine Extended Events-Sitzung importieren

• Eine Extended Events-Sitzung bearbeiten

• Eine Extended Events-Sitzung löschen

Erstellen einer Extended Events-Sitzung

Weitere Informationen zum Erstellen einer Sitzung für erweiterte Ereignisse finden Sie unter Erstellen einer Sitzung für erweiterte Ereignisse.

Starten oder Beenden einer Extended Events-Sitzung

Sie können eine erweiterte Ereignissitzung über die Abfrage-Editor mithilfe der ALTER EVENT SESSION Anweisung oder mithilfe des Knotens "Erweiterte Ereignisse" von Objekt-Explorer starten oder beenden.

Wenn Sie eine Ereignissitzung beenden, wird die Sitzung in der dynamischen Verwaltungssicht (dynamic management view; DMV) von „sys.dm_xe_sessions“ nicht mehr als aktive Sitzung aufgeführt. Die Sitzungsdefinition bleibt jedoch intakt, und Sie können die Sitzung neu starten. Um eine Sitzungsdefinition vollständig zu entfernen, müssen Sie die Sitzung löschen.

Zum Starten oder Beenden einer Extended Events-Sitzung müssen Sie über die Berechtigung ALTER ANY EVENT SESSION verfügen.

Beim Beenden einer Sitzung, die ein Arbeitsspeicherziel verwendet, z.B. den Ringpuffer, Buckets, Ereignispaarung oder synchrone Ereigniszählerziele, gehen die gesamten im Puffer der Sitzung gespeicherten Informationen (die target_data-Spalte der „sys.dm_xe_session_targets“-DMV) verloren. Um auch nach dem Beenden der Sitzung auf die Ereignisdaten zugreifen zu können, sollten Sie die Daten speichern, bevor Sie die Sitzung beenden, oder die Sitzung so konfigurieren, dass sie das Dateiziel verwendet.

Eine Extended Events-Sitzung mit dem Abfrage-Editor starten oder beenden

Geben Sie die folgenden Anweisungen aus, und ersetzen Sie dabei Sitzungsname durch den Namen der Sitzung für erweiterte Ereignisse, um eine Sitzung zu starten:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = START  

Um eine Sitzung zu beenden, geben Sie die folgenden Anweisungen aus, und ersetzen Sie dabei Sitzungsname durch den Namen der Sitzung für erweiterte Ereignisse:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = STOP  

Starten oder Beenden einer Sitzung für erweiterte Ereignisse mittels Objekt-Explorer

Erweitern Sie die Knoten Verwaltung, Erweiterte Ereignisseund Sitzungen, klicken mit der rechten Maustaste auf eine Sitzung und klicken anschließend auf Sitzung starten oder Sitzung beenden , um im Objekt-Explorer eine Sitzung für erweiterte Ereignisse zu starten oder zu beenden.

Eine Extended Events-Sitzungsvorlage exportieren

Sie können mit dem Objekt-Explorereine Sitzung für erweiterte Ereignisse exportieren und diese als XML-Vorlage speichern. Beispielsweise möchten Sie möglicherweise eine Sitzung exportieren und dann die Vorlage mithilfe des Assistenten „Neue Sitzung“ oder des Assistenten „Neue Sitzung“ auf eine neue Eventsitzung anwenden.

Stellen Sie beim Exportieren einer Sitzung sicher, dass Sie die Vorlagendatei an einem Speicherort speichern, der das NTFS-Dateisystem verwendet. Schränken Sie zudem den Zugriff auf Benutzer ein, die zum Anzeigen der Informationen autorisiert sind.

So exportieren Sie mit dem Objekt-Explorereine Sitzung für erweiterte Ereignisse:

1. Erweitern Sie die Knoten Verwaltung, Erweiterte Ereignisse und dann Sitzungen.

2. Klicken Sie mit der rechten Maustaste auf die zu exportierende Sitzung, und wählen Sie anschließend Sitzung exportierenaus.

3. Wählen Sie im Dialogfeld Speichern unter einen Speicherort zum Speichern der Datei aus, geben Sie den Dateinamen in das Feld Dateiname ein, und klicken Sie auf Speichern.

   Wenn Sie die Datei am Standardspeicherort für SQL Server Management Studio-Vorlagen speichern, wird die Vorlage in der Dropdownliste vordefinierter Vorlagen angezeigt, wenn Sie das Dialogfeld Assistent für neue Sitzungen und Neue Sitzung verwenden.

Eine Vorlage für eine Extended Events-Sitzung importieren

Sie können mit dem Objekt-Explorereine Vorlage für eine Sitzung für erweiterte Ereignisse importieren. Dies ist beispielsweise hilfreich, um eine Sitzung aus einer Vorlage zu erstellen, die aus einer anderen Instanz von SQL Server exportiert wurde.

Um eine Extended Events-Sitzung zu importieren, müssen Sie über die erforderlichen Berechtigungen für ALTER ANY EVENT SESSION verfügen.

Bevor Sie eine Vorlagendatei importieren, stellen Sie sicher, dass die Datei aus einer vertrauenswürdigen Quelle stammt. Die Vorlagendateien sollten an einem Speicherort gespeichert werden, bei dem das NTFS-Dateisystem verwendet und der Zugriff auf Benutzer eingeschränkt wird, die zum Anzeigen der Informationen autorisiert sind.

So importieren Sie eine Extended Events-Sitzung:

1. Erweitern Sie im Objekt-Explorer die Knoten Verwaltung und anschließend Erweiterte Ereignisse.

2. Klicken Sie mit der rechten Maustaste auf Sitzungen , und wählen Sie anschließend Neue Sitzung.

3. Geben Sie einen Namen für die Sitzung an.

4. Erweitern Sie die Dropdown-Liste der Vorlagen .

5. Klicken Sie auf <Datei aus ...>Öffnen und navigieren Sie zu der Sitzung (XML-Datei), die Sie importieren möchten.

Die Sitzung wird unter dem Knoten Sitzungen angezeigt. Standardmäßig wird die Sitzung nicht gestartet.

Eine Extended Events-Sitzung bearbeiten

Sie können eine Sitzung für erweiterte Ereignisse in Objekt-Explorer bearbeiten.

So bearbeiten Sie eine Extended Events-Sitzung:

1. Erweitern Sie im Objekt-Explorer die Knoten Verwaltung, Erweiterte Ereignisse und anschließend Sitzungen.

2. Klicken Sie mit der rechten Maustaste auf eine Sitzung, und wählen Sie Eigenschaftenaus.

3. Wählen Sie im Abschnitt Seite auswählen die Seite oder Seiten aus, die Sie bearbeiten möchten.

4. Klicken Sie nach der Überarbeitung der Ereignissitzung auf OK.

Skript für eine Ereignissitzung als Definition mit Transact-SQL

Sowohl der Assistent für neue Sitzungen als auch das Dialogfeld "Neue Sitzung" verfügen über eine Skriptoption, die den Transact-SQL-Code generiert, der die Sitzung für erweiterte Ereignisse definiert.

Sie können auf den Transact-SQL-Code einer vorhandenen Extended-Events-Sitzung zugreifen, indem Sie mit der rechten Maustaste auf den Sitzungsnamen klicken, Sitzung als Skript speichern auswählen und anschließend Erstellen wählen.

Eine Extended Events-Sitzung löschen

Sie können eine Sitzung für Erweiterte Ereignisse löschen:

• Im Abfrage-Editor mit DROP EVENT SESSION.

• Im Objekt-Explorer

Wenn Sie eine Ereignissitzung löschen, werden alle Konfigurationsinformationen entfernt, und die Sitzungsdefinition wird nicht mehr in der „sys.server_event_sessions“-Katalogsicht angezeigt.

Um eine Extended Events-Sitzung zu löschen, müssen Sie über die Berechtigung ALTER ANY EVENT SESSION verfügen.

So löschen Sie eine Sitzung für erweiterte Ereignisse im Objekt-Explorer:

1. Erweitern Sie die Knoten Verwaltung, Erweiterte Ereignisse und anschließend Sitzungen.

2. Klicken Sie mit der rechten Maustaste auf eine Sitzung, und wählen Sie Löschenaus.

3. Klicken Sie im Dialogfeld Objekt löschen auf OK.

4. Klicken Sie nach der Überarbeitung der Ereignissitzung auf OK.

Geben Sie die folgenden Anweisungen ein, und ersetzen Sie dabei Sitzungsnamedurch den Namen der Sitzung für erweiterte Ereignisse, die Sie löschen möchten, um eine Sitzung für erweiterte Ereignisse im Abfrage-Editor zu löschen:

DROP EVENT SESSION [session_name]  
ON SERVER