Übersicht über OneLake-Tabellen-APIs

OneLake stellt APIs zur Verfügung, um mit Tabellenmetadaten zu arbeiten und Tabellenzeilen in Fabric auszulesen. Die Katalogmetadaten-APIs arbeiten mit Clients und Bibliotheken, die mit dem offenen Standard der Iceberg REST Catalog (IRC) API oder dem offenen Standard der Unity Catalog API kompatibel sind. Eine gängige REST-API liest und schreibt zusätzliche Beschreibungen und Tags für Tabellen und Spalten. Die formatunabhängige Tabellenlese-API liefert Tabellenzeilen als Apache Arrow-Daten zurück, während sie die OneLake-Sicherheit durchsetzt.

Arbeit mit Tabellenmetadaten

Nutzen Sie die Metadaten-APIs, um Schemata, Tabellen und Tabellenmetadaten zu entdecken. Unterstützte Lese- und Schreiboperationen variieren je nach Protokoll.

Verwenden Sie die zusätzliche Tabellen-Metadaten-API (Vorschau), um Tabellen- und Spaltenbeschreibungen sowie -tags zu lesen und zu schreiben, ohne eine formatspezifische Katalog-API zu verwenden.

API Protocol Tabellenformate
Iceberg metadata API Iceberg REST Katalog API Eisberg-Metadaten für unterstützte OneLake-Tabellen
Delta-Metadaten-API Unity-Katalog-kompatible REST-API Delta-Metadaten

Tabellendaten lesen

Verwenden Sie die Table Read API, um gesicherte Zeilen aus unterstützten OneLake-Tabellen abzurufen.

API Protokoll und Arbeitsablauf Tabellenformate
Table Read API (Vorschau) Weisen Sie Streams mit POST /read zu und rufen Sie jeden Stream mit GET /readStream/{streamId} ab Gültige Delta Lake und Apache Iceberg Tabellen

Voraussetzungen

Bevor Sie diese APIs verwenden, identifizieren Sie einige Informationen und wählen Sie Ihren bevorzugten Microsoft Entra ID-Authentifizierungsfluss aus.

Sammeln Sie grundlegende Informationen

Sammeln Sie die folgenden Informationen:

  • Ihre Fabric-Mandanten-ID.

    Die Mieter-ID ist eine GUID. Finden Sie es auf der Profilkarte oder in Hilfe>über 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.

  • Der Schemaname und der Tabellenname der Tabelle, auf die du Zugriff haben möchtest. Für die Table Read API muss die Tabelle eine gültige Delta Lake- oder Apache-Eisberg-Tabelle sein.

  • Eine Benutzer- oder Service-Principal-Identität in Microsoft Entra ID, die die für die geplanten Operationen erforderlichen Berechtigungen besitzt.

    • Leseoperationen erfordern eine Berechtigung, um die Zieltabellen zu lesen. Die Table Read API verwendet die Berechtigungen und Datensicherheitsrichtlinien dieser Identität, wenn sie Zeilen und Spalten zurückgibt.
    • Schreiboperationen erfordern Schreibzugriff auf das Zieldatenelement und den OneLake-Standort. Je nach Item-Typ und Zugriffsmodell gewähren Sie eine Element- oder Arbeitsbereichsrolle, die Schreibvorgänge erlaubt, oder gewähren Sie ReadWrite über eine OneLake-Datenzugriffsrolle. Weitere Informationen finden Sie unter "Erste Schritte mit OneLake-Sicherheit".

Vorbereitung auf die Authentifizierung

Mach einen Plan, wie du dich mit der API authentifizieren möchtest.

  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 vielleicht bereits, wie man sich mit Microsoft Entra ID authentifiziert, um mit OneLake-Dateisystem-REST-APIs zu interagieren. Wenn ja, kannst du denselben Ansatz zur Authentifizierung mit dem OneLake-Tabellenendpunkt verwenden.

Verwandte Inhalte

  • Zuletzt aktualisiert um