Jaa

OneLaken ja Azure Data Lake Storage (ADLS) Gen2:n ohjelmointirajapintapariteetti

  • Artikkeli

OneLake tukee samoja ohjelmointirajapintoja kuin Azure Data Lake Storage (ADLS) Gen2, joten käyttäjät voivat lukea, kirjoittaa ja hallita tietojaan OneLakessa niillä työkaluilla, joita he jo käyttävät jo tänään. Koska OneLake on hallittu looginen Data Lake -tallennustila, joitakin ominaisuuksia hallitaan eri tavalla kuin Azure-tallennus eikä kaikkia OneLake-toimintoja tueta. Tällä sivulla on tiedot näistä eroista, kuten OneLaken hallituista kansioista, ohjelmointirajapinnan eroista ja avoimen lähdekoodin yhteensopivuudesta.

Hallitut OneLake-kansiot

Fabric-vuokraajan työtilat ja tietokohteet määrittävät OneLaken rakenteen. Työtilojen ja kohteiden hallinta tapahtuu Fabric-käyttökokemuksen avulla – OneLake ei tue työtilojen tai kohteiden luomista, päivittämistä tai poistamista ADLS Gen2 -ohjelmointirajapintojen kautta. OneLake sallii HEAD-kutsut vain työtilan (säilö) ja vuokraajan (tilin) tasolla, koska sinun on tehtävä muutoksia vuokraajaan ja työtiloihin Fabric-hallintaportaalissa.

OneLake valvoo myös Fabric-kohteiden kansiorakennetta, joka suojaa kohteita ja niiden hallittuja alikansioita luomiselta, poistamiselta tai uudelleennimeämiseltä ADLS Gen2 -ohjelmointirajapintojen kautta. Fabric-hallittuihin kansioihin kuuluu kohteen ylimmän tason kansio (esimerkiksi /MyLakehouse.Lakehouse) ja sen sisältämien kansioiden ensimmäinen taso (esimerkiksi /MyLakehouse.lakehouse/Files ja /MyLakehouse.lakehouse/Tables).

Voit suorittaa CRUD-toimintoja missä tahansa kansiossa tai tiedostossa, joka on luotu näissä hallituissa kansioissa, ja suorittaa vain luku -toimintoja työtilassa ja kohdekansioissa.

Pyynnön otsikot ja parametrit, joita ei tueta

Jopa käyttäjän luomissa tiedostoissa ja kansioissa OneLake rajoittaa joitakin Fabric-hallintatoimintoja ADLS Gen2 -ohjelmointirajapintojen kautta. Sinun on käytettävä Fabric-käyttökokemusta käyttöoikeuksien päivittämiseen tai kohteiden ja työtilojen muokkaamiseen, ja Fabric hallitsee muita vaihtoehtoja, kuten käyttöoikeustasoja.

OneLake hyväksyy lähes kaikki samat otsikot kuin ADLS Gen2, ohittaen vain jotkin otsikot, jotka liittyvät OneLaken hyväksymättömiin toimintoihin. Koska nämä otsikot eivät muuta koko kutsun toimintaa, OneLake ohittaa kielletyt otsikot ja palauttaa ne uudessa x-ms-rejected-headers-vastausotsikossa ja sallii kutsun muut osat. Esimerkiksi OneLake ohittaa PUT-kutsun x-ms-owner-parametrin, koska Fabric ja OneLake eivät omista käyttäjiä samalla tavalla kuin Azure-tallennus.

OneLake hylkää pyynnöt, jotka sisältävät ei-sallittuja kyselyparametreja, koska kyselyparametrit muuttavat koko kutsun toimintaa. Esimerkiksi SETAccessControl-parametrilla hallitut UPDATE-kutsut on estetty, koska OneLake ei koskaan tue käyttöoikeuksien valvonnan määrittämistä Azure-tallennus ohjelmointirajapintojen kautta.

OneLake ei salli seuraavia toimintoja ja niihin liittyviä pyyntöotsikoita ja URI-parametreja:

  • Määritä käyttöoikeuksien valvonta
    • URI-parametri:
      • toiminto: setAccessControl (Pyyntö hylättiin)
      • toiminto: setAccessControlRecursive (Pyyntö hylätty)
    • Pyyntöotsikot:
      • x-ms-owner (Otsikko sivuutettu)
      • x-ms-group (Otsikko sivuutettu)
      • x-ms-permissions (Otsikko sivuutettu)
      • x-ms-group (Otsikko sivuutettu)
      • x-ms-acls (Otsikko sivuutettu)
  • Määritä salauksen laajuus
    • Pyyntöotsikot:
      • x-ms-encryption-key (Otsikko sivuutettu)
      • x-ms-encryption-key (Otsikko sivuutettu)
      • x-ms-encryption-algorithm:AES256 (Otsikko sivuutettu)
  • Käyttöoikeustason määrittäminen
    • Pyyntöotsikot:
      • x-ms-access-tier (Header ohitettu)

Vastauksen otsikoiden erot

Koska OneLake käyttää eri käyttöoikeusmallia kuin ADLS Gen2, käyttöoikeuksiin liittyviä vastausotsikoita käsitellään eri tavalla:

  • x-ms-owner ja x-ms-group palauttavat aina arvon $superuser, koska OneLakella ei ole omistavia käyttäjiä tai ryhmiä
  • x-ms-permissions palauttaa aina ---------, koska OneLakella ei ole omistavia käyttäjiä, ryhmiä tai julkisia käyttöoikeuksia.
  • x-ms-acl palauttaa kutsuvan käyttäjän Fabric-käyttöoikeudet, jotka on muunnettu POSIX-käyttöoikeuksien hallintaluetteloksi (ACL), muodossa "rwx"

Avoimen lähdekoodin integrointi

Koska OneLake tukee samoja ohjelmointirajapintoja kuin ADLS Gen2, monet avoimen lähdekoodin kirjastot ja paketit, jotka ovat yhteensopivia ADLS Gen2:n kanssa, toimivat saumattomasti OneLaken kanssa. Muut kirjastot saattavat vaatia pieniä päivityksiä OneLake-päätepisteiden tai muiden yhteensopivuusongelmien vuoksi. Seuraavat kirjastot on vahvistettu yhteensopiviksi OneLaken kanssa viimeaikaisten muutosten vuoksi. Luettelo ei ole tyhjentävä:

Esimerkit

Luetteloi kohteita työtilassa

GET https://onelake.dfs.fabric.microsoft.com/myWorkspace?resource=filesystem&recursive=false

Luo kansio Lakehousessa

PUT https://onelake.dfs.fabric.microsoft.com/myWorkspace/myLakehouse.Lakehouse/Files/newFolder/?resource=directory

Liittyvä sisältö