OneLake-genveje

Genveje i Microsoft OneLake giver dig mulighed for at samle dine data på tværs af domæner, cloudmiljøer og konti ved at oprette en enkelt virtuel data lake for hele virksomheden. Alle Fabric-oplevelser og analyseprogrammer kan oprette direkte forbindelse til dine eksisterende datakilder, f.eks. Azure, Amazon Web Services (AWS) og OneLake via et samlet navneområde. OneLake administrerer alle tilladelser og legitimationsoplysninger, så du ikke behøver at konfigurere hver Enkelt Fabric-arbejdsbelastning separat for at oprette forbindelse til hver datakilde. Derudover kan du bruge genveje til at fjerne kantkopier af data og reducere procesventetiden, der er knyttet til datakopier og midlertidig lagring.

Hvad er genveje?

Genveje er objekter i OneLake, der peger på andre lagerplaceringer. Placeringen kan være intern eller ekstern i forhold til OneLake. Den placering, som en genvej peger på, kaldes genvejens destinationssti. Den placering, hvor genvejen vises, kaldes genvejsstien. Genveje vises som mapper i OneLake, og alle arbejdsbelastninger eller tjenester, der har adgang til OneLake, kan bruge dem. Genveje fungerer som symbolske kæder. De er et uafhængigt objekt fra målet. Hvis du sletter en genvej, påvirkes destinationen ikke. Hvis du flytter, omdøber eller sletter en destinationssti, kan genvejen blive brudt.

Hvor kan jeg oprette genveje?

Du kan oprette genveje i lakehouses og KQL-databaser (Kusto Query Language). Desuden kan de genveje, du opretter i disse elementer, pege på andre OneLake-placeringer, Azure Data Lake Storage (ADLS) Gen2, Amazon S3-lagerkonti eller Dataverse. Du kan endda oprette genveje til placeringer , der er begrænset til det lokale miljø eller netværket, ved hjælp af OPDG (Fabric on-premises data gateway).

Du kan bruge Brugergrænsefladen i Fabric til at oprette genveje interaktivt, og du kan bruge REST-API'en til at oprette genveje programmatisk.

Lakehouse

Når du opretter genveje i et lakehouse, skal du forstå elementets mappestruktur. Lakehouses består af to mapper på øverste niveau: mappen Tables og mappen Files. Mappen tabeller repræsenterer den administrerede del af lakehouse'et for strukturerede datasæt. Mens mappen Filer er den ikke-administrerede del af lakehouse'et for ustrukturerede eller semi-strukturerede data.

I mappen Tabeller kan du kun oprette genveje på øverste niveau. Genveje understøttes ikke i undermapper i mappen Tables. Genveje i tabelafsnittet peger typisk på interne kilder i OneLake eller linker til andre dataaktiver, der er i overensstemmelse med Delta-tabelformatet. Hvis destinationen for genvejen indeholder data i formatet Delta\Parquet, synkroniserer lakehouse automatisk metadataene og genkender mappen som en tabel. Genveje i tabelafsnittet kan linke til enten en enkelt tabel eller et skema, som er en overordnet mappe til flere tabeller.

Bemærk

Delta-formatet understøtter ikke tabeller med mellemrumstegn i navnet. Enhver genvej, der indeholder et mellemrum i navnet, bliver ikke fundet som en Delta-tabel i lakehouse.

I mappen Filer er der ingen begrænsninger for, hvor du kan oprette genveje. Du kan oprette dem på et hvilket som helst niveau i mappehierarkiet. Registrering af tabeller sker ikke i mappen Filer . Genveje her kan pege på både interne (OneLake) og eksterne lagersystemer med data i et hvilket som helst format.

KQL-database

Når du opretter en genvej i en KQL-database, vises den i mappen Genveje i databasen. KQL-databasen behandler genveje som eksterne tabeller. Hvis du vil forespørge genvejen external_table , skal du bruge funktionen for Kusto-forespørgselssproget.

Hvor kan jeg få adgang til genveje?

Alle Fabric- eller ikke-Fabric-tjenester, der kan få adgang til data i OneLake, kan bruge genveje. Genveje er gennemsigtige for alle tjenester, der tilgår data via OneLake-API'en. Genveje vises blot som en anden mappe i søen. Apache Spark, SQL, Realtidsintelligens og Analysis Services kan alle bruge genveje, når der forespørger om data.

