Opret en Genvej til Azure Data Lake Storage Gen2

I denne artikel lærer du, hvordan du opretter en genvej til Azure Data Lake Storage (ADLS) Gen2 inde i et Fabric lakehouse. 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.

Du kan få en oversigt over genveje under OneLake-genveje. Hvis du vil oprette genveje programmeringsmæssigt, skal du se REST API'er til OneLake-genveje.

Forudsætninger

  • Et søhus. Hvis du ikke har en, så lav en ved at følge disse trin: Opret et sommerhus ved søen.
  • Du skal aktivere hierarkiske navnerum på din ADLS Gen2-lagringskonto.

Opret en genvej

  1. Åbn et søhus.

  2. Højreklik på en mappe i Lake-visningen af lakehouse.

  3. Vælg Ny genvej.

    Det samme skærmbillede, der blev vist tidligere, og som viser, hvor du skal vælge Ny genvej i visningen Lake.

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

  5. Indtast forbindelsesindstillingerne og forbindelsesoplysningerne for lagringskontoen.

    Skærmbillede af vinduet Ny genvej, der viser Forbindelsesindstillinger og Legitimationsoplysninger for forbindelse.

    Felt Beskrivelse
    URL-adresse DFS-endpointet for din lagerkonto.

    https://<STORAGE_ACCOUNT_NAME>.dfs.core.windows.net
    Forbindelse Vælg en eksisterende forbindelse til den angivne lagringsplacering fra rullemenuen. Eller hvis der ikke findes nogen forbindelser, vælg Opret ny forbindelse.
    Forbindelsesnavn Et navn til din Azure Data Lake Storage Gen2-forbindelse.
    Godkendelsestype Vælg din foretrukne autorisationsmodel fra rullemenuen: Organisationskonto, Kontonøgle, Shared Access Signature (SAS), Service principal eller Workspace Identity. For mere information, se Autorisation.

    Når du har valgt en godkendelsestype, skal du udfylde de påkrævede legitimationsoplysninger.

  6. Vælg Næste.

  7. Gå til genvejens destinationsplacering.

    Skærmbillede af vinduet til gennemsyn af lagerplads med flere mapper valgt.

    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 i lagringskontoen ved at vælge en mappe eller udvidelsespilen ved siden af en mappe.

    I denne visning kan du vælge en eller flere genvejsmålplaceringer. Vælg målplaceringer ved at markere afkrydsningsboksen ved siden af en mappe i venstre navigationsvisning.

  8. Vælg Næste

    Skærmbillede af gennemgangssiden for genvejen med indstillinger til omdøbning og sletning af genveje.

    Gennemsynssiden giver dig mulighed for at bekræfte alle dine valg. Her kan du se hver genvej, der oprettes. I handlingskolonnen kan du vælge blyantikonet for at redigere genvejsnavnet. Du kan vælge skraldespand-ikonet for at slette genvej.

  9. Vælg Opret.

  10. Lakehouse opdateres automatisk. Genvejen vises i venstre rude i Stifinder .

    Skærmbillede, der viser en lakevisningsliste over mapper, der viser genvejssymbolet.

Adgang

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

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

Hvis en lagrings-firewall beskytter din lagerkonto, kan du konfigurere adgang til betroede tjenester. For mere information, se Trusted workspace access.

Authorization

ADLS-genveje bruger en delegeret godkendelsesmodel. I denne model specificerer genvejsskaberen en legitimation til ADLS-genvejen, og al adgang til denne genvej er autoriseret ved at bruge denne legitimation. 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.
  • Kontonøgle - adgangsnøglen til lagringskontoen. Kontonøgler giver fuld adgang til lagringskontoen, så brug denne mulighed med forsigtighed og beskyt dine nøgler korrekt.

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 om at generere en brugerdelegeringsnøgle håndhæves ikke i øjeblikket, når en arbejdsområdeidentitet konfigureres for arbejdsområdet, og ADLS-genvejsgodkendelsestypen er Organisationskonto, Service Principal eller Workspace Identity. Denne funktionsmåde vil dog blive begrænset i fremtiden. Sørg for, at alle delegerede identiteter har handlingen Generer en brugerdelegeringsnøgle for at sikre, at dine brugeres adgang ikke påvirkes, når denne adfærd ændrer sig.

