Spørringsdata i et KQL-spørringssett

I denne artikkelen lærer du hvordan du bruker et KQL-spørringssett. KQL Queryset er elementet som brukes til å kjøre spørringer, vise og tilpasse spørringsresultater på data fra ulike datakilder, for eksempel Eventhouse, KQL-database med mer.

KQL Queryset bruker Kusto-spørringsspråket til å opprette spørringer, og støtter også mange SQL-funksjoner. Hvis du vil ha mer informasjon om spørringsspråket, kan du se Oversikt over Kusto-spørringsspråk.

Forutsetning

• Et arbeidsområde med en Microsoft Fabric-aktivert kapasitet
• En KQL-database med redigeringstillatelser og data, eller en Azure Data Explorer-klynge og database med AllDatabaseAdmin-tillatelser .

Velg en datakilde

Spørringer kjøres i konteksten til en datakilde. Du kan endre den tilknyttede datakilden når som helst, og beholde spørringene som er lagret i redigeringsprogrammet for spørringen. Du kan knytte KQL-spørringssettet til flere datakilder av forskjellige typer, inkludert en KQL-database eller en datakilde fra en Azure Data Explorer-klynge.

Velg fanen som samsvarer med ønsket datakildetype.

KQL-database

1. Åpne KQL-spørringssettet.

2. I ruten på venstre side av spørringssiden, under Explorer- og søkefeltet, bruker du databasebryteren til å utvide tilkoblingsmenyen for datakilder.

   

3. Velg Legg til datakilde, og velg deretter OneLake-datahub.

4. Velg en KQL-database i OneLake-datahubvinduet som vises, for å koble til KQL-spørringssettet, og velg deretter Koble til. Du kan også lukke OneLake-datahuben vinduet og bruke + Legg til datakilde-menyen for å koble til en annen datakilde.

Azure Data Explorer-klynge

1. Åpne KQL-spørringssettet.

2. I ruten på venstre side av spørringssiden, under Explorer- og søkefeltet, bruker du databasebryteren til å utvide tilkoblingsmenyen for datakilder.

   

3. Velg Legg til datakilde, og velg deretter Azure Data Explorer.

4. Angi klynge-URI under Tilkoblings-URI.

   Hvis du vil finne tilkoblings-URI-en, kan du gå til klyngeressursen i Azure-portalen. Tilkoblings-URI-en er URI-en som finnes i oversikten. Hvis du vil legge til en gratis eksempelklynge, angir du «hjelp» som tilkoblings-URI.

   

5. Velg rullegardinmenyen under Databasefor å utvide listen over datakilder i klyngen, og velg deretter en datakilde.

6. Velg Koble til.

En liste over tabeller som er knyttet til denne datakilden, vises under datakildenavnet.

Skrive en spørring

Nå som du er koblet til datakilden, kan du kjøre spørringer på disse dataene. KQL Queryset bruker Kusto Query Language (KQL) til å spørre etter data fra noen av datakildene du har tilgang til. Hvis du vil ha mer informasjon om KQL, kan du se Oversikt over Kusto-spørringsspråk.

Eksemplene nedenfor bruker data som er offentlig tilgjengelige på https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Skriv eller kopier en spørring i den øverste ruten i KQL Queryset.

2. Velg Kjør-knappen, eller trykk SKIFT+ for å kjøre spørringen.

   Resultatet av spørringsutdataene vises i resultatrutenettet, som vises under spørringsruten. Legg merke til den grønne kontrollen som angir at spørringen er fullført, og tiden som brukes til å beregne spørringsresultatene.

   

Samhandle med datakilder

Datakildeutforskeren lar deg bytte mellom datakildene som er koblet til spørringssettfanen du er i.

Øverst i datakildeutforskerruten, under Explorer kan du bruke søkefeltet til å søke etter en bestemt datakilde. Du kan også bruke databasebytteren under søkefeltet til å utvide menyen for datakildetilkoblinger. Velg datakilden du vil bruke. Hvis fanenavnet ikke har blitt redigert tidligere, blir det automatisk oppkalt etter datakilden.

Datakildeutforskerruten har to inndelinger. Den øvre delen viser alle elementene i datakilden, og den nedre delen viser alle tilgjengelige datakilder i spørringssettet.

Elementer i datakilden

Den øvre delen av datakildeutforskeren viser alle elementene som er inkludert i datakilden du bruker.

• Tabeller
• Materialisert visning
• Snarveier
• Funksjoner

