Jaa

Yhdistäminen Microsoft OneLakeen

  • Artikkeli

Microsoft OneLake tarjoaa avoimen pääsyn kaikkiin Fabric-kohteisiisi aiemmin luotujen Azure Data Lake Storage (ADLS) Gen2 -ohjelmointirajapintojen ja SDK:iden kautta. Voit käyttää tietojasi OneLakessa minkä tahansa ADLS Gen2 :n kanssa yhteensopivan ohjelmointirajapinnan, SDK:n tai työkalun kautta vain OneLake-URI:n avulla. Voit ladata tietoja Lakehouse-tallennustilaan Azure-tallennus Explorerin kautta tai lukea delta-taulukon Azure Databricksin pikakuvakkeen kautta.

Koska OneLake on ohjelmisto palveluna (SaaS), jotkin toiminnot, kuten käyttöoikeuksien hallinta tai kohteiden päivittäminen, on tehtävä Fabric-käyttökokemuksen kautta ADLS Gen2 -ohjelmointirajapintojen sijaan. Täydellinen luettelo näiden ohjelmointirajapintojen muutoksista on kohdassa OneLake-ohjelmointirajapinnan pariteetti.

URI-syntaksi

Koska OneLake on olemassa koko Microsoft Fabric -vuokraajassa, voit viitata mihin tahansa vuokraajassa sen työtilan, kohteen ja polun mukaan:

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

Muistiinpano

Koska voit käyttää kohteiden nimiä eri kohdetyypeissä, sinun on määritettävä kohdetyyppi laajennuksessa. Esimerkiksi .lakehouse Lakehouselle ja .datawarehouse varastolle.

OneLake tukee myös viittaavia työtiloja ja kohteita, joilla on guiD-tunnukset (GUID) globaalisti yksilöllisillä tunnisteilla. OneLake määrittää GUID- ja GUID-tunnukset, jotka eivät muutu, vaikka työtilan tai kohteen nimi muuttuisi. Löydät työtilaan tai kohteeseen liittyvän GUID-tunnuksen Fabric-portaalin URL-osoitteesta. Sinun on käytettävä GUID-tunnuksia sekä työtilassa että kohteessa, eikä sinun tarvitse käyttää kohdetyyppiä.

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

Kun otat käyttöön työkalun OneLaken käyttämiseksi ADLS Gen2:n sijaan, käytä seuraavaa yhdistämismääritystä:

  • Tilin nimi on aina onelake.
  • Säilön nimi on työtilasi nimi.
  • Tietopolku alkaa kohteesta. Esimerkki: /mylakehouse.lakehouse/Files/.

OneLake tukee myös Azure Blob Filesystem -ohjainta (ABFS), joka takaa yhteensopivuuden ADLS Gen2-järjestelmän ja Azure Blob -säilön kanssa. ABFS-ohjain käyttää omaa järjestelmän tunnistettaan abfs ja eri URI-muotoa tiedostojen ja hakemistojen käsittelemiseen ADLS Gen2 -tileillä. Jos haluat käyttää tätä URI-muotoa OneLakessa, vaihda työtila tiedostojärjestelmään ja sisällytä kohde ja kohdetyyppi.

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

Abfs-ohjaimen URI ei salli työtilan nimessä erikoismerkkejä, kuten välilyöntejä. Näissä tapauksissa voit viitata työtiloihin ja kohteisiin GUID-tunnuksilla aiemmin tässä osiossa kuvatulla tavalla.

Valtuutus

Voit todentaa OneLake-ohjelmointirajapinnat Microsoft Entra -tunnuksella välittämällä valtuutusotsikon. Jos työkalu tukee kirjautumista Azure-tilillesi tunnuksen läpivientin käyttöönottamiseksi, voit valita minkä tahansa tilauksen. OneLake edellyttää vain käyttäjätunnusta, eikä Azure-tilauksestasi ole mitään hyötyä.

Kun kutsut OneLakea suoraan DFS-ohjelmointirajapintojen kautta, voit todentautua Microsoft Entra -tilisi haltijatunnuksen avulla. Jos haluat lisätietoja organisaatiosi haltijatunnusten pyytämisestä ja hallinnasta, tutustu Microsoftin todentamiskirjastoon.

Seuraavassa on yksinkertainen esimerkki OneLaken nopeasta ja ad-hoc-testauksesta suorilla ohjelmointirajapintakutsuilla, ja tässä on yksinkertainen esimerkki, jossa kirjaudut sisään Azure-tilillesi, noudat tallennusvälineeksi määritetyn tunnuksen ja kopioit sen leikepöydällesi muualle. Lisätietoja käyttöoikeustietueiden noutamisesta PowerShellin avulla on kohdassa Get-AzAccessToken.

Muistiinpano

OneLake tukee vain tunnuksia yleisössä Storage . Seuraavassa esimerkissä määritämme yleisön parametrin ResourceTypeName kautta.

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

Tietojen sijainti

Jos käytät yleistä päätepistettä ('https://onelake.dfs.fabric.microsoft.com' tietojen kyselemiseen eri alueella kuin työtilasi alueella, on mahdollista, että tiedot voivat poistua alueeltasi päätepisteiden ratkaisuprosessin aikana. Jos olet huolissasi tietojen tallennussijainnista, työtilasi oikean alueellisen päätepisteen avulla varmistat, että tiedot pysyvät senhetkisillä alueilla ilman, että ne ylittävät aluekohtaisia rajoja. Voit löytää oikean alueellisen päätepisteen tarkistamalla kapasiteetin alueen, johon työtila on liitetty.

OneLaken aluekohtaiset päätepisteet noudattavat kaikki samaa muotoa: https://<region>-onelake.dfs.fabric.microsoft.com. Esimerkiksi kapasiteettiin liitetty työtila olisi käytettävissä Länsi-Yhdysvaltain alueella alueellisen päätepisteen https://westus-onelake.dfs.fabric.microsoft.comkautta.

Yleiset ongelmat

Jos ADLS Gen2 -yhteensopiva työkalu tai paketti ei toimi OneLaken kanssa, yleisin ongelma on URL-osoitteen vahvistus. Koska OneLake käyttää eri päätepistettä (dfs.fabric.microsoft.com) kuin ADLS Gen2 (dfs.core.windows.net), jotkin työkalut eivät tunnista OneLake-päätepistettä ja estä sitä. Joidenkin työkalujen avulla voit käyttää mukautettuja päätepisteitä (kuten PowerShelliä). Muussa tapauksessa on usein helppoa lisätä OneLaken päätepiste tuettuna päätepisteenä. Jos löydät URL-osoitteen vahvistusongelman tai sinulla on muita OneLakeen liittyviä ongelmia, kerro meille siitä.

Näytteet

Luo tiedosto

Pyydä ASETTAA https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Otsikot Authorization: Bearer <userAADToken>
Response ResponseCode: 201 Created
Otsakkeet:
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
Keho:

Liittyvä sisältö