diff --git a/.github/ISSUE_TEMPLATE/dabs-issue.md b/.github/ISSUE_TEMPLATE/dabs-issue.md index dff820265ff..1dddb108e05 100644 --- a/.github/ISSUE_TEMPLATE/dabs-issue.md +++ b/.github/ISSUE_TEMPLATE/dabs-issue.md @@ -1,6 +1,6 @@ --- -name: Bug report for Databricks Asset Bundles -about: Use this to report an issue with Databricks Asset Bundles. +name: Bug report for Declarative Automation Bundles +about: Use this to report an issue with Declarative Automation Bundles. labels: DABs title: '' --- diff --git a/.github/ISSUE_TEMPLATE/direct-issue.md b/.github/ISSUE_TEMPLATE/direct-issue.md index 54a79b9180e..5ddbfbe7437 100644 --- a/.github/ISSUE_TEMPLATE/direct-issue.md +++ b/.github/ISSUE_TEMPLATE/direct-issue.md @@ -1,6 +1,6 @@ --- name: Bug report for direct deployment engine for DABs -about: Use this to report an issue with direct deployment engine in Databricks Asset Bundles. +about: Use this to report an issue with direct deployment engine in Declarative Automation Bundles. labels: ["DABs", "engine/direct", "Bug"] title: '' --- diff --git a/AGENTS.md b/AGENTS.md index d6de67204d1..6680a83e205 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ This file provides guidance to AI assistants when working with code in this repo # Project Overview -This is the Databricks CLI, a command-line interface for interacting with Databricks workspaces and managing Databricks Assets Bundles (DABs). The project is written in Go and follows a modular architecture. +This is the Databricks CLI, a command-line interface for interacting with Databricks workspaces and managing Declarative Automation Bundles (DABs), formerly known as Databricks Asset Bundles. The project is written in Go and follows a modular architecture. # General Rules @@ -46,7 +46,7 @@ GIT_EDITOR=true GIT_SEQUENCE_EDITOR=true VISUAL=true GIT_PAGER=cat git rebase or - `cmd/workspace/` - Workspace API commands (auto-generated) - `cmd/account/` - Account-level API commands (auto-generated) -**bundle/** - Core bundle functionality for Databricks Asset Bundles +**bundle/** - Core bundle functionality for Declarative Automation Bundles - `bundle/bundle.go` - Main Bundle struct and lifecycle management - `bundle/config/` - Configuration loading, validation, and schema - `bundle/deploy/` - Deployment logic (Terraform and direct modes) @@ -227,7 +227,7 @@ A databricks_template_schema.json file is used to configure bundle templates. Below is a good reference template: { - "welcome_message": "\nWelcome to the dbt template for Databricks Asset Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", + "welcome_message": "\nWelcome to the dbt template for Declarative Automation Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", "properties": { "project_name": { "type": "string", diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md index e78b24ad1a5..13575a1d648 100644 --- a/NEXT_CHANGELOG.md +++ b/NEXT_CHANGELOG.md @@ -4,6 +4,7 @@ ### Notable Changes +- Databricks Asset Bundles have been renamed to Declarative Automation Bundles (DABs). This is a non-breaking change; no code or configuration modifications are required. See the [FAQ](https://docs.databricks.com/aws/en/dev-tools/bundles/faqs#why-was-databricks-asset-bundles-renamed-to-declarative-automation-bundles). - Add `bundle.engine` config setting to select the deployment engine (`terraform` or `direct`). The `DATABRICKS_BUNDLE_ENGINE` environment variable takes precedence over this setting. When the configured engine doesn't match existing deployment state, a warning is issued and the existing engine is used ([#4749](https://github.com/databricks/cli/pull/4749)). ### CLI diff --git a/acceptance/bundle/help/bundle/output.txt b/acceptance/bundle/help/bundle/output.txt index 379373b63ad..624e18db9ca 100644 --- a/acceptance/bundle/help/bundle/output.txt +++ b/acceptance/bundle/help/bundle/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle --help -Databricks Asset Bundles let you express data/AI/analytics projects as code. +Declarative Automation Bundles let you express data/AI/analytics projects as code. Common workflows: databricks bundle init default-python # Initialize new project diff --git a/acceptance/bundle/migrate/default-python/output.txt b/acceptance/bundle/migrate/default-python/output.txt index dcdd47e0874..15d49805b47 100644 --- a/acceptance/bundle/migrate/default-python/output.txt +++ b/acceptance/bundle/migrate/default-python/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/dbt-sql/output.txt b/acceptance/bundle/templates/dbt-sql/output.txt index 2699ad55416..8555f15292c 100644 --- a/acceptance/bundle/templates/dbt-sql/output.txt +++ b/acceptance/bundle/templates/dbt-sql/output.txt @@ -1,7 +1,7 @@ >>> [CLI] bundle init dbt-sql --config-file ./input.json --output-dir output -Welcome to the dbt template for Databricks Asset Bundles! +Welcome to the dbt template for Declarative Automation Bundles! A workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html. workspace_host: [DATABRICKS_URL] diff --git a/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/README.md b/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/README.md index 7a36fa56fc5..6fd15788a5f 100644 --- a/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/README.md +++ b/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/README.md @@ -1,15 +1,15 @@ # my_dbt_sql The 'my_dbt_sql' project was generated by using the dbt template for -Databricks Asset Bundles. It follows the standard dbt project structure +Declarative Automation Bundles. It follows the standard dbt project structure and has an additional `resources` directory to define Databricks resources such as jobs that run dbt models. * Learn more about dbt and its standard project structure here: https://docs.getdbt.com/docs/build/projects. -* Learn more about Databricks Asset Bundles here: https://docs.databricks.com/en/dev-tools/bundles/index.html +* Learn more about Declarative Automation Bundles here: https://docs.databricks.com/en/dev-tools/bundles/index.html The remainder of this file includes instructions for local development (using dbt) -and deployment to production (using Databricks Asset Bundles). +and deployment to production (using Declarative Automation Bundles). ## Development setup @@ -99,9 +99,9 @@ Or you can use CI/CD to automate deployment. See https://docs.databricks.com/dev-tools/bundles/ci-cd.html for documentation on CI/CD setup. -## Manually deploying to Databricks with Databricks Asset Bundles +## Manually deploying to Databricks with Declarative Automation Bundles -Databricks Asset Bundles can be used to deploy to Databricks and to execute +Declarative Automation Bundles can be used to deploy to Databricks and to execute dbt commands as a job using Databricks Workflows. See https://docs.databricks.com/dev-tools/bundles/index.html to learn more. diff --git a/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/databricks.yml b/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/databricks.yml index 4285a44eba0..5f2a8cd93b0 100644 --- a/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/databricks.yml +++ b/acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/databricks.yml @@ -1,5 +1,5 @@ # This file defines the structure of this project and how it is deployed -# to production using Databricks Asset Bundles. +# to production using Declarative Automation Bundles. # See https://docs.databricks.com/dev-tools/bundles/index.html for documentation. bundle: name: my_dbt_sql diff --git a/acceptance/bundle/templates/default-python/azure-government/output.txt b/acceptance/bundle/templates/default-python/azure-government/output.txt index 4c34df71ef5..89120bfb82c 100644 --- a/acceptance/bundle/templates/default-python/azure-government/output.txt +++ b/acceptance/bundle/templates/default-python/azure-government/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json --output-dir output -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/classic/output.txt b/acceptance/bundle/templates/default-python/classic/output.txt index af2eb7495cf..2a301801d86 100644 --- a/acceptance/bundle/templates/default-python/classic/output.txt +++ b/acceptance/bundle/templates/default-python/classic/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json --output-dir output -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/combinations/classic/output.txt b/acceptance/bundle/templates/default-python/combinations/classic/output.txt index 64e612c69f0..634b857f961 100644 --- a/acceptance/bundle/templates/default-python/combinations/classic/output.txt +++ b/acceptance/bundle/templates/default-python/combinations/classic/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/combinations/serverless/output.txt b/acceptance/bundle/templates/default-python/combinations/serverless/output.txt index 64e612c69f0..634b857f961 100644 --- a/acceptance/bundle/templates/default-python/combinations/serverless/output.txt +++ b/acceptance/bundle/templates/default-python/combinations/serverless/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/fail-missing-uv/output.txt b/acceptance/bundle/templates/default-python/fail-missing-uv/output.txt index f96a96c1c5e..8eec220aec1 100644 --- a/acceptance/bundle/templates/default-python/fail-missing-uv/output.txt +++ b/acceptance/bundle/templates/default-python/fail-missing-uv/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json --output-dir output -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/integration_classic/output.txt b/acceptance/bundle/templates/default-python/integration_classic/output.txt index ba5cfabec9d..2206b10cd25 100644 --- a/acceptance/bundle/templates/default-python/integration_classic/output.txt +++ b/acceptance/bundle/templates/default-python/integration_classic/output.txt @@ -3,7 +3,7 @@ [UV_PYTHON] >>> [CLI] bundle init default-python --config-file ./input.json --output-dir . -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/no-uc/output.txt b/acceptance/bundle/templates/default-python/no-uc/output.txt index 4c34df71ef5..89120bfb82c 100644 --- a/acceptance/bundle/templates/default-python/no-uc/output.txt +++ b/acceptance/bundle/templates/default-python/no-uc/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json --output-dir output -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/serverless-customcatalog/output.txt b/acceptance/bundle/templates/default-python/serverless-customcatalog/output.txt index 14910c6bbba..5142d961643 100644 --- a/acceptance/bundle/templates/default-python/serverless-customcatalog/output.txt +++ b/acceptance/bundle/templates/default-python/serverless-customcatalog/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file [TESTROOT]/bundle/templates/default-python/serverless-customcatalog/../serverless/input.json --output-dir output -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-python/serverless/output.txt b/acceptance/bundle/templates/default-python/serverless/output.txt index 6cad79ec1dc..1b8abcf31ff 100644 --- a/acceptance/bundle/templates/default-python/serverless/output.txt +++ b/acceptance/bundle/templates/default-python/serverless/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init default-python --config-file ./input.json --output-dir output -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/default-scala/output.txt b/acceptance/bundle/templates/default-scala/output.txt index 2dbf5196920..8a4f23f5a32 100644 --- a/acceptance/bundle/templates/default-scala/output.txt +++ b/acceptance/bundle/templates/default-scala/output.txt @@ -1,7 +1,7 @@ >>> [CLI] bundle init default-scala --config-file ./input.json --output-dir output -Welcome to the default-scala template for Databricks Asset Bundles! +Welcome to the default-scala template for Declarative Automation Bundles! A workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html. workspace_host: [DATABRICKS_URL] diff --git a/acceptance/bundle/templates/default-scala/output/my_default_scala/README.md b/acceptance/bundle/templates/default-scala/output/my_default_scala/README.md index 00575283647..9bc393514c2 100644 --- a/acceptance/bundle/templates/default-scala/output/my_default_scala/README.md +++ b/acceptance/bundle/templates/default-scala/output/my_default_scala/README.md @@ -36,7 +36,7 @@ The 'my_default_scala' project was generated by using the default-scala template 6. Optionally, install developer tools such as the Databricks extension for Visual Studio Code from https://docs.databricks.com/dev-tools/vscode-ext.html. -7. For documentation on the Databricks Asset Bundles format used +7. For documentation on the Declarative Automation Bundles format used for this project, and for CI/CD configuration, see https://docs.databricks.com/dev-tools/bundles/index.html. diff --git a/acceptance/bundle/templates/default-scala/output/my_default_scala/resources/.gitkeep b/acceptance/bundle/templates/default-scala/output/my_default_scala/resources/.gitkeep index c6f742a7181..5b0d6b6f74b 100644 --- a/acceptance/bundle/templates/default-scala/output/my_default_scala/resources/.gitkeep +++ b/acceptance/bundle/templates/default-scala/output/my_default_scala/resources/.gitkeep @@ -1,2 +1,2 @@ -This folder is reserved for Databricks Asset Bundles resource definitions. +This folder is reserved for Declarative Automation Bundles resource definitions. diff --git a/acceptance/bundle/templates/default-sql/output.txt b/acceptance/bundle/templates/default-sql/output.txt index 06eff962bc2..222e5d7e1e6 100644 --- a/acceptance/bundle/templates/default-sql/output.txt +++ b/acceptance/bundle/templates/default-sql/output.txt @@ -1,7 +1,7 @@ >>> [CLI] bundle init default-sql --config-file ./input.json --output-dir output -Welcome to the default SQL template for Databricks Asset Bundles! +Welcome to the default SQL template for Declarative Automation Bundles! A workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html. workspace_host: [DATABRICKS_URL] diff --git a/acceptance/bundle/templates/default-sql/output/my_default_sql/README.md b/acceptance/bundle/templates/default-sql/output/my_default_sql/README.md index 903869eebec..9d915327dbe 100644 --- a/acceptance/bundle/templates/default-sql/output/my_default_sql/README.md +++ b/acceptance/bundle/templates/default-sql/output/my_default_sql/README.md @@ -36,7 +36,7 @@ The 'my_default_sql' project was generated by using the default-sql template. 6. Optionally, install developer tools such as the Databricks extension for Visual Studio Code from https://docs.databricks.com/dev-tools/vscode-ext.html. -7. For documentation on the Databricks Asset Bundles format used +7. For documentation on the Declarative Automation Bundles format used for this project, and for CI/CD configuration, see https://docs.databricks.com/dev-tools/bundles/index.html. diff --git a/acceptance/bundle/templates/experimental-jobs-as-code/output.txt b/acceptance/bundle/templates/experimental-jobs-as-code/output.txt index 5a978ab8063..089a5c53a40 100644 --- a/acceptance/bundle/templates/experimental-jobs-as-code/output.txt +++ b/acceptance/bundle/templates/experimental-jobs-as-code/output.txt @@ -1,7 +1,7 @@ >>> [CLI] bundle init experimental-jobs-as-code --config-file ./input.json --output-dir output -Welcome to (EXPERIMENTAL) "Jobs as code" template for Databricks Asset Bundles! +Welcome to (EXPERIMENTAL) "Jobs as code" template for Declarative Automation Bundles! Workspace to use (auto-detected, edit in 'my_jobs_as_code/databricks.yml'): [DATABRICKS_URL] ✨ Your new project has been created in the 'my_jobs_as_code' directory! diff --git a/acceptance/bundle/templates/experimental-jobs-as-code/output/my_jobs_as_code/README.md b/acceptance/bundle/templates/experimental-jobs-as-code/output/my_jobs_as_code/README.md index 8c429c6e53f..6bfac07da05 100644 --- a/acceptance/bundle/templates/experimental-jobs-as-code/output/my_jobs_as_code/README.md +++ b/acceptance/bundle/templates/experimental-jobs-as-code/output/my_jobs_as_code/README.md @@ -19,7 +19,7 @@ The 'my_jobs_as_code' project was generated by using the "Jobs as code" template https://docs.databricks.com/dev-tools/vscode-ext.html. Or read the "getting started" documentation for **Databricks Connect** for instructions on running the included Python code from a different IDE. -5. For documentation on the Databricks Asset Bundles format used +5. For documentation on the Declarative Automation Bundles format used for this project, and for CI/CD configuration, see https://docs.databricks.com/dev-tools/bundles/index.html. diff --git a/acceptance/bundle/templates/pydabs/check-consistency/output.txt b/acceptance/bundle/templates/pydabs/check-consistency/output.txt index 4a048236e8f..a229c70dfc1 100644 --- a/acceptance/bundle/templates/pydabs/check-consistency/output.txt +++ b/acceptance/bundle/templates/pydabs/check-consistency/output.txt @@ -1,7 +1,7 @@ == Collecting resources into ./enable_pydabs=yes >>> [CLI] bundle init pydabs --config-file ./input.json -Welcome to PyDABs template for Databricks Asset Bundles! +Welcome to PyDABs template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. @@ -21,7 +21,7 @@ To get started, refer to the project README.md file and the documentation at htt == Collecting resources into ./enable_pydabs=no >>> [CLI] bundle init pydabs --config-file ./input.json -Welcome to PyDABs template for Databricks Asset Bundles! +Welcome to PyDABs template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/pydabs/check-formatting/output.txt b/acceptance/bundle/templates/pydabs/check-formatting/output.txt index c9b4edad760..29db0fde3c5 100644 --- a/acceptance/bundle/templates/pydabs/check-formatting/output.txt +++ b/acceptance/bundle/templates/pydabs/check-formatting/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init pydabs --config-file ./input.json -Welcome to PyDABs template for Databricks Asset Bundles! +Welcome to PyDABs template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/pydabs/deploy-classic/output.txt b/acceptance/bundle/templates/pydabs/deploy-classic/output.txt index c9dc1c3ac61..f79f8337c74 100644 --- a/acceptance/bundle/templates/pydabs/deploy-classic/output.txt +++ b/acceptance/bundle/templates/pydabs/deploy-classic/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init pydabs --config-file ./input.json -Welcome to PyDABs template for Databricks Asset Bundles! +Welcome to PyDABs template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/pydabs/init-classic/output.txt b/acceptance/bundle/templates/pydabs/init-classic/output.txt index b36f764a20d..d62e10c6cb2 100644 --- a/acceptance/bundle/templates/pydabs/init-classic/output.txt +++ b/acceptance/bundle/templates/pydabs/init-classic/output.txt @@ -1,6 +1,6 @@ >>> [CLI] bundle init pydabs --config-file ./input.json --output-dir output -Welcome to PyDABs template for Databricks Asset Bundles! +Welcome to PyDABs template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/telemetry/dbt-sql/out.databricks.yml b/acceptance/bundle/templates/telemetry/dbt-sql/out.databricks.yml index e2aa7e9831c..d4e7a980b0b 100644 --- a/acceptance/bundle/templates/telemetry/dbt-sql/out.databricks.yml +++ b/acceptance/bundle/templates/telemetry/dbt-sql/out.databricks.yml @@ -1,5 +1,5 @@ # This file defines the structure of this project and how it is deployed -# to production using Databricks Asset Bundles. +# to production using Declarative Automation Bundles. # See https://docs.databricks.com/dev-tools/bundles/index.html for documentation. bundle: name: my_dbt_sql diff --git a/acceptance/bundle/templates/telemetry/dbt-sql/output.txt b/acceptance/bundle/templates/telemetry/dbt-sql/output.txt index 92ae6504ab4..092d7557f21 100644 --- a/acceptance/bundle/templates/telemetry/dbt-sql/output.txt +++ b/acceptance/bundle/templates/telemetry/dbt-sql/output.txt @@ -1,5 +1,5 @@ -Welcome to the dbt template for Databricks Asset Bundles! +Welcome to the dbt template for Declarative Automation Bundles! A workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html. workspace_host: [DATABRICKS_URL] diff --git a/acceptance/bundle/templates/telemetry/default-python/output.txt b/acceptance/bundle/templates/telemetry/default-python/output.txt index 0ae361c932b..c1f9e4f0825 100644 --- a/acceptance/bundle/templates/telemetry/default-python/output.txt +++ b/acceptance/bundle/templates/telemetry/default-python/output.txt @@ -1,4 +1,4 @@ -Welcome to the default Python template for Databricks Asset Bundles! +Welcome to the default Python template for Declarative Automation Bundles! Answer the following questions to customize your project. You can always change your configuration in the databricks.yml file later. diff --git a/acceptance/bundle/templates/telemetry/default-sql/output.txt b/acceptance/bundle/templates/telemetry/default-sql/output.txt index ba77a00690f..907e24fc872 100644 --- a/acceptance/bundle/templates/telemetry/default-sql/output.txt +++ b/acceptance/bundle/templates/telemetry/default-sql/output.txt @@ -1,5 +1,5 @@ -Welcome to the default SQL template for Databricks Asset Bundles! +Welcome to the default SQL template for Declarative Automation Bundles! A workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html. workspace_host: [DATABRICKS_URL] diff --git a/acceptance/help/output.txt b/acceptance/help/output.txt index 19b491dd57d..41ac18aaf19 100644 --- a/acceptance/help/output.txt +++ b/acceptance/help/output.txt @@ -156,7 +156,7 @@ Postgres postgres Use the Postgres API to create and manage Lakebase Autoscaling Postgres infrastructure, including projects, branches, compute endpoints, and roles. Developer Tools - bundle Databricks Asset Bundles let you express data/AI/analytics projects as code. + bundle Declarative Automation Bundles let you express data/AI/analytics projects as code. sync Synchronize a local directory to a workspace directory Additional Commands: diff --git a/bundle/bundle.go b/bundle/bundle.go index 55a1275b7e5..97824eb8396 100644 --- a/bundle/bundle.go +++ b/bundle/bundle.go @@ -1,4 +1,4 @@ -// Package bundle is the top level package for Databricks Asset Bundles. +// Package bundle is the top level package for Declarative Automation Bundles. // // A bundle is represented by the [Bundle] type. It consists of configuration // and runtime state, such as a client to a Databricks workspace. diff --git a/bundle/direct/dresources/resources.yml b/bundle/direct/dresources/resources.yml index a6c70ef44e6..733973ecf9a 100644 --- a/bundle/direct/dresources/resources.yml +++ b/bundle/direct/dresources/resources.yml @@ -1,4 +1,4 @@ -# Resource lifecycle configuration for Databricks Asset Bundles. +# Resource lifecycle configuration for Declarative Automation Bundles. # This file defines how field changes affect resource operations. # # Available options: diff --git a/bundle/docsgen/output/reference.md b/bundle/docsgen/output/reference.md index 97449aca785..ca4a347e1a5 100644 --- a/bundle/docsgen/output/reference.md +++ b/bundle/docsgen/output/reference.md @@ -389,7 +389,7 @@ Defines bundle deployment presets. See [\_](/dev-tools/bundles/deployment-modes. **`Type: Map`** -A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Databricks Asset Bundles supported resources, and resource definition reference, see [\_](/dev-tools/bundles/resources.md). +A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Declarative Automation Bundles supported resources, and resource definition reference, see [\_](/dev-tools/bundles/resources.md). ```yaml resources: @@ -656,7 +656,7 @@ Lifecycle is a struct that contains the lifecycle settings for a resource. It co **`Type: Map`** -The identity to use when running Databricks Asset Bundles workflows. See [\_](/dev-tools/bundles/run-as.md). +The identity to use when running Declarative Automation Bundles workflows. See [\_](/dev-tools/bundles/run-as.md). diff --git a/bundle/docsgen/output/resources.md b/bundle/docsgen/output/resources.md index 95dd6f94942..2075ceae55c 100644 --- a/bundle/docsgen/output/resources.md +++ b/bundle/docsgen/output/resources.md @@ -1,5 +1,5 @@ --- -description: 'Learn about resources supported by Databricks Asset Bundles and how to configure them.' +description: 'Learn about resources supported by Declarative Automation Bundles and how to configure them.' last_update: date: 2025-09-13 --- @@ -1816,7 +1816,7 @@ Tags: Additional metadata key-value pairs. **`Type: Map`** -The job resource allows you to define [jobs and their corresponding tasks](/api/workspace/jobs/create) in your bundle. For information about jobs, see [_](/jobs/index.md). For a tutorial that uses a Databricks Asset Bundles template to create a job, see [_](/dev-tools/bundles/jobs-tutorial.md). +The job resource allows you to define [jobs and their corresponding tasks](/api/workspace/jobs/create) in your bundle. For information about jobs, see [_](/jobs/index.md). For a tutorial that uses a Declarative Automation Bundles template to create a job, see [_](/dev-tools/bundles/jobs-tutorial.md). ```yaml jobs: @@ -6783,7 +6783,7 @@ Additional metadata for registered model. **`Type: Map`** -The pipeline resource allows you to create Delta Live Tables [pipelines](/api/workspace/pipelines/create). For information about pipelines, see [_](/dlt/index.md). For a tutorial that uses the Databricks Asset Bundles template to create a pipeline, see [_](/dev-tools/bundles/pipelines-tutorial.md). +The pipeline resource allows you to create Delta Live Tables [pipelines](/api/workspace/pipelines/create). For information about pipelines, see [_](/dlt/index.md). For a tutorial that uses the Declarative Automation Bundles template to create a pipeline, see [_](/dev-tools/bundles/pipelines-tutorial.md). ```yaml pipelines: @@ -8639,7 +8639,7 @@ resources: comment: This schema was created by DABs. ``` -A top-level grants mapping is not supported by Databricks Asset Bundles, so if you want to set grants for a schema, define the grants for the schema within the `schemas` mapping. For more information about grants, see [_](/data-governance/unity-catalog/manage-privileges/index.md#grant). +A top-level grants mapping is not supported by Declarative Automation Bundles, so if you want to set grants for a schema, define the grants for the schema within the `schemas` mapping. For more information about grants, see [_](/data-governance/unity-catalog/manage-privileges/index.md#grant). The following example defines a Unity Catalog schema with grants: @@ -9187,7 +9187,7 @@ only requires read permissions. The volume resource type allows you to define and create Unity Catalog [volumes](/api/workspace/volumes/create) as part of a bundle. When deploying a bundle with a volume defined, note that: -- A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Databricks Asset Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments. +- A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Declarative Automation Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments. - Volumes in the bundle are not prepended with the `dev_${workspace.current_user.short_name}` prefix when the deployment target has `mode: development` configured. However, you can manually configure this prefix. See [_](/dev-tools/bundles/deployment-modes.md#custom-presets). diff --git a/bundle/docsgen/templates/resources.md b/bundle/docsgen/templates/resources.md index aac2c4d9128..ffc33f558bf 100644 --- a/bundle/docsgen/templates/resources.md +++ b/bundle/docsgen/templates/resources.md @@ -1,5 +1,5 @@ --- -description: 'Learn about resources supported by Databricks Asset Bundles and how to configure them.' +description: 'Learn about resources supported by Declarative Automation Bundles and how to configure them.' last_update: date: {{update_date}} --- diff --git a/bundle/internal/schema/annotations.yml b/bundle/internal/schema/annotations.yml index 97b17eb8a7c..7098f400f03 100644 --- a/bundle/internal/schema/annotations.yml +++ b/bundle/internal/schema/annotations.yml @@ -317,7 +317,7 @@ github.com/databricks/cli/bundle/config.Root: "description": |- A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. "markdown_description": |- - A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Databricks Asset Bundles supported resources, and resource definition reference, see [\_](/dev-tools/bundles/resources.md). + A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Declarative Automation Bundles supported resources, and resource definition reference, see [\_](/dev-tools/bundles/resources.md). ```yaml resources: @@ -327,9 +327,9 @@ github.com/databricks/cli/bundle/config.Root: ``` "run_as": "description": |- - The identity to use when running Databricks Asset Bundles workflows. + The identity to use when running Declarative Automation Bundles workflows. "markdown_description": |- - The identity to use when running Databricks Asset Bundles workflows. See [\_](/dev-tools/bundles/run-as.md). + The identity to use when running Declarative Automation Bundles workflows. See [\_](/dev-tools/bundles/run-as.md). "scripts": "description": |- PLACEHOLDER diff --git a/bundle/internal/schema/annotations_openapi_overrides.yml b/bundle/internal/schema/annotations_openapi_overrides.yml index 7cb24e98d11..f492ddf88f6 100644 --- a/bundle/internal/schema/annotations_openapi_overrides.yml +++ b/bundle/internal/schema/annotations_openapi_overrides.yml @@ -229,7 +229,7 @@ github.com/databricks/cli/bundle/config/resources.ExternalLocation: github.com/databricks/cli/bundle/config/resources.Job: "_": "markdown_description": |- - The job resource allows you to define [jobs and their corresponding tasks](/api/workspace/jobs/create) in your bundle. For information about jobs, see [_](/jobs/index.md). For a tutorial that uses a Databricks Asset Bundles template to create a job, see [_](/dev-tools/bundles/jobs-tutorial.md). + The job resource allows you to define [jobs and their corresponding tasks](/api/workspace/jobs/create) in your bundle. For information about jobs, see [_](/jobs/index.md). For a tutorial that uses a Declarative Automation Bundles template to create a job, see [_](/dev-tools/bundles/jobs-tutorial.md). "markdown_examples": |- The following example defines a job with the resource key `hello-job` with one notebook task: @@ -328,7 +328,7 @@ github.com/databricks/cli/bundle/config/resources.ModelServingEndpoint: github.com/databricks/cli/bundle/config/resources.Pipeline: "_": "markdown_description": |- - The pipeline resource allows you to create Delta Live Tables [pipelines](/api/workspace/pipelines/create). For information about pipelines, see [_](/dlt/index.md). For a tutorial that uses the Databricks Asset Bundles template to create a pipeline, see [_](/dev-tools/bundles/pipelines-tutorial.md). + The pipeline resource allows you to create Delta Live Tables [pipelines](/api/workspace/pipelines/create). For information about pipelines, see [_](/dlt/index.md). For a tutorial that uses the Declarative Automation Bundles template to create a pipeline, see [_](/dev-tools/bundles/pipelines-tutorial.md). "markdown_examples": |- The following example defines a pipeline with the resource key `hello-pipeline`: @@ -480,7 +480,7 @@ github.com/databricks/cli/bundle/config/resources.Schema: comment: This schema was created by DABs. ``` - A top-level grants mapping is not supported by Databricks Asset Bundles, so if you want to set grants for a schema, define the grants for the schema within the `schemas` mapping. For more information about grants, see [_](/data-governance/unity-catalog/manage-privileges/index.md#grant). + A top-level grants mapping is not supported by Declarative Automation Bundles, so if you want to set grants for a schema, define the grants for the schema within the `schemas` mapping. For more information about grants, see [_](/data-governance/unity-catalog/manage-privileges/index.md#grant). The following example defines a Unity Catalog schema with grants: @@ -543,7 +543,7 @@ github.com/databricks/cli/bundle/config/resources.Volume: "markdown_description": |- The volume resource type allows you to define and create Unity Catalog [volumes](/api/workspace/volumes/create) as part of a bundle. When deploying a bundle with a volume defined, note that: - - A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Databricks Asset Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments. + - A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Declarative Automation Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments. - Volumes in the bundle are not prepended with the `dev_${workspace.current_user.short_name}` prefix when the deployment target has `mode: development` configured. However, you can manually configure this prefix. See [_](/dev-tools/bundles/deployment-modes.md#custom-presets). "markdown_examples": |- diff --git a/bundle/schema/jsonschema.json b/bundle/schema/jsonschema.json index 79090e5be52..1a3e558dd3d 100644 --- a/bundle/schema/jsonschema.json +++ b/bundle/schema/jsonschema.json @@ -850,7 +850,7 @@ } }, "additionalProperties": false, - "markdownDescription": "The job resource allows you to define [jobs and their corresponding tasks](https://docs.databricks.com/api/workspace/jobs/create) in your bundle. For information about jobs, see [link](https://docs.databricks.com/jobs/index.html). For a tutorial that uses a Databricks Asset Bundles template to create a job, see [link](https://docs.databricks.com/dev-tools/bundles/jobs-tutorial.html)." + "markdownDescription": "The job resource allows you to define [jobs and their corresponding tasks](https://docs.databricks.com/api/workspace/jobs/create) in your bundle. For information about jobs, see [link](https://docs.databricks.com/jobs/index.html). For a tutorial that uses a Declarative Automation Bundles template to create a job, see [link](https://docs.databricks.com/dev-tools/bundles/jobs-tutorial.html)." }, { "type": "string", @@ -1300,7 +1300,7 @@ } }, "additionalProperties": false, - "markdownDescription": "The pipeline resource allows you to create Delta Live Tables [pipelines](https://docs.databricks.com/api/workspace/pipelines/create). For information about pipelines, see [link](https://docs.databricks.com/dlt/index.html). For a tutorial that uses the Databricks Asset Bundles template to create a pipeline, see [link](https://docs.databricks.com/dev-tools/bundles/pipelines-tutorial.html)." + "markdownDescription": "The pipeline resource allows you to create Delta Live Tables [pipelines](https://docs.databricks.com/api/workspace/pipelines/create). For information about pipelines, see [link](https://docs.databricks.com/dlt/index.html). For a tutorial that uses the Declarative Automation Bundles template to create a pipeline, see [link](https://docs.databricks.com/dev-tools/bundles/pipelines-tutorial.html)." }, { "type": "string", @@ -1945,7 +1945,7 @@ "name", "schema_name" ], - "markdownDescription": "The volume resource type allows you to define and create Unity Catalog [volumes](https://docs.databricks.com/api/workspace/volumes/create) as part of a bundle. When deploying a bundle with a volume defined, note that:\n\n- A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Databricks Asset Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments.\n\n- Volumes in the bundle are not prepended with the `dev_${workspace.current_user.short_name}` prefix when the deployment target has `mode: development` configured. However, you can manually configure this prefix. See [custom-presets](https://docs.databricks.com/dev-tools/bundles/deployment-modes.html#custom-presets)." + "markdownDescription": "The volume resource type allows you to define and create Unity Catalog [volumes](https://docs.databricks.com/api/workspace/volumes/create) as part of a bundle. When deploying a bundle with a volume defined, note that:\n\n- A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Declarative Automation Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments.\n\n- Volumes in the bundle are not prepended with the `dev_${workspace.current_user.short_name}` prefix when the deployment target has `mode: development` configured. However, you can manually configure this prefix. See [custom-presets](https://docs.databricks.com/dev-tools/bundles/deployment-modes.html#custom-presets)." }, { "type": "string", @@ -11750,12 +11750,12 @@ "resources": { "description": "A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource.", "$ref": "#/$defs/github.com/databricks/cli/bundle/config.Resources", - "markdownDescription": "A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Databricks Asset Bundles supported resources, and resource definition reference, see [link](https://docs.databricks.com/dev-tools/bundles/resources.html).\n\n```yaml\nresources:\n \u003cresource-type\u003e:\n \u003cresource-name\u003e:\n \u003cresource-field-name\u003e: \u003cresource-field-value\u003e\n```" + "markdownDescription": "A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Declarative Automation Bundles supported resources, and resource definition reference, see [link](https://docs.databricks.com/dev-tools/bundles/resources.html).\n\n```yaml\nresources:\n \u003cresource-type\u003e:\n \u003cresource-name\u003e:\n \u003cresource-field-name\u003e: \u003cresource-field-value\u003e\n```" }, "run_as": { - "description": "The identity to use when running Databricks Asset Bundles workflows.", + "description": "The identity to use when running Declarative Automation Bundles workflows.", "$ref": "#/$defs/github.com/databricks/databricks-sdk-go/service/jobs.JobRunAs", - "markdownDescription": "The identity to use when running Databricks Asset Bundles workflows. See [link](https://docs.databricks.com/dev-tools/bundles/run-as.html)." + "markdownDescription": "The identity to use when running Declarative Automation Bundles workflows. See [link](https://docs.databricks.com/dev-tools/bundles/run-as.html)." }, "scripts": { "$ref": "#/$defs/map/github.com/databricks/cli/bundle/config.Script" diff --git a/bundle/schema/jsonschema_for_docs.json b/bundle/schema/jsonschema_for_docs.json index 4ce01550cdf..9df92739c80 100644 --- a/bundle/schema/jsonschema_for_docs.json +++ b/bundle/schema/jsonschema_for_docs.json @@ -852,7 +852,7 @@ } }, "additionalProperties": false, - "markdownDescription": "The job resource allows you to define [jobs and their corresponding tasks](https://docs.databricks.com/api/workspace/jobs/create) in your bundle. For information about jobs, see [link](https://docs.databricks.com/jobs/index.html). For a tutorial that uses a Databricks Asset Bundles template to create a job, see [link](https://docs.databricks.com/dev-tools/bundles/jobs-tutorial.html)." + "markdownDescription": "The job resource allows you to define [jobs and their corresponding tasks](https://docs.databricks.com/api/workspace/jobs/create) in your bundle. For information about jobs, see [link](https://docs.databricks.com/jobs/index.html). For a tutorial that uses a Declarative Automation Bundles template to create a job, see [link](https://docs.databricks.com/dev-tools/bundles/jobs-tutorial.html)." }, "resources.JobPermission": { "type": "object", @@ -1295,7 +1295,7 @@ } }, "additionalProperties": false, - "markdownDescription": "The pipeline resource allows you to create Delta Live Tables [pipelines](https://docs.databricks.com/api/workspace/pipelines/create). For information about pipelines, see [link](https://docs.databricks.com/dlt/index.html). For a tutorial that uses the Databricks Asset Bundles template to create a pipeline, see [link](https://docs.databricks.com/dev-tools/bundles/pipelines-tutorial.html)." + "markdownDescription": "The pipeline resource allows you to create Delta Live Tables [pipelines](https://docs.databricks.com/api/workspace/pipelines/create). For information about pipelines, see [link](https://docs.databricks.com/dlt/index.html). For a tutorial that uses the Declarative Automation Bundles template to create a pipeline, see [link](https://docs.databricks.com/dev-tools/bundles/pipelines-tutorial.html)." }, "resources.PipelinePermission": { "type": "object", @@ -1943,7 +1943,7 @@ "name", "schema_name" ], - "markdownDescription": "The volume resource type allows you to define and create Unity Catalog [volumes](https://docs.databricks.com/api/workspace/volumes/create) as part of a bundle. When deploying a bundle with a volume defined, note that:\n\n- A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Databricks Asset Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments.\n\n- Volumes in the bundle are not prepended with the `dev_${workspace.current_user.short_name}` prefix when the deployment target has `mode: development` configured. However, you can manually configure this prefix. See [custom-presets](https://docs.databricks.com/dev-tools/bundles/deployment-modes.html#custom-presets)." + "markdownDescription": "The volume resource type allows you to define and create Unity Catalog [volumes](https://docs.databricks.com/api/workspace/volumes/create) as part of a bundle. When deploying a bundle with a volume defined, note that:\n\n- A volume cannot be referenced in the `artifact_path` for the bundle until it exists in the workspace. Hence, if you want to use Declarative Automation Bundles to create the volume, you must first define the volume in the bundle, deploy it to create the volume, then reference it in the `artifact_path` in subsequent deployments.\n\n- Volumes in the bundle are not prepended with the `dev_${workspace.current_user.short_name}` prefix when the deployment target has `mode: development` configured. However, you can manually configure this prefix. See [custom-presets](https://docs.databricks.com/dev-tools/bundles/deployment-modes.html#custom-presets)." }, "variable.Lookup": { "type": "object", @@ -9381,13 +9381,13 @@ "resources": { "description": "A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource.", "$ref": "#/$defs/github.com/databricks/cli/bundle/config.Resources", - "markdownDescription": "A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Databricks Asset Bundles supported resources, and resource definition reference, see [link](https://docs.databricks.com/dev-tools/bundles/resources.html).\n\n```yaml\nresources:\n \u003cresource-type\u003e:\n \u003cresource-name\u003e:\n \u003cresource-field-name\u003e: \u003cresource-field-value\u003e\n```", + "markdownDescription": "A Map that defines the resources for the bundle, where each key is the name of the resource, and the value is a Map that defines the resource. For more information about Declarative Automation Bundles supported resources, and resource definition reference, see [link](https://docs.databricks.com/dev-tools/bundles/resources.html).\n\n```yaml\nresources:\n \u003cresource-type\u003e:\n \u003cresource-name\u003e:\n \u003cresource-field-name\u003e: \u003cresource-field-value\u003e\n```", "x-since-version": "v0.229.0" }, "run_as": { - "description": "The identity to use when running Databricks Asset Bundles workflows.", + "description": "The identity to use when running Declarative Automation Bundles workflows.", "$ref": "#/$defs/github.com/databricks/databricks-sdk-go/service/jobs.JobRunAs", - "markdownDescription": "The identity to use when running Databricks Asset Bundles workflows. See [link](https://docs.databricks.com/dev-tools/bundles/run-as.html).", + "markdownDescription": "The identity to use when running Declarative Automation Bundles workflows. See [link](https://docs.databricks.com/dev-tools/bundles/run-as.html).", "x-since-version": "v0.229.0" }, "scripts": { diff --git a/cmd/bundle/bundle.go b/cmd/bundle/bundle.go index e6ecae4d9af..3f4985c2480 100644 --- a/cmd/bundle/bundle.go +++ b/cmd/bundle/bundle.go @@ -8,8 +8,8 @@ import ( func New() *cobra.Command { cmd := &cobra.Command{ Use: "bundle", - Short: "Databricks Asset Bundles let you express data/AI/analytics projects as code.", - Long: `Databricks Asset Bundles let you express data/AI/analytics projects as code. + Short: "Declarative Automation Bundles let you express data/AI/analytics projects as code.", + Long: `Declarative Automation Bundles let you express data/AI/analytics projects as code. Common workflows: databricks bundle init default-python # Initialize new project diff --git a/cmd/bundle/generate/dashboard.go b/cmd/bundle/generate/dashboard.go index 8b95e63ee6a..77fc5d207af 100644 --- a/cmd/bundle/generate/dashboard.go +++ b/cmd/bundle/generate/dashboard.go @@ -96,7 +96,7 @@ func (d *dashboard) resolveFromPath(ctx context.Context, b *bundle.Bundle) strin Severity: diag.Error, Summary: fmt.Sprintf("dashboard %q is a legacy dashboard", path.Base(d.existingPath)), Detail: "" + - "Databricks Asset Bundles work exclusively with AI/BI dashboards.\n" + + "Declarative Automation Bundles work exclusively with AI/BI dashboards.\n" + "\n" + "Instructions on how to convert a legacy dashboard to an AI/BI dashboard\n" + "can be found at: https://docs.databricks.com/en/dashboards/clone-legacy-to-aibi.html.", diff --git a/docs/direct.md b/docs/direct.md index 857a186d11e..1b3fdb801ff 100644 --- a/docs/direct.md +++ b/docs/direct.md @@ -5,13 +5,13 @@ Known issues: https://github.com/databricks/cli/issues?q=state%3Aopen%20label%3A ## Reporting bugs -Click "new issue" on [https://github.com/databricks/cli/issues](https://github.com/databricks/cli/issues) and select "Bug report for Databricks Asset Bundles with direct deployment engine". +Click "new issue" on [https://github.com/databricks/cli/issues](https://github.com/databricks/cli/issues) and select "Bug report for Declarative Automation Bundles with direct deployment engine". Please ensure you are on the latest version of CLI when reporting an issue. ## Background -Databricks Asset Bundles were originally implemented on top of databricks-terraform-provider. +Declarative Automation Bundles were originally implemented on top of databricks-terraform-provider. Since version 0.279.0 DABs support two different deployment engines: "terraform" and "direct". The latter does not make use of Terraform. It is intended to be a drop-in replacement and will become the only engine we support in 2026\. diff --git a/libs/template/templates/dbt-sql/README.md b/libs/template/templates/dbt-sql/README.md index 4ccacab10ba..0ddce68ed38 100644 --- a/libs/template/templates/dbt-sql/README.md +++ b/libs/template/templates/dbt-sql/README.md @@ -1,9 +1,9 @@ # dbt template -This folder provides a template for using dbt-core with Databricks Asset Bundles. -It leverages dbt-core for local development and relies on Databricks Asset Bundles +This folder provides a template for using dbt-core with Declarative Automation Bundles. +It leverages dbt-core for local development and relies on Declarative Automation Bundles for deployment (either manually or with CI/CD). In production, dbt is executed using Databricks Workflows. * Learn more about the dbt and its standard project structure here: https://docs.getdbt.com/docs/build/projects. -* Learn more about Databricks Asset Bundles here: https://docs.databricks.com/en/dev-tools/bundles/index.html +* Learn more about Declarative Automation Bundles here: https://docs.databricks.com/en/dev-tools/bundles/index.html diff --git a/libs/template/templates/dbt-sql/databricks_template_schema.json b/libs/template/templates/dbt-sql/databricks_template_schema.json index a4b2cd879ea..c8212bdb1c2 100644 --- a/libs/template/templates/dbt-sql/databricks_template_schema.json +++ b/libs/template/templates/dbt-sql/databricks_template_schema.json @@ -1,5 +1,5 @@ { - "welcome_message": "\nWelcome to the dbt template for Databricks Asset Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", + "welcome_message": "\nWelcome to the dbt template for Declarative Automation Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", "properties": { "project_name": { "type": "string", diff --git a/libs/template/templates/dbt-sql/template/{{.project_name}}/README.md.tmpl b/libs/template/templates/dbt-sql/template/{{.project_name}}/README.md.tmpl index 1b40e4f3df0..683bde99cc4 100644 --- a/libs/template/templates/dbt-sql/template/{{.project_name}}/README.md.tmpl +++ b/libs/template/templates/dbt-sql/template/{{.project_name}}/README.md.tmpl @@ -1,15 +1,15 @@ # {{.project_name}} The '{{.project_name}}' project was generated by using the dbt template for -Databricks Asset Bundles. It follows the standard dbt project structure +Declarative Automation Bundles. It follows the standard dbt project structure and has an additional `resources` directory to define Databricks resources such as jobs that run dbt models. * Learn more about dbt and its standard project structure here: https://docs.getdbt.com/docs/build/projects. -* Learn more about Databricks Asset Bundles here: https://docs.databricks.com/en/dev-tools/bundles/index.html +* Learn more about Declarative Automation Bundles here: https://docs.databricks.com/en/dev-tools/bundles/index.html The remainder of this file includes instructions for local development (using dbt) -and deployment to production (using Databricks Asset Bundles). +and deployment to production (using Declarative Automation Bundles). ## Development setup @@ -99,9 +99,9 @@ Or you can use CI/CD to automate deployment. See https://docs.databricks.com/dev-tools/bundles/ci-cd.html for documentation on CI/CD setup. -## Manually deploying to Databricks with Databricks Asset Bundles +## Manually deploying to Databricks with Declarative Automation Bundles -Databricks Asset Bundles can be used to deploy to Databricks and to execute +Declarative Automation Bundles can be used to deploy to Databricks and to execute dbt commands as a job using Databricks Workflows. See https://docs.databricks.com/dev-tools/bundles/index.html to learn more. diff --git a/libs/template/templates/dbt-sql/template/{{.project_name}}/databricks.yml.tmpl b/libs/template/templates/dbt-sql/template/{{.project_name}}/databricks.yml.tmpl index d991c06ffec..89e66ef929c 100644 --- a/libs/template/templates/dbt-sql/template/{{.project_name}}/databricks.yml.tmpl +++ b/libs/template/templates/dbt-sql/template/{{.project_name}}/databricks.yml.tmpl @@ -1,5 +1,5 @@ # This file defines the structure of this project and how it is deployed -# to production using Databricks Asset Bundles. +# to production using Declarative Automation Bundles. # See https://docs.databricks.com/dev-tools/bundles/index.html for documentation. bundle: name: {{.project_name}} diff --git a/libs/template/templates/default-python/databricks_template_schema.json b/libs/template/templates/default-python/databricks_template_schema.json index d1c716ea24a..9099ceb4d89 100644 --- a/libs/template/templates/default-python/databricks_template_schema.json +++ b/libs/template/templates/default-python/databricks_template_schema.json @@ -1,6 +1,6 @@ { "template_dir": "../default", - "welcome_message": "Welcome to the default Python template for Databricks Asset Bundles!\n\nAnswer the following questions to customize your project.\nYou can always change your configuration in the databricks.yml file later.\n\nNote that {{workspace_host}} is used for initialization.\n(For information on how to change your profile, see https://docs.databricks.com/dev-tools/cli/profiles.html.)", + "welcome_message": "Welcome to the default Python template for Declarative Automation Bundles!\n\nAnswer the following questions to customize your project.\nYou can always change your configuration in the databricks.yml file later.\n\nNote that {{workspace_host}} is used for initialization.\n(For information on how to change your profile, see https://docs.databricks.com/dev-tools/cli/profiles.html.)", "properties": { "template_name": { "//": "This property is always set to 'default-python'", diff --git a/libs/template/templates/default-scala/README.md b/libs/template/templates/default-scala/README.md index 4538fb17e01..471e5d6d2ba 100644 --- a/libs/template/templates/default-scala/README.md +++ b/libs/template/templates/default-scala/README.md @@ -1,6 +1,6 @@ # default-scala -This template helps you create Scala projects with Databricks Asset Bundles. It uses sbt to compile and package Scala files, and can be used with Databricks Connect for local development. +This template helps you create Scala projects with Declarative Automation Bundles. It uses sbt to compile and package Scala files, and can be used with Databricks Connect for local development. It supports two compute types: standard clusters and serverless compute. diff --git a/libs/template/templates/default-scala/databricks_template_schema.json b/libs/template/templates/default-scala/databricks_template_schema.json index 3829ea97b75..ef46d2d0fa2 100644 --- a/libs/template/templates/default-scala/databricks_template_schema.json +++ b/libs/template/templates/default-scala/databricks_template_schema.json @@ -1,5 +1,5 @@ { - "welcome_message": "\nWelcome to the default-scala template for Databricks Asset Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", + "welcome_message": "\nWelcome to the default-scala template for Declarative Automation Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", "properties": { "project_name": { "type": "string", diff --git a/libs/template/templates/default-scala/template/{{.project_name}}/README.md.tmpl b/libs/template/templates/default-scala/template/{{.project_name}}/README.md.tmpl index 3d4792ed985..cc4be2586ce 100644 --- a/libs/template/templates/default-scala/template/{{.project_name}}/README.md.tmpl +++ b/libs/template/templates/default-scala/template/{{.project_name}}/README.md.tmpl @@ -36,7 +36,7 @@ The '{{.project_name}}' project was generated by using the default-scala templat 6. Optionally, install developer tools such as the Databricks extension for Visual Studio Code from https://docs.databricks.com/dev-tools/vscode-ext.html. -7. For documentation on the Databricks Asset Bundles format used +7. For documentation on the Declarative Automation Bundles format used for this project, and for CI/CD configuration, see https://docs.databricks.com/dev-tools/bundles/index.html. diff --git a/libs/template/templates/default-scala/template/{{.project_name}}/resources/.gitkeep b/libs/template/templates/default-scala/template/{{.project_name}}/resources/.gitkeep index c6f742a7181..5b0d6b6f74b 100644 --- a/libs/template/templates/default-scala/template/{{.project_name}}/resources/.gitkeep +++ b/libs/template/templates/default-scala/template/{{.project_name}}/resources/.gitkeep @@ -1,2 +1,2 @@ -This folder is reserved for Databricks Asset Bundles resource definitions. +This folder is reserved for Declarative Automation Bundles resource definitions. diff --git a/libs/template/templates/default-sql/README.md b/libs/template/templates/default-sql/README.md index 6b7140f07d4..d43ffbd5273 100644 --- a/libs/template/templates/default-sql/README.md +++ b/libs/template/templates/default-sql/README.md @@ -1,3 +1,3 @@ # sql template -This folder provides a template for using SQL with Databricks Asset Bundles. +This folder provides a template for using SQL with Declarative Automation Bundles. diff --git a/libs/template/templates/default-sql/databricks_template_schema.json b/libs/template/templates/default-sql/databricks_template_schema.json index b1a797b6c61..35a7b972d30 100644 --- a/libs/template/templates/default-sql/databricks_template_schema.json +++ b/libs/template/templates/default-sql/databricks_template_schema.json @@ -1,5 +1,5 @@ { - "welcome_message": "\nWelcome to the default SQL template for Databricks Asset Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", + "welcome_message": "\nWelcome to the default SQL template for Declarative Automation Bundles!\n\nA workspace was selected based on your current profile. For information about how to change this, see https://docs.databricks.com/dev-tools/cli/profiles.html.\nworkspace_host: {{workspace_host}}", "properties": { "project_name": { "type": "string", diff --git a/libs/template/templates/default-sql/template/{{.project_name}}/README.md.tmpl b/libs/template/templates/default-sql/template/{{.project_name}}/README.md.tmpl index 866e2a41abc..1377874bf79 100644 --- a/libs/template/templates/default-sql/template/{{.project_name}}/README.md.tmpl +++ b/libs/template/templates/default-sql/template/{{.project_name}}/README.md.tmpl @@ -36,7 +36,7 @@ The '{{.project_name}}' project was generated by using the default-sql template. 6. Optionally, install developer tools such as the Databricks extension for Visual Studio Code from https://docs.databricks.com/dev-tools/vscode-ext.html. -7. For documentation on the Databricks Asset Bundles format used +7. For documentation on the Declarative Automation Bundles format used for this project, and for CI/CD configuration, see https://docs.databricks.com/dev-tools/bundles/index.html. diff --git a/libs/template/templates/experimental-jobs-as-code/databricks_template_schema.json b/libs/template/templates/experimental-jobs-as-code/databricks_template_schema.json index 2f2a5d211e3..574ce59259b 100644 --- a/libs/template/templates/experimental-jobs-as-code/databricks_template_schema.json +++ b/libs/template/templates/experimental-jobs-as-code/databricks_template_schema.json @@ -1,5 +1,5 @@ { - "welcome_message": "\nWelcome to (EXPERIMENTAL) \"Jobs as code\" template for Databricks Asset Bundles!", + "welcome_message": "\nWelcome to (EXPERIMENTAL) \"Jobs as code\" template for Declarative Automation Bundles!", "properties": { "project_name": { "type": "string", diff --git a/libs/template/templates/experimental-jobs-as-code/template/{{.project_name}}/README.md.tmpl b/libs/template/templates/experimental-jobs-as-code/template/{{.project_name}}/README.md.tmpl index 497ce37238b..37e7040846f 100644 --- a/libs/template/templates/experimental-jobs-as-code/template/{{.project_name}}/README.md.tmpl +++ b/libs/template/templates/experimental-jobs-as-code/template/{{.project_name}}/README.md.tmpl @@ -21,7 +21,7 @@ The '{{.project_name}}' project was generated by using the "Jobs as code" templa **Databricks Connect** for instructions on running the included Python code from a different IDE. {{- end}} -5. For documentation on the Databricks Asset Bundles format used +5. For documentation on the Declarative Automation Bundles format used for this project, and for CI/CD configuration, see https://docs.databricks.com/dev-tools/bundles/index.html. diff --git a/libs/template/templates/pydabs/databricks_template_schema.json b/libs/template/templates/pydabs/databricks_template_schema.json index 21260ef958e..7ab9b8c4085 100644 --- a/libs/template/templates/pydabs/databricks_template_schema.json +++ b/libs/template/templates/pydabs/databricks_template_schema.json @@ -1,6 +1,6 @@ { "template_dir": "../default", - "welcome_message": "Welcome to PyDABs template for Databricks Asset Bundles!\n\nAnswer the following questions to customize your project.\nYou can always change your configuration in the databricks.yml file later.\n\nNote that {{workspace_host}} is used for initialization.\n(For information on how to change your profile, see https://docs.databricks.com/dev-tools/cli/profiles.html.)", + "welcome_message": "Welcome to PyDABs template for Declarative Automation Bundles!\n\nAnswer the following questions to customize your project.\nYou can always change your configuration in the databricks.yml file later.\n\nNote that {{workspace_host}} is used for initialization.\n(For information on how to change your profile, see https://docs.databricks.com/dev-tools/cli/profiles.html.)", "properties": { "template_name": { "//": "This property is always set to 'PyDABs'", diff --git a/python/README.md b/python/README.md index d73b84110ec..791752f2e10 100644 --- a/python/README.md +++ b/python/README.md @@ -1,6 +1,6 @@ # databricks-bundles -Python for Databricks Asset Bundles extends [Databricks Asset Bundles](https://docs.databricks.com/aws/en/dev-tools/bundles/) so that you can: +Python for Declarative Automation Bundles extends [Declarative Automation Bundles](https://docs.databricks.com/aws/en/dev-tools/bundles/) so that you can: - Define jobs and pipelines as Python code. These jobs can coexist with jobs defined in YAML. - Dynamically create jobs and pipelines using metadata. - Modify jobs and pipelines defined in YAML or Python during bundle deployment. diff --git a/python/databricks/bundles/core/_variable.py b/python/databricks/bundles/core/_variable.py index 81e3841f2ed..e5aa0782258 100644 --- a/python/databricks/bundles/core/_variable.py +++ b/python/databricks/bundles/core/_variable.py @@ -25,7 +25,7 @@ class Variable(Generic[_T]): """ Reference to a bundle variable. - See: `Databricks Asset Bundles configuration `_ + See: `Declarative Automation Bundles configuration `_ """ path: str diff --git a/python/docs/conf.py b/python/docs/conf.py index 3422b6a3ad1..4559d39b23b 100644 --- a/python/docs/conf.py +++ b/python/docs/conf.py @@ -44,7 +44,7 @@ "logo": "databricks-logo.svg", "github_user": "databricks", "github_repo": "databricks-bundles", - "description": "databricks-bundles: Python support for Databricks Asset Bundles", + "description": "databricks-bundles: Python support for Declarative Automation Bundles", "fixed_sidebar": "true", "logo_text_align": "center", "github_button": "true", diff --git a/python/docs/index.rst b/python/docs/index.rst index 0ecdd689ffe..96eada6fdd4 100644 --- a/python/docs/index.rst +++ b/python/docs/index.rst @@ -1,9 +1,9 @@ databricks-bundles -------------------------------- -`databricks-bundles` package implements Python support for Databricks Asset Bundles. +`databricks-bundles` package implements Python support for Declarative Automation Bundles. -See `What is Python support for Databricks Asset Bundles? (TBD) <#>`_. +See `What is Python support for Declarative Automation Bundles? (TBD) <#>`_. .. toctree:: diff --git a/python/pyproject.toml b/python/pyproject.toml index 056cb1e9ea8..40318b7c2dc 100644 --- a/python/pyproject.toml +++ b/python/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "databricks-bundles" -description = "Python support for Databricks Asset Bundles" +description = "Python support for Declarative Automation Bundles" version = "0.294.0" authors = [