Opprette OneLake-snarveier i en KQL-database

OneLake er en enkel, enhetlig, logisk datainnsjø for Microsoft Fabric for lagring av innsjøer, varehus, KQL-databaser og andre elementer. Snarveier er innebygde referanser i OneLake som peker til andre filers lagringsplasseringer uten å flytte de opprinnelige dataene. Den innebygde referansen får det til å se ut som om filene og mappene lagres lokalt, men i virkeligheten. de finnes på et annet lagringssted. Snarveier kan oppdateres eller fjernes fra elementene, men disse endringene påvirker ikke de opprinnelige dataene og kilden.

I denne artikkelen lærer du hvordan du oppretter en OneLake-snarvei i en KQL-database som peker til interne stoffer eller eksterne kilder. Denne typen snarvei åpnes senere for spørring i KQL-spørringssett ved hjelp external_table() av funksjonen. Snarveier som er opprettet i en KQL-database, kan ikke gis nytt navn, og bare én snarvei kan opprettes om gangen.

I tillegg til å opprette snarveier fra en KQL-database, kan snarveier også opprettes fra andre stoffelementer. Disse hurtigtastene peker også på data som er lagret i interne stoffer eller eksterne kilder, men har forskjellige begrensninger og åpnes på en annen måte. Hvis du vil ha mer informasjon, kan du se OneLake-snarveier.

Merk

Hvis du vil akselerere spørringer over OneLake-snarveier, kan du se Akselerere spørringer over OneLake-snarveier.

Velg fanen som tilsvarer snarveien du vil opprette:

OneLake-snarvei

Forutsetning

• Et arbeidsområde med en Microsoft Fabric-aktivert kapasitet
• En KQL-database med redigeringstillatelser
• A Lakehouse

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

Opprett snarvei

Merk

Følgende flyt viser hvordan du oppretter en snarvei som peker til data i et Lakehouse i Fabric. På samme måte kan du opprette snarveier som peker til datalagre eller andre KQL-databaser.

1. Bla til en eksisterende KQL-database.

2. Velg Ny>OneLake-snarvei.

   

Velg en kilde

1. Velg Microsoft OneLake under Interne kilder.

   

2. Velg datakilden du vil koble til, og velg deretter Neste.

   

3. Utvid tabeller, og velg en bestemt tabell du vil koble til.

   

4. Velg Neste.

Merk

Hvis du vil aktivere spørringsakselerasjon på en ny snarvei, kan du slå på Hurtigtast-knappen. Hvis du vil ha mer informasjon, kan du se Akselerere spørringer over OneLake-snarveier.

5. Velg Opprett.

Merk

Du kan bare koble til én undermappe eller tabell per snarvei. Hvis du vil koble til flere data, gjentar du disse trinnene og oppretter flere snarveier.

Azure Data Lake Storage Gen2

Forutsetning

• Et arbeidsområde med en Microsoft Fabric-aktivert kapasitet
• En KQL-database med redigeringstillatelser
• En Azure Data Lake Storage Gen2-konto .

Opprett snarvei

1. Bla til en eksisterende KQL-database.

2. Velg Ny>OneLake-snarvei.

   

Velg en kilde

1. Velg Azure Data Lake Storage Gen2 under Eksterne kilder.

2. Skriv inn tilkoblingsinnstillingene i henhold til følgende tabell:

   

   Felt	Beskrivelse	Verdi
   Nettadresse	Den tilkoblingsstreng for deltabeholderen.	https://StorageAccountName.dfs.core.windows.net
   Forbindelse	Tidligere definerte tilkoblinger for den angitte lagringsplasseringen vises i rullegardinlisten. Hvis det ikke finnes noen tilkoblinger, oppretter du en ny tilkobling.	Opprett ny tilkobling.
   Tilkoblingsnavn	Tilkoblingsnavnet for Azure Data Lake Storage Gen2.	Et navn på tilkoblingen.
   Godkjenningstype	Godkjenningsmodellen. De støttede modellene er: Organisasjonskonto, kontonøkkel, SAS (Shared Access Signature), Service Principal og Workspace Identity. Hvis du vil ha mer informasjon, kan du se ADLS-snarveier.	Avhengig av godkjenningsmodellen. Når du har valgt en godkjenningstype, fyller du inn den nødvendige legitimasjonen.

3. Velg Neste.

