Fråga efter data i en KQL-frågeuppsättning

I den här artikeln får du lära dig hur du använder en KQL-frågeuppsättning. KQL Queryset är det objekt som används för att köra frågor, visa och anpassa frågeresultat på data från olika datakällor, till exempel Eventhouse, KQL-databas med mera.

KQL Queryset använder Kusto-frågespråk för att skapa frågor och stöder även många SQL-funktioner. Mer information om frågespråket finns i Kusto-frågespråk översikt.

Förutsättningar

• En arbetsyta med en Microsoft Fabric-aktiverad kapacitet
• En KQL-databas med redigeringsbehörigheter och data, eller ett Azure Data Explorer-kluster och en databas med AllDatabaseAdmin-behörigheter .

Välj en datakälla

Frågor körs i kontexten för en datakälla. Du kan ändra den associerade datakällan när som helst och behålla de frågor som sparats i frågeredigeraren. Du kan associera din KQL-frågeuppsättning med flera datakällor av olika typer, inklusive en KQL-databas eller en datakälla från ett Azure Data Explorer-kluster.

Välj den flik som motsvarar din önskade datakällatyp.

KQL-databas

1. Öppna din KQL-frågeuppsättning.

2. I fönstret till vänster på frågesidan, under Explorer och sökfältet, använder du databasväxlaren för att expandera menyn för anslutningar till datakällan.

   

3. Välj Lägg till datakällaoch välj sedan OneLake-datahubben.

4. I fönstret OneLake-datahubben som visas väljer du en KQL-databas för att ansluta till din KQL-frågeuppsättning och väljer sedan Anslut. Du kan också stänga fönstret OneLake-datahubben och använda menyn + Lägg till datakälla för att ansluta till en annan datakälla.

Azure Data Explorer-kluster

1. Öppna din KQL-frågeuppsättning.

2. I fönstret till vänster på frågesidan, under Explorer och sökfältet, använder du databasväxlaren för att expandera menyn för anslutningar till datakällan.

   

3. Välj Lägg till datakällaoch välj sedan Azure Data Explorer.

4. Under Anslutnings-URI anger du klustrets URI.

   Om du vill hitta anslutnings-URI:n går du till klusterresursen i Azure Portal. Anslutnings-URI:n är den URI som finns i översikten. Om du vill lägga till ett kostnadsfritt exempelkluster anger du "hjälp" som anslutnings-URI.

   

5. Under Databaseväljer du den nedrullningsbara menyn för att expandera listan över datakällor i klustret och sedan välja en datakälla.

6. Välj Anslut.

En lista över tabeller som är associerade med den här datakällan visas under namnet på datakällan.

Skriva en fråga

Nu när du är ansluten till datakällan kan du köra frågor på dessa data. KQL Queryset använder KQL (Kusto Query Language) för att fråga efter data från någon av de datakällor som du har åtkomst till. Mer information om KQL finns i Kusto-frågespråk översikt.

I följande exempel används data som är offentligt tillgängliga på https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Skriva eller kopiera en fråga i den övre rutan i KQL-frågeuppsättningen.

2. Välj knappen Kör eller tryck på Skift+Retur för att köra frågan.

   Resultatet av frågan visas i resultatrutnätet, som visas under frågefönstret. Observera den gröna kontrollen som anger att frågan har slutförts och den tid som används för att beräkna frågeresultatet.

   

Interagera med datakällor

Med datakällsutforskaren kan du växla mellan de datakällor som är anslutna till den frågeuppsättningsflik som du befinner dig i.

Längst upp i datakälla-utforskaren under Explorer kan du använda sökfältet för att söka efter en specifik datakälla. Du kan också använda databasväxlaren under sökfältet för att expandera menyn för datakällans anslutningar. Välj den datakälla som du vill använda. Om tabbnamnet inte har redigerats tidigare namnges det automatiskt efter datakällan.

Utforskarrutan för datakällan har två sektioner. I det övre avsnittet visas alla objekt i datakällan, och i det nedre avsnittet visas alla tillgängliga datakällor i frågeuppsättningen.

Objekt i datakällan

Det övre avsnittet i datakällsutforskaren visar alla objekt som ingår i den datakälla som du använder.

• Tabeller
• Materialiserad vy
• Genvägar
• Funktioner

