Обновление до последней версии 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 разрешений теперь помечен как устаревший. Используйте API рабочей области для управления разрешениями объектов. Используйте запросы и оповещения, обновляя API для передачи владения объектами.

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

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