Freigeben über

Übersicht über OneLake-Tabellen-APIs

OneLake bietet einen REST-API-Endpunkt für die Interaktion mit Tabellen in Microsoft Fabric. Dieser Endpunkt kann mit Clients und Bibliotheken verwendet werden, die mit der IRC-API (Iceberg REST Catalog) kompatibel sind, oder mit der unity Catalog API open standard.)

Von Bedeutung

Dieses Feature befindet sich in der Vorschauphase.

Voraussetzungen

Die Verwendung dieser APIs ist einfach, sobald Sie einige Informationen identifizieren und Ihren bevorzugten Microsoft Entra ID-Authentifizierungsfluss auswählen.

Sammeln grundlegender Informationen

Um diese APIs zu verwenden, müssen Sie zunächst die folgenden Informationen sammeln:

  • Ihre Fabric-Mandanten-ID.

    Die Mandanten-ID ist eine GUID, und sie finden Sie auf der Profilkarte oder im Menü **Hilfe, Informationen zu Fabric in Fabric.

  • Die Arbeitsbereichs- und Datenelement-ID des Datenelements (z. B. ein Seehaus) mit einem Tabellenverzeichnis der obersten Ebene.

    Diese IDs sind GUIDs. Sie finden sie in der OneLake-URL einer beliebigen Tabelle in OneLake. Sie können alternativ in der URL gefunden werden, die in Ihrem Browser angezeigt wird, wenn ein Datenelement in Fabric geöffnet ist.

  • Die Benutzer- oder Dienstprinzipalidentität in der Microsoft Entra-ID, die über Berechtigungen zum Lesen von Tabellen in Ihrem ausgewählten Datenelement verfügt.

Vorbereiten der Authentifizierung

  1. Entscheiden Sie, wie Sie sich mit der Microsoft Entra-ID authentifizieren möchten, um ein Zugriffstoken für Ihre ausgewählte Microsoft Entra-Identität zu erhalten.

    In diesem Leitfaden erfahren Sie mehr über die verschiedenen Möglichkeiten zum Abrufen eines Zugriffstokens mit Microsoft Entra ID. Microsoft bietet praktische Authentifizierungsbibliotheken in mehreren Sprachen.

  2. Wenn Sie eine neue Anwendung entwickeln, die es Benutzern entweder ermöglicht, sich anzumelden oder sich als eigenständige Anwendung anzumelden, registrieren Sie Ihre Anwendung mit der Microsoft Entra-ID.

  3. Erteilen Sie API-Berechtigungen für die Azure Storage(https://storage.azure.com/)-Tokengruppe Ihrer Microsoft Entra-ID-Anwendung. Durch die Erteilung dieser Berechtigung wird sichergestellt, dass Ihre Anwendung Token für die Verwendung mit dem OneLake-Tabellenendpunkt abrufen kann.

    Hinweis

    Der OneLake-Tabellen-API-Endpunkt akzeptiert dieselbe Token-Zielgruppe wie die OneLake-Dateisystemendpunkte.

    Wenn Sie eine Anwendung entwickeln, wissen Sie möglicherweise bereits, wie Sie sich mit Microsoft Entra-ID authentifizieren, um mit OneLake-Dateisystem-REST-APIs zu interagieren. Wenn ja, können Sie denselben Ansatz verwenden, um sich beim neuen OneLake-Tabellenendpunkt zu authentifizieren.

Iceberg REST Catalog (IRC)-API-Vorgänge auf OneLake

Erfahren Sie , wie Sie mit dem OneLake-Tabellen-API-Endpunkt beginnen, um mit Iceberg-Tabellen in OneLake zu interagieren. Zunächst werden schreibgeschützte Metadatentabellenvorgänge unterstützt, und wir planen, in Kürze weitere Vorgänge hinzuzufügen.

Hinweis

Bevor Sie die Iceberg-APIs verwenden, stellen Sie sicher, dass Delta Lake zu Iceberg-Metadatenkonvertierung für Ihren Mandanten oder Arbeitsbereich aktiviert ist. Lesen Sie die Anweisungen, um zu erfahren, wie Sie die automatische Konvertierung des Delta Lake in Iceberg-Tabellenformats aktivieren.

Delta Lake REST-API-Vorgänge auf OneLake

Erfahren Sie , wie Sie mit dem OneLake-Tabellen-API-Endpunkt beginnen, um mit Delta-Tabellen in OneLake zu interagieren.

Verwandte Inhalte

  • Last updated on