API tabel OneLake dla Delta

Usługa OneLake oferuje punkt końcowy interfejsu API REST do interakcji z tabelami w usłudze Microsoft Fabric. W tym artykule opisano, jak rozpocząć korzystanie z tego punktu końcowego do interakcji z interfejsami API delty dostępnymi w tym punkcie końcowym na potrzeby operacji odczytu metadanych. Te operacje są zgodne z otwartym standardem Unity Catalog API.

Aby uzyskać ogólne wskazówki dotyczące interfejsu API tabel OneLake i wskazówki dotyczące wymagań wstępnych, zobacz Omówienie interfejsu API tabel OneLake.

Aby uzyskać szczegółową dokumentację interfejsu API, zobacz przewodnik Wprowadzenie.

Punkt końcowy interfejsu API tabeli Delta

Punkt końcowy interfejsu API tabeli OneLake to:

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

Na końcówce interfejsu API tabeli OneLake, API Delta są dostępne pod następującym adresem <BaseUrl>.

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

Operacje API tabeli Delta

Następujące operacje interfejsu API delty są obecnie obsługiwane w tym punkcie końcowym. Szczegółowe wskazówki dotyczące tych operacji są dostępne w przewodniku Wprowadzenie.

• Wyświetl schematy

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas?catalog_name=<ItemName or ItemID>

  Ta operacja akceptuje identyfikator obszaru roboczego i identyfikator elementu danych (lub ich równoważne przyjazne nazwy, jeśli nie zawierają żadnych znaków specjalnych).

  Ta operacja zwraca listę schematów w elemencie danych. Jeśli element danych nie obsługuje schematów, zwracany jest stały schemat o nazwie dbo .

• Lista tabel

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables?catalog_name=<ItemName or ItemID>&schema_name=<SchemaName>

  Ta operacja zwraca listę tabel znalezionych w danym schemacie.

• Pobieranie tabeli

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

  Ta operacja zwraca szczegóły metadanych dla tabeli w schemacie, jeśli tabela zostanie znaleziona.

• Schemat istnieje

  HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas/<SchemaName>

  Ta operacja sprawdza istnienie schematu w elemencie danych i zwraca powodzenie w przypadku znalezienia schematu.

• Tabela istnieje

  HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

  Ta operacja sprawdza istnienie tabeli w schemacie i zwraca powodzenie w przypadku znalezienia schematu.

Bieżące ograniczenia, zagadnienia

Korzystanie z interfejsów API tabeli OneLake dla Delta podlega następującym ograniczeniom i zagadnieniom:

• Niektóre elementy danych mogą nie obsługiwać schematów

  W zależności od typu używanego elementu danych, takich jak magazyny lakehouse w środowisku Fabric, które nie obsługują schematów, w katalogu 'Tables' mogą nie być obecne schematy. W takich przypadkach, aby zapewnić zgodność z klientami API, interfejsy API tabel OneLake udostępniają domyślny, stały dbo schemat (lub przestrzeń nazw) zawierające wszystkie tabele w ramach elementu danych.

• Dodatkowe parametry ciągu zapytania wymagane, jeśli nazwa schematu lub nazwa tabeli zawiera kropki

  Jeśli nazwa schematu lub tabeli zawiera kropki (.) i znajduje się w adresie URL, należy również podać dodatkowe parametry zapytania. Jeśli na przykład nazwa schematu zawiera kropki, dołącz catalog_name jako dodatkowy parametr zapytania w wywołaniu interfejsu API, aby sprawdzić, czy schemat istnieje.

• Operacje zapisu metadanych, inne operacje

  Obecnie obsługiwane są tylko operacje wymienione w operacjach interfejsu API tabeli delty . Operacje związane z zapisywaniem metadanych nie są jeszcze obsługiwane przez punkt końcowy interfejsu API Delta dla tabeli OneLake.

Treści powiązane

• Dowiedz się więcej o interfejsach API tabel OneLake.
• Zobacz szczegółowe wskazówki i szczegóły interfejsu API.