Zdieľať cez

Pripojenie k Microsoft OneLake

  • Článok

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 prostredí služby Fabric namiesto rozhraní ADLS Gen2 API. Úplný zoznam zmien týchto rozhraní API nájdete v téme Parita rozhrania API oneLake.

URI Syntax

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 -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ť.

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:

Súvisiaci obsah