Oversikt over OneLake-tabell-API-er

OneLake tilbyr API-er for å arbeide med tabellmetadata og lese tabellrader i Fabric. Katalogmetadata-API-ene fungerer med klienter og biblioteker som er kompatible med Iceberg REST Catalog (IRC) API åpen standard eller Unity Catalog API åpen standard. Et vanlig REST-API leser og skriver tilleggsbeskrivelser og tagger for tabeller og kolonner. Det formatuavhengige tabelllese-API-et returnerer tabellrader som Apache Arrow-data samtidig som det håndhever OneLake-sikkerheten.

Arbeid med tabellmetadata

Bruk metadata-API-ene for å oppdage skjemaer, tabeller og tabellmetadata. Støttede lese- og skriveoperasjoner varierer etter protokoll.

Bruk det ekstra tabellmetadata-API-et (forhåndsvisning) for å lese og skrive tabell- og kolonnebeskrivelser og tagger uten å bruke et formatspesifikt katalog-API.

API Protokoll Tabellformater
Iceberg metadata API Iceberg REST-katalog API Isfjellmetadata for støttede OneLake-tabeller
Delta metadata API Unity-katalogkompatibel REST API Delta-metadata

Lesetabelldata

Bruk Table Read API-et for å hente sikrede rader fra støttede OneLake-tabeller.

API Protokoll og arbeidsflyt Tabellformater
Table read API (forhåndsvisning) Alloker strømmer med POST /read, og hent hver strøm med GET /readStream/{streamId} Gyldige tabeller for Delta Lake og Apache Iceberg

Forutsetninger

Før du bruker disse API-ene, identifiser noen få opplysninger og velg din foretrukne Microsoft Entra ID-autentiseringsflow.

Samle grunnleggende informasjon

Samle følgende informasjon:

  • Din Fabric-leier-ID.

    Leietaker-ID-en er en GUID. Finn det i profilkortet eller i Help>About Fabric.

  • Arbeidsområdet og dataelement-ID-en for dataelementet (for eksempel et innsjøhus) med en tabellkatalog på øverste nivå.

    Disse ID-ene er GUID-er. De finner du i OneLake-URL-adressen til en hvilken som helst tabell i OneLake. De kan alternativt finnes i URL-en som vises i nettleseren din når du har et dataelement åpent i Fabric.

  • Skjemanavnet og tabellnavnet for tabellen du ønsker å få tilgang til. For tabelllese-API-et må tabellen være en gyldig Delta Lake- eller Apache Iceberg-tabell.

  • En bruker- eller tjenestehovedidentitet i Microsoft Entra ID som har de nødvendige tillatelsene for operasjonene du planlegger å bruke.

    • Leseoperasjoner krever tillatelse for å lese måltabellene. Tabelllese-API-et bruker tillatelser og datasikkerhetspolicyer for denne identiteten når det returnerer rader og kolonner.
    • Skriveoperasjoner krever skrivetilgang til måldataelementet og OneLake-lokasjonen. Avhengig av elementtype og tilgangsmodell, gi en element- eller arbeidsområderolle som tillater skriving, eller gi ReadWrite gjennom en OneLake datatilgangsrolle. Hvis du vil ha mer informasjon, kan du se Komme i gang med OneLake-sikkerhet.

Gjør deg klar for autentisering

Lag en plan for hvordan du vil autentisere deg med API-et.

  1. Bestem hvordan du vil godkjenne med Microsoft Entra-ID for å få et tilgangstoken for den valgte Microsoft Entra-identiteten.

    Du kan se denne veiledningen for å lære om de forskjellige måtene å få et tilgangstoken med Microsoft Entra ID på. Microsoft tilbyr praktiske godkjenningsbiblioteker på flere språk.

  2. Hvis du utvikler et nytt program som enten lar brukere logge på eller logge på som et frittstående program, registrerer du programmet med Microsoft Entra ID.

  3. Gi API-tillatelse for Azure Storage (https://storage.azure.com/)-tokenmålgruppen til Microsoft Entra ID-programmet. Hvis du gir denne tillatelsen, sikrer du at programmet kan hente tokener for bruk med OneLake-tabellendepunktet.

    Note

    API-endepunktet for OneLake-tabellen godtar samme tokenmålgruppe som endepunktene for OneLake-filsystemet.

    Hvis du utvikler en applikasjon, vet du kanskje allerede hvordan du autentiserer deg med Microsoft Entra ID for å samhandle med OneLake-filsystemets REST-API-er. Hvis ja, kan du bruke samme tilnærming for autentisering med OneLake-tabellens endepunkt.

Beslektet innhold

  • Sist oppdatert