Заметки о выпуске компонентов для декларативных пакетов автоматизации

В этой статье содержатся сведения о выпусках основных декларативных пакетов автоматизации (ранее известных как наборы ресурсов Databricks) и изменениях. Функции пакета выпускаются с интерфейсом командной строки Databricks.

Полный список обновлений см. в заметках о версии GitHub репозитория Databricks CLI.

Подсказка

Чтобы получать уведомления о новых выпусках интерфейса командной строки Databricks и компонентов пакета, настройте уведомления GitHub для репозитория CLI. См. сведения о уведомлениях GitHub.

Пакеты активов Databricks теперь являются декларативными пакетами автоматизации

16 марта 2026 г.

Пакеты активов Databricks переименованы в декларативные пакеты автоматизации. См. статью "Почему пакеты активов Databricks переименованы в декларативные пакеты автоматизации?".

Новые ресурсы для проектов, ветвей и конечных точек Postgres

5 февраля 2026 г.

Эта функция была выпущена в Databricks CLI 0.287.0.

Теперь вы можете определить проекты, ветви и вычислительные конечные точки Lakebase Postgres в конфигурации декларативных пакетов автоматизации. См. postgres_project, postgres_branch и postgres_endpoint.

Развертывание без Terraform

4 декабря 2025 г.

Эта возможность была выпущена вместе с Databricks CLI 0.279.0.

Как первый шаг к удалению зависимости от Terrform, новая databricks bundle migrate команда теперь доступна для переноса пакетов для использования нового механизма прямого развертывания. См. раздел "Миграция в подсистему прямого развертывания".

Поддержка оповещений

4 декабря 2025 г.

Эта возможность была выпущена вместе с Databricks CLI 0.279.0.

Теперь вы можете определить оповещения SQL в конфигурации декларативных пакетов автоматизации. См. оповещение.

Новый шаблон минимального пакета

13 ноября 2025 г.

Эта функция была выпущена в Databricks CLI 0.277.0.

Теперь доступен новый default-minimal шаблон пакета. Этот шаблон содержит только необходимые файлы проекта пакета, а также настраивает переменные каталога. Это позволяет быстро создавать новые проекты пустого пакета. См. шаблоны проектов декларативных пакетов автоматизации.

Обновленный шаблон пакета для декларативных конвейеров Lakeflow Spark

5 ноября 2025 г.

Эта функция была выпущена с Databricks CLI 0.276.0.

Шаблон default-python связки обновлен для выполнения соглашений о декларативных конвейерах Spark Lakeflow, включая использование конвейеров в качестве исходных файлов и pyproject.toml. Новый шаблон отказывается от использования ноутбуков для исходного кода конвейера.

Учебник, использующий шаблон для создания пакета с конвейером, см. в разделе "Разработка конвейеров с помощью декларативных пакетов автоматизации".

Python для декларативных наборов автоматизации доступен для общего пользования

27 октября 2025 г.

Эта функция была выпущена в Databricks CLI 0.275.0.

Python для декларативных пакетов автоматизации теперь общедоступен (GA). Эта функция позволяет определять ресурсы в Python и изменять ресурсы, определенные в Python или YAML во время развертывания пакета.

Дополнительные сведения о поддержке Python для декларативных пакетов автоматизации см. в разделе "Настройка пакета" в Python.

Пакеты в рабочей области — общедоступная версия

15 октября 2025 г.

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

См. Совместная работа над пакетами в рабочей области.

Изменение поведения для резервных путей

Это важно

Декларативные пакеты автоматизации ранее поддерживали резервный механизм при обработке относительных путей в файлах конфигурации. Этот резервный вариант был удален в Databricks CLI 0.266.0.

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

Например, при выполнении развертывания пакета для записной книжки в задании, определённом в resources/job.yml (подпапке корневого каталога), и путь к записной книжке был задан в файле ../src/notebook.py (в корне), путь к записной книжке изначально разрешен на override.yml, в зависимости от расположения файла конфигурации <BUNDLE_ROOT>/../src/notebook.py, в котором был задан путь. Если этот путь не существует, он определял путь к <BUNDLE_ROOT>/src/notebook.py, основываясь на относительном пути к месту определения задания.

