Notas de lançamento da funcionalidade Databricks Asset Bundles

Este artigo contém detalhes sobre os lançamentos dos principais recursos e alterações do Databricks Asset Bundles. As funcionalidades do pacote são lançadas 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.

Implementar sem Terraform

4 de dezembro de 2025

Esta funcionalidade foi lançada com o Databricks CLI 0.279.0.

Como primeiro passo para eliminar a dependência do Terraform, está agora disponível um novo databricks bundle migrate comando para migrar bundles para usar o novo motor de implementação direta. Veja Migração para o motor de implementação direta.

Suporte a alertas

4 de dezembro de 2025

Esta funcionalidade foi lançada com o Databricks CLI 0.279.0.

Agora pode definir alertas SQL na sua configuração do Databricks Asset Bundles. Ver alerta.

Novo modelo de pacote mínimo

13 de novembro de 2025

Este recurso foi lançado com Databricks CLI 0.277.0.

Um novo default-minimal modelo de pacote já está disponível. Este modelo contém apenas os 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 vazio. Consulte Modelos de projeto do Databricks Asset Bundle.

Modelo atualizado de bundle para Pipelines Declarativos do Lakeflow Spark

5 de novembro de 2025

Esta funcionalidade foi lançada com o Databricks CLI 0.276.0.

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

Para um tutorial que utiliza o template para criar um bundle com uma pipeline, veja Desenvolver Lakeflow Spark Declarative Pipelines com Databricks Asset Bundles.

Python para Databricks Asset Bundles está em Disponibilidade Geral (GA)

Outubro 27, 2025

Este recurso foi lançado com o Databricks CLI 0.275.0.

Python for Databricks Asset Bundles agora está disponível para o público em geral (GA). Esse recurso permite definir recursos em Python e modificar recursos definidos em Python ou YAML durante a implantação do pacote.

Para obter mais informações sobre o suporte Python para Databricks Asset Bundles, consulte Configuração do pacote em Python.

Pacotes no espaço de trabalho é GA

15 de outubro de 2025

O Databricks Asset Bundles no espaço de trabalho agora está disponível ao público em geral (GA). 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.

Veja Colaborar em pacotes no espaço de trabalho.

Alteração de comportamento para caminhos de fallback

Em 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 do caminho era baseada no caminho onde o recurso foi definido pela primeira vez, que era confuso e propenso a erros.

Por exemplo, ao executar a implantação de pacote para um bloco de anotações em um trabalho definido em resources/job.yml (uma subpasta da raiz) e o caminho do bloco de anotações foi definido como ../src/notebook.py em um arquivo override.yml (na raiz), o caminho do bloco de anotações foi primeiro resolvido para <BUNDLE_ROOT>/../src/notebook.py, com base no local do arquivo de configuração onde o caminho foi definido. Se esse caminho não existisse, ele resolvia 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 ocorre 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, ocorre um erro se o caminho especificado não existir. Apenas caminhos relativos diretos são suportados. Para implantar seu pacote, você deve corrigir o caminho.

run_as suporte para gasodutos

3 de setembro de 2025

Este recurso foi lançado com Databricks CLI 0.267.0.

O suporte de nível run_as superior está agora disponível para Lakeflow Spark Declarative Pipelines. Para obter mais informações sobre identidades de execução de pacote, consulte Especificar uma identidade de execução para um fluxo de trabalho do Databricks Asset Bundles.

Suporte ao banco de dados Lakebase

21 de agosto de 2025

Este recurso foi lançado com Databricks CLI 0.265.0.

Agora você pode definir instâncias e catálogos de banco de dados Lakebase em sua configuração do Databricks Asset Bundles. Veja database_instance e database_catalog.

Nova configuração do pacote de scripts

Julho 16, 2025

Este recurso foi lançado com Databricks CLI 0.259.0.

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

O modelo default-python agora usa uv

Julho 2, 2025

