Notas de versão do recurso Pacotes de Ativos do Databricks

Este artigo contém detalhes sobre os lançamentos dos principais recursos e alterações dos Pacotes de Ativos do Databricks. Os recursos do pacote são lançados com a CLI do Databricks.

Para obter uma lista completa de atualizações, consulte as notas de versão do repositório GitHub da CLI do Databricks.

Dica

Para ser notificado sobre as novas versões da CLI do Databricks e dos recursos de pacote, configure as notificações do GitHub para o repositório da CLI. Consulte sobre as notificações do GitHub.

Implantar sem Terraform

4 de dezembro de 2025

Esse recurso foi lançado com a CLI 0.279.0 do Databricks.

Como a primeira etapa para remover a dependência do Terrform, um novo databricks bundle migrate comando agora está disponível para migrar pacotes para usar o novo mecanismo de implantação direta. Consulte Migrar para o mecanismo de implantação direta.

Suporte para alertas

4 de dezembro de 2025

Esse recurso foi lançado com a CLI 0.279.0 do Databricks.

Agora você pode definir alertas SQL na configuração de Pacotes de Ativos do Databricks. Consulte o alerta.

Novo modelo de pacote mínimo

13 de novembro de 2025

Esse recurso foi lançado com a CLI 0.277.0 do Databricks.

Um novo default-minimal modelo de pacote agora está disponível. Esse modelo contém apenas arquivos de projeto de pacote necessários e também configura variáveis de catálogo. Isso permite que você crie rapidamente novos projetos de pacote vazios. Confira Modelos de projetos do Pacote de Ativos do Databricks.

Modelo de pacote atualizado para Pipelines Declarativos do Lakeflow Spark

5 de novembro de 2025

Esse recurso foi lançado com a CLI 0.276.0 do Databricks.

O default-python modelo de pacote foi atualizado para seguir as convenções do Lakeflow Spark Declarative Pipelines, que inclui pipelines como arquivos de origem e pyproject.toml. O novo modelo se afasta do uso de notebooks para o código-fonte do pipeline.

Para obter um tutorial que usa o modelo para criar um pacote com um pipeline, consulte Desenvolver Pipelines Declarativos do Spark do Lakeflow com Pacotes de Ativos do Databricks.

Os pacotes de ativos do Python para Databricks estão em Disponibilidade Geral

27 de outubro de 2025

Esse recurso foi lançado com a CLI 0.275.0 do Databricks.

Os Pacotes de Ativos do Python para Databricks agora estão disponíveis em geral (GA). Esse recurso permite que você defina recursos no Python e modifique os recursos definidos em Python ou YAML durante a implantação do pacote.

Para obter mais informações sobre o suporte do Python para pacotes de ativos do Databricks, consulte a configuração do pacote no Python.

Os pacotes no workspace estão em Disponibilidade Geral.

15 de outubro de 2025

Os Pacotes de Ativos do Databricks agora estão em disponibilidade geral (GA) no espaço de trabalho. Esse recurso permite que você colabore com outros usuários em sua organização para editar, confirmar, testar e implantar atualizações de pacote por meio da interface do usuário.

Consulte Colaborar em pacotes no workspace.

Alteração de comportamento para caminhos de fallback

Importante

Os Pacotes de Ativos do Databricks anteriormente suportavam um mecanismo de fallback ao resolver caminhos relativos entre arquivos de configuração. Esse fallback foi removido na CLI 0.266.0 do Databricks.

Nas versões anteriores da CLI, quando os recursos eram definidos em um arquivo, mas substituídos em outro em um diretório diferente, a resolução de caminho se baseava no caminho em que o recurso foi definido pela primeira vez, o que era confuso e propenso a erros.

Por exemplo, ao executar a resources/job.yml implantação de pacote para um notebook em um trabalho definido em ../src/notebook.py (uma subpasta da raiz) e o caminho do notebook foi definido como em um arquivo override.yml (na raiz), o caminho do notebook foi resolvido <BUNDLE_ROOT>/../src/notebook.pypela primeira vez, com base no local do arquivo de configuração em que o caminho foi definido. Se esse caminho não existir, ele resolveu o caminho para <BUNDLE_ROOT>/src/notebook.py, com base no caminho relativo para onde o trabalho foi definido.

