Gebeurtenisgegevens weergeven in SQL Server Management Studio

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

In dit artikel wordt beschreven hoe u SQL Server Management Studio (SSMS) kunt gebruiken om doelgegevens van uitgebreide gebeurtenissen weer te geven. In het artikel wordt uitgelegd hoe u:

• Open en bekijk de doelgegevens op verschillende manieren.
• Exporteer de doelgegevens naar verschillende indelingen met behulp van het speciale menu of de werkbalk voor uitgebreide gebeurtenissen.
• Bewerk de gegevens tijdens het weergeven of voordat u exporteert. U kunt gebeurtenisgegevens weergeven, exporteren, filteren en aggregeren.

Vereiste voorwaarden

In het huidige artikel wordt ervan uitgegaan dat u al weet hoe u een gebeurtenissessie maakt en start. Instructies voor het maken van een gebeurtenissessie worden vroeg in het volgende artikel gedemonstreerd:

Quickstart: Uitgebreide gebeurtenissen

Installeer de nieuwste versie van SQL Server Management Studio (SSMS).

Verschillen met Azure SQL Database

Er zijn bepaalde verschillen tussen uitgebreide gebeurtenissen in SQL Server en in Azure SQL Database.

• Voor Azure SQL Database kan het event_file doel geen bestand op het lokale schijfstation zijn. In plaats daarvan moet een Azure Storage-container worden gebruikt. Wanneer u verbinding hebt met de database in Azure SQL Database, vraagt de SSMS-gebruikersinterface om een opslagcontainer in plaats van een lokaal pad en een bestandsnaam.
• In de SSMS-gebruikersinterface zijn livegegevens bekijken uitgeschakeld. Dit komt doordat deze functie niet beschikbaar is voor Azure SQL Database.
• Er worden enkele uitgebreide gebeurtenissensessies geïnstalleerd met SQL Server, bijvoorbeeld de system_health sessie. Deze sessies zijn niet beschikbaar voor Azure SQL Database.

Het huidige artikel is geschreven vanuit het perspectief van SQL Server. In het artikel wordt het event_file doel gebruikt, dat anders wordt geïmplementeerd in uitgebreide gebeurtenissen voor SQL Server en voor Azure SQL Database.

Zie Uitgebreide gebeurtenissen in Azure SQL Database voor documentatie over uitgebreide gebeurtenissen die specifiek zijn voor Azure SQL Database.

De gebruikersinterface van SSMS-gebeurtenissenlogboek bekijken openen

De gebruikersinterface van de SSMS-gebeurtenissenviewer is op een van de volgende manieren toegankelijk:

• Hoofdmenu Bestand>>openen en blader vervolgens naar een xel bestand
• Klik met de rechtermuisknop op Uitgebreide gebeurtenissen in Objectverkenner-beheer >
• Het menu Uitgebreide gebeurtenissen en de werkbalk Uitgebreide gebeurtenissen
• Met de rechtermuisknop klikken in het deelvenster met tabbladen waarin de doelgegevens worden weergegeven

Event_file gegevens weergeven in SSMS

Er zijn verschillende manieren om de event_file doelgegevens in de gebruikersinterface van SSMS weer te geven. Wanneer u een event_file doel opgeeft, stelt u het bestandspad en de naam in, inclusief de xel extensie.

• Telkens wanneer de gebeurtenissessie wordt gestart, voegt Uitgebreide gebeurtenissen een numeriek achtervoegsel toe aan de bestandsnaam om de bestandsnaam uniek te maken.
  • Voorbeeld: Checkpoint_Begins_ES_0_131103935140400000.xel
• xel bestanden zijn binaire bestanden. Ze mogen niet in een teksteditor zoals Kladblok worden geopend.
  • Gebruik het dialoogvenster Bestand>Openen>Uitgebreide gebeurtenisbestanden samenvoegen om meerdere gebeurtenisbestanden te openen in de gebeurtenisweergave-interface van SSMS.

SSMS kan gegevens weergeven voor de meeste doelen voor uitgebreide gebeurtenissen. Maar de schermen verschillen voor de verschillende doelen. Voorbeeld:

• event_file: Gegevens van het doel van de event_file worden weergegeven in de gebeurtenisweergave, met beschikbare filters, aggregatiefuncties en andere functies.
• ring_buffer: Gegevens van een ringbufferdoel worden weergegeven als XML.

SSMS kan geen gegevens van het etw_classic_sync_target doel weergeven.

Een xel-bestand openen met bestand > openen >

U kunt één xel bestand openen vanuit het hoofdmenu van SSMS met behulp van Bestand>openen>. U kunt een xel bestand ook slepen en neerzetten in SSMS.

Doelgegevens weergeven

Met de optie Doelgegevens weergeven worden de gegevens weergegeven die tot nu toe zijn vastgelegd. In Objectverkenner kunt u de knooppunten uitvouwen en vervolgens met de rechtermuisknop klikken:

• Beheer>Uitgebreide gebeurtenissen>Sessies>[uw sessie]>[uw doelknooppunt]>Doelgegevens weergeven.

De doelgegevens worden als volgt weergegeven in een deelvenster met tabbladen in SSMS:

Opmerking

