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 i stället för 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>

Kommentar

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 och GUID ändras inte, även om arbetsytan eller objektnamnet ändras. Du hittar det associerade GUID:t för din arbetsyta eller ditt objekt i URL:en på Infrastrukturportalen. 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.
  • Containernamnet är namnet på arbetsytan.
  • 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 över OneLake byter du arbetsyta mot filsystem och inkluderar objekt- och objekttypen.

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 hjälp av Microsoft Entra-ID genom att skicka ett auktoriseringshuvud. Om ett verktyg har stöd för att logga in på ditt Azure-konto för att aktivera tokengenomströmning 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, här är ett enkelt exempel med PowerShell för att logga in på ditt Azure-konto, hämta en lagringsomfattningstoken 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.

Kommentar

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

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

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 datahemvist ser du till att dina data ligger inom den aktuella regionen och inte överskrider några regionala gränser med rätt regional slutpunkt för arbetsytan. 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 regionen USA, västra 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.

Exempel

Skapa fil

Begär 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
Brödtext:

Relaterat innehåll