Anslut till Microsoft OneLake
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>
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 .
az login --allow-no-subscriptions
$testToken = Get-AzAccessToken -ResourceTypeName Storage
$testToken.Token | Set-Clipboard
Dataresidens
OneLake garanterar för närvarande inte datahemvist i en viss region när du använder den globala slutpunkten (https://onelake.dfs.fabric.microsoft.com). När du frågar 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 2 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 | SÄTTA https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file |
|---|---|
| Rubriker | Authorization: Bearer <userAADToken> |
| Svar | ResponseCode:201 CreatedRubriker: x-ms-version : 2021-06-08x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67bx-ms-content-crc64 : OAJ6r0dQWP0=x-ms-request-server-encrypted : trueETag : 0x8DA58EE365Brödtext: |
Relaterat innehåll
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för