Koble til til Microsoft OneLake

  • Artikkel

Microsoft OneLake gir åpen tilgang til alle Fabric-elementene dine gjennom eksisterende Azure Data Lake Storage (ADLS) Gen2 API-er og SDK-er. Du kan få tilgang til dataene dine i OneLake gjennom alle API-er, SDK-er eller verktøy som er kompatible med ADLS Gen2, bare ved å bruke en OneLake-URI i stedet. Du kan laste opp data til et lakehouse via Azure Storage Explorer, eller lese en deltatabell gjennom en snarvei fra Azure Databricks.

Ettersom OneLake er programvare som en tjeneste (SaaS), må noen operasjoner, for eksempel administrere tillatelser eller oppdatere elementer, gjøres gjennom Fabric-opplevelser i stedet for ADLS Gen2-API-ene. Hvis du vil ha en fullstendig liste over endringer i disse API-ene, kan du se OneLake API-paritet.

URI-syntaks

Siden OneLake finnes på tvers av hele Microsoft Fabric-leieren, kan du referere til hva som helst i leieren etter arbeidsområde, element og bane:

https://onelake.dfs.fabric.microsoft.com/<workspace>/<item>.<itemtype>/<path>/<fileName>

Merk

Fordi du kan bruke elementnavn på nytt på tvers av flere elementtyper, må du angi elementtypen i filtypen. For eksempel .lakehouse for et lakehouse og .datawarehouse for et lager.

OneLake støtter også referansearbeidsområder og elementer med globalt unike identifikatorer (GUIDer). OneLake tilordner GUIDer og GUIDer endres ikke, selv om arbeidsområdet eller elementnavnet endres. Du finner den tilknyttede GUID-en for arbeidsområdet eller elementet i nettadressen på Stoff-portalen. Du må bruke GUIDer for både arbeidsområdet og elementet, og du trenger ikke elementtypen.

https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>

Når du bruker et verktøy for bruk over OneLake i stedet for ADLS Gen2, bruker du følgende tilordning:

  • Kontonavnet er alltid onelake.
  • Beholdernavnet er navnet på arbeidsområdet.
  • Databanen starter ved elementet. Eksempel: /mylakehouse.lakehouse/Files/.

OneLake støtter også Azure Blob Filesystem-driveren (ABFS) for mer kompatibilitet med ADLS Gen2 og Azure Blob Storage. ABFS-driveren bruker sin egen skjemaidentifikator abfs og et annet URI-format for å adressere filer og kataloger i ADLS Gen2-kontoer. Hvis du vil bruke dette URI-formatet over OneLake, bytter du arbeidsområde for filsystem og inkluderer element- og elementtypen.

abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>

Autorisasjon

Du kan godkjenne OneLake-API-er ved hjelp av Microsoft Entra ID ved å sende gjennom et autorisasjonshode. Hvis et verktøy støtter pålogging til Azure-kontoen for å aktivere gjennomslag av token, kan du velge et hvilket som helst abonnement. OneLake krever bare brukertokenet ditt og bryr seg ikke om Azure-abonnementet.

Når du ringer OneLake via DFS-API-er direkte, kan du godkjenne med et bærertoken for Microsoft Entra-kontoen din. Hvis du vil lære mer om å be om og administrere bærertokener for organisasjonen, kan du ta en titt på Microsoft Authentication Library.

For rask ad hoc-testing av OneLake ved hjelp av direkte API-kall, her er et enkelt eksempel ved hjelp av PowerShell for å logge på Azure-kontoen din, hente et lagringsomfangtoken og kopiere det til utklippstavlen for enkel bruk andre steder. Hvis du vil ha mer informasjon om hvordan du henter tilgangstokener ved hjelp av PowerShell, kan du se Get-AzAccessToken.

Merk

OneLake støtter bare tokener i Storage målgruppen. I eksemplet nedenfor angir vi målgruppen gjennom parameteren ResourceTypeName .

az login --allow-no-subscriptions
$testToken = Get-AzAccessToken -ResourceTypeName Storage
$testToken.Token | Set-Clipboard

Datalagring

OneLake garanterer for øyeblikket ikke datalagring i et bestemt område når du bruker det globale endepunktet (https://onelake.dfs.fabric.microsoft.com). Når du spør etter data i et annet område enn området i arbeidsområdet, er det en mulighet for at data kan forlate området under løsningsprosessen for endepunktet. Hvis du er bekymret for datalagring, sikrer bruk av riktig regionalt endepunkt for arbeidsområdet at dataene forblir innenfor gjeldende område og ikke krysser noen regionale grenser. Du kan oppdage riktig regionalt endepunkt ved å kontrollere området for kapasiteten som arbeidsområdet er knyttet til.

OneLake regionale endepunkter følger alle samme format: https://<region>-onelake.dfs.fabric.microsoft.com. Et arbeidsområde som er knyttet til en kapasitet i området Vest-USA 2, vil for eksempel være tilgjengelig via det regionale endepunktet https://westus-onelake.dfs.fabric.microsoft.com.

Vanlige problemer

Hvis et verktøy eller en pakke som er kompatibel med ADLS Gen2 ikke fungerer over OneLake, er det vanligste problemet url-validering. Ettersom OneLake bruker et annet endepunkt (dfs.fabric.microsoft.com) enn ADLS Gen2 (dfs.core.windows.net), gjenkjenner ikke noen verktøy OneLake-endepunktet og blokkerer det. Noen verktøy lar deg bruke egendefinerte endepunkter (for eksempel PowerShell). Ellers er det ofte en enkel løsning å legge til OneLakes endepunkt som et støttet endepunkt. Hvis du finner et problem med validering av url-adressen eller har andre problemer med å koble til OneLake, kan du gi oss beskjed.

Eksempler

Opprett fil

Be om SETTE https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Hoder Authorization: Bearer <userAADToken>
Svar ResponseCode:201 Created
Hoder:
x-ms-version : 2021-06-08
x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67b
x-ms-content-crc64 : OAJ6r0dQWP0=
x-ms-request-server-encrypted : true
ETag : 0x8DA58EE365
Kroppen:

Relatert innhold