Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/dabs-issue.md
Original file line number Diff line number Diff line change
@@ -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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: Perhaps we could use DABs acronym more instead?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, agree. Let's do this in a separate PR where we take a look at each of these individually.

about: Use this to report an issue with Declarative Automation Bundles.
labels: DABs
title: ''
---
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/direct-issue.md
Original file line number Diff line number Diff line change
@@ -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: ''
---
Expand Down
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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)
Expand Down Expand Up @@ -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",
Expand Down
1 change: 1 addition & 0 deletions NEXT_CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion acceptance/bundle/help/bundle/output.txt
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion acceptance/bundle/migrate/default-python/output.txt
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 1 addition & 1 deletion acceptance/bundle/templates/dbt-sql/output.txt
Original file line number Diff line number Diff line change
@@ -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]
Expand Down
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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.

Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 1 addition & 1 deletion acceptance/bundle/templates/default-scala/output.txt
Original file line number Diff line number Diff line change
@@ -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]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@

This folder is reserved for Databricks Asset Bundles resource definitions.
This folder is reserved for Declarative Automation Bundles resource definitions.
2 changes: 1 addition & 1 deletion acceptance/bundle/templates/default-sql/output.txt
Original file line number Diff line number Diff line change
@@ -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]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Original file line number Diff line number Diff line change
@@ -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!
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion acceptance/bundle/templates/telemetry/dbt-sql/output.txt
Original file line number Diff line number Diff line change
@@ -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]
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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]
Expand Down
2 changes: 1 addition & 1 deletion acceptance/help/output.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion bundle/bundle.go
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 1 addition & 1 deletion bundle/direct/dresources/resources.yml
Original file line number Diff line number Diff line change
@@ -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:
Expand Down
4 changes: 2 additions & 2 deletions bundle/docsgen/output/reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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).



Expand Down
Loading
Loading