Delen via


Verbinding maken met Microsoft OneLake

Microsoft OneLake biedt open toegang tot al uw Fabric-items via bestaande AZURE Data Lake Storage (ADLS) Gen2-API's en SDK's. U kunt uw gegevens in OneLake openen via elke API, SDK of elk hulpprogramma dat compatibel is met ADLS Gen2, met behulp van een OneLake-URI. U kunt gegevens uploaden naar een lakehouse via Azure Storage Explorer of een deltatabel lezen via een snelkoppeling van Azure Databricks.

Omdat OneLake Software as a Service (SaaS) is, moeten sommige bewerkingen, zoals het beheren van machtigingen of het bijwerken van items, worden uitgevoerd via Fabric-ervaringen in plaats van de ADLS Gen2-API's. Zie de pariteit van onelake-API's voor een volledige lijst met wijzigingen in deze API's.

URI-syntaxis

Omdat OneLake bestaat in uw hele Microsoft Fabric-tenant, kunt u naar alles in uw tenant verwijzen via de werkruimte, het item en het pad:

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

Notitie

Omdat u itemnamen voor meerdere itemtypen opnieuw kunt gebruiken, moet u het itemtype in de extensie opgeven. Bijvoorbeeld .lakehouse voor een lakehouse en .datawarehouse voor een magazijn.

OneLake biedt ook ondersteuning voor het verwijzen naar werkruimten en items met GUID's (Globally Unique Identifiers). OneLake wijst GUID's en GUID's niet toe, zelfs als de naam van de werkruimte of het item wordt gewijzigd. U vindt de bijbehorende GUID voor uw werkruimte of item in de URL in de Fabric-portal. U moet GUID's gebruiken voor zowel de werkruimte als het item en u hebt het itemtype niet nodig.

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

Wanneer u een hulpprogramma gebruikt voor gebruik via OneLake in plaats van ADLS Gen2, gebruikt u de volgende toewijzing:

  • De accountnaam is altijd onelake.
  • De containernaam is de naam van uw werkruimte.
  • Het gegevenspad begint bij het item. Voorbeeld: /mylakehouse.lakehouse/Files/.

OneLake biedt ook ondersteuning voor het Stuurprogramma van het Azure Blob-bestandssysteem (ABFS) voor meer compatibiliteit met ADLS Gen2 en Azure Blob Storage. Het ABFS-stuurprogramma gebruikt een eigen schema-id abfs en een andere URI-indeling om bestanden en mappen in ADLS Gen2-accounts aan te pakken. Als u deze URI-indeling wilt gebruiken via OneLake, wisselt u werkruimte voor bestandssysteem en neemt u het item en itemtype op.

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

De URI van het stuurprogramma abfs staat geen speciale tekens toe, zoals spaties, in de naam van de werkruimte. In deze gevallen kunt u verwijzen naar werkruimten en items met de GUID's (Globally Unique Identifiers), zoals eerder in deze sectie is beschreven.

Autorisatie

U kunt OneLake-API's verifiëren met behulp van Microsoft Entra-id door een autorisatieheader door te geven. Als een hulpprogramma ondersteuning biedt voor het aanmelden bij uw Azure-account om tokenpassthrough in te schakelen, kunt u elk abonnement selecteren. OneLake vereist alleen uw gebruikerstoken en geeft niet om uw Azure-abonnement.

Wanneer u OneLake rechtstreeks via DFS-API's aanroept, kunt u zich verifiëren met een bearer-token voor uw Microsoft Entra-account. Raadpleeg de Microsoft Authentication Library voor meer informatie over het aanvragen en beheren van Bearer-tokens voor uw organisatie.

Voor snelle ad-hoctests van OneLake met behulp van directe API-aanroepen, is dit een eenvoudig voorbeeld van PowerShell om u aan te melden bij uw Azure-account, een token met opslagbereik op te halen en naar het klembord te kopiëren voor eenvoudig gebruik elders. Zie Get-AzAccessToken voor meer informatie over het ophalen van toegangstokens met behulp van PowerShell.

Notitie

OneLake ondersteunt alleen tokens in de Storage doelgroep. In het volgende voorbeeld stellen we de doelgroep in via de ResourceTypeName parameter.

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

Gegevensresidentie

Als u het globale eindpunt ('') gebruikt om query'shttps://onelake.dfs.fabric.microsoft.com uit te voeren op gegevens in een andere regio dan de regio van uw werkruimte, is het mogelijk dat gegevens uw regio verlaten tijdens het proces voor eindpuntoplossing. Als u zich zorgen maakt over gegevenslocatie, zorgt u ervoor dat uw gegevens binnen de huidige regio blijven en geen regionale grenzen overschrijden met behulp van het juiste regionale eindpunt voor uw werkruimte. U kunt het juiste regionale eindpunt detecteren door de regio te controleren van de capaciteit waaraan de werkruimte is gekoppeld.

Regionale OneLake-eindpunten volgen allemaal dezelfde indeling: https://<region>-onelake.dfs.fabric.microsoft.com. Een werkruimte die is gekoppeld aan een capaciteit in de regio VS - west, is bijvoorbeeld toegankelijk via het regionale eindpunt https://westus-onelake.dfs.fabric.microsoft.com.

Algemene problemen

Als een hulpprogramma of pakket dat compatibel is met ADLS Gen2 niet werkt via OneLake, is url-validatie het meest voorkomende probleem. Omdat OneLake een ander eindpunt (dfs.fabric.microsoft.com) gebruikt dan ADLS Gen2 (dfs.core.windows.net), herkennen sommige hulpprogramma's het OneLake-eindpunt niet en blokkeren het. Met sommige hulpprogramma's kunt u aangepaste eindpunten (zoals PowerShell) gebruiken. Anders is het vaak een eenvoudige oplossing om het eindpunt van OneLake toe te voegen als een ondersteund eindpunt. Als u een probleem met URL-validatie vindt of andere problemen ondervindt bij het maken van verbinding met OneLake, laat het ons dan weten.

Voorbeelden

Bestand maken

Aanvragen ZETTEN https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Kopteksten Authorization: Bearer <userAADToken>
Respons ResponseCode: 201 Created
Kopteksten:
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
Hoofdtekst: