Dela via

Ansluta till Microsoft OneLake

  • Artikel

Microsoft OneLake ger öppen åtkomst till alla dina Fabric-objekt via befintliga Api:er och SDK:er för Azure Data Lake Storage (ADLS) Gen2. Du kan komma åt dina data i OneLake via valfritt API, SDK eller verktyg som är kompatibla med ADLS Gen2 bara genom att använda en OneLake-URI i stället. Du kan ladda upp data till ett lakehouse via Azure Storage Explorer eller läsa en deltatabell via en genväg från Azure Databricks.

Eftersom OneLake är programvara som en tjänst (SaaS) måste vissa åtgärder, till exempel hantering av behörigheter eller uppdatering av objekt, utföras via infrastrukturresurser och kan inte utföras via ADLS Gen2-API:er. En fullständig lista över ändringar i dessa API:er finns i OneLake API-paritet.

URI-syntax

Eftersom OneLake finns i hela Microsoft Fabric-klientorganisationen kan du referera till vad som helst i din klientorganisation med dess arbetsyta, objekt och sökväg:

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

Anteckning

Eftersom du kan återanvända objektnamn över flera objekttyper måste du ange objekttypen i tillägget. Till exempel .lakehouse för ett sjöhus och .datawarehouse för ett lager.

OneLake har också stöd för att referera till arbetsytor och objekt med globalt unika identifierare (GUID). OneLake tilldelar GUID:er och GUID:er ändras inte, även om namnet på arbetsytan eller objektet ändras. Du hittar det associerade GUID:t för din arbetsyta eller ditt objekt i URL:en på Fabric-portalen. Du måste använda GUID:er för både arbetsytan och objektet och behöver inte objekttypen.

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

När du använder ett verktyg för användning över OneLake i stället för ADLS Gen2 använder du följande mappning:

  • Kontonamnet är alltid onelake.
  • Container-namnet är namnet på din arbetsyta.
  • Datasökvägen börjar vid objektet. Exempel: /mylakehouse.lakehouse/Files/.

OneLake har också stöd för Azure Blob Filesystem-drivrutinen (ABFS) för mer kompatibilitet med ADLS Gen2 och Azure Blob Storage. ABFS-drivrutinen använder sin egen schemaidentifierare abfs och ett annat URI-format för att hantera filer och kataloger i ADLS Gen2-konton. Om du vill använda det här URI-formatet i OneLake, bytter du ut arbetsyta mot filsystem och inkluderar objekt och objekttyp.

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

Abfs-drivrutins-URI:n tillåter inte specialtecken, till exempel blanksteg, i arbetsytans namn. I dessa fall kan du referera till arbetsytor och objekt med de globalt unika identifierarna (GUID) enligt beskrivningen tidigare i det här avsnittet.

Auktorisering

Du kan autentisera OneLake-API:er med Microsoft Entra-ID genom att använda en auktoriseringsheader. Om ett verktyg har stöd för att logga in på ditt Azure-konto för att möjliggöra tokenöverföring kan du välja valfri prenumeration. OneLake kräver bara din användartoken och bryr sig inte om din Azure-prenumeration.

När du anropar OneLake via DFS-API:er direkt kan du autentisera med en ägartoken för ditt Microsoft Entra-konto. Mer information om hur du begär och hanterar ägartoken för din organisation finns i Microsofts autentiseringsbibliotek.

För snabb ad hoc-testning av OneLake med direkta API-anrop är här ett enkelt exempel som visar hur du använder PowerShell för att logga in på ditt Azure-konto, hämta en token för lagring och kopiera den till urklipp för enkel användning någon annanstans. Mer information om hur du hämtar åtkomsttoken med PowerShell finns i Get-AzAccessToken.

Anteckning

OneLake stöder endast tokens i målgruppen Storage. I följande exempel anger vi målgruppen via parametern ResourceTypeName .

Connect-AzAccount
$testToken = Get-AzAccessToken -AsSecureString -ResourceTypeName Storage
# Retrieved token is of string type which you can validate with the "$testToken.Token.GetTypeCode()" command.
$testToken.Token | Set-Clipboard

Dataresidens

Om du använder den globala slutpunkten (''https://onelake.dfs.fabric.microsoft.com) för att fråga efter data i en annan region än arbetsytans region finns det en möjlighet att data kan lämna din region under slutpunktsmatchningsprocessen. Om du är orolig för dataplacering, säkerställer användandet av rätt regional slutpunkt för din arbetsyta att dina data stannar inom den nuvarande regionen och inte överskrider några regionala gränser. Du kan identifiera rätt regional slutpunkt genom att kontrollera regionen för den kapacitet som arbetsytan är kopplad till.

De regionala OneLake-slutpunkterna har samma format: https://<region>-onelake.dfs.fabric.microsoft.com. Till exempel skulle en arbetsyta som är kopplad till en kapacitet i den västra USA-regionen vara tillgänglig via den regionala slutpunkten https://westus-onelake.dfs.fabric.microsoft.com.

Vanliga problem

Om ett verktyg eller paket som är kompatibelt med ADLS Gen2 inte fungerar över OneLake är det vanligaste problemet URL-validering. Eftersom OneLake använder en annan slutpunkt (dfs.fabric.microsoft.com) än ADLS Gen2 (dfs.core.windows.net) känner vissa verktyg inte igen OneLake-slutpunkten och blockerar den. Med vissa verktyg kan du använda anpassade slutpunkter (till exempel PowerShell). Annars är det ofta en enkel korrigering att lägga till OneLakes slutpunkt som en slutpunkt som stöds. Om du hittar ett URL-valideringsproblem eller har andra problem med att ansluta till OneLake kan du meddela oss.

Resurser

OneLake är tillgängligt via samma API:er och SDK:er som ADLS Gen2. Mer information om hur du använder ADLS Gen2-API:er finns på följande sidor:

Exempel

Skapa fil

Förfrågan STÄLLA https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Rubriker Authorization: Bearer <userAADToken>
Response ResponseCode:201 Created
Rubriker:
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
Kropp:

Relaterat innehåll