Apache Spark

Apache Spark-notesbøger og Apache Spark-job kan bruge genveje, som du opretter i OneLake. Relative filstier kan bruges til at læse data direkte fra genveje. Hvis du desuden opretter en genvej i afsnittet Tabeller i lakehouse, og den er i Delta-formatet, kan du læse den som en administreret tabel ved hjælp af Apache Spark SQL-syntaksen.

df = spark.read.format("delta").load("Tables/MyShortcut")
display(df)

df = spark.sql("SELECT * FROM MyLakehouse.MyShortcut LIMIT 1000")
display(df)

SQL

Du kan læse genveje i afsnittet Tabeller i et lakehouse via SQL Analytics-slutpunktet for lakehouse'et. Du kan få adgang til SQL Analytics-slutpunktet via tilstandsvælgeren for lakehouse'et eller via SQL Server Management Studio (SSMS).

SELECT TOP (100) *
FROM [MyLakehouse].[dbo].[MyShortcut]

Intelligence i realtid

Genveje i KQL-databaser genkendes som eksterne tabeller. Hvis du vil forespørge genvejen external_table , skal du bruge funktionen for Kusto-forespørgselssproget.

external_table('MyShortcut')
| take 100

Analysis Services

Du kan oprette semantiske modeller til lakehouses, der indeholder genveje i afsnittet Tabeller i lakehouse. Når den semantiske model kører i Direct Lake-tilstand, kan Analysis Services læse data direkte fra genvejen.

Ikke-stof

Programmer og tjenester uden for Fabric kan også få adgang til genveje via OneLake-API'en. OneLake understøtter et undersæt af ADLS Gen2- og Blob Storage-API'er. Hvis du vil vide mere om OneLake-API'en, skal du se OneLake-adgang med API'er.

https://onelake.dfs.fabric.microsoft.com/MyWorkspace/MyLakhouse/Tables/MyShortcut/MyFile.csv

Typer af genveje

OneLake-genveje understøtter flere filsystemdatakilder. Disse omfatter interne OneLake-placeringer, Azure Data Lake Storage (ADLS) Gen2, Amazon S3, S3-kompatibel, Google Cloud Storage (GCS) og Dataverse.

Interne OneLake-genveje

Interne OneLake-genveje giver dig mulighed for at referere til data i eksisterende Fabric-elementer, herunder:

• KQL-databaser
• Lakehouses
• Spejlede Azure Databricks-kataloger
• Spejlede databaser
• Semantiske modeller
• SQL-databaser
• Lagersteder

Genvejen kan pege på en mappeplacering i det samme element, på tværs af elementer i det samme arbejdsområde eller endda på tværs af elementer i forskellige arbejdsområder. Når du opretter en genvej på tværs af elementer, behøver elementtyperne ikke at stemme overens. Du kan f.eks. oprette en genvej i et lakehouse, der peger på data i et data warehouse.

Når en bruger får adgang til data via en genvej til en anden OneLake-placering, bruger OneLake identiteten for den kaldende bruger til at godkende adgang til dataene i genvejens destinationssti. Denne bruger skal have tilladelser på målplaceringen for at kunne læse dataene.

Vigtigt

Når du får adgang til genveje via semantiske Power BI-modeller ved hjælp af DirectLake via SQL- eller T-SQL-motorer i delegeret identitetstilstand, overføres den kaldende brugers identitet ikke til genvejsmålet. Ejeren af opkaldselementet overføres i stedet for og uddelegerer adgang til den kaldende bruger. Du kan løse dette ved at bruge semantiske Power BI-modeller i DirectLake via OneLake-tilstand eller T-SQL i brugerens identitetstilstand.

Genveje til Azure Data Lake Storage

Når du opretter genveje til Azure Data Lake Storage (ADLS) Gen2-lagerkonti, kan destinationsstien pege på en hvilken som helst mappe i det hierarkiske navneområde. Destinationsstien skal som minimum indeholde et objektbeholdernavn.

Bemærk

Hierarkiske navneområder skal være aktiveret på din ADLS Gen 2-lagerkonto.

Adgang

ADLS-genveje skal pege på DFS-slutpunktet for lagerkontoen.

