Обновление до последней версии API SQL Databricks
В этой статье описываются изменения API запросов, оповещений, разрешений и источников данных, включенных в последнюю версию API SQL Databricks. Эта статья поможет перенести приложения и интеграции в новую версию API.
Устаревший API будет поддерживаться в течение шести месяцев. Этот период перехода дает вам время для миграции до поэтапного завершения старой версии.
Изменения в API запросов
Новый API запросов включает более удобный для пользователя интерфейс с более описательными именами, ответами с разбивкой на страницы и автоматически отсортированными по времени создания. В следующем списке описываются изменения API запросов:
- Теперь путь
api/2.0/sql/queries
API заменяет устаревший путь/api/2.0/preview/sql/queries
. - Включает новое определение запроса с более описательными именами полей и типами.
- Конечная точка обновления теперь поддерживает частичные обновления с помощью
PATCH
вместоPOST
. - Конечная точка обновления теперь поддерживает передачу владения запросами. Ранее это было разрешено только с помощью API владения объектами передачи.
- Ответы конечной точки списка теперь разбиены на страницы с помощью разбиения на страницы на основе маркеров.
- Конечная точка списка больше не поддерживает фильтрацию по имени или пользовательскому упорядочению. Вместо этого все доступные запросы возвращаются и отсортированы по возрастанию по времени их создания.
- Конечная точка восстановления больше не поддерживается. Корзинные запросы можно восстановить с помощью пользовательского интерфейса Azure Databricks.
Полная документация по обновленному API запросов см. в разделе "Запросы".
Изменения в API оповещений
Новый API оповещений включает более удобный для пользователя интерфейс с более описательными именами полей и типами, ответами с разбивкой на страницы для списков конечных точек и поддержкой частичных обновлений. В следующем списке описываются изменения API оповещений:
- Теперь путь
api/2.0/sql/alerts
API заменяет устаревший путь/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 больше не требуется.