Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
OneLake udostępnia API do pracy z metadanymi tabel oraz odczytu wierszy tabel w Fabric. Interfejsy API metadanych katalogu współpracują z klientami i bibliotekami kompatybilnymi z otwartym standardem interfejsu API Iceberg REST Catalog (IRC) lub otwartym standardem interfejsu API Unity Catalog. Wspólne API REST odczytuje i zapisuje dodatkowe opisy oraz tagi dla tabel i kolumn. Niezależne od formatu API czytania tabel zwraca wiersze tabel jako dane Apache Arrow, jednocześnie egzekwując bezpieczeństwo OneLake.
Praca z metadanymi tabel
Korzystaj z API metadanych, aby odkrywać schematy, tabele i metadane tabel. Obsługiwane operacje odczytu i zapisu różnią się w zależności od protokołu.
Użyj dodatkowego API metadanych tabel (podgląd) do odczytu i zapisu opisów i tagów tabel oraz kolumn bez użycia API katalogowego specyficznego dla formatu.
| API | Protocol | Formaty tabel |
|---|---|---|
| API metadanych Iceberg | API katalogu Iceberg REST | Metadane Iceberg dla obsługiwanych tabel OneLake |
| API metadanych Delta | API REST kompatybilne z katalogiem Unity | Metadane różnicowe |
Czytaj dane tabelowe
Użyj API do czytania tabel, aby pobrać zabezpieczone wiersze z obsługiwanych tabel OneLake.
| API | Protokół i przepływ pracy | Formaty tabel |
|---|---|---|
| API do czytania tabel (podgląd) | Przydziel strumienie za pomocą POST /read, a każdy strumień pobierz za pomocą GET /readStream/{streamId} |
Prawidłowe tabele Delta Lake i Apache Iceberg |
Wymagania wstępne
Zanim skorzystasz z tych API, zidentyfikuj kilka informacji i wybierz preferowany przepływ uwierzytelniania Microsoft Entra ID.
Zbierz podstawowe informacje
Zbierz następujące informacje:
Identyfikator dzierżawy Fabric.
Identyfikator najemcy to GUID. Znajdziesz go w karcie Profil lub w Pomocy>o 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.
Nazwa schematu i nazwa tabeli dla tabeli, do której chcesz mieć dostęp. W przypadku interfejsu API odczytu tabeli tabela musi być prawidłową tabelą Delta Lake lub Apache Iceberg.
Tożsamość użytkownika lub jednostki usługi w Microsoft Entra ID, która posiada uprawnienia wymagane do operacji, których planujesz użyć.
- Operacje odczytu wymagają zgody na odczyt tabel docelowych. Interfejs API odczytu tabeli używa uprawnień i zasad bezpieczeństwa danych przypisanych do tej tożsamości podczas zwracania wierszy i kolumn.
- Operacje zapisu wymagają dostępu do zapisu do docelowego elementu danych oraz lokalizacji OneLake. W zależności od typu elementu i modelu dostępu przyznaj rolę elementu lub obszaru roboczego umożliwiającą zapis albo przyznaj uprawnienie ReadWrite za pomocą roli dostępu do danych OneLake. Aby uzyskać więcej informacji, zobacz Wprowadzenie do zabezpieczeń usługi OneLake.
Przygotuj się do uwierzytelniania
Zrób plan, jak chcesz się uwierzytelnić za pomocą API.
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.
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.
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ę, być może już wiesz, jak uwierzytelnić się za pomocą Microsoft Entra ID, aby współpracować z API REST systemu plików OneLake. Jeśli tak, możesz użyć tego samego podejścia, aby uwierzytelnić się w punkcie końcowym tabel OneLake.
Treści powiązane
- Dowiedz się więcej o dodatkowych metadanych tabeli.
- Dowiedz się więcej o API metadanych Iceberg.
- Dowiedz się więcej o API metadanych Delta.
- Dowiedz się więcej o czytaniu danych z tabel OneLake.
- Skonfiguruj automatyczną konwersję formatu Delta Lake na Iceberg.