Dela via

OneLake-tabell-API:er för Isberg

OneLake erbjuder en REST API-slutpunkt för att interagera med tabeller i Microsoft Fabric. I den här artikeln beskrivs hur du kommer igång med den här slutpunkten för att interagera med Apache Iceberg REST Catalog-API:er (IRC) som är tillgängliga på den här slutpunkten för metadataläsningsåtgärder.

Övergripande vägledning för OneLake-tabell-API:et och nödvändig vägledning finns i översikten över OneLake-tabell-API:et.

Detaljerad API-dokumentation finns i komma igång-guiden.

Viktigt!

Den här funktionen är i förhandsversion.

Isbergstabellens API-slutpunkt

OneLake-tabell-API-slutpunkten är:

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

I OneLake-tabell-API:ets slutpunkt är API:erna för Iceberg REST Catalog (IRC) tillgängliga under följande <BaseUrl>. Du kan vanligtvis ange den här sökvägen när du initierar befintliga IRC-klienter eller bibliotek.

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

Exempel på IRC-klientkonfiguration med OneLake-tabellslutpunkten beskrivs i guiden Komma igång.

Anmärkning

Innan du använder Isbergs-API:erna, se till att Delta Lake till Iceberg-metadatakonvertering är aktiverad för din klientorganisation eller arbetsyta. Se anvisningarna för att lära dig hur du aktiverar automatisk konvertering av Delta Lake till Iceberg-metadata.

API-åtgärder för isbergstabeller

Följande IRC-åtgärder stöds för närvarande på den här slutpunkten. Detaljerad vägledning för dessa åtgärder finns i guiden Komma igång.

  • Hämta konfiguration

    GET <BaseUrl>/v1/config?warehouse=<Warehouse>

    Den här åtgärden accepterar arbetsytans ID och dataobjekts-ID (eller motsvarande vänliga namn om de inte innehåller några specialtecken). <Warehouse> är vanligtvis <WorkspaceID>/<dataItemID>.

    Den här åtgärden returnerar strängen Prefix som används i efterföljande begäranden.

  • Lista namnområden

    GET <BaseUrl>/v1/<Prefix>/namespaces

    Den här åtgärden returnerar listan över scheman i ett dataobjekt. Om dataobjektet inte stöder scheman returneras ett fast schema med namnet dbo .

  • Hämta namnområde

    GET <BaseUrl>/v1/<Prefix>/namespaces/<SchemaName>

    Den här åtgärden returnerar information om ett schema i ett dataobjekt, om schemat hittas. Om dataobjektet inte stöder scheman stöds ett fast schema med namnet dbo här.

  • Lista tabeller

    GET <BaseUrl>/v1/<Prefix>/namespaces/<SchemaName>/tables

    Den här åtgärden returnerar listan över tabeller som finns i ett visst schema.

  • Hämta tabell

    GET <BaseUrl>/v1/<Prefix>/namespaces/<SchemaName>/tables/<TableName>

    Den här åtgärden returnerar metadatainformation för en tabell i ett schema, om tabellen hittas.

Aktuella begränsningar, överväganden

Användning av OneLake-tabell-API:er för Iceberg omfattas av följande begränsningar och överväganden:

  • Vissa dataobjekt kanske inte stöder scheman

    Beroende på vilken typ av dataobjekt du använder, till exempel icke-schemaanvända Fabric-lagerhus, kanske det inte finns scheman i Tabellkatalogen. I sådana fall, för kompatibilitet med API-klienter, tillhandahåller OneLake-tabell-API:erna ett standardschema dbo (eller namnområde) som innehåller alla tabeller i ett dataobjekt.

  • Aktuellt namnområdesomfång

    I Fabric innehåller dataobjekt en platt lista med scheman, där varje innehåller en platt lista med tabeller. I dag är de toppnivånamnområden som listas av Isbergs-API:erna scheman, så även om isbergs-REST-katalogen (IRC) har stöd för namnområden på flera nivåer, erbjuder OneLake-implementeringen en nivå och mappning till scheman.

    På grund av den här begränsningen parent har vi ännu inte stöd för frågeparametern för åtgärden list namespaces .

  • Skrivåtgärder för metadata, andra åtgärder

    Endast de åtgärder som anges i ISBERG-tabell-API-åtgärder stöds i dag. Åtgärder som hanterar metadataskrivningsåtgärder stöds ännu inte av OneLake-tabell-API-slutpunkten. Vi planerar att lägga till stöd för fler åtgärder vid ett senare tillfälle.

Relaterat innehåll

  • Last updated on