В Databricks CLI версии 0.252 и более поздних версиях возникает следующее предупреждение, если определенный путь не существует:

Warn: path <PATH> is defined relative to the <DIR> directory. Please update the path to be relative to the file where it is defined. The current value will no longer be valid in the next release.

В Databricks CLI версии 0.266 и более поздних версиях ошибка возникает, если указанный путь не существует. Поддерживаются только прямые относительные пути. Чтобы развернуть пакет, необходимо исправить путь.

поддержка run_as для конвейеров

3 сентября 2025 г.

Эта функция была выпущена в Databricks CLI 0.267.0.

Теперь поддержка верхнего уровня run_as доступна для декларативных конвейеров Spark Lakeflow. Дополнительные сведения об идентификациях запуска пакета см. в разделе Указание удостоверения запуска для рабочего процесса декларативного пакета автоматизации.

Поддержка базы данных Lakebase

21 августа 2025 г.

Эта функция была выпущена вместе с Databricks CLI 0.265.0.

Теперь можно определить экземпляры и каталоги баз данных Lakebase в конфигурации декларативных пакетов автоматизации. См. database_instance и database_catalog.

Настройка пакета новых скриптов

16 июля 2025 г.

Эта функция была выпущена в Databricks CLI 0.259.0.

Теперь вы можете определить скрипты в настройках пакета и запустить их с помощью bundle run настроенных учетных данных аутентификации пакета. См. статью "Выполнение скриптов и скриптов".

Шаблон python по умолчанию теперь использует uv

2 июля 2025 г.

Эта функция была выпущена вместе с Databricks CLI 0.258.0.

Теперь шаблон пакета python по умолчанию требует установки и использования pyproject.toml в целевом объекте dev для создания whl артефактов. Если инициализация пакета настроена на использование классической вычислительной архитектуры, предустановка развертывания для целевого artifacts_dynamic_version объекта dev включена. См. пользовательские предустановки.

Шаблон файла python, используемый по умолчанию, настроен для работы в бессерверной среде.

25 июня 2025 г.

Эта функция была выпущена одновременно с Databricks CLI 0.257.0.

При инициализации пакета с помощью шаблона пакета python по умолчанию вам будет предложено подтвердить, следует ли настроить пакет для использования бессерверных вычислений для выполнения заданий и конвейеров. Сведения о шаблонах пакетов см. в разделе "Декларативные шаблоны проектов пакетов автоматизации".

Новая предустановка развертывания artifacts_dynamic_version

18 июня 2025 г.

Эта функция была выпущена в версии Databricks CLI 0.256.0.

Теперь доступен новый профиль развертывания artifacts_dynamic_version. Эта настраиваемая настройка позволяет динамически обновлять версию whl артефактов во время развертывания. См. пользовательские предустановки.

Пакеты в рабочей области — общедоступная предварительная версия

19 мая 2025 г.

Эта функция была выпущена вместе с Databricks CLI 0.250.0.

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

См. Совместная работа над пакетами в рабочей области.

Поддержка выполнения скриптов в строке

30 апреля 2025 г.

Эта функция была выпущена вместе с Databricks CLI 0.250.0.

Теперь можно запускать скрипты в том же контексте проверки подлинности, что и пакет с помощью databricks bundle run команды. См. статью "Выполнение скриптов".

Python для декларативных пакетов автоматизации — общедоступная предварительная версия

16 апреля 2025 г.

Эта функция была выпущена в версии Databricks CLI 0.248.0.

Python для декларативных пакетов автоматизации теперь находится в общедоступной предварительной версии. Эта функция расширяет пакеты, чтобы можно было определить задания как код Python, динамически создавать задания с помощью метаданных и изменять задания, определенные в YAML или Python во время развертывания пакета. Дополнительные сведения и сведения об использовании Python для декларативных пакетов автоматизации см. в разделе "Конфигурация пакета" в Python.

