Query's uitvoeren op gegevens in een KQL-queryset

In dit artikel leert u hoe u een KQL-queryset gebruikt. Met een KQL-queryset kunt u query's uitvoeren, resultaten weergeven en queryresultaten aanpassen voor gegevens uit verschillende bronnen, zoals een eventhouse of een KQL-database.

U kunt ook een KQL-queryset gebruiken om query's voor meerdere services uit te voeren op een Azure Monitor Log Analytics werkruimte of een Application Insights-resource.

KQL-queryset maakt gebruik van Kusto Query Language (KQL) om query's te maken en ondersteunt ook veel SQL-functies. Zie Kusto-querytaal overzicht voor meer informatie over de querytaal.

Vereisten

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

Een gegevensbron selecteren

Query's worden uitgevoerd in de context van een gegevensbron. U kunt de bijbehorende gegevensbron op elk gewenst moment wijzigen en de query's opslaan in de query-editor. U kunt uw KQL-queryset koppelen aan meerdere gegevensbrontypen, waaronder een KQL-database, een Azure Data Explorer-cluster of Azure Monitor.

Selecteer het tabblad voor het gegevensbrontype.

Een lijst met tabellen die aan deze gegevensbron zijn gekoppeld, wordt weergegeven onder de naam van de gegevensbron.

Een query schrijven

Nu u bent verbonden met een gegevensbron, kunt u er query's op uitvoeren. KQL-queryset maakt gebruik van Kusto Query Language (KQL) om query's uit te voeren op gegevens uit elke verbonden gegevensbron waartoe u toegang hebt. Zie Kusto-querytaal overzicht voor meer informatie over KQL.

In de volgende voorbeelden wordt het openbare StormEvents.csv voorbeeldbestand gebruikt.

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 queryresultaten worden weergegeven in het resultatenraster onder het queryvenster. Let op de groene controle die aangeeft dat de query is voltooid en de tijd die wordt gebruikt om de queryresultaten te berekenen.

   

Interactie met gegevensbronnen

Met de gegevensbronverkenner kunt u schakelen tussen de gegevensbronnen die zijn verbonden met het huidige tabblad queryset.

Boven in het deelvenster Gegevensbronverkenner, onder Explorer, kunt u de zoekbalk gebruiken om te zoeken naar een specifieke gegevensbron. U kunt ook de databasewisselaar onder de zoekbalk gebruiken om het menu voor gegevensbronverbindingen uit te vouwen. Selecteer de gegevensbron die u wilt gebruiken. Als u de naam van het tabblad eerder niet hebt gewijzigd, wordt het automatisch benoemd naar de gegevensbron.

Het deelvenster Gegevensbronverkenner bevat twee secties. In de bovenste sectie ziet u alle items in de gegevensbron en in de onderste sectie ziet u alle beschikbare gegevensbronnen in de queryset.

Items in de gegevensbron weergeven

In het bovenste gedeelte van de gegevensbronverkenner ziet u alle items in de gegevensbron die u gebruikt.

• Tabellen
• Gematerializeerde views
• Snelkoppelingen
• Functies

Selecteer de pijl > links van het item dat u wilt uitvouwen. U kunt doorklikken om meer details weer te geven door de pijl > links van items in de volgende lijstniveaus te selecteren. Selecteer bijvoorbeeld onder Tabellen de pijl > links van een tabel om de lijst met kolommen in die tabel weer te geven.

Als u het actiemenu wilt openen, plaatst u de muisaanwijzer op een item in de uitgevouwen lijst en selecteert u het menu Meer [...]. Het menu bevat de volgende opties:

• Database vernieuwen
• Gegevensprofiel weergeven
• Gegevens verkennen
• Invoegen: een script maken en kopiëren
• Gegevens ophalen: een nieuwe gegevensbron toevoegen
• Een dashboard maken
• Tabel verwijderen

Er zijn verschillende acties beschikbaar voor verschillende itemtypen.

Door beschikbare gegevensbronnen bladeren

In het onderste gedeelte van de gegevensbronverkenner ziet u alle beschikbare gegevensbronnen die u aan de queryset toevoegt.

Als u het actiemenu wilt openen, beweegt u de muisaanwijzer over de naam van de gegevensbron en selecteert u het menu Meer [...]. Het menu bevat de volgende opties:

• Database vernieuwen
• Gebruik deze database: schakel over naar deze gegevensbron op het huidige tabblad
• Query uitvoeren op een nieuw tabblad: open deze gegevensbron op een nieuw tabblad in de queryset
• Bron verwijderen: verwijdert alle databases in die gegevensbron
• Database verwijderen: alleen de geselecteerde database verwijderen
• Openen in KQL-database: hiermee opent u deze gegevensbron in een KQL-database.

Querysettabbladen beheren

Binnen een KQL-queryset kunt u meerdere tabbladen maken. Elk tabblad kan worden gekoppeld aan een andere KQL-database. Met deze instelling 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 is gekoppeld aan elk tabblad, waarmee u dezelfde query kunt uitvoeren op gegevens in verschillende databases.

U kunt uw tabbladen op de volgende manieren beheren:

• De bestaande gegevensbronverbinding wijzigen: gebruik onder Explorer en de zoekbalk de databasewisselaar om het menu met gegevensbronverbindingen uit te vouwen.
• Naam van een tabblad wijzigen: selecteer naast de naam van het tabblad het potloodpictogram .
• Een nieuw tabblad toevoegen: selecteer aan de rechterkant van de bestaande tabbladen in de opdrachtbalk het plusteken +. Verschillende tabbladen kunnen worden verbonden met verschillende gegevensbronnen.
• Meer acties: gebruik aan de rechterkant van de opdrachtbalk het tabbladmenu om meerdere tabbladen in uw queryset te beheren.
• Tabposities wijzigen: gebruik bewegingen voor slepen en neerzetten.

Een KQL-queryset verwijderen

Volg deze stappen om uw KQL-queryset te verwijderen:

1. Selecteer de werkruimte die uw KQL-queryset bevat.

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

   

Volgende stap