Brug adgangskontrollister i Azure Data Lake Storage med ADLS-genveje

For at genbruge adgangskontrollister (ACL'er), der er tildelt et ADLS-genvejsmål, og bringe dem til en ADLS-genvej, brug en kombination af Storage Blob Delegator-rollen og ACL'er, der er tildelt filerne og mapperne i lagringskontoen for at kontrollere adgangen til ADLS-genveje.

Et screenshot af en lagringskonto med eksempel på ACL-konfiguration.

Ved at bruge denne autorisationsmodel kan du kontrollere adgangen til ADLS-genveje med større detaljering. Modellen kombinerer Storage Blob Delegator-rollen med ACL'er tildelt ADLS-mapper og filer inden for lagringskontoen. Denne autorisationsmodel påvirker ikke eksisterende ADLS-genveje. Kunder kan fortsætte med at bruge eksisterende autorisationsmodeller. ACL-autorisationsmodellen understøtter brugeridentitet, serviceprincipaler og Fabric-arbejdsområdeidentitet.

  1. Gå til Azure Storage-kontoen og vælg Add role assignment. Vælg derefter rollen Storage Blob Delegator . Tildel denne rolle til en brugeridentitet eller en serviceprincipal (SPN).

    Skærmbillede af Azure Storage-rolletildeling med Storage Blob Delegator-rollen fremhævet i billedet.

  2. Når du har gennemført rolletildelingen, skal du gå til objektet (filen eller mappen) i ADLS og vælge Manage ACL. Tildel passende ACL-tilladelser til den sikkerhedsprincipal, du bruger til at konfigurere ADLS-genvejen.

    Skærmbillede af ADLS-indstillinger med ACL-konfigurationsmuligheder.

  3. Skift til Microsoft Fabric og vælg Ny genvej. Følg promptene for at konfigurere ADLS-genvejen ved at bruge sikkerhedsprincippet, som du har tildelt Storage Blob Delegator-rollen og relevante ACL-tilladelser.

    Skærmbillede af 'Opret en ny genvej'-oplevelse med forbindelsesindstillinger markeret.

  4. Efter du har angivet forbindelsesdetaljer og legitimationsoplysninger, gå til mappen på ADLS med kildedataene for genvejen. Din sikkerhedsprincipal, som du bruger til at konfigurere ADLS-genvejen, har måske ikke tilladelse til at gennemse mapper. Hvis denne principal ikke har tilladelse, vælg Path View i øverste højre hjørne af dialogboksen og skriv det ønskede sted.

    Skærmbillede af den nye genvejsopsætning med Path View-muligheden fremhævet.

  5. Vælg Opret genvej , når du har angivet den ønskede placering. De nye genveje vises i OneLake, når du opretter genvejen med succes.

    Skærmbillede af Fabric lakehouse UX, der viser ADLS-genveje, er blevet oprettet med succes.

Nu opsætter du en ADLS-genvej, der bruger ADLS-adgangskontrollister til at administrere autorisationen for genvejsrepræsentationen af det objekt.

Begrænsninger

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

  • ADLS-genveje til lagringskonti i en anden Microsoft Entra-lejer end din Fabric-lejer kræver, at du bruger en service principal eller SAS-token til autentificering. Identitetsgodkendelse af organisationskonti og arbejdsområder virker ikke på tværs af lejere. For deling af data på tværs af Fabric-lejere, overvej i stedet at bruge ekstern datadeling , hvilket kræver Fabric-kapacitet i begge lejere.
  • 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. For mere information, se administrerede private endpoints for Fabric.
  • Du kan ikke lave flere genveje inde i ADLS-genveje.
  • ADLS gen 2 genveje understøttes ikke for lagringskonti, der bruger Microsoft Purview Data Sharing.

Relateret indhold

  • Sidst opdateret den