Eksempel: https://accountname.dfs.core.windows.net/

Hvis din lagerkonto er beskyttet af en lagerfirewall, kan du konfigurere tjenesteadgang, der er tillid til. Du kan få flere oplysninger under Adgang til arbejdsområder, der er tillid til

Autorisation

ADLS-genveje bruger en delegeret godkendelsesmodel. I denne model angiver genvejsforfatteren en legitimationsoplysninger for ADLS-genvejen, og al adgang til genvejen er godkendt ved hjælp af disse legitimationsoplysninger. ADLS-genveje understøtter følgende delegerede godkendelsestyper:

• Organisationskonto – skal have rollen Lagerblobdatalæser, Bidragyder til lagerblobdata eller Ejer af lagerblobdata på lagerkontoen. eller Rollen Delegator på lagerkontoen plus den fil- eller mappeadgang, der er tildelt i lagerkontoen.
• Tjenesteprincipal – skal have rollen Lagerblobdatalæser, Bidragyder til lagerblobdata eller Ejer af lagerblobdata på lagerkontoen. eller Rollen Delegator på lagerkontoen plus den fil- eller mappeadgang, der er tildelt i lagerkontoen.
• Arbejdsområdeidentitet – skal have rollen Lagerblobdatalæser, Bidragyder til lagerblobdata eller Ejer af lagerblobdata på lagerkontoen. eller Rollen Delegator på lagerkontoen plus den fil- eller mappeadgang, der er tildelt i lagerkontoen.
• SAS (Shared Access Signature) – skal som minimum indeholde følgende tilladelser: Læs, Liste og Udfør.