Na CLI do Databricks versão 0.252 e superior, o seguinte aviso ocorrerá se o caminho definido não existir:

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.

Na CLI do Databricks versão 0.266 e superior, ocorrerá um erro se o caminho especificado não existir. Há suporte apenas para caminhos relativos diretos. Para implantar seu pacote, você deve corrigir o caminho.

suporte para execução_como em pipelines

3 de setembro de 2025

Esse recurso foi lançado com a CLI 0.267.0 do Databricks.

Agora está disponível o suporte de nível run_as superior para os Pipelines Declarativos do Lakeflow Spark. Para obter mais informações sobre identidades de execução de pacote, consulte Especifique uma identidade de execução para um fluxo de trabalho de Pacotes de Ativos do Databricks.

Suporte ao banco de dados lakebase

21 de agosto de 2025

Esse recurso foi lançado com a CLI 0.265.0 do Databricks.

Agora você pode definir instâncias de banco de dados e catálogos do Lakebase na configuração de Pacotes de Ativos do Databricks. Consulte database_instance e database_catalog.

Configuração do novo pacote de scripts

16 de julho de 2025

Esse recurso foi lançado com a CLI 0.259.0 do Databricks.

Agora você pode definir scripts na configuração do pacote e executá-los com as credenciais de autenticação configuradas de um pacote usando bundle run. Consulte Executar scripts e scripts.

O modelo de python padrão agora usa uv

2 de julho de 2025

Esse recurso foi lançado com a CLI 0.258.0 do Databricks.

O modelo de pacote default-python agora requer que uv esteja instalado e use pyproject.toml no dev alvo para compilar artefatos whl. Se a inicialização do pacote estiver configurada para usar a computação clássica, a artifacts_dynamic_version predefinição de implantação para o dev destino será habilitada. Confira Predefinições personalizadas.

O modelo padrão-python é configurado para usar serverless.

25 de junho de 2025

Esse recurso foi lançado com a CLI 0.257.0 do Databricks.

Ao inicializar um pacote com o modelo de pacote python padrão, agora você será solicitado a confirmar se deseja configurar o pacote para usar a computação sem servidor para execuções de trabalho e pipeline. Para obter informações sobre modelos de pacote, consulte os modelos de projeto do Pacote de Ativos do Databricks.

Nova predefinição de implantação artifacts_dynamic_version

18 de junho de 2025

Esse recurso foi lançado com a CLI 0.256.0 do Databricks.

Uma nova predefinição artifacts_dynamic_version de implantação agora está disponível. Essa predefinição personalizada permite a atualização dinâmica da versão dos whl artefatos durante a implantação. Confira Predefinições personalizadas.

Os pacotes no espaço de trabalho estão em Versão prévia pública.

19 de maio de 2025

Esse recurso foi lançado com a CLI 0.250.0 do Databricks.

A colaboração em Pacotes de Ativos do Databricks com outros usuários em sua organização ficou mais fácil com pacotes no espaço de trabalho, permitindo aos usuários do espaço de trabalho editar, confirmar, testar e implantar atualizações de pacotes através da interface do usuário.

Consulte Colaborar em pacotes no workspace.

Suporte à execução de script embutido

30 de abril de 2025

Esse recurso foi lançado com a CLI 0.250.0 do Databricks.

Agora você pode executar scripts no mesmo contexto de autenticação que um pacote usando o databricks bundle run comando. Consulte Execute scripts.

Os Bundles de Ativos Python para Databricks estão em Versão Prévia Pública

16 de abril de 2025

Esse recurso foi lançado com a CLI 0.248.0 do Databricks.

Os Pacotes de Ativos do Python para Databricks agora estão em Versão Prévia Pública. Esse recurso estende os pacotes para que você possa definir trabalhos como código Python, criar trabalhos dinamicamente usando metadados e modificar trabalhos definidos em YAML ou Python durante a implantação do pacote. Para obter mais informações e começar a usar o Python para Pacotes de Ativos do Databricks, consulte a configuração do pacote no Python.

