← All updates Databricks Update One-Pager Light version
databricks Platform · Updated Sep 24, 2025

Spark Declarative Pipelines Migration

Migration from legacy publishing mode to default publishing mode is now generally available.

What it does

The migration allows Spark Declarative Pipelines on Lakeflow to transition from a legacy publishing mode, which restricted publishing to a single catalog and schema, to a default publishing mode that supports multiple catalogs and schemas. This new mode simplifies syntax for table and view management within pipelines and is designed to enhance flexibility and usability. The migration process affects only the metadata of the pipeline and does not impact existing datasets.

Why it matters

This update significantly enhances the capabilities of data teams by allowing them to manage multiple catalogs and schemas within a single pipeline, improving operational efficiency and reducing complexity. It enables better data governance and organization, which can lead to increased productivity and reduced costs associated with data management. Organizations can leverage this feature to streamline their data workflows and improve collaboration across teams.

Key capabilities
Multiple Catalogs Support
The default publishing mode allows a single pipeline to publish to multiple catalogs and schemas.
Simplified Syntax
The new mode includes a simplified syntax for managing tables and views within the pipeline.
Backward Compatibility
Most pipelines will not require changes to migrate, ensuring a smoother transition.
Metadata-Only Migration
The migration process only affects the pipeline's metadata without altering any datasets.
Prerequisites
Databricks CLI version v0.230.0 or above is required.
Recommended use cases
Organizations needing to manage multiple data catalogs efficiently.Data teams looking to simplify their pipeline syntax and management.Companies aiming to enhance data governance and compliance.Teams requiring backward compatibility during migration to minimize disruptions.
Limitations · remember
!Migration is not supported using Declarative Automation Bundles.
!Once migrated, pipelines cannot revert to the legacy publishing mode.
!Materialized views and streaming tables cannot be moved across schemas after creation.
Architecture
Lakeflow Pipelines → Default Publishing Mode → Metadata Management → Catalog and Schema Management
Get started
1
Access Pipeline Settings
Click 'Jobs & Pipelines' from the left sidebar and select the pipeline to migrate.
2
Pause Updates
Pause updates and ensure any running pipeline has stopped.
3
Configure Migration
Add the configuration 'pipelines.enableDPMForExistingPipeline' and set it to 'true'.
4
Start Manual Update
Initiate a manual update and allow it to complete.
5
Remove Migration Config
Optionally remove the migration configuration after the update.
Key takeaway
The migration to the default publishing mode enhances flexibility and efficiency for managing Spark Declarative Pipelines.
2025-09-24-a15eb078 Generated by the Databricks Updates Agent · browse all updates