Velg pilen > til venstre for elementet du vil utvide. Du kan drille ned for å vise flere detaljer ved å velge pilen > til venstre for elementer i etterfølgende listenivåer. Under Tabellervelger du for eksempel pilen > til venstre for en tabell for å vise listen over kolonnene i tabellen.

Hvis du vil åpne handlingsmenyen, holder du pekeren over et element i den utvidede listen og velger Flere handlinger-menyen [...]. Menyen viser følgende alternativer:

• Oppdater database
• Vis dataprofil
• Sett inn: for å opprette og kopiere et skript
• Hent data: slik legger du til en ny datakilde
• Opprette et instrumentbord
• Slett tabell

Ulike handlinger er tilgjengelige for ulike elementtyper.

Tilgjengelige datakilder

Den nedre delen av datakildeutforskeren viser alle tilgjengelige datakilder som er lagt til i spørringssettet.

Hvis du vil åpne handlingsmenyen, holder du pekeren over datakildenavnet og velger Flere handlinger-menyen [...]. Menyen viser følgende alternativer:

• Oppdater database
• Bruk denne databasen: bytt til å bruke denne datakilden i gjeldende fane
• Spørring i en ny fane: Åpne denne datakilden i en ny fane i spørringssettet
• Fjern kilde: fjerner alle databasene i datakilden
• Fjern database: fjerner bare den valgte databasen

Kopier spørring

Du vil kanskje kopiere og dele spørringene du oppretter.

1. Velg Hjem-fanen øverst i spørringsvinduet.

2. Velg Kopier spørring i spørringsruten.

   

   Tabellen nedenfor beskriver de mange alternativene for hvordan du kopierer en spørring.

   Handling	Bekrivelse
   Kopier spørring	Kopier spørringsteksten.
   Kobling til utklippstavle	Kopier en dyp kobling som kan brukes til å kjøre spørringen.
   Koble og spørre til utklippstavlen	Kopier en kobling som kan brukes til å kjøre spørringen og teksten i spørringen.
   Kobling, spørring og resultater til utklippstavlen	Kopier en kobling som kan brukes til å kjøre spørringen, teksten i spørringen og resultatene av spørringen.
   Kopier resultater	Kopier resultatene av spørringen.

3. Velg ønsket handling fra listen.

4. Lim inn denne informasjonen for å redigere eller dele den, for eksempel i Microsoft Word, Microsoft Teams eller Outlook.

   Viktig

   Brukeren som mottar spørringskoblingen, må ha visningstillatelser til de underliggende dataene for å utføre spørringen og vise resultater.

Behandle spørringssettfaner

I et KQL-spørringssett kan du opprette flere faner. Hver fane kan knyttes til en annen KQL-database, og lar deg lagre spørringer for senere bruk eller dele med andre for å samarbeide om datautforskning. Du kan også endre KQL-databasen som er knyttet til en hvilken som helst fane, slik at du kan kjøre den samme spørringen på data i forskjellige databaser.

Du kan administrere fanene på følgende måter:

• Endre eksisterende datakildetilkobling: Bruk databaseveksleren under Explorer og søkefeltet til å utvide menyen for datakildetilkoblinger.
• Gi nytt navn til en fane: Velg blyantikonetved siden av fanenavnet.
• Legg til en ny fane: Velg pluss +til høyre for de eksisterende fanene på kommandolinjen. Ulike faner kan kobles til ulike datakilder.
• Flere handlinger: På høyre side av kommandolinjen finnes det en fanemeny med flere handlinger for å administrere flere faner i spørringssettet.
• Endre tabulatorposisjoner: Bruk dra- og slippbevegelser.

Eksporter spørringsdata som CSV

I stedet for å kopiere spørringsutdataene, kan du også eksportere spørringsresultatene.

Dette er en engangsmetode for å eksportere en CSV-fil som inneholder spørringsresultatene.

1. Velg Hjem-fanen øverst i spørringsvinduet.

   

2. Velg Eksporter til CSV i spørringsruten.

3. Lagre CSV-filen lokalt.

Slett KQL-spørringssett

Slik sletter du KQL-spørringssettet:

1. Velg arbeidsområdet der KQL-spørringssettet er plassert.

2. Hold pekeren over KQL-spørringssettet du vil slette. Velg Mer [...], og velg deretter Slett.

   

Neste trinn

Tilpasse resultater i KQL Queryset-resultatrutenettet