Suporte associado/desvinmado para quality_monitor e model_serving_endpoint

9 de abril de 2025

Esse recurso foi lançado com a CLI 0.247.0 do Databricks.

Os comandos bind e unbind agora têm suporte para o quality_monitor e model_serving_endpoint. Isso significa que você pode vincular esses recursos definidos por pacote a monitores de qualidade existentes e a pontos de extremidade de serviço de modelo no workspace do Azure Databricks para que eles se tornem gerenciados pelos Pacotes de Ativos do Databricks. Para obter mais informações, consulte a associação de implantação do pacote databricks.

Controle de versão dinâmico para wheels

26 de março de 2025

Esse recurso foi lançado com a CLI 0.245.0 do Databricks.

Uma nova configuração dynamic_version para o mapeamento de artifacts permite que os pacotes atualizem a versão do wheel com base no carimbo de data/hora do arquivo wheel. Em seguida, o novo código pode ser implantado sem precisar atualizar a versão em setup.py ou pyproject.toml. Essa configuração só é válida quando type está definido como whl. Confira artefatos.

Suporte de vinculação/desvinculação para recursos adicionais

26 de março de 2025

Esse recurso foi lançado com a CLI 0.245.0 do Databricks.

Os comandos bind e unbind agora têm suporte para os recursos de cluster, painel, modelo_registrado e volume. Isso significa que você pode vincular esses recursos definidos por pacote a clusters, dashboards, modelos registrados e volumes existentes no workspace do Azure Databricks para que eles se tornem gerenciados pelos Pacotes de Ativos do Databricks. Para obter mais informações, consulte a associação de implantação do pacote databricks.

Suporte de vinculação/desvinculação para esquemas

5 de março de 2025

Esse recurso foi lançado com a CLI 0.243.0 do Databricks.

O bind e unbind agora têm suporte para o recurso de esquema. Esses comandos permitem vincular recursos definidos por pacote a recursos existentes no workspace do Azure Databricks para que eles se tornem gerenciados pelos Pacotes de Ativos do Databricks. Para obter mais informações, consulte a associação de implantação do pacote databricks.

Suporte a aplicativos

16 de janeiro de 2025

Esse recurso foi lançado com a CLI 0.239.0 do Databricks.

Agora você pode gerenciar implantações do Databricks Apps usando pacotes de ativos do Databricks definindo um recurso de aplicativo na configuração do pacote. Confira aplicativo.

Suporte a volumes

5 de dezembro de 2024

Esse recurso foi lançado com a CLI 0.236.0 do Databricks.

Agora você pode criar volumes do Catálogo do Unity usando Pacotes de Ativos do Databricks definindo um recurso de volume na configuração do seu pacote. Confira volume (Catálogo do Unity).

Pesquisa variável para destinos de notificação

5 de dezembro de 2024

Esse recurso foi lançado com a CLI 0.236.0 do Databricks.

As buscas de variáveis agora dão suporte a destinos de notificação. Consulte Recuperar o valor da ID de um objeto.

Suporte ao painel de controle

30 de outubro de 2024

Esse recurso foi lançado com a CLI do Databricks 0.232.0.

Os painéis de IA/BI agora podem ser gerenciados na configuração do pacote usando o novo tipo de recurso de painel. Você pode gerar a configuração do painel usando bundle generate dashboard e manter a versão local e remota de um painel em sincronia com as opções --force e --watch. Consulte o painel e o pacote do databricks gerados.

Para obter informações sobre painéis de IA/BI, consulte Painéis.

Novo comando de resumo do pacote

23 de outubro de 2024

Esse recurso foi lançado com a CLI do Databricks 0.231.0.

Um novo bundle summary comando foi adicionado. Esse comando gera um resumo da identidade e dos recursos de um pacote, incluindo links profundos para recursos para que você possa navegar facilmente até o recurso no workspace do Databricks. Confira o resumo do pacote do Databricks.

Aviso para pacotes distribuídos em Compartilhado com permissões conflitantes

23 de outubro de 2024

Importante

Essa é uma mudança comportamental.

Essa alteração foi lançada com a CLI do Databricks 0.231.0.

