Query's uitvoeren op gegevens in een KQL-queryset

In dit artikel leert u hoe u een KQL-queryset gebruikt. De KQL-queryset is het item dat wordt gebruikt voor het uitvoeren van query's, het weergeven en aanpassen van queryresultaten op gegevens uit verschillende gegevensbronnen, zoals Eventhouse, KQL-database en meer.

De KQL-queryset maakt gebruik van de Kusto-querytaal voor het maken van query's en ondersteunt ook veel SQL-functies. Zie Kusto-querytaal overzicht voor meer informatie over de querytaal.

Vereisten

• Een werkruimte met een Capaciteit met Microsoft Fabric
• Een KQL-database met bewerkingsmachtigingen en -gegevens, of een Azure Data Explorer-cluster en -database met AllDatabaseAdmin-machtigingen .

Een database selecteren

Query's worden uitgevoerd in de context van een database. U kunt de gekoppelde database op elk gewenst moment wijzigen en de query's behouden die zijn opgeslagen in de query-editor. U kunt uw KQL-queryset koppelen aan meerdere gegevensbronnen van verschillende typen, waaronder een KQL-database of een database uit een Azure Data Explorer-cluster.

Selecteer het tabblad dat overeenkomt met het gewenste databasetype.

KQL-database

1. Open uw KQL-queryset.

2. Selecteer in het verbindingsvenster aan de linkerkant van de querypagina, onder Explorer, de optie V om het menu databaseverbindingen uit te vouwen.

   

3. Selecteer oneLake-gegevenshub onder Verbinding maken.

4. Selecteer in het venster van de OneLake-gegevenshub dat wordt weergegeven een KQL-database om verbinding te maken met uw KQL-queryset en selecteer vervolgens Verbinding maken. U kunt ook hetonelake-gegevenshubvenster sluiten en het menu +Gegevensbron toevoegen gebruiken om verbinding te maken met een andere gegevensbron.

Azure Data Explorer-cluster

1. Open uw KQL-queryset.

2. Selecteer in het verbindingsvenster aan de linkerkant van de querypagina, onder Explorer, de optie V om het menu databaseverbindingen uit te vouwen.

   

3. Selecteer onder Verbinding maken de optie Azure Data Explorer.

4. Voer onder Verbindings-URI de cluster-URI in.

   Als u de verbindings-URI wilt vinden, gaat u naar uw clusterresource in Azure Portal. De verbindings-URI is de URI in het overzicht. Als u een gratis voorbeeldcluster wilt toevoegen, geeft u 'help' op als de verbindings-URI.

   

5. Selecteer onder Database de vervolgkeuzelijst om de lijst met databases in uw cluster uit te vouwen en selecteer vervolgens een database.

6. Selecteer Verbinding maken.

Een lijst met tabellen die aan deze database zijn gekoppeld, wordt weergegeven onder de databasenaam in het verbindingsvenster.

Interactie met databases via het verbindingsvenster

In het verbindingsvenster kunt u bladeren en schakelen tussen de databases die zijn verbonden met de queryset. Selecteer V in het verbindingsvenster onder Database om het menu databaseverbindingen uit te vouwen. Selecteer de database die u wilt verkennen. In het verbindingsvenster ziet u een uitsplitsing van de volgende items die zijn opgenomen in de geselecteerde database:

• Tabellen
• Gerealiseerde weergave
• Snelkoppelingen
• Functies

In het verbindingsvenster kunt u bekijken welke items in elke sectie zijn opgenomen. Als u het actiemenu wilt openen, beweegt u de muisaanwijzer over het item en selecteert u het menu Meer [...]. Het menu bevat opties voor:

• Gegevens vernieuwen
• Gegevensprofiel weergeven
• Invoegen om een script te maken en in de queryeditor te plakken
• Verwijderen

Er zijn verschillende acties beschikbaar voor verschillende typen items.

Een query schrijven

