Oprettelse af forbindelse til Microsoft OneLake
Microsoft OneLake giver åben adgang til alle dine Fabric-elementer via eksisterende ADLS (Azure Data Lake Storage) Gen2-API'er og SDK'er. Du kan få adgang til dine data i OneLake via en hvilken som helst API, SDK eller et hvilket som helst værktøj, der er kompatibelt med ADLS Gen2, blot ved hjælp af en OneLake URI i stedet. Du kan uploade data til et lakehouse via Azure Storage Explorer eller læse en deltatabel via en genvej fra Azure Databricks.
Da OneLake er SaaS (software as a service), skal nogle handlinger, f.eks. administration af tilladelser eller opdatering af elementer, udføres via Fabric-oplevelser i stedet for ADLS Gen2-API'er. Du kan finde en komplet liste over ændringer af disse API'er under OneLake API-paritet.
URI-syntaks
Da OneLake findes på tværs af hele din Microsoft Fabric-lejer, kan du referere til alt i din lejer ved hjælp af arbejdsområdet, elementet og stien:
https://onelake.dfs.fabric.microsoft.com/<workspace>/<item>.<itemtype>/<path>/<fileName>
Bemærk
Da du kan genbruge elementnavne på tværs af flere elementtyper, skal du angive elementtypen i filtypenavnet. For eksempel .lakehouse for et lakehouse og .datawarehouse for et lager.
OneLake understøtter også henvisninger til arbejdsområder og elementer med GUID'er (Globally Unique Identifiers). OneLake-tildelings-GUID'er og GUID'er ændres ikke, selvom arbejdsområdet eller elementets navn ændres. Du kan finde det tilknyttede GUID for dit arbejdsområde eller element i URL-adressen på Fabric-portalen. Du skal bruge GUID'er til både arbejdsområdet og elementet og ikke behøver elementtypen.
https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>
Når du bruger et værktøj til brug over OneLake i stedet for ADLS Gen2, skal du bruge følgende tilknytning:
- Kontonavnet er altid
onelake. - Objektbeholdernavnet er navnet på dit arbejdsområde.
- Datastien starter ved elementet. Eksempel:
/mylakehouse.lakehouse/Files/.
OneLake understøtter også Azure Blob Filesystem-driveren (ABFS) for at få mere kompatibilitet med ADLS Gen2 og Azure Blob Storage. ABFS-driveren bruger sit eget skema-id abfs og et andet URI-format til at adressere filer og mapper i ADLS Gen2-konti. Hvis du vil bruge dette URI-format via OneLake, skal du bytte arbejdsområdet til filsystemet og inkludere elementet og elementtypen.
abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>
URI'en for abfs-driveren tillader ikke specialtegn, f.eks. mellemrum, i navnet på arbejdsområdet. I disse tilfælde kan du referere til arbejdsområder og elementer med GUID'erne (Globally Unique Identifiers), som beskrevet tidligere i dette afsnit.
Autorisation
Du kan godkende OneLake-API'er ved hjælp af Microsoft Entra-id ved at gå gennem en godkendelsesheader. Hvis et værktøj understøtter logføring på din Azure-konto for at aktivere tokenadgang, kan du vælge et hvilket som helst abonnement. OneLake kræver kun dit brugertoken og er ligeglad med dit Azure-abonnement.
Når du ringer til OneLake via DFS API'er direkte, kan du godkende med et ihændehavertoken for din Microsoft Entra-konto. Du kan få mere at vide om, hvordan du anmoder om og administrerer ihændehavertokens for din organisation, i Microsoft Authentication Library.
Hvis du vil have hurtig ad hoc-test af OneLake ved hjælp af direkte API-kald, er dette et simpelt eksempel på, hvordan du bruger PowerShell til at logge på din Azure-konto, hente et lagerbaseret token og kopiere det til udklipsholderen, så det er nemt at bruge det et andet sted. Du kan finde flere oplysninger om hentning af adgangstokens ved hjælp af PowerShell under Get-AzAccessToken.
Bemærk
OneLake understøtter kun tokens i målgruppen Storage . I følgende eksempel angiver vi målgruppen via ResourceTypeName parameteren .
Connect-AzAccount
$testToken = Get-AzAccessToken -ResourceTypeName Storage
# Retrieved token is of string type which you can validate with the "$testToken.Token.GetTypeCode()" command.
$testToken.Token | Set-Clipboard
Dataopbevaring
Hvis du bruger det globale slutpunkt ('https://onelake.dfs.fabric.microsoft.com' ) til at forespørge om data i et andet område end arbejdsområdets område, er der en mulighed for, at data kan forlade dit område under løsningsprocessen for slutpunktet. Hvis du er bekymret for dataopbevaring, sikrer brugen af det korrekte regionale slutpunkt for dit arbejdsområde, at dine data forbliver inden for det aktuelle område og ikke krydser nogen regionale grænser. Du kan finde det korrekte regionale slutpunkt ved at kontrollere området for den kapacitet, arbejdsområdet er knyttet til.
De regionale OneLake-slutpunkter følger alle det samme format: https://<region>-onelake.dfs.fabric.microsoft.com. Et arbejdsområde, der er knyttet til en kapacitet i området Det vestlige USA, vil f.eks. være tilgængeligt via det regionale slutpunkt https://westus-onelake.dfs.fabric.microsoft.com.
Almindelige problemer
Hvis et værktøj eller en pakke, der er kompatibel med ADLS Gen2, ikke fungerer via OneLake, er det mest almindelige problem validering af URL-adresser. Da OneLake bruger et andet slutpunkt (dfs.fabric.microsoft.com) end ADLS Gen2 (dfs.core.windows.net), genkender nogle værktøjer ikke OneLake-slutpunktet og blokerer det. Nogle værktøjer giver dig mulighed for at bruge brugerdefinerede slutpunkter (f.eks. PowerShell). Ellers er det ofte en simpel rettelse at tilføje OneLakes slutpunkt som et understøttet slutpunkt. Hvis du finder et valideringsproblem for URL-adressen eller har andre problemer med at oprette forbindelse til OneLake, skal du give os besked.
Eksempler
Oprette fil
| Request | SÆTTE https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file |
|---|---|
| Overskrifter | Authorization: Bearer <userAADToken> |
| Response | Svarkode: 201 CreatedOverskrifter: x-ms-version : 2021-06-08x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67bx-ms-content-crc64 : OAJ6r0dQWP0=x-ms-request-server-encrypted : trueETag : 0x8DA58EE365Legeme: |