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) Gen2. K údajom vo OneLake môžete získať prístup prostredníctvom ľubovoľného rozhrania API, SDK alebo nástroja kompatibilného s ADLS Gen2 len 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 je napríklad správa povolení alebo aktualizácia položiek, sa musia vykonávať prostredníctvom skúseností so službou Fabric a nemožno ich vykonať prostredníctvom rozhraní ADLS Gen2 API. Ú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 .datawarehouse
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 Gen2 použite nasledujúce priradenie:
- 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) na väčšiu kompatibilitu s ADLS Gen2 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 Gen2. 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žívate globálny koncový bod ('https://onelake.dfs.fabric.microsoft.com') na dotazovanie údajov v inej oblasti, ako je oblasť vášho pracovného priestoru, existuje možnosť, že údaje by mohli opustiť vašu oblasť počas procesu riešenia koncového bodu. 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
.
Bežné problémy
Ak nástroj alebo balík kompatibilný s ADLS Gen2 nefunguje v službe OneLake, najčastejším problémom je overenie URL adresy. Keďže OneLake používa iný koncový bod (dfs.fabric.microsoft.com
) ako ADLS Gen2 (dfs.core.windows.net
), niektoré nástroje nerozpoznajú koncový bod OneLake a blokujú 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
Služba OneLake je prístupná prostredníctvom rovnakých rozhraní API a súprav SDK ako ADLS Gen2. Ďalšie informácie o používaní rozhraní ADLS Gen2 API 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: |