Поделиться через


Обновление до последней версии API SQL Databricks

В этой статье описываются изменения API запросов, оповещений, разрешений и источников данных, включенных в последнюю версию API SQL Databricks. Эта статья поможет перенести приложения и интеграции в новую версию API.

Устаревший API будет поддерживаться в течение шести месяцев. Этот период перехода дает вам время для миграции до поэтапного завершения старой версии.

Изменения в API запросов

Новый API запросов включает более удобный для пользователя интерфейс с более описательными именами, ответами с разбивкой на страницы и автоматически отсортированными по времени создания. В следующем списке описываются изменения API запросов:

  • Теперь путь api/2.0/sql/queriesAPI заменяет устаревший путь /api/2.0/preview/sql/queries.
  • Включает новое определение запроса с более описательными именами полей и типами.
  • Конечная точка обновления теперь поддерживает частичные обновления с помощью PATCH вместо POST.
  • Конечная точка обновления теперь поддерживает передачу владения запросами. Ранее это было разрешено только с помощью API владения объектами передачи.
  • Ответы конечной точки списка теперь разбиены на страницы с помощью разбиения на страницы на основе маркеров.
  • Конечная точка списка больше не поддерживает фильтрацию по имени или пользовательскому упорядочению. Вместо этого все доступные запросы возвращаются и отсортированы по возрастанию по времени их создания.
  • Конечная точка восстановления больше не поддерживается. Корзинные запросы можно восстановить с помощью пользовательского интерфейса Azure Databricks.

Полная документация по обновленному API запросов см. в разделе "Запросы".

Изменения в API оповещений

Новый API оповещений включает более удобный для пользователя интерфейс с более описательными именами полей и типами, ответами с разбивкой на страницы для списков конечных точек и поддержкой частичных обновлений. В следующем списке описываются изменения API оповещений:

  • Теперь путь api/2.0/sql/alertsAPI заменяет устаревший путь /api/2.0/preview/sql/alerts.
  • Включает новое определение оповещений с более описательными именами полей и типами.
  • Конечная точка обновления теперь поддерживает частичные обновления с помощью PATCH вместо POST.
  • Конечная точка обновления теперь поддерживает передачу владения запросами. Ранее это было разрешено только с помощью API владения объектами передачи.
  • Ответы конечной точки списка теперь разделены на страницы с помощью пагинации на основе маркеров.
  • Конечная точка удаления теперь перемещает оповещение в корзину вместо окончательного удаления оповещения. Оповещение с корзиной автоматически очищается через 30 дней. Оповещений с корзиной можно восстановить в течение 30 дней после удаления с помощью пользовательского интерфейса Azure Databricks.

Полная документация по обновленному API оповещений см. в разделе "Оповещения".

Изменения в API разрешений

API разрешений больше не поддерживает методы Get object ACL и Set object ACL. Используйте API рабочей области для управления разрешениями для этих действий.

API источников данных, помеченный как устаревший

ТЕПЕРЬ API источников данных помечается как устаревший. В настоящее время ее функциональные возможности ограничены получением списка хранилищ SQL. Так как новый API запросов поддерживает передачу и возврат идентификаторов хранилища SQL вместо идентификаторов источников данных, отдельный вызов API для преобразования между источниками данных и хранилищами SQL больше не требуется.