OneLake Delta Metadaten-API

OneLake bietet einen REST-API-Endpunkt für die Interaktion mit Tabellen in 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.

Diese Operationen entdecken Schemata, Tabellen und Tabellenmetadaten. Um Zeilen aus einer Delta-Tabelle abzurufen und gleichzeitig die OneLake-Sicherheit durchzusetzen, verwenden Sie die OneLake-Tabellenlese-API.

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

Beispiele für die Nutzung der API finden Sie in den API-Beispielen der Delta-Tabelle.

Delta-Tabellen-API-Endpunkt

Der OneLake-Tabellen-API-Endpunkt lautet:

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

Am API-Endpunkt für OneLake-Tabellen ist die Delta-API unter dem folgenden <BaseUrl> verfügbar.

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

Delta-Tabellen-API-Vorgänge

Dieser Endpunkt unterstützt derzeit die folgenden Delta-API-Operationen. Beispiele für diese Operationen finden Sie in den API-Beispielen der Delta-Tabelle.

  • 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 OneLake Delta-Metadaten-API hat folgende 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.

  • Andere 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 andere Abfrageparameter angeben. Wenn der Schemaname beispielsweise Punkte enthält, schließen Sie die catalog_name als Abfrageparameter in den API-Aufruf ein, um zu überprüfen, ob das Schema vorhanden ist.

  • Metadaten-Schreiboperationen und andere Metadaten-Operationen

    Die Delta-Metadaten-API-Oberfläche unterstützt nur die in den Delta-Tabellen-API-Operationen aufgeführten Metadatenoperationen. Diese Oberfläche unterstützt keine Metadaten-Schreiboperationen. Diese Einschränkung beschreibt nicht den Zeilenabruf über die separate Table Read API.

Verwandte Inhalte

  • Zuletzt aktualisiert um