Pripojenie k Microsoft OneLake

Microsoft OneLake poskytuje otvorený prístup ku všetkým položkám služby Fabric prostredníctvom existujúcich rozhraní API a súprav SDK služby Azure Data Lake Storage (ADLS) a rozhrania Blob API. K svojim údajom v OneLake môžete pristupovať prostredníctvom ľubovoľného rozhrania API, súpravy SDK alebo nástroja kompatibilného s ADLS alebo Azure Blob Storage iba pomocou identifikátora URI OneLake. Do služby Lakehouse môžete nahrať údaje prostredníctvom prieskumníka Azure Storage Explorer alebo môžete prečítať delta tabuľky prostredníctvom odkazu zo služby Azure Databricks.

Keďže OneLake je softvér ako služba (SaaS), niektoré operácie, ako napríklad správa povolení alebo aktualizácia položiek, sa musia vykonávať prostredníctvom prostredí Fabric a nemožno ich vykonávať prostredníctvom rozhraní API ADLS. Úplný zoznam zmien týchto rozhraní API nájdete v téme Parita rozhrania API oneLake.

Syntax URI

Keďže OneLake existuje v celom nájomníkovi služby Microsoft Fabric, môžete na čokoľvek vo svojom nájomníkovi odkazovať prostredníctvom jeho pracovného priestoru, položky a cesty:

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

Poznámka

Keďže môžete opakovane používať názvy položiek v rámci viacerých typov položiek, musíte v rozšírení zadať typ položky. Napríklad .lakehouse pre lakehouse a .warehouse pre sklad.

OneLake tiež podporuje odkazovanie na pracovné priestory a položky pomocou globálne jedinečných identifikátorov (GUID). OneLake priraďuje identifikátory GUID a identifikátory GUID, ktoré sa nemenia, a to ani v prípade, že sa zmení názov pracovného priestoru alebo položky. Priradený identifikátor GUID pre pracovný priestor alebo položku nájdete v URL adrese na portáli služby Fabric. Identifikátory GUID musíte použiť pre pracovný priestor aj položku, pričom nie je potrebný typ položky.

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

Pri prijímaní nástroja na použitie cez OneLake namiesto ADLS použite nasledujúce mapovanie:

Názov konta je vždy onelake.
Názov kontajnera je názov vášho pracovného priestoru.
Cesta k údajom začína pri položke. Napríklad: /mylakehouse.lakehouse/Files/.

OneLake tiež podporuje ovládač Azure Blob Filesystem (ABFS) pre väčšiu kompatibilitu s ADLS a Azure Blob Storage. Ovládač ABFS používa vlastný identifikátor abfs schémy a iný formát URI na adresovanie súborov a adresárov v kontách ADLS. Ak chcete použiť tento formát URI na onelake, vymeňte pracovný priestor za systém súborov a zahrňte typ položky a položky.

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

Identifikátor URI ovládača abfs nepovoľuje v názve pracovného priestoru špeciálne znaky, ako sú napríklad medzery. V týchto prípadoch môžete odkazovať na pracovné priestory a položky pomocou globálne jedinečných identifikátorov (GUID), ako je to popísané vyššie v tejto časti.

Oprávnenie

Rozhrania API OneLake môžete overiť pomocou ID aplikácie Microsoft Entra odovzdaním hlavičky oprávnenia. Ak nástroj podporuje prihlásenie do vášho konta Azure, čo umožňuje odovzdávanie tokenov, môžete vybrať ľubovoľné predplatné. OneLake vyžaduje len váš používateľský token a nestará sa o vaše predplatné služby Azure.

Pri volaní služby OneLake cez rozhrania DFS API môžete vykonať overenie pomocou nosného tokenu pre vaše konto Microsoft Entra. Ďalšie informácie o vyžiadaní a spravovaní nosných tokenov pre vašu organizáciu nájdete v knižnici overenia spoločnosti Microsoft.

V prípade rýchleho ad hoc testovania OneLake pomocou priamych volaní rozhrania API: tu je jednoduchý príklad použitia prostredia PowerShell na prihlásenie do konta Azure, načítanie tokenu zameraného na úložisko a jeho skopírovanie do schránky na jednoduché použitie inde. Ďalšie informácie o načítavaní prístupových tokenov pomocou prostredia PowerShell nájdete v téme Get-AzAccessToken.

Poznámka

OneLake podporuje len tokeny v publiku Storage . V nasledujúcom príklade nastavíme cieľovú skupinu ResourceTypeName cez parameter.

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

Data residency (Pobyt údajov)

Ak použijete globálny koncový bod (https://onelake.dfs.fabric.microsoft.com) na dotazovanie dát v regióne inom ako región vášho pracovného priestoru, existuje možnosť, že dáta môžu počas procesu riešenia koncového bodu opustiť váš región. Ak sa obávate o pobyt údajov, vďaka správnemu miestnemu koncovému bodu pracovného priestoru sa vaše údaje zostanú v rámci aktuálnej oblasti a neprekročia žiadne regionálne hranice. Správnosť regionálneho koncového bodu nájdete tak, že skontrolujete oblasť kapacity, ku ktorej je pracovný priestor pripojený.

Všetky miestne koncové body OneLake majú rovnaký formát: https://<region>-onelake.dfs.fabric.microsoft.com. Napríklad pracovný priestor pripojený ku kapacite v oblasti Západná Časť USA by bol dostupný prostredníctvom regionálneho koncového bodu https://westus-onelake.dfs.fabric.microsoft.com.

Ďalšie OneLake koncové body

OneLake tiež podporuje všeobecný FQDN (https://api.onelake.fabric.microsoft.com), spolu s regionálnou (https://<region>-api.onelake.fabric.microsoft.com) a workspace () verziouhttps://<wsid>.z<xy>.onelake.fabric.microsoft.com. Tieto FQDN fungujú rovnako ako blob a DFS varianty, ale môžu byť nekompatibilné s niektorými nástrojmi Azure Storage, ktoré sa spoliehajú na blob a DFS varianty na použitie správnych Azure Storage API.

Bežné problémy

Ak nástroj alebo balík kompatibilný s ADLS nefunguje cez OneLake, najbežnejším problémom je overenie adresy URL. Keďže OneLake používa iný koncový bod (dfs.fabric.microsoft.com) ako ADLS (dfs.core.windows.net), niektoré nástroje nerozpoznajú koncový bod OneLake a zablokujú ho. Niektoré nástroje vám umožňujú používať vlastné koncové body (napríklad PowerShell). V opačnom prípade je často jednoduchá oprava pridania koncového bodu OneLake ako podporovaného koncového bodu. Ak nájdete problém s overovaním URL adresy alebo máte akékoľvek iné problémy s pripojením k službe OneLake, dajte nám vedieť.

Zdroje

OneLake je prístupný prostredníctvom rovnakých rozhraní API a súprav SDK ako ADLS. Ďalšie informácie o používaní rozhraní API služby ADLS nájdete na nasledujúcich stránkach:

referenčné rozhrania API služby ADLS Gen2
Súpravy SDK súborov ADLS Gen2
- platformy .NET
- jazyka Python
- jazyka Java

Ukážky

Vytvoriť súbor

Požiadavka	DAŤ `https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file`
Hlavičky	`Authorization: Bearer <userAADToken>`
Odpoveď	Kód odpovede:`201 Created` Hlavičky: `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` Telo:

Pripomienky

Bola táto stránka užitočná?

Last updated on 2026-01-16