Opprette OneLake-snarveier i en KQL-database

OneLake-snarveier i en KQL-database lar deg spørre data i interne Fabric-elementer og ekstern lagring uten å flytte dataene. I en KQL-database vises hver snarvei under Snarveier og forespørres som en ekstern tabell i et KQL-spørringssett ved å bruke funksjonenexternal_table().

I denne artikkelen lærer du hvordan du oppretter en OneLake-snarvei i en KQL-database som peker til interne stoffer eller eksterne kilder. Du kan ikke gi nytt navn på snarveier laget i en KQL-database, og du kan bare lage én snarvei om gangen.

For generell informasjon om snarveityper, kildespesifikke instruksjoner og bredere begrensninger, se OneLake-snarveier.

Merk

For å forbedre spørringsytelsen over støttede snarveier, se Spørringsakselerasjon over OneLake-snarveier.

Forutsetning

Hvis du vil ha tilgang til dataene i KQL-databasen i andre Microsoft Fabric-opplevelser, kan du se En logisk kopi.

Opprette en snarvei

  1. Bla til en eksisterende KQL-database.

  2. Velg +>New>OneLake-snarvei.

    Skjermbilde av Hjem-fanen som viser rullegardinlisten for Ny-knappen. Alternativet OneLake-snarvei med tittelen er uthevet.

Velg en kilde

KQL-databaser støtter snarveier til interne OneLake-ressurser, som KQL-databaser, innsjøhus og lagerbygninger, samt til eksterne ressurser, som Azure Data Lake Storage, Amazon S3 og Google Cloud Storage. For en fullstendig liste over støttede snarveistyper og kildespesifikke konfigurasjonsveiledninger, se Typer av snarveier.

  1. I Ny snarvei-vinduet velger du kildetypen du vil koble til.
  2. Fyll ut nødvendige tilkoblingsdetaljer for kilden, og velg deretter mappen eller tabellen du vil eksponere i KQL-databasen.
  3. Valgfritt: For å aktivere spørringsakselerasjon på den nye snarveien, sett Akselerer til På.
  4. Velg Opprett.

For støttede scenarier og begrensninger, se Spørringsakselerasjon for OneLake-snarveier – oversikt.

Skjermbilde av det nye snarveisvinduet som viser snarveidetaljene. Akseler-bryteren er markert.

Merk

  1. Du kan bare koble til én undermappe eller tabell per snarvei. For å koble til mer data, lag flere snarveier.
  2. Du kan ikke lage en snarvei over en tabell som har en stjerne (*) i et hvilket som helst kolonnenavn. Gi kolonnene nytt navn før du lager snarveien.

Etter at du har opprettet snarveien, oppdateres databasen automatisk. Snarveien vises under Snarveier i Explorer-ruten . Du kan nå spørre dataene.

Skjermbilde av Explorer-ruten som viser den nye snarveien.

Organiser snarveier med mapper

For å opprette en undermappe eller flytte til en eksisterende mappe:

  1. I utforskerpanelet, enten:
    • Høyreklikk på snarveien og velg Flytt til mappe>+Ny mappe.
      Skjermbilde av popup-menyen som viser muligheten til å opprette en ny mappe for snarveien.
    • Eller velg ellipsen (...) ved siden av den spesifikke snarveien og velg Flytt til mappe>+ Ny mappe , eller velg en eksisterende mappe.
      Skjermbilde av popup-menyen som viser muligheten til å flytte snarveien til en eksisterende mappe eller opprette en ny.
  2. For å opprette en mappe, skriv inn et navn på mappen og velg Opprette. Snarveien flyttes til den nye mappen.
    Skjermbilde av den nye mappen som opprettes.
  3. For å flytte mer enn én snarvei, må du enten skrive inn et annet mappenavn eller velge nedtrekksmenyen og krysse av i boksene ved siden av snarveiene du vil flytte til samme mappe.
    Skjermbilde av pop-up-menyen som viser muligheten til å flytte flere snarveier til samme mappe.
  4. Du kan også flytte snarveier til en eksisterende mappe. For å gjøre det, velg Flytt til mappe og deretter mappen du vil flytte snarveien til, eller dra og slipp snarveien inn i mappen.

Merk

  • Hvis du sletter en undermappe, blir ikke snarveiene i mappen slettet, men flyttes tilbake til foreldremappen.
  • En undermappe slettes automatisk når det ikke finnes snarveier i mappen.
  • Mapper kan opprettes per ressurstype, og navnet må være unikt per ressurstype. For eksempel kan du ha en tabellmappe og en snarveismappe med samme navn, men du kan ikke ha to snarveismapper med samme navn.

Spørringsdata

Hvis du vil spørre etter data fra OneLake-snarveien external_table() , bruker du funksjonen.

  1. På høyre side av databasen din, velg Utforsk dataene dine. Vinduet åpnes med noen eksempler på spørringer du kan kjøre for å få en innledende titt på dataene.
  2. Erstatt plassholderen for tabellnavnet med external_table('<shortcut-name>').
  3. Velg Kjør eller trykk SKIFT + ENTER for å kjøre en valgt spørring.

Skjermbilde av Utforsk datavinduet som viser resultatene av en eksempelspørring.

Tilordning av datatype

Delta Parquet til Eventhouse datatypekartlegging

Delta-primitive datatyper kartlegges til Eventhouse-skalardatatyper som vist i tabellen nedenfor. For mer informasjon, se Skalar datatyper.

Delta-type Eventhouse skalar datatype
string string
long long
integer int
short int
byte real
float real
double real
decimal decimal
boolean bool
binary string
date datetime
timestamp_ntz (uten tidssone) datetime
struct dynamic
array dynamic
map dynamic

Automatisk skjema-synkronisering

Tabellskjemaer for en snarveitabell synkroniseres automatisk, slik at kolonnetillegg, slettinger, omdøpninger og typeendringer i kildetabellen reflekteres i snarveien uten å kreve manuelle oppdateringer. Denne oppførselen er aktivert som standard. For å deaktivere den, kjør følgende kommando i kildedatabasen:

.create-or-alter external table ExternalTable
kind=delta
(
   h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)

For mer informasjon om skjemasynkroniseringsatferd, se Automatisk skjemasynkronisering.

Relatert innhold

  • Last updated on