Forespørg om data i et KQL-forespørgselssæt

I denne artikel lærer du, hvordan du bruger et KQL-forespørgselssæt. KQL-forespørgselssættet er det element, der bruges til at køre forespørgsler, få vist og tilpasse forespørgselsresultater på data fra forskellige datakilder, f.eks. Eventhouse, KQL-database med mere.

KQL-forespørgselssættet bruger Kusto-forespørgselssproget til oprettelse af forespørgsler og understøtter også mange SQL-funktioner. Du kan få flere oplysninger om forespørgselssproget under Oversigt over Kusto-forespørgselssprog.

Forudsætninger

• Et arbejdsområde med en Microsoft Fabric-aktiveret kapacitet
• En KQL-database med redigeringstilladelser og data eller en Azure Data Explorer-klynge og -database med tilladelserne AllDatabaseAdmin .

Vælg en database

Forespørgsler kører i konteksten af en database. Du kan når som helst ændre den tilknyttede database og bevare de forespørgsler, der er gemt i forespørgselseditoren. Du kan knytte dit KQL-forespørgselssæt til flere datakilder af forskellige typer, herunder en KQL-database eller en database fra en Azure Data Explorer-klynge.

Vælg den fane, der svarer til den ønskede databasetype.

KQL-database

1. Åbn dit KQL-forespørgselssæt.

2. I forbindelsesruden i venstre side af forespørgselssiden under Stifinder skal du vælge V for at udvide menuen for databaseforbindelser.

   

3. Under Opret forbindelseskilde skal du vælge OneLake-datahub.

4. I vinduet OneLake-datahub , der vises, skal du vælge en KQL-database for at oprette forbindelse til dit KQL-forespørgselssæt og derefter vælge Opret forbindelse. Du kan også lukke vinduetOneLake-datahub og bruge menuen +Tilføj datakilde til at oprette forbindelse til en anden datakilde.

Azure Data Explorer-klynge

1. Åbn dit KQL-forespørgselssæt.

2. I forbindelsesruden i venstre side af forespørgselssiden under Stifinder skal du vælge V for at udvide menuen for databaseforbindelser.

   

3. Under Opret forbindelseskilde skal du vælge Azure Data Explorer.

4. Angiv klynge-URI'en under Forbindelses-URI.

   Hvis du vil finde forbindelses-URI'en, skal du gå til din klyngeressource i Azure-portal. Forbindelses-URI'en er den URI, der blev fundet i Oversigt. Hvis du vil tilføje en gratis eksempelklynge, skal du angive "hjælp" som forbindelses-URI'en.

   

5. Under Database skal du vælge rullemenuen for at udvide listen over databaser i klyngen og derefter vælge en database.

6. Vælg Opret forbindelse.

Der vises en liste over tabeller, der er knyttet til denne database, under databasenavnet i forbindelsesruden.

Interager med databaser ved hjælp af forbindelsesruden

I forbindelsesruden kan du gennemse og skifte mellem de databaser, der er forbundet til forespørgselssættet. Under Database i forbindelsesruden skal du vælge V for at udvide menuen databaseforbindelser. Vælg den database, du vil udforske. I forbindelsesruden vises en oversigt over følgende elementer, der er inkluderet i den valgte database:

• Tabeller
• Materialiseret visning
• Genveje
• Functions

I forbindelsesruden kan du udforske, hvilke elementer der er inkluderet i hvert afsnit. Hvis du vil åbne handlingsmenuen, skal du holde markøren over elementet og vælge menuen Flere [...]. Menuen giver mulighed for at:

• Opdater data
• Vis dataprofil
• Indsæt for at oprette et script og indsætte det i forespørgselseditoren
• Delete

Der er forskellige handlinger tilgængelige for forskellige typer elementer.

Skriv en forespørgsel

Nu, hvor du har forbindelse til din datakilde, kan du køre forespørgsler på disse data. KQL-forespørgselssættet bruger KQL (Kusto Query Language) til at forespørge om data fra en hvilken som helst af de databaser, du har adgang til. Du kan få mere at vide om KQL under Oversigt over Kusto-forespørgselssprog.

