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 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 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 gegevensbron uit een Azure Data Explorer-cluster.
Selecteer het tabblad dat overeenkomt met het gewenste gegevensbrontype.
Gebruik in het deelvenster aan de linkerkant van de querypagina, onder Explorer en de zoekbalk, de databasewisselaar om het menu met gegevensbronverbindingen uit te vouwen.
Selecteer Gegevensbron toevoegenen selecteer vervolgens OneLake-gegevenshub.
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 het OneLake-gegevenshub venster sluiten en het menu + Gegevensbron toevoegen gebruiken om verbinding te maken met een andere gegevensbron.
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 uw gegevensbron, kunt u query's uitvoeren op deze gegevens. De KQL-queryset maakt gebruik van de Kusto Query Language (KQL) om gegevens op te vragen uit een van de gegevensbronnen 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.
Een query schrijven of kopiëren in het bovenste deelvenster van de KQL-queryset.
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.
Interactie met gegevensbronnen
Met de gegevensbronverkenner kunt u schakelen tussen de gegevensbronnen die zijn verbonden met het tabblad queryset waarin u zich bevindt.
Boven in het deelvenster Gegevensbronverkenner, onder Explorer kunt u de zoekbalk gebruiken om naar een specifieke gegevensbron te zoeken. 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 de naam van het tabblad nog niet eerder is bewerkt, wordt deze 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
In het bovenste gedeelte van de gegevensbronverkenner ziet u alle items die zijn opgenomen in de gegevensbron die u gebruikt.
- Tabellen
- Gerealiseerde weergave
- 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 Tabellende pijl > links van een tabel om de lijst met kolommen in die tabel weer te geven.
Als u het actiemenu wilt openen, beweegt u de muisaanwijzer over een item in de uitgevouwen lijst en selecteert u de Meer acties menu [...]. In het menu ziet u de volgende opties:
- Database vernieuwen
- Gegevensprofiel weergeven
- 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.
Beschikbare gegevensbronnen
In het onderste gedeelte van de gegevensbronverkenner ziet u alle beschikbare gegevensbronnen die zijn toegevoegd aan de queryset.
Als u het actiemenu wilt openen, beweegt u de muisaanwijzer over de naam van de gegevensbron en selecteert u de Meer acties menu [...]. In het menu ziet u 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
Query kopiëren
Mogelijk wilt u de query's die u maakt kopiëren en delen.
Selecteer bovenaan het queryvenster het tabblad Start .
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. Selecteer de gewenste actie in de lijst.
Plak deze informatie 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.
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 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: aan de rechterkant van de opdrachtbalk bevindt zich een tabbladmenu met meer acties voor het beheren van de meerdere tabbladen in uw queryset.
- Tabposities wijzigen: gebruik bewegingen voor slepen en neerzetten.
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.
Selecteer bovenaan het queryvenster het tabblad Start .
Selecteer Exporteren naar CSV in het queryvenster.
Sla het CSV-bestand lokaal op.
KQL-queryset verwijderen
Ga als volgt te werk om uw KQL-queryset te verwijderen:
Selecteer de werkruimte waarin uw KQL-queryset zich bevindt.
Beweeg de muisaanwijzer over de KQL-queryset die u wilt verwijderen. Selecteer Meer [...]en selecteer Vervolgens Verwijderen.