Nu u bent verbonden met uw gegevensbron, kunt u query's uitvoeren op deze gegevens. De KQL-queryset maakt gebruik van de Kusto-querytaal (KQL) om gegevens op te vragen uit een van de databases waar u toegang toe hebt. Zie Kusto-querytaal overzicht voor meer informatie over KQL.

In de volgende voorbeelden worden gegevens gebruikt die openbaar beschikbaar zijn op https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Een query schrijven of kopiëren in het bovenste deelvenster van de KQL-queryset.

2. Selecteer de knop Uitvoeren of druk op Shift+Enter om de query uit te voeren.

   De resulterende queryuitvoer wordt weergegeven in het resultatenraster, dat onder het queryvenster wordt weergegeven. Let op de groene controle die aangeeft dat de query is voltooid en de tijd die wordt gebruikt om de queryresultaten te berekenen.

   

Tabbladen queryset beheren

Binnen een KQL-queryset kunt u meerdere tabbladen maken. Elk tabblad kan worden gekoppeld aan een andere KQL-database en kunt u query's opslaan voor later gebruik of delen met anderen om samen te werken aan gegevensverkenning. U kunt ook de KQL-database wijzigen die aan elk tabblad is gekoppeld, zodat u dezelfde query kunt uitvoeren op gegevens in verschillende statussen.

• Een nieuw tabblad toevoegen: Selecteer het plusteken + rechts van de bestaande tabbladen. Verschillende tabbladen kunnen worden verbonden met verschillende databases.
• De naam van een tabblad wijzigen: selecteer het potloodpictogram naast de naam van het tabblad.
• Tabposities wijzigen: Tabposities wijzigen met behulp van bewegingen voor slepen en neerzetten.
• Wijzig de bestaande databaseverbinding: selecteer onder Explorer de bestaande databaseverbinding om de gegevenshub te openen.

Aan de rechterkant van de opdrachtbalk bevindt zich een menu met extra acties voor het beheren van de meerdere tabbladen in uw queryset.

Query kopiëren

Mogelijk wilt u de query's die u maakt kopiëren en delen.

1. Selecteer bovenaan het queryvenster het tabblad Start .

2. Selecteer De query kopiëren in het queryvenster.

   

   De volgende tabel bevat een overzicht van de vele opties voor het kopiëren van een query.

   Actie	Beschrijving
   Query kopiëren	Kopieer de querytekst.
   Koppeling naar klembord	Kopieer een dieptekoppeling die kan worden gebruikt om de query uit te voeren.
   Koppelen en query's uitvoeren op klembord	Kopieer een koppeling die kan worden gebruikt om de query en de tekst van de query uit te voeren.
   Koppelen, query's en resultaten aan klembord	Kopieer een koppeling die kan worden gebruikt om de query, de tekst van de query en de resultaten van de query uit te voeren.
   Resultaten kopiëren	Kopieer de resultaten van de query.

3. Selecteer de gewenste actie in de bovenstaande tabel.

4. Plak deze gegevens om deze te bewerken of te delen, bijvoorbeeld in Microsoft Word, Microsoft Teams of Outlook.

   Belangrijk

   De gebruiker die de querykoppeling ontvangt, moet weergavemachtigingen hebben voor de onderliggende gegevens om de query uit te voeren en resultaten weer te geven.

Querygegevens exporteren als CSV

In plaats van simpelweg de queryuitvoer te kopiëren, kunt u ook de queryresultaten exporteren.

Dit is een eenmalige methode voor het exporteren van een CSV-bestand met de queryresultaten.

1. Selecteer bovenaan het queryvenster het tabblad Start .

   

2. Selecteer Exporteren naar CSV in het queryvenster.

3. Sla het CSV-bestand lokaal op.

KQL-queryset verwijderen

Ga als volgt te werk om uw KQL-queryset te verwijderen:

1. Selecteer de werkruimte waarin uw KQL-queryset zich bevindt.

2. Beweeg de muisaanwijzer over de KQL-queryset die u wilt verwijderen. Selecteer Meer [...]en selecteer Vervolgens Verwijderen.

   

Volgende stap

Resultaten aanpassen in het KQL Queryset-resultatenraster