Opret OneLake-genveje i en KQL-database

OneLake er en enkelt, samlet, logisk datasø til Microsoft Fabric til lagring af lakehouses, lagre, KQL-databaser og andre elementer. Genveje er integrerede referencer i OneLake, der peger på andre filers lagerplaceringer uden at flytte de oprindelige data. Den integrerede reference får det til at se ud, som om filerne og mapperne gemmes lokalt, men i virkeligheden. de findes på en anden lagerplacering. Genveje kan opdateres eller fjernes fra dine elementer, men disse ændringer påvirker ikke de oprindelige data og dens kilde.

I denne artikel lærer du, hvordan du opretter en OneLake-genvej i en KQL-database, der peger på interne Fabric- eller eksterne kilder. Denne type genvej tilgås senere for forespørgsler i KQL-forespørgselssæt ved hjælp af funktionen external_table(). Genveje, der er oprettet i en KQL-database, kan ikke omdøbes, og der kan kun oprettes én genvej ad gangen.

Ud over at oprette genveje fra en KQL-database kan der også oprettes genveje fra andre Fabric-elementer. Disse genveje peger også på data, der er gemt i interne Fabric- eller eksterne kilder, men har forskellige begrænsninger og tilgås forskelligt. Du kan få flere oplysninger under OneLake-genveje.

Bemærk

Brug OneLake-genveje, når du sjældent vil køre forespørgsler på historiske data uden at partitionere eller indeksere dataene. Hvis du vil køre forespørgsler ofte og fremskynde ydeevnen, skal du importere dataene direkte i din KQL-database.

Vælg den fane, der svarer til den genvej, du vil oprette:

OneLake-genvej

Forudsætninger

• Et arbejdsområde med en Microsoft Fabric-aktiveret kapacitet
• En KQL-database med redigeringstilladelser
• Et lakehouse

Hvis du vil have adgang til dataene i din KQL-database i andre Microsoft Fabric-oplevelser, skal du se Én logisk kopi.

Opret genvej

Bemærk

I følgende flow kan du se, hvordan du opretter en genvej, der peger på data i en Lakehouse i Fabric. På samme måde kan du oprette genveje, der peger på Data Warehouses eller andre KQL-databaser.

1. Gå til en eksisterende KQL-database.

2. Vælg Ny>OneLake-genvej.

   

Vælg en kilde

1. Under Interne kilder skal du vælge Microsoft OneLake.

   

2. Vælg den datakilde, du vil oprette forbindelse til, og vælg derefter Næste.

   

3. Udvid Tabeller, og vælg en bestemt tabel, der skal oprettes forbindelse til.

   

4. Vælg Opret.

Bemærk

Du kan kun oprette forbindelse til én undermappe eller tabel pr. genvej. Hvis du vil oprette forbindelse til flere data, skal du gentage disse trin og oprette flere genveje.

Azure Data Lake Storage Gen2

Forudsætninger

• Et arbejdsområde med en Microsoft Fabric-aktiveret kapacitet
• En KQL-database med redigeringstilladelser
• En Azure Data Lake Storage Gen2-konto .

Opret genvej

1. Gå til en eksisterende KQL-database.

2. Vælg Ny>OneLake-genvej.

   

Vælg en kilde

1. Under Eksterne kilder skal du vælge Azure Data Lake Storage Gen2.

2. Angiv indstillingerne for Forbind ion i henhold til følgende tabel:

   

   Felt	Beskrivelse	Værdi
   URL-adresse	Forbindelsesstreng for deltaobjektbeholderen.	https://StorageAccountName.dfs.core.windows.net
   Forbind ion	Tidligere definerede forbindelser for den angivne lagerplacering vises på rullelisten. Hvis der ikke findes nogen forbindelser, skal du oprette en ny forbindelse.	Opret ny forbindelse.
   Forbindelsesnavn	Azure Data Lake Storage Gen2-forbindelsesnavnet.	Et navn til din forbindelse.
   Godkendelsestype	Godkendelsesmodellen. De understøttede modeller er: Organisationskonto, Kontonøgle, SAS (Shared Access Signature) og Tjenesteprincipal. Du kan få flere oplysninger under ADLS-genveje.	Afhængig af godkendelsesmodellen. Når du har valgt en godkendelsestype, skal du udfylde de påkrævede legitimationsoplysninger.

3. Vælg Næste.

4. Gå til genvejens destinationsplacering.

   

   Hvis du lige har brugt lagerkontoen i URL-adressen til forbindelsen, vises alle dine tilgængelige objektbeholdere i venstre navigationsvisning. Hvis du har angivet en objektbeholder i URL-adressen til forbindelsen, er det kun den angivne objektbeholder og dens indhold, der vises i navigationsvisningen.

   Naviger til lagerkontoen ved at vælge en mappe eller klikke på udvidelsesroden ud for en mappe.

   I denne visning kan du vælge en eller flere genvejsmålplaceringer. Vælg destinationsplaceringer ved at klikke på afkrydsningsfeltet ud for en mappe i venstre navigationsvisning.