I følgende eksempler bruges data, der er offentligt tilgængelige på https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Skriv eller kopiér en forespørgsel i den øverste rude i KQL-forespørgselssættet.

2. Vælg knappen Kør , eller tryk på Skift+Enter for at køre forespørgslen.

   Det resulterende forespørgselsoutput vises i resultatgitteret, som vises under forespørgselsruden. Bemærk den grønne kontrol, der angiver, at forespørgslen blev fuldført korrekt, og den tid, der blev brugt til at beregne forespørgselsresultaterne.

   

Administrer faner for forespørgselssæt

I et KQL-forespørgselssæt kan du oprette flere faner. Hver fane kan knyttes til en anden KQL-database og giver dig mulighed for at gemme forespørgsler til senere brug eller dele med andre for at samarbejde om dataudforskning. Du kan også ændre den KQL-database, der er knyttet til en hvilken som helst fane, så du kan køre den samme forespørgsel på data i forskellige tilstande.

• Tilføj en ny fane: Vælg plus + til højre for de eksisterende faner. Forskellige faner kan forbindes til forskellige databaser.
• Omdøb en fane: Vælg blyantsikonet ud for fanens navn.
• Skift tabulatorplaceringer: Skift tabulatorplaceringer ved hjælp af træk og slip-håndbevægelser.
• Skift den eksisterende databaseforbindelse: Under Stifinder skal du vælge den eksisterende databaseforbindelse for at åbne datahubben.

I højre side af kommandolinjen er der en menu med yderligere handlinger til administration af flere faner i dit forespørgselssæt.

Kopiér forespørgsel

Det kan være en god idé at kopiere og dele de forespørgsler, du opretter.

1. Øverst i forespørgselsvinduet skal du vælge fanen Hjem .

2. Vælg Kopiér forespørgsel i forespørgselsruden.

   

   I følgende tabel beskrives de mange muligheder for, hvordan du kopierer en forespørgsel.

   Handling	Beskrivelse
   Kopiér forespørgsel	Kopiér forespørgselsteksten.
   Link til Udklipsholder	Kopiér et dybt link, der kan bruges til at køre forespørgslen.
   Kæde og forespørg til Udklipsholder	Kopiér et link, der kan bruges til at køre forespørgslen og teksten i forespørgslen.
   Kæde, forespørg og resultater til Udklipsholder	Kopiér et link, der kan bruges til at køre forespørgslen, forespørgslens tekst og resultaterne af forespørgslen.
   Kopiér resultater	Kopiér resultaterne af forespørgslen.

3. Vælg den ønskede handling i ovenstående tabel.

4. Indsæt disse oplysninger for at redigere eller dele dem, f.eks. i Microsoft Word, Microsoft Teams eller Outlook.

   Vigtigt

   Den bruger, der modtager forespørgselslinket, skal have visningstilladelser til de underliggende data for at kunne udføre forespørgslen og få vist resultaterne.

Eksportér forespørgselsdata som CSV

I stedet for blot at kopiere og indsætte forespørgselsoutputtet kan du også eksportere forespørgselsresultaterne.

Dette er en engangsmetode til eksport af en CSV-fil, der indeholder forespørgselsresultaterne.

1. Øverst i forespørgselsvinduet skal du vælge fanen Hjem .

   

2. Vælg Eksportér til CSV i forespørgselsruden.

3. Gem CSV-filen lokalt.

Slet KQL-forespørgselssæt

Sådan sletter du dit KQL-forespørgselssæt:

1. Vælg det arbejdsområde, som dit KQL-forespørgselssæt er placeret i.

2. Peg på det KQL-forespørgselssæt, du vil slette. Vælg Mere [...], og vælg derefter Slet.

   

Næste trin

Tilpas resultater i resultatgitteret for KQL-forespørgselssæt