Freigeben über

OneLake-Tabellen-APIs für Delta

OneLake bietet einen REST-API-Endpunkt für die Interaktion mit Tabellen in Microsoft Fabric. In diesem Artikel wird beschrieben, wie Sie mit diesem Endpunkt beginnen, um mit Delta-APIs zu interagieren, die an diesem Endpunkt für Metadatenlesevorgänge verfügbar sind. Diese Vorgänge sind mit dem offenen Standard der Unity-Katalog-API kompatibel.

Allgemeine Anleitungen und Voraussetzungen für die OneLake-Tabellen-API finden Sie in der Übersicht über die OneLake-Tabellen-API.

Ausführliche API-Dokumentation finden Sie im Leitfaden "Erste Schritte".

Von Bedeutung

Dieses Feature befindet sich in der Vorschauphase.

Delta-Tabellen-API-Endpunkt

Der OneLake-Tabellen-API-Endpunkt lautet:

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

Am OneLake-Tabellen-API-Endpunkt sind die Delta-APIs unter den folgenden <BaseUrl>Verfügbar.

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

Delta-Tabellen-API-Vorgänge

Die folgenden Delta-API-Vorgänge werden derzeit an diesem Endpunkt unterstützt. Detaillierte Anleitungen für diese Vorgänge finden Sie im Leitfaden für erste Schritte.

  • Schemas für Listen

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

    Dieser Vorgang akzeptiert die Arbeitsbereichs-ID und die Datenelement-ID (oder die entsprechenden Anzeigenamen, wenn sie keine Sonderzeichen enthalten).

    Dieser Vorgang gibt die Liste der Schemas innerhalb eines Datenelements zurück. Wenn das Datenelement keine Schemas unterstützt, wird ein festes Schema mit dem Namen dbo zurückgegeben.

  • Tabellen auflisten

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

    Dieser Vorgang gibt die Liste der Tabellen zurück, die in einem bestimmten Schema gefunden wurden.

  • Tabelle abrufen

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

    Dieser Vorgang gibt Metadatendetails für eine Tabelle innerhalb eines Schemas zurück, wenn die Tabelle gefunden wird.

  • Schema ist vorhanden

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

    Dieser Vorgang überprüft das Vorhandensein eines Schemas innerhalb eines Datenelements und gibt erfolgreich zurück, wenn das Schema gefunden wird.

  • Tabelle ist vorhanden

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

    Dieser Vorgang überprüft, ob eine Tabelle innerhalb eines Schemas existiert und meldet Erfolg, wenn das Schema gefunden wird.

Aktuelle Einschränkungen, Überlegungen

Die Verwendung der OneLake-Tabellen-APIs für Delta unterliegt den folgenden Einschränkungen und Überlegungen:

  • Bestimmte Datenelemente unterstützen möglicherweise keine Schemas.

    Je nach Typ des verwendeten Datenelements, z. B. nicht schemafähige Fabric Lakehouses, gibt es möglicherweise keine Schemas im Tabellenverzeichnis. In solchen Fällen bieten die OneLake-Tabellen-APIs aus Gründen der Kompatibilität mit API-Clients ein Standardschema, ein festes dbo Schema (oder einen Namespace), das alle Tabellen in einem Datenelement enthält.

  • Zusätzliche Abfragezeichenfolgenparameter erforderlich, wenn ihr Schemaname oder Tabellenname Punkte enthält

    Wenn Ihr Schema- oder Tabellenname Punkte (.) enthält und in der URL enthalten ist, müssen Sie auch zusätzliche Abfrageparameter angeben. Wenn der Schemaname beispielsweise Punkte enthält, schließen Sie die catalog_name als zusätzlichen Abfrageparameter in den API-Aufruf ein, um zu überprüfen, ob das Schema vorhanden ist.

  • Metadatenschreibvorgänge, andere Vorgänge

    Nur die in Delta-Tabellen-API-Vorgängen aufgeführten Vorgänge werden heute unterstützt. Vorgänge, die Metadatenschreibvorgänge verarbeiten, werden vom Delta-API-Endpunkt der OneLake-Tabelle noch nicht unterstützt.

Verwandte Inhalte

  • Last updated on