Delegerede godkendelsestyper for Microsoft Entra-id (organisationskonto, tjenesteprincipal eller arbejdsområdeidentitet) kræver handlingen Generér en brugerdelegeringsnøgle på lagerkontoniveau. Denne handling er inkluderet som en del af rollerne Storage Blob Data Reader, Storage Blob Data Contributor, Storage Blob Data Owner og Delegator. Hvis du ikke vil give en brugerlæser, bidragyder eller ejer tilladelser til hele lagerkontoen, skal du tildele vedkommende rollen Delegator i stedet. Definer derefter detaljerede dataadgangsrettigheder ved hjælp af adgangskontrollister (ACL'er) i Azure Data Lake Storage.

Vigtigt

Kravet Generér en brugerdelegeringsnøgle gennemtvinges ikke i øjeblikket, når et arbejdsområdeidentitet er konfigureret for arbejdsområdet, og ADLS-genvejsgodkendelsestypen er Organisationskonto, Tjenesteprincipal eller Arbejdsområdeidentitet. Denne funktionsmåde vil dog blive begrænset i fremtiden. Vi anbefaler, at du sikrer, at alle delegerede identiteter har handlingen Generér en brugerdelegeringsnøgle for at sikre, at brugernes adgang ikke påvirkes, når denne funktionsmåde ændres.

Begrænsninger

Følgende begrænsninger gælder for ADLS-genveje:

• ADLS-genvejsmålstier kan ikke indeholde reserverede tegn fra RFC 3986 afsnit 2.2. Se RFC 3968 section 2.3 for tilladte tegn.
• ADLS-genveje understøtter ikke Copy Blob API'en.
• Funktionen Copy fungerer ikke på genveje, der peger direkte på ADLS-objektbeholdere. Det anbefales at oprette ADLS-genveje til en mappe, der er mindst ét niveau under en objektbeholder.
• OneLake-genveje understøtter ikke forbindelser til ADLS Gen2-lagerkonti, der bruger administrerede private slutpunkter. Du kan finde flere oplysninger under administrerede private slutpunkter for Fabric.
• Flere genveje kan ikke oprettes inde i ADLS-genveje.
• ADLS genvej 2 genveje understøttes ikke for lagringskonti, der bruger Microsoft Purview datadeling.

Genveje til Azure Blob Storage

Adgang

Genvejen Azure Blob Storage kan pege på kontonavnet eller URL-adressen for lagerkontoen.

Eksempel: accountname eller https://accountname.blob.core.windows.net/

Autorisation

Genveje til Blob Storage bruger en delegeret godkendelsesmodel. I denne model angiver forfatteren af genvejen en legitimationsoplysninger for genvejen, og al adgang til genvejen er godkendt ved hjælp af disse legitimationsoplysninger. Blobgenveje understøtter følgende delegerede godkendelsestyper:

• Organisationskonto – skal have rollen Lagerblobdatalæser, Bidragyder til lagerblobdata eller Ejer af lagerblobdata på lagerkontoen. eller Rollen Delegator på lagerkontoen plus den fil- eller mappeadgang, der er tildelt i lagerkontoen.
• Tjenesteprincipal – skal have rollen Lagerblobdatalæser, Bidragyder til lagerblobdata eller Ejer af lagerblobdata på lagerkontoen. eller Rollen Delegator på lagerkontoen plus den fil- eller mappeadgang, der er tildelt i lagerkontoen.
• Arbejdsområdeidentitet – skal have rollen Lagerblobdatalæser, Bidragyder til lagerblobdata eller Ejer af lagerblobdata på lagerkontoen. eller Rollen Delegator på lagerkontoen plus den fil- eller mappeadgang, der er tildelt i lagerkontoen.
• SAS (Shared Access Signature) – skal som minimum indeholde følgende tilladelser: Læs, Liste og Udfør.

S3-genveje

Når du opretter genveje til Amazon S3-konti, skal målstien som minimum indeholde et bucketnavn. S3 understøtter ikke hierarkiske navneområder oprindeligt, men du kan bruge præfikser til at efterligne en mappestruktur. Du kan inkludere præfikser i genvejsstien for yderligere at indsnævre omfanget af data, der er tilgængelige via genvejen. Når du får adgang til data via en S3-genvej, repræsenteres præfikser som mapper.

S3-genveje er skrivebeskyttede. De understøtter ikke skrivehandlinger, uanset brugerens tilladelser.

Adgang

S3-genveje skal pege på https-slutpunktet for S3-bucket'en.

Eksempel: https://bucketname.s3.region.amazonaws.com/

Bemærk

Du behøver ikke at deaktivere indstillingen S3 Bloker offentlig adgang for din S3-konto for S3-genvejen for at fungere.

Adgangen til S3-slutpunktet må ikke blokeres af en lagerfirewall eller Virtual Private Cloud, medmindre du konfigurerer en datagateway i det lokale miljø. Hvis du vil konfigurere en datagateway, skal du se Oprette genveje til data i det lokale miljø.

Autorisation

S3-genveje bruger en delegeret godkendelsesmodel. I denne model angiver genvejsforfatteren en legitimationsoplysninger for S3-genvejen, og al adgang til genvejen er godkendt ved hjælp af disse legitimationsoplysninger. De understøttede delegerede legitimationsoplysninger er en nøgle og hemmelighed for en IAM-bruger.

IAM-brugeren skal have følgende tilladelser til den bucket, som genvejen peger på:

• S3:GetObject
• S3:GetBucketLocation
• S3:ListBucket

S3-genveje understøtter S3-buckets, der bruger S3 Bucket Keys til SSE-KMS kryptering. Hvis brugeren vil have adgang til data, der er krypteret med SSE-KMS kryptering, skal vedkommende have krypterings-/dekrypteringstilladelser til bucketnøglen, ellers modtager vedkommende en "Forbudt" -fejl (403). Du kan få flere oplysninger under Konfiguration af bucketen til at bruge en S3 Bucket-nøgle med SSE-KMS til nye objekter.

Begrænsninger

Følgende begrænsninger gælder for genveje i S3:

• S3-genveje er skrivebeskyttede. De understøtter ikke skrivehandlinger, uanset brugerens tilladelser.
• S3-genvejsmålstier kan ikke indeholde reserverede tegn fra RFC 3986 afsnit 2.2. Se RFC 3968 section 2.3 for tilladte tegn.
• S3-genveje understøtter ikke Copy Blob API'en.
• Flere genveje kan ikke oprettes inde i S3-genveje.

Genveje til Google Cloud Storage

Der kan oprettes genveje til Google Cloud Storage (GCS) ved hjælp af XML-API'en til GCS. Når du opretter genveje til Google Cloud Storage, skal målstien som minimum indeholde et bucketnavn. Du kan også begrænse omfanget af genvejen ved yderligere at angive det præfiks/den mappe, du vil pege på i lagerhierarkiet.

Bemærk

GCS-genveje er skrivebeskyttede. De understøtter ikke skrivehandlinger, uanset brugerens tilladelser.

Adgang

Når du konfigurerer forbindelsen til en GCS-genvej, kan du enten angive det globale slutpunkt for lagertjenesten eller bruge et bucketspecifikt slutpunkt.

• Eksempel på globalt slutpunkt: https://storage.googleapis.com
• Eksempel på bucketspecifikt slutpunkt: https://<BucketName>.storage.googleapis.com

Autorisation

GCS-genveje bruger en delegeret godkendelsesmodel. I denne model angiver forfatteren af genvejen en legitimationsoplysninger for GCS-genvejen, og al adgang til genvejen er godkendt ved hjælp af disse legitimationsoplysninger. De understøttede delegerede legitimationsoplysninger er en HMAC-nøgle og en hemmelighed for en tjenestekonto eller brugerkonto.

Kontoen skal have tilladelse til at få adgang til dataene i GCS-bucketen. Hvis det bucketspecifikke slutpunkt blev brugt i forbindelsen til genvejen, skal kontoen have følgende tilladelser:

• storage.objects.get
• stoage.objects.list

Hvis det globale slutpunkt blev brugt i forbindelsen til genvejen, skal kontoen også have følgende tilladelse:

• storage.buckets.list

Dataversegenveje

Direkte integration med Dataverse med Microsoft Fabric gør det muligt for organisationer at udvide deres Dynamics 365-virksomhedsprogrammer og forretningsprocesser til Fabric. Denne integration opnås via genveje, som kan oprettes på to måder: via PowerApps-udviklerportalen eller via Fabric direkte.

Bemærk

Dataversegenveje er skrivebeskyttede. De understøtter ikke skrivehandlinger, uanset brugerens tilladelser.

Oprettelse af genveje via PowerApps-udviklerportalen

Autoriserede PowerApps-brugere kan få adgang til PowerApps-udviklerportalen og bruge funktionen Link til Microsoft Fabric . Fra denne enkelt handling oprettes der et lakehouse i Fabric, og genveje genereres automatisk for hver tabel i Dataverse-miljøet.

Du kan få flere oplysninger under Direkte integration af Dataverse med Microsoft Fabric.

Oprettelse af genveje via Fabric

Fabric-brugere kan også oprette genveje til Dataverse. Når brugerne opretter genveje, kan de vælge Dataverse, angive deres URL-adresse til miljøet og gennemse de tilgængelige tabeller. Denne oplevelse giver brugerne mulighed for at vælge, hvilke tabeller der skal overføres til Fabric i stedet for at hente alle tabeller ind.

Bemærk

Dataverse-tabeller skal først være tilgængelige i Dataverse Managed Lake, før de er synlige i Fabric-oprettelsesgenvejene UX. Hvis dine tabeller ikke er synlige fra Fabric, kan du bruge funktionen Link til Microsoft Fabric fra PowerApps-udviklerportalen.

Autorisation

Dataverse-genveje bruger en uddelegeret godkendelsesmodel. I denne model angiver forfatteren af genvejen en legitimationsoplysninger for Dataverse-genvejen, og al adgang til genvejen er godkendt ved hjælp af disse legitimationsoplysninger. De understøttede delegerede legitimationstyper er organisationskonto (OAuth2) og tjenesteprincipal. Kontoen skal have systemadministratortilladelse til at få adgang til data i Dataverse Managed Lake.

Cachelagring

Cachelagring af genveje kan reducere udgående dataomkostninger, der er forbundet med adgang til data på tværs af cloudmiljøet. Når filer læses via en ekstern genvej, gemmes filerne i en cache til Fabric-arbejdsområdet. Efterfølgende anmodninger om læsning behandles fra cachen i stedet for udbyderen af fjernlageret. Opbevaringsperioden for cachelagrede filer kan angives fra 1-28 dage. Hver gang filen åbnes, nulstilles opbevaringsperioden. Hvis filen i udbyderen af fjernlageret er nyere end filen i cachen, behandles anmodningen fra udbyderen af fjernlageret, og den opdaterede fil gemmes derefter i cachen. Hvis der ikke er blevet åbnet en fil i mere end den valgte opbevaringsperiode, fjernes den fra cachen. Individuelle filer, der er større end 1 GB, cachelagres ikke.

Bemærk

Cachelagring af genveje understøttes i øjeblikket for genveje til GCS, S3, S3 og datagateway i det lokale miljø.

Hvis du vil aktivere cachelagring for genveje, skal du åbne panelet Indstillinger for arbejdsområde. Vælg fanen OneLake. Slå cacheindstillingen til Til, og vælg opbevaringsperiode.

Cachen kan også ryddes når som helst. På den samme indstillingsside skal du vælge knappen Nulstil cache. Denne handling fjerner alle filer fra genvejscachen i dette arbejdsområde.

Sådan bruger genveje cloudforbindelser

Godkendelse af ADLS- og S3-genveje uddelegeres ved hjælp af cloudforbindelser. Når du opretter en ny ADLS- eller S3-genvej, opretter du enten en ny forbindelse eller vælger en eksisterende forbindelse til datakilden. Angivelse af en forbindelse for en genvej er en bindingshandling. Det er kun brugere med tilladelse til forbindelsen, der kan udføre bindingshandlingen. Hvis du ikke har tilladelser til forbindelsen, kan du ikke oprette nye genveje ved hjælp af denne forbindelse.

Genvejssikkerhed

Genveje kræver visse tilladelser til at administrere og bruge. Sikkerhed for OneLake-genvej ser på de tilladelser, der kræves for at oprette genveje og få adgang til data ved hjælp af dem.

Hvordan håndterer genveje sletninger?

Genveje udfører ikke overlappende sletninger. Når du sletter en genvej, sletter du kun genvejsobjektet. Dataene i genvejsmålet forbliver uændrede. Men hvis du sletter en fil eller mappe i en genvej, og du har tilladelse i genvejsdestinationen til at udføre sletningen, slettes filerne eller mapperne i destinationen.

Overvej f.eks. et lakehouse med følgende sti i den: MyLakehouse\Files\MyShortcut\Foo\Bar. MyShortcut er en genvej, der peger på en ADLS Gen2-konto, der indeholder mapperne Foo\Bar .

Du kan udføre en sletning på følgende sti: MyLakehouse\Files\MyShortcut. I dette tilfælde slettes genvejen MyShortcut fra lakehouse, men filerne og mapperne på ADLS Gen2-kontoen Foo\Bar forbliver upåvirkede.

Du kan også udføre en sletning på følgende sti: MyLakehouse\Files\MyShortcut\Foo\Bar. Hvis du i dette tilfælde har skrivetilladelser til ADLS Gen2-kontoen, slettes Bar-biblioteket fra ADLS Gen2-kontoen.

Afstamningsvisning for arbejdsområde

Når du opretter genveje mellem flere Fabric-elementer i et arbejdsområde, kan du visualisere genvejsrelationerne via afstamningsvisningen for arbejdsområdet. Vælg knappen Afstamningsvisning ( ) i øverste højre hjørne af Arbejdsområdeoversigt.

Bemærk

Afstamningsvisningen er begrænset til et enkelt arbejdsområde. Genveje til placeringer uden for det valgte arbejdsområde vises ikke.

Begrænsninger og overvejelser

• Det maksimale antal genveje pr. Fabric-element er 100.000. I denne kontekst henviser begrebet element til: apps, lakehouses, warehouses, rapporter og meget mere.
• Det maksimale antal genveje i en enkelt OneLake-sti er 10.
• Det maksimale antal direkte genveje til genvejslinks er 5.
• OneLake-genvejsnavne, overordnede stier og destinationsstier må ikke indeholde "%" eller "+"-tegn.
• Genveje understøtter ikke ikke-latinske tegn.
• Afstamning for genveje til data warehouses og semantiske modeller er ikke tilgængelig i øjeblikket.
• En Fabric-genvej synkroniseres med kilden næsten med det samme, men overførselstiden kan variere på grund af datakildens ydeevne, cachelagrede visninger eller problemer med netværksforbindelsen.
• Det kan tage op til et minut, før Tabel-API'en genkender nye genveje.

Relateret indhold

• Opret en OneLake-genvej
• Brug OneLake-genveje REST API'er