Um aviso agora ocorre quando um pacote é implantado na pasta /Workspace/Shared, que pode ser acessada por todos os usuários, mas o nível superior permissions definido para o pacote entra em conflito com isso. Modifique as permissões definidas para o pacote ou mova o pacote para fora da /Workspace/Shared pasta.

Para modificar as permissões de um pacote, consulte permissões.

Para mover o pacote para fora da /Workspace/Shared pasta, altere a workspace.root_path configuração do pacote para apontar para um novo local e, em seguida, reimplante o pacote. Remova a pasta de pacote antiga usando a interface do usuário ou executando databricks fs rm.

Os caminhos do espaço de trabalho agora são prefixados automaticamente

9 de outubro de 2024

Importante

Essa é uma mudança comportamental.

Essa alteração foi lançada com a CLI do Databricks 0.230.0.

Os caminhos da área de trabalho agora são prefixados automaticamente com /Workspace. Além disso, todo o uso de strings de caminho, como /Workspace/${workspace.root_path}/... na configuração do pacote, é automaticamente substituído por ${workspace.root_path}/... e gerará um aviso como parte de bundle validate.

Se você tiver especificado um workspace.root_path, workspace.artifact_path ou workspace.file_path, os pacotes de ativos do Databricks o prefixarão automaticamente com /Workspace, mas se você usar qualquer um deles como variáveis (por exemplo, my_config_path: /Workspace/${workspace.file_path}/config), será necessário atualizar essas entradas para remover o prefixo /Workspace para evitar o aviso.

Se você passar uma dessas como variáveis e prefixá-las em seu código, precisará atualizar seu código para não fazer isso.

Essa alteração é necessária porque, originalmente, quando o sistema de arquivo de espaço de trabalho estava enraizado em / e os diretórios base estavam em /Users, para acessar caminhos do espaço de trabalho por meio da API REST do Databricks, você usaria esses caminhos diretamente. Para acessar os caminhos do espaço de trabalho a partir do seu código, você poderia usar o caminho do arquivo /Workspace e os diretórios iniciais também estariam disponíveis em /Workspace/Users. Para evitar essa dualidade de caminhos de workspace e também a ambiguidade entre caminhos de workspace e os caminhos do Catálogo do Unity /Volumes, todos os caminhos de workspace são prefixados com /Workspace.

Suporte para a criação de clusters para todas as finalidades

1 de outubro de 2024

Esse recurso foi lançado com a CLI do Databricks 0.229.0.

Agora você pode criar clusters para todas as finalidades em sua configuração de pacote usando o novo tipo de recurso de cluster. Confira cluster.

Novo prompt de recreação do Lakeflow Spark Declarative Pipelines e –sinalizador de aprovação automática

5 de setembro de 2024

Esse recurso foi lançado com a CLI do Databricks 0.228.0.

Agora aparecerá um prompt se existirem alterações de reconfiguração de pacote que resultem na recriação de um pipeline. É possível ignorar a solicitação especificando o sinalizador --auto-approve.

Adicionado suporte para o recurso de esquema de catálogo do Unity

31 de julho de 2024

Esse recurso foi lançado com a CLI do Databricks 0.225.0.

Os esquemas de catálogo do Unity agora podem ser definidos na configuração do pacote. Confira schema (Catálogo do Unity).

Agrupar comandos em terminal web

4 de julho de 2024

Esse recurso foi lançado com a CLI do Databricks 0.223.0.

Agora é possível interagir com pacotes usando a CLI do Databricks no terminal da Web. Para obter informações sobre como usar o terminal da Web, consulte Executar comandos do shell no terminal da Web do Azure Databricks.

Adicionado suporte para variáveis complexas

26 de junho de 2024

Esse recurso foi lançado com a CLI do Databricks v0.222.0.

Os pacotes de ativos do Databricks agora oferecem suporte a variáveis complexas. Consulte Definir uma variável complexa.

Os Pacotes de Ativos do Databricks estão em disponibilidade geral

23 de abril de 2024

Com a versão de CLI 0.218.0 do Databricks, agora os Pacotes de Ativos do Databricks têm disponibilidade geral.