Doelgegevens weergeven geeft gegevens weer uit alle xel bestanden die zijn gekoppeld aan de sessies. Elkestartstopcyclus- maakt een bestand met een latere, tijd afgeleide numerieke waarde die is toegevoegd aan de bestandsnaam, maar elk bestand deelt dezelfde hoofdnaam. Er worden ook extra rollover-bestanden xel gemaakt wanneer de bestandsgrootte groter is dan de maximale bestandsgrootte die is opgegeven met de MAX_FILE_SIZE parameter.

Livegegevens bekijken

Wanneer uw gebeurtenissessie wordt uitgevoerd, kunt u de gebeurtenisgegevens in realtime bekijken, omdat deze door het doel worden ontvangen.

• Beheer>Uitgebreide gebeurtenissen>Sessies>[uw sessie]>Bekijk livegegevens.

De gegevensweergave wordt bijgewerkt met een interval dat u kunt opgeven. Zie Maximale latentie voor verzending op:

• Uitgebreide gebeurtenissen>Sessies>[uw sessie]>Eigenschappen>Geavanceerd>Maximale latentie voor verzending

Gebeurtenisgegevens weergeven met de functie sys.fn_xe_file_target_read_file()

De functie sys.fn_xe_file_target_read_file() retourneert een rijenset met elke rij die een vastgelegde gebeurtenis vertegenwoordigt. Gebeurtenisgegevens worden geretourneerd als XML. XQuery kan worden gebruikt om gebeurtenisgegevens relationeel te presenteren.

Doelgegevens exporteren

Zodra u gebeurtenisgegevens hebt weergegeven in de SSMS-logboeken, kunt u deze als volgt exporteren naar verschillende indelingen:

1. Selecteer Uitgebreide gebeurtenissen in het hoofdmenu.
2. Selecteer Exporteren naar en kies vervolgens een indeling.

Gegevens in de weergave bewerken

De SSMS-gebruikersinterface biedt u verschillende manieren om de gegevens te bewerken, behalve het alleen weergeven van de gegevens zoals dat is.

Contextmenu's in de gegevensweergave

Verschillende plaatsen in de gegevensweergave bieden verschillende contextmenu's wanneer u met de rechtermuisknop klikt.

Klik met de rechtermuisknop op een gegevenscel

In de volgende schermopname ziet u het inhoudsmenu dat u krijgt wanneer u met de rechtermuisknop op de cel in de gegevensweergave klikt. In de schermopname ziet u ook de uitbreiding van het menu-item Kopiëren .

Klik met de rechtermuisknop op een kolomkop

In de volgende schermopname toont het contextmenu dat verschijnt bij een rechtermuisklik op de tijdstempel-header.

Kolommen kiezen, kolommen samenvoegen

Met de optie Kolommen kiezen kunt u bepalen welke gegevenskolommen worden weergegeven. U vindt de menuopdracht Kolommen kiezen op een aantal verschillende plaatsen:

• In het menu Uitgebreide gebeurtenissen .
• Op de werkbalk Uitgebreide gebeurtenissen.
• In het contextmenu van een koptekst in de gegevensweergave.

Wanneer u Kolommen kiezen selecteert, wordt het dialoogvenster met dezelfde naam weergegeven.

Kolommen samenvoegen

Het dialoogvenster Kolommen kiezen bevat een sectie die is gewijd aan het samenvoegen van meerdere kolommen in één, voor weergave en gegevensexport.

Filteren

De filters in de SSMS-gebeurtenisviewer kunnen:

• Beperk de geretourneerde gegevens op basis van de tijdstempelkolom
• Filteren op een kolomwaarde

De relatie tussen het tijdfilter en het kolomfilter is een Booleaanse waarde AND.

Groeperen en samenvoegen

Rijen groeperen door overeenkomende waarden in een bepaalde kolom te vergelijken, is de eerste stap in de richting van de samenvattingsaggregatie van gegevens.

Groepering

Op de werkbalk Uitgebreide gebeurtenissen start de knop Groeperen een dialoogvenster dat u kunt gebruiken om de weergegeven gegevens te groeperen op een bepaalde kolom. In de volgende schermopname ziet u een dialoogvenster dat wordt gebruikt om te groeperen op de naamkolom .

Nadat de groepering is voltooid, heeft de weergave een nieuw uiterlijk, zoals hierna wordt weergegeven.

Aggregation

Nadat de weergegeven gegevens zijn gegroepeerd, kunt u doorgaan met het aggregeren van gegevens in andere kolommen. In de volgende schermopname ziet u dat de gegroepeerde gegevens worden samengevoegd op aantal.

Nadat de aggregatie is voltooid, heeft de weergave een nieuw uiterlijk, zoals hierna wordt weergegeven.

Weergave van het queryplan voor uitvoeringstijd

query_post_execution_showplan Met deze gebeurtenis kunt u het werkelijke queryplan (inclusief runtimestatistieken) in de SSMS-gebruikersinterface zien. Wanneer het deelvenster Details zichtbaar is, ziet u het grafische queryplan op het tabblad Queryplan . Door de muisaanwijzer op een knooppunt in het queryplan te plaatsen, ziet u een lijst met eigenschapsnamen en de bijbehorende waarden voor het planknooppunt.

Verwante inhoud

• Overzicht van uitgebreide gebeurtenissen