Jaa

Microsoft OneLaken Näyttöyhteys ing

  • Artikkeli

Microsoft OneLake tarjoaa avoimen pääsyn kaikkiin Fabric-kohteisiisi aiemmin luotujen Azure Data Lake Tallennus (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 Syntax

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 Tallennus 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>

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
$testToken.Token | Set-Clipboard

Tietojen sijainti

OneLake ei tällä hetkellä takaa tietojen tallennusta tietyllä alueella, kun käytetään yleistä päätepistettä (https://onelake.dfs.fabric.microsoft.com). Kun teet kyselyn eri alueella kuin työtilasi alueella, on mahdollista, että tiedot poistuvat 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 työtila, joka on liitetty kapasiteettiin Länsi-Yhdysvallat 2 -alueella, olisi käytettävissä 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ä.

Mallit

Luo tiedosto

Pyydä LAITTAA https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Otsikot Authorization: Bearer <userAADToken>
Vastaus 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
Elin:

Liittyvä sisältö