5. Vælg Næste

   

   Gennemsynssiden giver dig mulighed for at bekræfte alle dine valg. Her kan du se hver genvej, der oprettes. I handlingskolonnen kan du klikke på blyantsikonet for at redigere genvejsnavnet. Du kan klikke på papirkurvsikonet for at slette genvejen.

6. Vælg Opret.

Amazon S3

Forudsætninger

• Et arbejdsområde med en Microsoft Fabric-aktiveret kapacitet
• En KQL-database med redigeringstilladelser
• En Amazon S3-konto. Du kan få flere oplysninger under Hvad er Amazon S3?

Opret genvej

1. Gå til en eksisterende KQL-database.

2. Vælg Ny>OneLake-genvej.

   

Vælg en kilde

1. Under Eksterne kilder skal du vælge Amazon S3.

2. Angiv indstillingerne for Forbind ion i henhold til følgende tabel:

   

   Felt	Beskrivelse	Værdi
   URL-adresse	Forbindelsesstreng for din Amazon S3-bucket.	https://BucketName.s3.RegionCode.amazonaws.com
   Forbind ion	Tidligere definerede forbindelser for den angivne lagerplacering vises på rullelisten. Hvis der ikke findes nogen forbindelser, skal du oprette en ny forbindelse.	Opret ny forbindelse
   Forbindelsesnavn	Amazon S3-forbindelsesnavnet.	Et navn til din forbindelse.
   Godkendelsestype	IAM-politikken (Identity and Access Management). Politikken skal have læse- og listetilladelser. Du kan få flere oplysninger under IAM-brugere.	Afhængig af bucketpolitikken.
   Adgangsnøgle-id	IAM-brugernøglen (Identity and Access Management). Du kan få flere oplysninger under Administrer adgangsnøgler for IAM-brugere.	Din adgangsnøgle.
   Hemmelig adgangsnøgle	IAM-nøglen (Identity and Access Management).	Din hemmelige nøgle.

Vælg Næste.

1. Gå til genvejens destinationsplacering.

   

   Hvis du har brugt det globale slutpunkt i URL-adressen til forbindelsen, vises alle de tilgængelige buckets i venstre navigationsvisning. Hvis du har brugt et bucketspecifikt slutpunkt i URL-adressen til forbindelsen, er det kun den angivne bucket og dens indhold, der vises i navigationsvisningen.

   Naviger til lagerkontoen ved at vælge en mappe eller klikke på udvidelsesroden ud for en mappe.

   I denne visning kan du vælge en eller flere genvejsmålplaceringer. Vælg destinationsplaceringer ved at klikke på afkrydsningsfeltet ud for en mappe i venstre navigationsvisning.

2. Vælg Næste

   

   Gennemsynssiden giver dig mulighed for at bekræfte alle dine valg. Her kan du se hver genvej, der oprettes. I handlingskolonnen kan du klikke på blyantsikonet for at redigere genvejsnavnet. Du kan klikke på papirkurvsikonet for at slette genvejen.

3. Vælg Opret.

Databasen opdateres automatisk. Genvejen vises under Genveje i ruden Stifinder .

Genvejen OneLake er blevet oprettet. Du kan nu forespørge om disse data.

Forespørg om data

Hvis du vil forespørge om data fra OneLake-genvejen, skal du bruge funktionen external_table().

1. Vælg Udforsk dine data i højre side af databasen. Vinduet åbnes med et par eksempelforespørgsler, som du kan køre for at få et indledende kig på dine data.
2. Erstat pladsholderen for tabelnavnet med external_table('Genvejsnavn').
3. Vælg Kør , eller tryk på Skift + Enter for at køre en valgt forespørgsel.

Tilknytning af datatyper

Delta-parquet til tilknytning af hændelseshusdatatyper

Delta primitive datatyper knyttes til skalardatatyper for hændelseshus ved hjælp af følgende regler. Du kan finde flere oplysninger om datatyper for hændelseshus under Scalar-datatyper.

Deltatype	Skalardatatype for hændelseshus
string	string
long	long
integer	int
short	int
byte	real
float	real
double	real
decimal	decimal
boolean	bool
binary	string
date	datetime
timestamp_ntz (uden tidszone)	datetime
struct	dynamic
array	dynamic
map	dynamic

Relateret indhold

• Forespørg om data i et KQL-forespørgselssæt
• external_table() Funktion