OneLake-taulukon ohjelmointirajapintojen yleiskatsaus

OneLake tarjoaa API-rajapintoja taulukkometatietojen käsittelyyn ja taulukkorivien lukemiseen Fabric-ohjelmassa. Luettelon metatietorajapinnat toimivat asiakkaiden ja kirjastojen kanssa, jotka ovat yhteensopivia Iceberg REST Catalog (IRC) API -avoimen standardin tai Unity Catalog API -avoimen standardin kanssa. Yleinen REST-rajapinta lukee ja kirjoittaa lisäkuvauksia ja tageja tauluille ja sarakkeille. Formaatista riippumaton taulukkolukurajapinta palauttaa taulukon rivit Apache Arrow -datana samalla kun OneLake-turvallisuus valvotaan.

Työskentely taulukkometatietojen kanssa

Käytä metatietorajapintoja löytääksesi skeemoja, tauluja ja taulumetatietoja. Tuetut luku- ja kirjoitustoiminnot vaihtelevat protokollan mukaan.

Käytä lisätaulukkometatieto-API:ta (esikatselu) lukeaksesi ja kirjoittaaksesi taulujen ja sarakkeiden kuvauksia ja tageja ilman muotokohtaista katalogirajapintaa.

API Protokolla Taulukkomuodot
Iceberg metadata API Iceberg REST Catalog API Jäävuoren metatiedot tuetuille OneLake-taulukoille
Delta metadata API Unity Catalog -yhteensopiva REST API Delta-metatiedot

Lue taulukkotiedot

Käytä taulujen lukurajapintaa hakeaksesi suojattuja rivejä tuetuista OneLake-tauluista.

API Protokolla ja työnkulku Taulukkomuodot
Table read API (esikatselu) Varaa virrat , POST /readja hae jokainen virta , GET /readStream/{streamId} Voimassa olevat Delta Laken ja Apache Icebergin taulukot

Ennakkovaatimukset

Ennen kuin käytät näitä API-rajapintoja, tunnista muutama tieto ja valitse haluamasi Microsoft Entra ID -todennusprosessi.

Kerää perustiedot

Kerää seuraavat tiedot:

  • Fabric-vuokraajatunnuksesi.

    Vuokralaisen tunnus on GUID. Löydät sen Profiilikortista tai Help>about Fabric -osiosta.

  • Tietokohteen (kuten lakehousen) työtila ja tietokohdetunnus, jossa on ylimmän tason Tables-hakemisto.

    Nämä tunnukset ovat GUID-tunnuksia. Ne löytyvät minkä tahansa OneLaken taulukon OneLaken URL-osoitteesta. Ne löytyvät vaihtoehtoisesti selaimessasi näkyvästä URL-osoitteesta, kun tietokohde on avoinna Fabricissa.

  • Skeeman nimi ja taulun nimi taululle, johon haluat pääseä. Taulun lukurajapinnalle taulukon täytyy olla kelvollinen Delta Lake- tai Apache Iceberg -taulukko.

  • Käyttäjä- tai palvelupäähenkilöllisyys Microsoft Entra ID:ssä, jolla on tarvittavat oikeudet niille operaatioille, joita aiot käyttää.

    • Lukutoiminnot vaativat luvan kohdetaulujen lukemiseen. Taulukkolukurajapinta käyttää tämän identiteetin käyttöoikeuksia ja tietoturvakäytäntöjä palauttaessaan rivejä ja sarakkeita.
    • Kirjoitusoperaatiot vaativat kirjoitusoikeuden kohdetietokohteeseen ja OneLake-sijaintiin. Riippuen alityypistä ja käyttöoikeusmallista, myönnä alkio tai työtilarooli, joka sallii kirjoitukset, tai myönnä ReadWrite OneLake-datan käyttöroolin kautta. Lisätietoja on artikkelissa OneLaken suojauksen käytön aloittaminen.

Valmistaudu tunnistautumiseen

Tee suunnitelma siitä, miten haluat todentaa API:n avulla.

  1. Päätä, miten haluat todentaa Microsoft Entra ID:llä, jotta saat käyttöoikeustietueen valitsemallesi Microsoft Entra -käyttäjätiedolle.

    Tästä oppaasta saat lisätietoja eri tavoista hankkia käyttöoikeustietue Microsoft Entra ID:llä. Microsoft tarjoaa käteviä todennuskirjastoja useilla kielillä.

  2. Jos olet kehittämässä uutta sovellusta, jonka avulla käyttäjät voivat kirjautua sisään tai kirjautua sisään erillisenä sovelluksena, rekisteröi sovelluksesi Microsoft Entra ID:llä.

  3. Myönnä ohjelmointirajapinnan käyttöoikeus Azure-tallennus (https://storage.azure.com/) -tunnuksen käyttäjäryhmälle Microsoft Entra ID -sovelluksellesi. Tämän käyttöoikeuden myöntäminen varmistaa, että sovelluksesi voi hankkia tunnuksia käytettäväksi OneLake-taulukon päätepisteen kanssa.

    Note

    OneLake-taulukon ohjelmointirajapinnan päätepiste hyväksyy saman tunnuksen käyttäjäryhmän kuin OneLake-tiedostojärjestelmän päätepisteet.

    Jos kehität sovellusta, saatat jo osata tunnistautua Microsoft Entra ID:llä, jotta voit olla vuorovaikutuksessa OneLake-tiedostojärjestelmän REST-rajapintojen kanssa. Jos näin on, voit käyttää samaa lähestymistapaa tunnistautumiseen OneLake-taulun päätepisteellä.

Aiheeseen liittyvä sisältö

  • Viimeksi päivitetty