Поддержка привязки и отмены привязки для quality_monitor и model_serving_endpoint

9 апреля 2025 г.

Эта функция была выпущена в Databricks CLI 0.247.0.

Команды bind и unbind теперь поддерживаются для quality_monitor и model_serving_endpoint. Это означает, что эти наборы ресурсов можно связать с существующими мониторами качества и конечными точками обслуживания моделей в рабочей области Azure Databricks, чтобы они стали управляемыми декларативными пакетами автоматизации. Дополнительные сведения см. в инструкции по привязке развертывания пакета Databricks.

Динамическое управление версиями для колес

26 марта 2025 г.

Эта функция была выпущена в версии Databricks CLI 0.245.0.

Новый параметр dynamic_version для сопоставления artifacts позволяет пакетам обновлять версию wheel на основе метки времени файла wheel. Затем новый код можно внедрить без необходимости обновлять версию в setup.py или pyproject.toml. Этот параметр действителен только в том случае, если type задано значение whl. См. артефакты.

Поддержка привязки/отвязки дополнительных ресурсов

26 марта 2025 г.

Эта функция была выпущена в версии Databricks CLI 0.245.0.

bind и unbind команды теперь поддерживаются для ресурсов кластера, панели мониторинга, зарегистрированной модели, и тома. Это означает, что эти наборы ресурсов можно связать с существующими кластерами, панелями мониторинга, зарегистрированными моделями и томами в рабочей области Azure Databricks, чтобы они стали управляемыми декларативными пакетами автоматизации. Дополнительные сведения см. в инструкции по привязке развертывания пакета Databricks.

Поддержка привязки и отмены привязки для схем

5 марта 2025 г.

Эта функция была выпущена в версии Databricks CLI 0.243.0.

Команды bind и unbind теперь поддерживаются для ресурса схемы. Эти команды позволяют связать определенные пакетом ресурсы с существующими ресурсами в рабочей области Azure Databricks, чтобы они стали управляемыми декларативными пакетами автоматизации. Дополнительные сведения см. в инструкции по привязке развертывания пакета Databricks.

Поддержка приложений

16 января 2025 г.

Эта функция была выпущена вместе с Databricks CLI 0.239.0.

Теперь вы можете управлять развертываниями Databricks Apps с помощью декларативных пакетов автоматизации, определив ресурс приложения в конфигурации пакета. См. приложение.

Поддержка томов

5 декабря 2024 г.

Эта функция была выпущена в Databricks CLI 0.236.0.

Теперь вы можете создавать тома каталога Unity с помощью декларативных пакетов автоматизации, определив ресурс тома в конфигурации пакета. См. том (каталог Unity).

Поиск значений переменных для мест назначения уведомлений

5 декабря 2024 г.

Эта функция была выпущена в Databricks CLI 0.236.0.

Теперь поиск переменных поддерживает пункты назначения уведомлений. См. сведения о получении значения идентификатора объекта.

Поддержка панели мониторинга

30 октября 2024 г.

Эта функция была выпущена в Databricks CLI 0.232.0.

Теперь панели мониторинга AI/BI можно управлять в конфигурации пакета с помощью нового типа ресурса панели мониторинга. Вы можете создать конфигурацию панели мониторинга с помощью bundle generate dashboard и сохранить локальную и удаленную версию панели мониторинга в синхронизации с параметрами --force и --watch. См. панель мониторинга и databricks bundle generate.

Сведения о панелях мониторинга AI/BI см. в разделе "Панели мониторинга".

Команда для создания сводки пакета

23 октября 2024 г.

Эта функция была выпущена в версии Databricks CLI 0.231.0.

Добавлена новая bundle summary команда. Эта команда выводит сводку по идентификации и ресурсам пакета, включая глубокие ссылки на ресурсы, позволяющие вам легко перейти к ресурсу в рабочей области Databricks. См. сводку пакета Databricks.

Предупреждение о том, что пакеты, развернутые в Shared, имеют конфликтующие разрешения

