Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
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.