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 een KQL-database.

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 AllDatabase Beheer-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 een KQL-database of een database vanuit een Azure Data Explorer-cluster.

Selecteer het tabblad dat overeenkomt met het gewenste databasetype.

KQL-database

1. Open uw KQL-queryset.

2. Selecteer onder Database V om het menu databaseverbindingen uit te vouwen.

   

3. Selecteer onder Verbinding maken bron OneLake-gegevenshub.

4. Selecteer een KQL-database in het onelake-gegevenshubvenster dat wordt weergegeven en selecteer vervolgens Selecteren.

   

Azure Data Explorer-cluster

1. Open uw KQL-queryset.

2. Selecteer onder Database V om het menu databaseverbindingen uit te vouwen.

   

3. Selecteer Azure Data Explorer onder Verbinding maken bron.

4. Voer onder Verbinding maken ion-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 Verbinding maken ion-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.

Er wordt een lijst weergegeven met tabellen die aan deze database zijn gekoppeld, onder de databasenaam.

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.

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

Query kopiëren

U kunt de query's die u maakt, kopiëren of delen.

1. Selecteer bovenaan het queryvenster het tabblad Start .

2. Selecteer Query kopiëren.

   

   De volgende tabel bevat een overzicht van de vele opties voor het delen van een query.

   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.

   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 deelactie uit de bovenstaande tabel.

4. Plak deze informatie in een editor, zoals Microsoft Word.

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 Resultaten exporteren naar CSV.

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 waaraan uw KQL-queryset is gekoppeld.

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