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:
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.
Gå til en eksisterende KQL-database.
Vælg Ny>OneLake-genvej.
Vælg en kilde
Under Interne kilder skal du vælge Microsoft OneLake.
Vælg den datakilde, du vil oprette forbindelse til, og vælg derefter Næste.
Udvid Tabeller, og vælg en bestemt tabel, der skal oprettes forbindelse til.
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.
Under Eksterne kilder skal du vælge Azure Data Lake Storage Gen2.
Angiv forbindelsesindstillingerne i overensstemmelse med følgende tabel:
Felt
Beskrivelse
Værdi
URL-adresse
Forbindelsesstreng for deltaobjektbeholderen.
https://StorageAccountName.dfs.core.windows.net
Forbindelse
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), Tjenesteprincipal og Arbejdsområdeidentitet. 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.
Vælg Næste.
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å udvidelsespilen 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.
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.
En Amazon S3-konto. Du kan få flere oplysninger under Hvad er Amazon S3?
Opret genvej
Gå til en eksisterende KQL-database.
Vælg Ny>OneLake-genvej.
Vælg en kilde
Under Eksterne kilder skal du vælge Amazon S3.
Angiv forbindelsesindstillingerne i overensstemmelse med følgende tabel:
Felt
Beskrivelse
Værdi
URL-adresse
Forbindelsesstreng for din Amazon S3-bucket.
https://BucketName.s3.RegionCode.amazonaws.com
Forbindelse
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.
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å udvidelsespilen 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.
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.
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().
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.
Erstat pladsholderen for tabelnavnet med external_table('Genvejsnavn').
Vælg Kør , eller tryk på Skift + Enter for at køre en valgt forespørgsel.
Tilknytning af datatyper
Tilknytning af Delta-parquet til Eventhouse-datatyper
Delta primitive datatyper knyttes til Eventhouse-skalardatatyper ved hjælp af følgende regler. Du kan få flere oplysninger om Eventhouse-datatyper under Scalar-datatyper.