Välj pilen > till vänster om det objekt som du vill expandera. Du kan öka detaljnivån för att visa mer information genom att välja pilen > till vänster om objekt i efterföljande listnivåer. Under tabellerväljer du till exempel pilen > till vänster om en tabell för att visa listan över kolumnerna i tabellen.

Öppna åtgärdsmenyn genom att hovra över ett objekt i den expanderade listan och välja Fler åtgärder menyn [...]. Menyn visar följande alternativ:

• Uppdatera databas
• Visa dataprofil
• Infoga: för att skapa och kopiera ett skript
• Hämta data: för att lägga till en ny datakälla
• Skapa en instrumentpanel
• Ta bort tabell

Olika åtgärder är tillgängliga för olika objekttyper.

Tillgängliga datakällor

Det nedre avsnittet i datakällsutforskaren visar alla tillgängliga datakällor som har lagts till i frågeuppsättningen.

Öppna åtgärdsmenyn genom att hovra över datakällans namn och välja Fler åtgärder menyn [...]. Menyn visar följande alternativ:

• Uppdatera databas
• Använd den här databasen: växla för att använda den här datakällan på den aktuella fliken
• Fråga på en ny flik: Öppna den här datakällan på en ny flik i frågeuppsättningen
• Ta bort källa: tar bort alla databaser i datakällan
• Ta bort databas: tar endast bort den valda databasen

Kopiera fråga

Du kanske vill kopiera och dela de frågor som du skapar.

1. Längst upp i frågefönstret väljer du fliken Start .

2. I frågefönstret väljer du Kopiera fråga.

   

   I följande tabell beskrivs de många alternativen för hur du kopierar en fråga.

   Åtgärd	beskrivning
   Kopiera fråga	Kopiera frågetexten.
   Länka till Urklipp	Kopiera en djuplänk som kan användas för att köra frågan.
   Länka och fråga till Urklipp	Kopiera en länk som kan användas för att köra frågan och texten i frågan.
   Länka, fråga och resultat till Urklipp	Kopiera en länk som kan användas för att köra frågan, frågans text och resultatet av frågan.
   Kopiera resultat	Kopiera resultatet av frågan.

3. Välj önskad åtgärd i listan.

4. Klistra in den här informationen om du vill redigera eller dela den, till exempel i Microsoft Word, Microsoft Teams eller Outlook.

   Viktigt!

   Användaren som får frågelänken måste ha visningsbehörighet till underliggande data för att köra frågan och visa resultat.

Hantera flikar för frågeuppsättningar

I en KQL-frågeuppsättning kan du skapa flera flikar. Varje flik kan associeras med en annan KQL-databas och du kan spara frågor för senare användning eller dela med andra för att samarbeta om datautforskning. Du kan också ändra den KQL-databas som är associerad med valfri flik, så att du kan köra samma fråga på data i olika databaser.

Du kan hantera flikarna på följande sätt:

• Ändra den befintliga datakällanslutningen: Under Explorer och sökfältet använder du databasväxlaren för att expandera menyn för anslutningar till datakällan.
• Byt namn på en flik: Bredvid fliknamnet väljer du pennikonen.
• Lägg till en ny flik: Till höger om de befintliga flikarna i kommandofältet väljer du plus-+. Olika flikar kan anslutas till olika datakällor.
• Fler åtgärder: Till höger i kommandofältet finns det en flikmeny med fler åtgärder för att hantera flera flikar i frågeuppsättningen.
• Ändra tabbpositioner: Använd dra och släpp-gester.

Exportera frågedata som CSV

I stället för att kopiera och klistra in frågeutdata kan du också exportera frågeresultatet.

Det här är en engångsmetod för att exportera en CSV-fil som innehåller frågeresultatet.

1. Längst upp i frågefönstret väljer du fliken Start .

   

2. I frågefönstret väljer du Exportera till CSV.

3. Spara CSV-filen lokalt.

Ta bort KQL-frågeuppsättning

Så här tar du bort din KQL-frågeuppsättning:

1. Välj den arbetsyta där KQL-frågeuppsättningen finns.

2. Hovra över den KQL-frågeuppsättning som du vill ta bort. Välj Mer [...]och sedan Ta bort.

   

Gå vidare

Anpassa resultat i KQL Queryset-resultatrutnätet