Udostępnij przez

Omówienie interfejsów API tabel OneLake

Usługa OneLake oferuje punkt końcowy interfejsu API REST do interakcji z tabelami w usłudze Microsoft Fabric. Ten punkt końcowy może być używany z klientami i bibliotekami, które są zgodne z interfejsem API Iceberg REST Catalog (IRC) open standard lub interfejsem API Unity Catalog open standard.

Ważne

Ta funkcja jest dostępna w wersji zapoznawczej.

Wymagania wstępne

Korzystanie z tych interfejsów API jest proste po zidentyfikowaniu kilku informacji i wybraniu preferowanego przepływu uwierzytelniania identyfikatora Entra firmy Microsoft.

Zbieranie podstawowych informacji

Aby użyć tych interfejsów API, najpierw należy zebrać następujące informacje:

  • Identyfikator dzierżawy Fabric.

    Identyfikator dzierżawy jest identyfikatorem GUID i można go znaleźć na karcie Profil lub w menu **Pomoc, Informacje o Fabric w Fabric.

  • Identyfikator obszaru roboczego i elementu danych (na przykład lakehouse) z katalogiem głównym 'Tabele'.

    Te identyfikatory są GUID-ami. Można je znaleźć w adresie URL OneLake każdej tabeli w usłudze OneLake. Można je również znaleźć w adresie URL widocznym w przeglądarce, gdy element danych jest otwarty w Fabric.

  • Tożsamość użytkownika lub podmiotu usługi w Microsoft Entra ID, która ma uprawnienia do odczytywania tabel w wybranym elemencie danych.

Przygotowywanie do uwierzytelniania

  1. Zdecyduj, w jaki sposób chcesz uwierzytelnić się za pomocą Microsoft Entra ID, aby uzyskać token dostępu dla wybranej tożsamości Microsoft Entra.

    Możesz sprawdzić ten przewodnik, aby dowiedzieć się więcej o różnych sposobach uzyskiwania tokenu dostępu za pomocą identyfikatora Entra firmy Microsoft. Firma Microsoft oferuje wygodne biblioteki uwierzytelniania w kilku językach.

  2. Jeśli tworzysz nową aplikację, która umożliwi użytkownikom logowanie się lub logowanie jako autonomiczną aplikację, zarejestruj aplikację w usłudze Microsoft Entra ID.

  3. Przyznaj uprawnienia interfejsu API dla docelowej grupy tokenów usługi Azure Storage (https://storage.azure.com/) w aplikacji Microsoft Entra ID. Przyznanie tego uprawnienia gwarantuje, że aplikacja może uzyskać tokeny do użycia z punktem końcowym tabeli OneLake.

    Uwaga / Notatka

    Punkt końcowy interfejsu API tabeli OneLake akceptuje tę samą grupę odbiorców tokenu co punkty końcowe systemu plików OneLake.

    Jeśli tworzysz aplikację, możesz już wiedzieć, jak uwierzytelniać się za pomocą identyfikatora Entra firmy Microsoft w celu interakcji z interfejsami API REST systemu plików OneLake. Jeśli tak, możesz użyć tej samej metody do uwierzytelniania za pomocą nowego punktu końcowego tabeli OneLake.

Operacje Iceberg REST Catalog (IRC) API w usłudze OneLake

Dowiedz się , jak rozpocząć pracę z punktem końcowym interfejsu API tabeli OneLake do interakcji z tabelami Iceberg w usłudze OneLake. Początkowo operacje tabeli metadanych tylko do odczytu są obsługiwane i planujemy wkrótce dodać więcej operacji.

Uwaga / Notatka

Przed użyciem interfejsów API Iceberg upewnij się, że dla dzierżawy lub obszaru roboczego włączono konwersję metadanych usługi Delta Lake na Iceberg. Zapoznaj się z instrukcjami, aby dowiedzieć się, jak włączyć automatyczną konwersję formatu tabeli Delta Lake na Iceberg.

Operacje interfejsu API REST Delta Lake w ramach OneLake

Dowiedz się , jak rozpocząć pracę z punktem końcowym interfejsu API tabeli OneLake, aby współpracować z tabelami Delta w usłudze OneLake.

Treści powiązane

  • Last updated on