Oversigt over OneLake-tabel-API'er

OneLake tilbyder API'er til arbejde med tabelmetadata og læsning af tabelrækker i Fabric. Katalogmetadata-API'erne arbejder med klienter og biblioteker, der er kompatible med Iceberg REST Catalog (IRC) API open standard eller Unity Catalog API open standard. Et almindeligt REST API læser og skriver yderligere beskrivelser og tags for tabeller og kolonner. Det formatuafhængige tabellæse-API returnerer tabelrækker som Apache Arrow-data, mens det håndhæver OneLake-sikkerheden.

Arbejd med tabelmetadata

Brug metadata-API'erne til at opdage skemaer, tabeller og tabelmetadata. Understøttede læse- og skriveoperationer varierer efter protokol.

Brug det ekstra tabelmetadata-API (forhåndsvisning) til at læse og skrive tabell- og kolonnebeskrivelser samt tags uden at bruge et format-specifikt katalog-API.

API Protokol Tabelformater
Iceberg metadata API Iceberg REST Katalog API Iceberg-metadata for understøttede OneLake-tabeller
Delta metadata API Unity Catalog-kompatibel REST API Delta-metadata

Læs tabeldata

Brug table read API'en til at hente sikrede rækker fra understøttede OneLake-tabeller.

API Protokol og arbejdsgang Tabelformater
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

Forudsætninger

Før du bruger disse API'er, skal du identificere nogle få oplysninger og vælge din foretrukne Microsoft Entra ID-autentificeringsflow.

Indsaml grundlæggende information

Indsaml følgende information:

  • Dit Fabric-lejer-id.

    Lejer-ID'et er en GUID. Find det i profilkortet eller i Help>About Fabric.

  • Arbejdsområdet og dataelement-id'et for dataelementet (f.eks. et søhus) med en tabelmappe på øverste niveau.

    Disse id'er er GUID'er. De kan findes i OneLake-URL'en til enhver tabel i OneLake. De kan alternativt findes i den URL, der ses i din browser, når du har et dataelement åbent i Fabric.

  • Skemanavnet og tabelnavnet for den tabel, du vil tilgå. For table read API'en skal tabellen være en gyldig Delta Lake- eller Apache Iceberg-tabel.

  • En bruger- eller tjenesteprincipal-identitet i Microsoft Entra ID, som har de nødvendige tilladelser til de operationer, du planlægger at bruge.

    • Læseoperationer kræver tilladelse til at læse måltabellerne. Tabellæsnings-API'en bruger tilladelser og datasikkerhedspolitikker for denne identitet, når den returnerer rækker og kolonner.
    • Skriveoperationer kræver skriveadgang til måldataelementet og OneLake-lokationen. Afhængigt af elementtypen og adgangsmodellen tildeles en opgave- eller arbejdsområderolle, der tillader skrivning, eller ReadWrite gennem en OneLake dataadgangsrolle. Du kan finde flere oplysninger under Kom i gang med OneLake-sikkerhed.

Forbered dig på autentificering

Lav en plan for, hvordan du vil autentificere med API'et.

  1. Beslut, hvordan du vil godkende med Microsoft Entra ID for at få et adgangstoken til din valgte Microsoft Entra-identitet.

    Du kan se denne vejledning for at få mere at vide om de forskellige måder at få et adgangstoken på med Microsoft Entra ID. Microsoft tilbyder praktiske godkendelsesbiblioteker på flere sprog.

  2. Hvis du udvikler et nyt program, der enten giver brugerne mulighed for at logge på eller logge på som et enkeltstående program, skal du registrere dit program med Microsoft Entra ID.

  3. Giv API-tilladelse til Azure Storage-tokenmålgruppen (https://storage.azure.com/) til dit Microsoft Entra ID-program. Hvis du giver denne tilladelse, sikrer du, at dit program kan hente tokens til brug sammen med OneLake-tabelslutpunktet.

    Notat

    OneLake-tabel-API-slutpunktet accepterer den samme tokenmålgruppe som OneLake-filsystemets slutpunkter.

    Hvis du udvikler en applikation, ved du måske allerede, hvordan man autentificerer med Microsoft Entra ID for at interagere med OneLake-filsystemets REST API'er. Hvis ja, kan du bruge samme tilgang til at autentificere med OneLake-tabelens endpoint.

Relateret indhold

  • Sidst opdateret den