Обновление до последней версии 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 больше не требуется.

Обновление версий пакета SDK

Если вы обращаетесь к устаревшей версии API SQL Databricks с помощью пакетов SDK Databricks, обновите до последней версии пакета SDK и перейдите к новым API. Дополнительные сведения см. в документации по пакетам SDK для Databricks .

Перенос команд CLI

Если вы обращаетесь к устаревшей версии API SQL Databricks с помощью интерфейса командной строки Databricks, выполните миграцию из этих устаревших групп команд:

Deprecated	Используйте вместо
запросы устаревших систем	queries
устаревшие оповещения	alerts
источники данных	Замена не выполнена

Перенос ресурсов Terraform

Если вы используете Terraform для управления ресурсами SQL Databricks, перейдите к новым определениям ресурсов:

Устаревший ресурс	Вместо этого используйте	Руководство по миграции
databricks_sql_query	databricks_query	Руководство по миграции
databricks_sql_alert	databricks_alert	Руководство по миграции
databricks_sql_visualization	databricks_dashboard	Нет руководства по миграции

Для databricks_sql_endpoint и databricks_sql_warehouse:

Обновление до поставщика Databricks Terraform версии 1.105.0 или более поздней версии. Поле data_source_id устарело. Обновите, чтобы предотвратить ошибки при отключении API устаревших источников данных.