Este recurso foi lançado com o Databricks CLI 0.258.0.

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

O modelo default-python tem como padrão de utilização o serverless.

25 de junho de 2025

Este recurso foi lançado com o Databricks CLI 0.257.0.

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

Nova predefinição de implantação artifacts_dynamic_version

18 de junho de 2025

Este recurso foi lançado com Databricks CLI 0.256.0.

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

Os pacotes no ambiente de trabalho estão em Prévia Pública

Maio 19, 2025

Este recurso foi lançado com o Databricks CLI 0.250.0.

Colaborar em pacotes de ativos Databricks com outros usuários em sua organização agora é mais fácil com pacotes no espaço de trabalho, o que permite que os usuários do espaço de trabalho editem, confirmem, testem e implantem atualizações de pacotes por meio da interface do usuário.

Veja Colaborar em pacotes no espaço de trabalho.

Suporte à execução de scripts em linha

30 de abril de 2025

Este recurso foi lançado com o Databricks CLI 0.250.0.

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

Python for Databricks Asset Bundles está em pré-visualização pública

Abril 16, 2025

Este recurso foi lançado com Databricks CLI 0.248.0.

Python for Databricks Asset Bundles está agora em Visualização Pública. Esse recurso estende os pacotes para que você possa definir trabalhos como código Python, criar dinamicamente trabalhos 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 Python para Databricks Asset Bundles, consulte Configuração do pacote em Python.

Suporte de ligação/desvinculação para quality_monitor e model_serving_endpoint

9 de abril de 2025

Este recurso foi lançado com Databricks CLI 0.247.0.

Os bind comandos e unbind agora são suportados para o quality_monitor e model_serving_endpoint. Isso significa que você pode vincular esses recursos definidos pelo pacote a monitores de qualidade existentes e pontos de extremidade de serviço de modelo no espaço de trabalho do Azure Databricks para que eles se tornem gerenciados pelo Databricks Asset Bundles. Para obter mais informações, consulte databricks bundle deployment bind.

Versionamento dinâmico para rodas

26 de março de 2025

Este recurso foi lançado com Databricks CLI 0.245.0.

Uma nova configuração dynamic_version para o artifacts mapeamento permite que os bundles atualizem a versão do wheel com base no carimbo de data/hora do arquivo wheel. O novo código pode ser implantado sem a necessidade de atualizar a versão no setup.py ou pyproject.toml. Essa configuração só é válida quando type definida como whl. Veja artefatos.

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

26 de março de 2025

Este recurso foi lançado com Databricks CLI 0.245.0.

Os comandos bind e unbind agora são suportados para os recursos cluster, painel de controlo, modelo_registado e volume. Isso significa que você pode vincular esses recursos definidos por pacote a clusters, painéis, modelos registrados e volumes existentes no espaço de trabalho do Azure Databricks para que eles se tornem gerenciados pelo Databricks Asset Bundles. Para obter mais informações, consulte databricks bundle deployment bind.

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

5 de março de 2025

Este recurso foi lançado com Databricks CLI 0.243.0.

Os comandos bind e unbind são agora suportados para o recurso de esquema. Esses comandos permitem vincular recursos definidos pelo pacote a recursos existentes no espaço de trabalho do Azure Databricks para que eles sejam gerenciados pelo Databricks Asset Bundles. Para obter mais informações, consulte databricks bundle deployment bind.

Suporte de aplicativos

Janeiro 16, 2025

Este recurso foi lançado com Databricks CLI 0.239.0.

Agora você pode gerenciar implantações de aplicativos Databricks usando pacotes de ativos Databricks definindo um recurso de aplicativo em sua configuração de pacote. Veja o aplicativo.

Suporte de volume

5 de dezembro de 2024

Este recurso foi lançado com Databricks CLI 0.236.0.

Agora você pode criar volumes do Catálogo Unity usando o Databricks Asset Bundles definindo um recurso de volume na configuração do pacote. Ver volume (Catálogo Unity).