4. Bla til målplasseringen for snarveien.

   

   Hvis du nettopp brukte lagringskontoen i nettadressen for tilkoblingen, vises alle tilgjengelige beholdere i venstre navigasjonsvisning. Hvis du har angitt en beholder i nettadressen for tilkobling, vises bare den angitte beholderen og innholdet i navigasjonsvisningen.

   Naviger lagringskontoen ved å velge en mappe eller klikke på utvidelsespilen ved siden av en mappe.

   I denne visningen kan du velge én eller flere målplasseringer for snarveier. Velg målplasseringer ved å klikke på avmerkingsboksen ved siden av en mappe i venstre navigasjonsvisning.

5. Velg Neste

   

   Med gjennomgangssiden kan du bekrefte alle valgene dine. Her kan du se hver snarvei som skal opprettes. I handlingskolonnen kan du klikke blyantikonet for å redigere snarveisnavnet. Du kan klikke papirkurvikonet for å slette snarveien.

6. Velg Opprett.

Amazon S3

Forutsetning

• Et arbeidsområde med en Microsoft Fabric-aktivert kapasitet
• En KQL-database med redigeringstillatelser
• En Amazon S3-konto. Hvis du vil ha mer informasjon, kan du se Hva er Amazon S3?

Opprett snarvei

1. Bla til en eksisterende KQL-database.

2. Velg Ny>OneLake-snarvei.

   

Velg en kilde

1. Velg Amazon S3 under Eksterne kilder.

2. Skriv inn tilkoblingsinnstillingene i henhold til følgende tabell:

   

   Felt	Beskrivelse	Verdi
   Nettadresse	Den tilkoblingsstreng for Amazon S3 bøtte.	https://BucketName.s3.RegionCode.amazonaws.com
   Forbindelse	Tidligere definerte tilkoblinger for den angitte lagringsplasseringen vises i rullegardinlisten. Hvis det ikke finnes noen tilkoblinger, oppretter du en ny tilkobling.	Opprett ny tilkobling
   Tilkoblingsnavn	Amazon S3-tilkoblingsnavnet.	Et navn på tilkoblingen.
   Godkjenningstype	IAM-policyen (Identity and Access Management). Policyen må ha lese- og listetillatelser. Hvis du vil ha mer informasjon, kan du se IAM-brukere.	Avhengig av samlingspolicyen.
   Nøkkel-ID for Access	IAM-brukernøkkelen (Identity and Access Management). Hvis du vil ha mer informasjon, kan du se Behandle tilgangstaster for IAM-brukere.	Tilgangsnøkkelen.
   Hemmelig tilgangsnøkkel	Den hemmelige nøkkelen for identitets- og tilgangsbehandling (IAM ).	Din hemmelige nøkkel.

Velg Neste.

1. Bla til målplasseringen for snarveien.

   

   Hvis du brukte det globale endepunktet i nettadressen for tilkoblingen, vises alle tilgjengelige samlinger i venstre navigasjonsvisning. Hvis du brukte et samlingsspesifikkt endepunkt i nettadressen for tilkoblingen, vises bare den angitte samlingen og innholdet i navigasjonsvisningen.

   Naviger lagringskontoen ved å velge en mappe eller klikke på utvidelsespilen ved siden av en mappe.

   I denne visningen kan du velge én eller flere målplasseringer for snarveier. Velg målplasseringer ved å klikke på avmerkingsboksen ved siden av en mappe i venstre navigasjonsvisning.

2. Velg Neste

   

   Med gjennomgangssiden kan du bekrefte alle valgene dine. Her kan du se hver snarvei som skal opprettes. I handlingskolonnen kan du klikke blyantikonet for å redigere snarveisnavnet. Du kan klikke papirkurvikonet for å slette snarveien.

3. Velg Opprett.

Databasen oppdateres automatisk. Snarveien vises under Snarveier i Explorer-ruten .

OneLake-snarveien er opprettet. Nå kan du spørre etter disse dataene.

Spørringsdata

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

1. Velg Utforsk dataene på høyre side av databasen. Vinduet åpnes med noen eksempler på spørringer du kan kjøre for å få en innledende titt på dataene.
2. Erstatt plassholderen for tabellnavn med external_table('snarveisnavn').
3. Velg Kjør eller trykk SKIFT + ENTER for å kjøre en valgt spørring.

Tilordning av datatyper

Deltaparquet til Eventhouse-datatypertilordning

Delta primitive datatyper tilordnes eventhouse-skalardatatyper ved hjelp av følgende regler. Hvis du vil ha mer informasjon om Datatyper i Eventhouse, kan du se Skalardatatyper.

Deltatype	Skalardatatype for hendelseshus
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

Relatert innhold

• Spørringsdata i et KQL-spørringssett
• external_table() funksjon
• Akselerere spørringer over OneLake-snarveier