OneLake Delta metadata API

OneLake tilbyder et REST API-endpoint til interaktion med tabeller i Fabric. I denne artikel beskrives det, hvordan du kommer i gang med at bruge dette slutpunkt til at interagere med Delta-API'er, der er tilgængelige på dette slutpunkt til læsehandlinger af metadata. Disse handlinger er kompatible med den åbne standard for Unity Catalog API.

Disse operationer opdager skemaer, tabeller og tabelmetadata. For at hente rækker fra en Delta-tabel samtidig med at håndhæve OneLake-sikkerhed, brug OneLake-tabel-læse-API'en.

Du kan finde en generel vejledning til OneLake-tabel-API og vejledning til forudsætninger i oversigten over OneLake-tabel-API.

For eksempler på brug af API'en, se Delta-tabellen API-eksempler.

API-slutpunkt for deltatabel

API-slutpunktet for OneLake-tabel er:

https://onelake.table.fabric.microsoft.com

Ved OneLake-tabellen API-endpoint er Delta API'en tilgængelig under følgende <BaseUrl>.

https://onelake.table.fabric.microsoft.com/delta

API-handlinger for deltatabel

Dette endepunkt understøtter i øjeblikket følgende Delta API-operationer. Du kan finde eksempler på disse operationer i Delta-tabellen API-eksempler.

  • Liste skemaer

    GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas?catalog_name=<ItemName or ItemID>

    Denne handling accepterer arbejdsområde-id'et og dataelement-id'et (eller deres tilsvarende brugervenlige navne, hvis de ikke indeholder specialtegn).

    Denne handling returnerer listen over skemaer i et dataelement. Hvis dataelementet ikke understøtter skemaer, returneres et fast skema navngivet dbo .

  • Liste tabeller

    GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables?catalog_name=<ItemName or ItemID>&schema_name=<SchemaName>

    Denne handling returnerer listen over tabeller, der findes i et givet skema.

  • Hent tabel

    GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

    Denne handling returnerer metadataoplysninger for en tabel i et skema, hvis tabellen findes.

  • Skemaet findes

    HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas/<SchemaName>

    Denne handling kontrollerer, om der findes et skema i et dataelement, og returnerer succes, hvis skemaet findes.

  • Tabel findes

    HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

    Denne handling kontrollerer, om der findes en tabel i et skema, og returnerer succes, hvis skemaet findes.

Nuværende begrænsninger, overvejelser

OneLake Delta metadata-API'en har følgende begrænsninger og overvejelser:

  • Visse dataelementer understøtter muligvis ikke skemaer

    Afhængigt af den type dataelement, du bruger, f.eks. ikke-skemaaktiverede Fabric lakehouses, er der muligvis ikke skemaer i mappen Tabeller. I sådanne tilfælde indeholder OneLake-tabel-API'erne et standardskema dbo (eller navneområde) til at indeholde alle tabeller i et dataelement for kompatibilitet med API-klienter.

  • Andre forespørgselsstrengsparametre kræves, hvis dit skemanavn eller tabelnavn indeholder prikker

    Hvis dit skema eller tabelnavn indeholder prikker (.) og er inkluderet i URL'en, skal du også angive andre forespørgselsparametre. For eksempel, når skemanavnet indeholder prikker, skal catalog_name inkluderes som en forespørgselsparameter i API-kaldet for at kontrollere, om skemaet eksisterer.

  • Metadata-skriveoperationer og andre metadataoperationer

    Delta metadata API-overfladen understøtter kun de metadataoperationer, der er angivet i Delta-tabel API-operationer. Denne surface understøtter ikke metadata-skriveoperationer. Denne begrænsning beskriver ikke rækkehentning via det separate table read API.