23 октября 2024 г.

Это важно

Это изменение поведения.

Это изменение было выпущено с Databricks CLI 0.231.0.

Теперь предупреждение возникает при развертывании /Workspace/Shared пакета в папку, доступную всем пользователям, но верхний уровень permissions , определенный для пакета, конфликтует с этим. Измените разрешения, определенные для пакета, или переместите пакет из /Workspace/Shared папки.

Чтобы изменить разрешения для пакета, ознакомьтесь с разрешениями.

Чтобы переместить пакет из /Workspace/Shared папки, измените workspace.root_path конфигурацию пакета на новое расположение, а затем повторно разверните пакет. Удалите старую папку пакета с помощью пользовательского интерфейса или выполнив databricks fs rm.

Пути к рабочей области теперь автоматически префиксированы

9 октября 2024 г.

Это важно

Это изменение поведения.

Это изменение было выпущено в Databricks CLI 0.230.0.

Пути рабочих областей теперь автоматически получают префикс /Workspace. Кроме того, все строки пути, такие как /Workspace/${workspace.root_path}/... в конфигурации пакета, автоматически заменяются на ${workspace.root_path}/... и вызовут предупреждение в составе bundle validate.

Если вы указали настраиваемый workspace.root_path, workspace.artifact_path или workspace.file_path, Декларативные пакеты автоматизации автоматически добавят к нему префикс /Workspace, но если вы используете любую из этих переменных (например, my_config_path: /Workspace/${workspace.file_path}/config), необходимо обновить эти записи, чтобы удалить префикс /Workspace и избежать предупреждения.

Если вы передаете одну из этих переменных с префиксом в коде, необходимо обновить код, чтобы не использовать его таким образом.

Это изменение требуется, так как изначально, когда файловая система рабочей области имела корень в /, а домашние каталоги находились под /Users, для доступа к путям рабочей области через REST API Databricks вы использовали эти пути напрямую. Чтобы получить доступ к путям рабочей области из вашего кода, можно использовать путь к файлу /Workspace и домашние каталоги /Workspace/Users. Чтобы избежать дублирования путей рабочей области, а также неопределенности между путями рабочей области и путями каталога Unity /Volumes, ко всем путям рабочей области добавляется префикс /Workspace.

Поддержка создания универсальных кластеров

1 октября 2024 г.

Эта функция была выпущена вместе с Databricks CLI 0.229.0.

Теперь вы можете создать кластеры всех назначений в конфигурации пакета с помощью нового типа ресурса кластера. См. кластер.

Запрос на создание новых декларативных конвейеров Lakeflow Spark, а также флаг автоматического одобрения

5 сентября 2024 г.

Эта функция была выпущена вместе с Databricks CLI 0.228.0.

Теперь запрос будет возникать, если существуют изменения конфигурации пакета, которые привели бы к повторному созданию конвейера. Запрос можно пропустить, указав --auto-approve флаг.

Добавлена поддержка ресурса схемы Unity Catalog.

31 июля 2024 г.

Эта функция была выпущена с Databricks CLI 0.225.0.

Теперь схемы каталога Unity можно определить в конфигурации пакета. См. схему (каталог Unity).

Объединение команд в веб-терминале

4 июля 2024 г.

Эта функция была выпущена вместе с Databricks CLI 0.223.0.

Теперь вы можете взаимодействовать с пакетами с помощью интерфейса командной строки Databricks из веб-терминала. Сведения об использовании веб-терминала см. в разделе "Выполнение команд оболочки" в веб-терминале Azure Databricks.

Добавлена поддержка сложных переменных

26 июня 2024 г.

Эта функция была выпущена в Databricks CLI версии 0.222.0.

Декларативные пакеты автоматизации теперь поддерживают сложные переменные. См. раздел "Определение сложной переменной".

Декларативные пакеты автоматизации доступны в общем доступе

23 апреля 2024 г.

В выпуске Databricks CLI 0.218.0 теперь доступны декларативные пакеты автоматизации.