Rename Delta Live Tables to Lakeflow Declarative Pipelines in the default-python template (#3476)

shreyas-goenka · web-flow · commit 54932e4cf519 · 2025-08-25T14:03:43.000Z
## Tests

Covered by exiting tests. Also manually verified that the new template
is initialized and deployed correctly.
diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md
@@ -16,5 +16,6 @@ See more details here: ([#3225](https://github.com/databricks/cli/pull/3225))
 
 ### Bundles
 * [Breaking Change] Remove deprecated path fallback mechanism for jobs and pipelines ([#3225](https://github.com/databricks/cli/pull/3225))
+* Rename Delta Live Tables to Lakeflow Declarative Pipelines in the default-python template ([#3476](https://github.com/databricks/cli/pull/3476)).
 
 ### API Changes
diff --git a/acceptance/bundle/deploy/pipeline/recreate/databricks.yml.tmpl b/acceptance/bundle/deploy/pipeline/recreate/databricks.yml.tmpl
@@ -6,7 +6,7 @@ workspace:
 
 variables:
   catalog:
-    description: The catalog the DLT pipeline should use.
+    description: The catalog the Lakeflow Declarative Pipeline should use.
     default: main
 
 resources:
diff --git a/acceptance/bundle/help/bundle-init/output.txt b/acceptance/bundle/help/bundle-init/output.txt
@@ -3,7 +3,7 @@
 Initialize using a bundle template to get started quickly.
 
 TEMPLATE_PATH optionally specifies which template to use. It can be one of the following:
-- default-python: The default Python template for Notebooks / Delta Live Tables / Workflows
+- default-python: The default Python template for Notebooks / Lakeflow Declarative Pipelines / Workflows
 - default-sql: The default SQL template for .sql files that run with Databricks SQL
 - dbt-sql: The dbt SQL template (databricks.com/blog/delivering-cost-effective-data-real-time-dbt-and-databricks)
 - mlops-stacks: The Databricks MLOps Stacks template (github.com/databricks/mlops-stacks)
diff --git a/acceptance/bundle/templates/default-python/classic/output/my_default_python/pyproject.toml b/acceptance/bundle/templates/default-python/classic/output/my_default_python/pyproject.toml
@@ -8,7 +8,7 @@ requires-python = ">= 3.11"
 dev = [
     "pytest",
 
-    # Code completion support for DLT, also install databricks-connect
+    # Code completion support for Lakeflow Declarative Pipelines, also install databricks-connect
     "databricks-dlt",
 
     # databricks-connect can be used to run parts of this project locally.
diff --git a/acceptance/bundle/templates/default-python/classic/output/my_default_python/resources/my_default_python.pipeline.yml b/acceptance/bundle/templates/default-python/classic/output/my_default_python/resources/my_default_python.pipeline.yml
@@ -8,7 +8,7 @@ resources:
       schema: my_default_python_${bundle.target}
       libraries:
         - notebook:
-            path: ../src/dlt_pipeline.ipynb
+            path: ../src/pipeline.ipynb
 
       configuration:
         bundle.sourcePath: ${workspace.file_path}/src
diff --git a/acceptance/bundle/templates/default-python/classic/output/my_default_python/src/pipeline.ipynb b/acceptance/bundle/templates/default-python/classic/output/my_default_python/src/pipeline.ipynb
@@ -12,9 +12,9 @@
     }
    },
    "source": [
-    "# DLT pipeline\n",
+    "# Lakeflow Declarative Pipeline\n",
     "\n",
-    "This Delta Live Tables (DLT) definition is executed using a pipeline defined in resources/my_default_python.pipeline.yml."
+    "This Lakeflow Declarative Pipeline (LDP) definition is executed using a pipeline defined in resources/my_default_python.pipeline.yml."
    ]
   },
   {
@@ -72,7 +72,7 @@
    "notebookMetadata": {
     "pythonIndentUnit": 2
    },
-   "notebookName": "dlt_pipeline",
+   "notebookName": "pipeline",
    "widgets": {}
   },
   "kernelspec": {
diff --git a/acceptance/bundle/templates/default-python/integration_classic/out.validate.dev.json b/acceptance/bundle/templates/default-python/integration_classic/out.validate.dev.json
@@ -137,7 +137,7 @@
         "libraries": [
           {
             "notebook": {
-              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/dlt_pipeline"
+              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/pipeline"
             }
           }
         ],
diff --git a/acceptance/bundle/templates/default-python/integration_classic/output.txt b/acceptance/bundle/templates/default-python/integration_classic/output.txt
@@ -211,8 +211,8 @@ Validation OK!
          "libraries": [
            {
              "notebook": {
--              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/dlt_pipeline"
-+              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/dlt_pipeline"
+-              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/pipeline"
++              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/pipeline"
              }
            }
          ],
@@ -373,8 +373,8 @@ Resources:
 @@ -141,14 +127,11 @@
            {
              "notebook": {
--              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/dlt_pipeline"
-+              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/dlt_pipeline"
+-              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/pipeline"
++              "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/pipeline"
              }
            }
          ],
diff --git a/acceptance/bundle/templates/default-python/serverless/output/my_default_python/pyproject.toml b/acceptance/bundle/templates/default-python/serverless/output/my_default_python/pyproject.toml
@@ -8,7 +8,7 @@ requires-python = ">= 3.11"
 dev = [
     "pytest",
 
-    # Code completion support for DLT, also install databricks-connect
+    # Code completion support for Lakeflow Declarative Pipelines, also install databricks-connect
     "databricks-dlt",
 
     # databricks-connect can be used to run parts of this project locally.
diff --git a/acceptance/bundle/templates/default-python/serverless/output/my_default_python/resources/my_default_python.pipeline.yml b/acceptance/bundle/templates/default-python/serverless/output/my_default_python/resources/my_default_python.pipeline.yml
@@ -9,7 +9,7 @@ resources:
       serverless: true
       libraries:
         - notebook:
-            path: ../src/dlt_pipeline.ipynb
+            path: ../src/pipeline.ipynb
 
       configuration:
         bundle.sourcePath: ${workspace.file_path}/src
diff --git a/acceptance/bundle/templates/default-python/serverless/output/my_default_python/src/pipeline.ipynb b/acceptance/bundle/templates/default-python/serverless/output/my_default_python/src/pipeline.ipynb
@@ -12,9 +12,9 @@
     }
    },
    "source": [
-    "# DLT pipeline\n",
+    "# Lakeflow Declarative Pipeline\n",
     "\n",
-    "This Delta Live Tables (DLT) definition is executed using a pipeline defined in resources/my_default_python.pipeline.yml."
+    "This Lakeflow Declarative Pipeline (LDP) definition is executed using a pipeline defined in resources/my_default_python.pipeline.yml."
    ]
   },
   {
@@ -72,7 +72,7 @@
    "notebookMetadata": {
     "pythonIndentUnit": 2
    },
-   "notebookName": "dlt_pipeline",
+   "notebookName": "pipeline",
    "widgets": {}
   },
   "kernelspec": {
diff --git a/acceptance/bundle/templates/experimental-jobs-as-code/output/my_jobs_as_code/src/dlt_pipeline.ipynb b/acceptance/bundle/templates/experimental-jobs-as-code/output/my_jobs_as_code/src/dlt_pipeline.ipynb
@@ -14,7 +14,7 @@
    "source": [
     "# DLT pipeline\n",
     "\n",
-    "This Delta Live Tables (DLT) definition is executed using a pipeline defined in resources/my_jobs_as_code.pipeline.yml."
+    "This Lakeflow Declarative Pipeline (LDP) definition is executed using a pipeline defined in resources/my_jobs_as_code.pipeline.yml."
    ]
   },
   {
diff --git a/libs/template/template.go b/libs/template/template.go
@@ -38,7 +38,7 @@ const (
 var databricksTemplates = []Template{
 	{
 		name:        DefaultPython,
-		description: "The default Python template for Notebooks / Delta Live Tables / Workflows",
+		description: "The default Python template for Notebooks / Lakeflow Declarative Pipelines / Workflows",
 		Reader:      &builtinReader{name: string(DefaultPython)},
 		Writer:      &writerWithFullTelemetry{defaultWriter: defaultWriter{name: DefaultPython}},
 	},
diff --git a/libs/template/template_test.go b/libs/template/template_test.go
@@ -8,7 +8,7 @@ import (
 )
 
 func TestTemplateHelpDescriptions(t *testing.T) {
-	expected := `- default-python: The default Python template for Notebooks / Delta Live Tables / Workflows
+	expected := `- default-python: The default Python template for Notebooks / Lakeflow Declarative Pipelines / Workflows
 - default-sql: The default SQL template for .sql files that run with Databricks SQL
 - dbt-sql: The dbt SQL template (databricks.com/blog/delivering-cost-effective-data-real-time-dbt-and-databricks)
 - mlops-stacks: The Databricks MLOps Stacks template (github.com/databricks/mlops-stacks)
@@ -18,7 +18,7 @@ func TestTemplateHelpDescriptions(t *testing.T) {
 
 func TestTemplateOptions(t *testing.T) {
 	expected := []cmdio.Tuple{
-		{Name: "default-python", Id: "The default Python template for Notebooks / Delta Live Tables / Workflows"},
+		{Name: "default-python", Id: "The default Python template for Notebooks / Lakeflow Declarative Pipelines / Workflows"},
 		{Name: "default-sql", Id: "The default SQL template for .sql files that run with Databricks SQL"},
 		{Name: "dbt-sql", Id: "The dbt SQL template (databricks.com/blog/delivering-cost-effective-data-real-time-dbt-and-databricks)"},
 		{Name: "mlops-stacks", Id: "The Databricks MLOps Stacks template (github.com/databricks/mlops-stacks)"},
diff --git a/libs/template/templates/default-python/databricks_template_schema.json b/libs/template/templates/default-python/databricks_template_schema.json
@@ -20,7 +20,7 @@
             "type": "string",
             "default": "yes",
             "enum": ["yes", "no"],
-            "description": "Include a stub (sample) Delta Live Tables pipeline in '{{.project_name}}{{path_separator}}src'",
+            "description": "Include a stub (sample) Lakeflow Declarative Pipeline in '{{.project_name}}{{path_separator}}src'",
             "order": 3
         },
         "include_python": {
diff --git a/libs/template/templates/default-python/template/__preamble.tmpl b/libs/template/templates/default-python/template/__preamble.tmpl
@@ -17,7 +17,7 @@ This file only template directives; it is skipped for the actual output.
 {{end}}
 
 {{if $notDLT}}
-  {{skip "{{.project_name}}/src/dlt_pipeline.ipynb"}}
+  {{skip "{{.project_name}}/src/pipeline.ipynb"}}
   {{skip "{{.project_name}}/resources/{{.project_name}}.pipeline.yml"}}
 {{end}}
 
diff --git a/libs/template/templates/default-python/template/{{.project_name}}/pyproject.toml.tmpl b/libs/template/templates/default-python/template/{{.project_name}}/pyproject.toml.tmpl
@@ -8,7 +8,7 @@ requires-python = ">= 3.11"
 dev = [
     "pytest",
 
-    # Code completion support for DLT, also install databricks-connect
+    # Code completion support for Lakeflow Declarative Pipelines, also install databricks-connect
     "databricks-dlt",
 
     # databricks-connect can be used to run parts of this project locally.
diff --git a/libs/template/templates/default-python/template/{{.project_name}}/resources/{{.project_name}}.job.yml.tmpl b/libs/template/templates/default-python/template/{{.project_name}}/resources/{{.project_name}}.job.yml.tmpl
@@ -1,6 +1,6 @@
 # The main job for {{.project_name}}.
 
-{{- /* Clarify what this job is for for DLT-only users. */}}
+{{- /* Clarify what this job is for Lakeflow Declarative Pipelines only users. */}}
 {{if and (eq .include_dlt "yes") (and (eq .include_notebook "no") (eq .include_python "no")) -}}
 # This job runs {{.project_name}}_pipeline on a schedule.
 {{end -}}
diff --git a/libs/template/templates/default-python/template/{{.project_name}}/resources/{{.project_name}}.pipeline.yml.tmpl b/libs/template/templates/default-python/template/{{.project_name}}/resources/{{.project_name}}.pipeline.yml.tmpl
@@ -19,7 +19,7 @@ resources:
       {{- end}}
       libraries:
         - notebook:
-            path: ../src/dlt_pipeline.ipynb
+            path: ../src/pipeline.ipynb
 
       configuration:
         bundle.sourcePath: ${workspace.file_path}/src
diff --git a/libs/template/templates/default-python/template/{{.project_name}}/src/pipeline.ipynb.tmpl b/libs/template/templates/default-python/template/{{.project_name}}/src/pipeline.ipynb.tmpl
@@ -12,9 +12,9 @@
     }
    },
    "source": [
-    "# DLT pipeline\n",
+    "# Lakeflow Declarative Pipeline\n",
     "\n",
-    "This Delta Live Tables (DLT) definition is executed using a pipeline defined in resources/{{.project_name}}.pipeline.yml."
+    "This Lakeflow Declarative Pipeline (LDP) definition is executed using a pipeline defined in resources/{{.project_name}}.pipeline.yml."
    ]
   },
   {
@@ -86,7 +86,7 @@
    "notebookMetadata": {
     "pythonIndentUnit": 2
    },
-   "notebookName": "dlt_pipeline",
+   "notebookName": "pipeline",
    "widgets": {}
   },
   "kernelspec": {
diff --git a/libs/template/templates/experimental-jobs-as-code/template/{{.project_name}}/src/dlt_pipeline.ipynb.tmpl b/libs/template/templates/experimental-jobs-as-code/template/{{.project_name}}/src/dlt_pipeline.ipynb.tmpl
@@ -14,7 +14,7 @@
    "source": [
     "# DLT pipeline\n",
     "\n",
-    "This Delta Live Tables (DLT) definition is executed using a pipeline defined in resources/{{.project_name}}.pipeline.yml."
+    "This Lakeflow Declarative Pipeline (LDP) definition is executed using a pipeline defined in resources/{{.project_name}}.pipeline.yml."
    ]
   },
   {

Original file line number	Diff line number	Diff line change
`@@ -137,7 +137,7 @@`
`137`	`137`	`"libraries": [`
`138`	`138`	`{`
`139`	`139`	`"notebook": {`
`140`		`- "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/dlt_pipeline"`
	`140`	`+ "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/pipeline"`
`141`	`141`	`}`
`142`	`142`	`}`
`143`	`143`	`],`
Original file line number	Diff line number	Diff line change
`@@ -211,8 +211,8 @@ Validation OK!`
`211`	`211`	`"libraries": [`
`212`	`212`	`{`
`213`	`213`	`"notebook": {`
`214`		`-- "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/dlt_pipeline"`
`215`		`-+ "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/dlt_pipeline"`
	`214`	`+- "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/pipeline"`
	`215`	`++ "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/pipeline"`
`216`	`216`	`}`
`217`	`217`	`}`
`218`	`218`	`],`
`@@ -373,8 +373,8 @@ Resources:`
`373`	`373`	`@@ -141,14 +127,11 @@`
`374`	`374`	`{`
`375`	`375`	`"notebook": {`
`376`		`-- "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/dlt_pipeline"`
`377`		`-+ "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/dlt_pipeline"`
	`376`	`+- "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/dev/files/src/pipeline"`
	`377`	`++ "path": "/Workspace/Users/[USERNAME]/.bundle/project_name_[UNIQUE_NAME]/prod/files/src/pipeline"`
`378`	`378`	`}`
`379`	`379`	`}`
`380`	`380`	`],`