Pesquisa variável para destinos de notificação

5 de dezembro de 2024

Este recurso foi lançado com Databricks CLI 0.236.0.

As consultas de variáveis agora suportam destinos de notificação. Consulte Recuperar o valor de ID de um objeto.

Suporte de painel de controlo

30 de outubro de 2024

Este recurso foi lançado com Databricks CLI 0.232.0.

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

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

Novo comando de resumo de conjunto

Outubro 23, 2024

Este recurso foi lançado com Databricks CLI 0.231.0.

Um novo bundle summary comando foi adicionado. Este comando produz um resumo da identidade e dos recursos de um pacote, incluindo links diretos para recursos para que você possa navegar facilmente até o recurso no espaço de trabalho Databricks. Consulte o resumo do pacote databricks.

Aviso para pacotes implantados na área partilhada que tenham permissões em conflito

Outubro 23, 2024

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

Um aviso agora ocorre quando um pacote é implantado na pasta /Workspace/Shared, que é acessível por todos os usuários, mas o topo permissions definido para o pacote entra em conflito com a pasta. 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 automaticamente prefixados

9 de outubro de 2024

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

Os caminhos do espaço de trabalho agora são automaticamente prefixados com /Workspace. Além disso, todo o uso de cadeias de caracteres 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_pathpersonalizado, workspace.artifact_pathou workspace.file_path, o Databricks Asset Bundles o prefixará automaticamente com /Workspace, mas se você usar qualquer um desses 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 passar uma dessas como uma variável e a prefixar no seu código, precisará atualizar o código para evitar isso.

Essa alteração é necessária porque, originalmente, quando o sistema de arquivos do espaço de trabalho estava enraizado em / e os diretórios pessoais estavam sob /Users, para aceder aos caminhos do espaço de trabalho através da API REST do Databricks, utilizaria diretamente esses caminhos. Para aceder aos caminhos de espaço de trabalho a partir do código, pode utilizar o caminho do ficheiro e os diretórios base também estavam disponíveis sob /Workspace e /Workspace/Users. Para evitar esta dualidade de caminhos de espaço de trabalho, bem como a ambiguidade entre caminhos de espaço de trabalho e caminhos do Catálogo Unity /Volumes, todos os caminhos de espaço de trabalho são antecedidos por /Workspace.

Suporte para a criação de clusters polivalentes

1 de outubro de 2024

Este recurso foi lançado com Databricks CLI 0.229.0.

Agora você pode criar clusters multiuso em sua configuração de pacote usando o novo tipo de recurso de cluster. Consulte cluster.

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

5 de setembro de 2024

Este recurso foi lançado com Databricks CLI 0.228.0.

Uma mensagem será exibida agora se houver alterações na configuração do pacote que levariam à recriação do pipeline. Você pode ignorar o prompt especificando o --auto-approve sinalizador.

Adicionado suporte para o recurso de esquema do Unity Catalog

31 de julho de 2024

Este recurso foi lançado com o Databricks CLI 0.225.0.

Os esquemas do Catálogo Unity agora podem ser definidos na configuração do pacote. Consulte esquema (Unity Catalog).

Agrupar comandos no terminal web

4 de julho de 2024

Este recurso foi lançado com Databricks CLI 0.223.0.

Agora você pode interagir com pacotes usando a CLI do Databricks a partir do terminal da Web. Para obter informações sobre como usar o terminal Web, consulte Executar comandos shell no terminal Web do Azure Databricks.

Adicionado suporte para variáveis complexas

26 de junho de 2024

Este recurso foi lançado com Databricks CLI v0.222.0.

O Databricks Asset Bundles agora suporta variáveis complexas. Consulte Definir uma variável complexa.

O Databricks Asset Bundles está disponível em geral

23 de abril de 2024

Com a versão 0.218.0 da CLI do Databricks, os Databricks Asset Bundles agora estão disponíveis para o público em geral.