Skip to content

Update product names: Workflows→Jobs, Delta Live Tables→Spark Declarative Pipelines#4967

Merged
lennartkats-db merged 19 commits intomainfrom
product-name-changes
Apr 17, 2026
Merged

Update product names: Workflows→Jobs, Delta Live Tables→Spark Declarative Pipelines#4967
lennartkats-db merged 19 commits intomainfrom
product-name-changes

Conversation

@lennartkats-db
Copy link
Copy Markdown
Contributor

Changes

  • Rename "Databricks Workflows" / "Workflows" → "Databricks Jobs" / "Jobs" in CLI help text and templates
  • Rename "Delta Live Tables" → "Spark Declarative Pipelines" and "DLT" → "SDP" in descriptions, comments, and schema annotations
  • Rename template parameter include_dltinclude_sdp and file dlt_pipeline.ipynbsdp_pipeline.ipynb in experimental-jobs-as-code template

lennartkats-db and others added 7 commits April 14, 2026 12:12
…tive Pipelines

Update all non-generated references to retired product names:
- "Databricks Workflows" / "Workflows" → "Databricks Jobs" / "Jobs"
- "Delta Live Tables" → "Spark Declarative Pipelines"
- "DLT" → "SDP" (in comments/internal code)
- Template parameter `include_dlt` → `include_sdp`
- Template file `dlt_pipeline.ipynb` → `sdp_pipeline.ipynb`

Generated files (schema JSON, docsgen, acceptance test outputs, Python
models) are not updated here — regenerate with `make schema`, `make docs`,
`make test-update`, `make test-update-templates`, `make -C python codegen`
after the upstream proto changes land.

Co-authored-by: Isaac
With include_pipeline properly wired (was silently ignored as include_dlt),
PIPELINE=no now excludes the pipeline resource. With only a job resource,
dynamic_version causes 1 change and 0 unchanged, which is correct behavior.

Co-authored-by: Isaac
The template renamed include_dlt to include_pipeline in a prior PR, but
the combinations test intentionally still passes include_dlt (which gets
silently ignored, defaulting to yes). Renaming to include_pipeline makes
PIPELINE=no actually exclude pipelines, causing divergent output across
variants which the combinations framework doesn't support.

Co-authored-by: Isaac
The output was corrupted when running tests locally without terraform,
replacing the successful deployment output with terraform init errors.
Restores correct output from main and applies DLT→SDP string change.

Co-authored-by: Isaac
@lennartkats-db lennartkats-db changed the title [draft] Update product names: Workflows→Jobs, Delta Live Tables→Spark Declarative Pipelines Update product names: Workflows→Jobs, Delta Live Tables→Spark Declarative Pipelines Apr 15, 2026
@lennartkats-db lennartkats-db requested a review from denik April 15, 2026 08:13
Copy link
Copy Markdown
Member

@simonfaltum simonfaltum left a comment

Choose a reason for hiding this comment

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

Review swarm: Isaac + Cursor (1 round, Cursor timed out)

0 Critical | 1 Major (Gap) | 1 Nit | 1 Suggestion

The rename changes look correct across the board. A few things worth addressing before merge, the main one being that jsonschema.json appears to be manually edited rather than regenerated from the source annotations. There are also a couple of downstream generated files (jsonschema_for_docs.json, docsgen/output/reference.md, docsgen/output/resources.md) that still contain the old product names.

See inline comments for specifics.

Comment thread bundle/schema/jsonschema.json Outdated
Comment thread bundle/internal/schema/annotations_openapi_overrides.yml Outdated
Comment thread bundle/phases/deploy.go Outdated
…stroy.go

Address review feedback: drop "SDP" from comment since the variable
name already says "pipeline", and rename the missed dltActions variable.

Co-authored-by: Isaac
Address review feedback: edit annotations source files and regenerate
via make schema/schema-for-docs/docs instead of manually editing
generated files. Also picks up other schema changes from the codebase.

Co-authored-by: Isaac
Copy link
Copy Markdown
Collaborator

@juliacrawf-db juliacrawf-db left a comment

Choose a reason for hiding this comment

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

Similar to the comments I made on the DABs rename PR, from Dylan Vance:

  • In general, it's safer to say "Lakeflow Spark Declarative Pipelines" than just "Spark Declarative Pipelines", to avoid confusion.
  • The name of the feature is "Spark Declarative Pipelines". The resource that it creates is a "pipeline". Do not use "Spark Declarative Pipeline" or "Lakeflow Spark Declarative Pipeline", as this isn't a thing.
    It's very similar to DABs creating a bundle.

Comment thread acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/README.md Outdated
Comment thread acceptance/bundle/templates/default-scala/output/my_default_scala/README.md Outdated
Comment thread acceptance/bundle/templates/default-sql/output/my_default_sql/README.md Outdated
Comment thread libs/template/templates/dbt-sql/template/{{.project_name}}/README.md.tmpl Outdated
Comment thread libs/template/templates/default-scala/template/{{.project_name}}/README.md.tmpl Outdated
Comment thread libs/template/templates/default-sql/template/{{.project_name}}/README.md.tmpl Outdated
lennartkats-db and others added 8 commits April 17, 2026 12:22
- Use "Jobs & Pipelines" for UI navigation references in template READMEs
- Remove singular "Spark Declarative Pipeline" — feature name is always plural
- Use just "pipeline" when referring to the resource, not the product
- Regenerate template outputs and help text

Co-authored-by: Isaac
Co-authored-by: Julia Crawford (Databricks) <julia.crawford@databricks.com>
Per Julia's review: prefer "Lakeflow Spark Declarative Pipelines" over
bare "Spark Declarative Pipelines" to avoid confusion.

Co-authored-by: Isaac
- Change "stub (sample) pipeline" to "stub (sample) ETL pipeline"
- Regenerate acceptance tests for Lakeflow prefix in run_as warning

Co-authored-by: Isaac
This template is hidden/unlisted — renaming properties would break
existing users without benefit.

Co-authored-by: Isaac
…ct name

- run_as warning: "pipelines in your DABs project" instead of product name
- Pipeline resource description: "create pipelines" instead of product name
- Regenerate schema, docs, and acceptance test outputs

Co-authored-by: Isaac
@lennartkats-db lennartkats-db added this pull request to the merge queue Apr 17, 2026
Merged via the queue into main with commit 39573ae Apr 17, 2026
22 checks passed
@lennartkats-db lennartkats-db deleted the product-name-changes branch April 17, 2026 12:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants