Udostępnij za pośrednictwem

Aktualizacja do najnowszej wersji interfejsu API SQL usługi Databricks

  • Artykuł

W tym artykule opisano zmiany w interfejsach API zapytań, alertów, uprawnień i źródeł danych zawartych w najnowszej wersji interfejsu API SQL usługi Databricks. Ten artykuł ułatwia migrowanie aplikacji i integracji do nowej wersji interfejsu API.

Starszy interfejs API będzie nadal obsługiwany przez sześć miesięcy. Ten okres przejściowy zapewnia czas migracji przed wycofywanej starszej wersji.

Zmiany interfejsu API zapytań

Nowy interfejs API zapytań zawiera bardziej przyjazne dla użytkownika środowisko z bardziej opisowymi nazwami, odpowiedziami podzielonymi na strony i odpowiedziami listy automatycznie posortowanymi według czasu utworzenia. Poniższa lista zawiera opis zmian w interfejsie API zapytań:

  • Ścieżka interfejsu API to teraz api/2.0/sql/queries, zastępując starszą ścieżkę ./api/2.0/preview/sql/queries
  • Zawiera nową definicję zapytania z bardziej opisowymi nazwami pól i typami.
  • Punkt końcowy aktualizacji obsługuje teraz częściowe aktualizacje przy użyciu polecenia PATCH zamiast POST.
  • Punkt końcowy aktualizacji obsługuje teraz przenoszenie własności zapytań. Wcześniej było to dozwolone tylko przy użyciu interfejsu API własności obiektu transferu.
  • Odpowiedzi punktu końcowego listy są teraz podzielone na strony przy użyciu stronicowania opartego na tokenach.
  • Punkt końcowy listy nie obsługuje już filtrowania według nazwy ani niestandardowego porządkowania. Zamiast tego wszystkie dostępne zapytania są zwracane i sortowane w kolejności rosnącej według czasu tworzenia.
  • Punkt końcowy przywracania nie jest już obsługiwany. Zapytania z koszami mogą być nadal przywracane za pośrednictwem interfejsu użytkownika usługi Azure Databricks.

Aby uzyskać pełną dokumentację dotyczącą zaktualizowanego interfejsu API zapytań, zobacz Zapytania.

Zmiany interfejsu API alertów

Nowy interfejs API alertów zawiera bardziej przyjazne dla użytkownika środowisko z bardziej opisowymi nazwami pól i typami, odpowiedziami podzielonymi na strony w celu wyświetlenia listy punktów końcowych i obsługą częściowych aktualizacji. Poniższa lista zawiera opis zmian w interfejsie API alertów:

  • Ścieżka interfejsu API to teraz api/2.0/sql/alerts, zastępując starszą ścieżkę ./api/2.0/preview/sql/alerts
  • Zawiera nową definicję alertu z bardziej opisowymi nazwami pól i typami.
  • Punkt końcowy aktualizacji obsługuje teraz częściowe aktualizacje przy użyciu polecenia PATCH zamiast POST.
  • Punkt końcowy aktualizacji obsługuje teraz przenoszenie własności zapytań. Wcześniej było to dozwolone tylko przy użyciu interfejsu API własności obiektu transferu.
  • Odpowiedzi punktu końcowego listy są teraz podzielone na strony przy użyciu stronicowania opartego na tokenach.
  • Punkt końcowy usuwania przenosi teraz alert do kosza zamiast trwale usuwać alert. Alerty z kosza zostaną automatycznie wyczyszczone po upływie 30 dni. Alerty z kosza można przywrócić w ciągu 30 dni od usunięcia za pośrednictwem interfejsu użytkownika usługi Azure Databricks.

Aby uzyskać pełną dokumentację dotyczącą zaktualizowanego interfejsu API alertów, zobacz Alerty.

Zmiany interfejsu API uprawnień

Interfejs API uprawnień nie obsługuje już listy ACL obiektów Get i Set object ACL. Użyj interfejsu API obszaru roboczego, aby zarządzać uprawnieniami dla tych akcji.

Interfejs API źródeł danych oznaczony jako starsza wersja

Interfejs API źródeł danych jest teraz oznaczony jako starszy. Obecnie jej funkcjonalność jest ograniczona do uzyskiwania listy magazynów SQL. Ponieważ nowy interfejs API zapytań obsługuje przekazywanie i zwracanie identyfikatorów usługi SQL Warehouse zamiast identyfikatorów źródeł danych, oddzielne wywołanie interfejsu API do konwersji między źródłami danych i magazynami SQL nie jest już wymagane.