dbt Release Notes

dbt-core 1.12.0-rc2 - July 09, 2026

Breaking Changes

Flags introduced in 1.9 and 1.10 defaults to true (#12713)

Features

Add catalog_database field to CatalogWriteIntegrationConfig (v1) so catalogs.yml can set a database-name override for any catalog type; works in conjunction with the dbt-adapters get_catalog_database_override method to give catalog_database highest priority in generate_database_name (#15156)

Fixes

Reconstruct unrendered config kwarg values as readable expressions instead of raw AST repr (#15336)

Fix partial parsing ghost-duplicate that raised a false "found two data_tests" error by cleaning up disabled generic and singular test nodes on schema re-parse (#)

Contributors

@MichelleArk (#15336)

@aahel (#15156)

@itsnamangoyal (#12713, #)

dbt-core 1.12.0-rc1 - July 07, 2026

Breaking Changes

Remove the experimental dbt login command and the bundled dbt-state plugin (including --manage-state/manage_state and the DBT_ENGINE_STATE_* env vars), reverting PRs (#NA)

Features

Tolerate dbt Fusion-specific warn_error_options names instead of erroring, emitting a note that they are ignored because they are specific to the dbt Fusion engine (#12885)

Fixes

Fix intermittent "references a model that does not exist" parsing error when unit testing versioned models, caused by non-deterministic filesystem parse order (#11139)

Dependencies

Bump the minimum dbt-core-experimental-parser to 2.0.0a3 (#15391)

Bump ca-certificates, libpq-dev, and openssh-client in Docker image to current bullseye versions to fix Docker release build failure caused by superseded package versions (#NA)

Bump the minimum dbt-core-experimental-parser to 2.0.0a4 (#13065)

Contributors

@ajnovice (#12885, #NA)

@itsnamangoyal (#NA, #11139)

@tauhid621 (#15391, #13065)

2.0.0-alpha.4

Released July 06, 2026

Features

• [dbt-fusion] DuckDB: read-write Horizon and Unity (Iceberg REST) catalogs via duckdb 1.5.4 / duckdb-iceberg#1017 write-compat ATTACH options (stage_create_tables, disable_multi_table_commit, etc.). Upgrades the read-only support from the base PR.
• [dbt-fusion] DuckDB catalogs.yml v2: DuckLake, Iceberg REST, and local filesystem catalogs with catalog-aware materializations, plus read-only Horizon and Unity attachments (writes land with duckdb 1.5.4, #10950)
• [dbt-fusion] [Redshift] Switch the database context per node via USE / RESET USE when datasharing is enabled and the node targets a non-default database
• [dbt-fusion] dbt-agent: add guidance for surrogate key dbt_project.yml vars, incremental full-refresh after logic changes, staging enrichment LEFT JOIN, fct-to-dim LEFT JOIN, pre-computed age field warning, and cumulative standings MAX vs ROW_NUMBER
• [dbt-fusion] dbt-agent: add guidance for propagating source column type changes (INT→VARCHAR) to all downstream models
• [dbt-fusion] dbt-agent: add guidance for staging column inference vs source reuse, missing-column add-not-remove, enumerate-all-affected-models, time-bounded seed+JOIN pattern, mandatory full-refresh after surrogate_key rename
• [dbt-fusion] dbt-agent: mandatory --full-refresh after surrogate_key rename prominently in surrogate_key.md
• [dbt-fusion] Extract dbt-agent into dedicated crate with prompts, runner, integration tests, and benchmark scripts
• [fusion] Add GET /api/v1/identity endpoint to dbt-docs-server
• [fusion] Bump bundled dbt-docs-v2 UI to 862e5855aaa42463d3b5c34f4b53622ca32721fb
• [fusion] Add compiled code toggle to the Code tab and consolidate exposure metadata fields into the unified Metadata section
• [fusion] Show row count stat in the model list view

Fixes

• [dbt-fusion] BigQuery: qualify schema name with target project in create_schema and drop_schema so datasets are created in the correct project when execution_project differs from database
• [dbt-fusion] (dbt-auth) SparkConnect auth profiles have clear internal representaiton. To the user view, no "user" is required (but may be provided). An ambient authentication mode which entrusts connections to the networking layer et. al is added."
• [dbt-fusion] Accept comma-separated ref()/source() calls within a single depends_on list item and tolerate a trailing } after a Jinja expression in descriptions, matching dbt-core leniency.
• [dbt-fusion] dbt agent build: surface YAML parse errors via OTEL probe; fix panic on wrapped-negative line numbers in context_snippet; use --write-metadata instead of --write-index
• [dbt-fusion] Fix Databricks incremental run SQL error when using custom PK constraints: correctly expose constraint attributes (type, name, render) to Jinja templates and normalize custom PK expressions for stable incremental diffs
• [fusion] Fix panic when a query result contains a map with non-scalar (struct) values, e.g. map<string,struct<...>>. dbt-agate now has a StructConverter so struct columns render as dicts instead of failing an unsupported Struct->Utf8 cast.
• [fusion] Fix unique_id parity with dbt-core for singular and schema tests
• [fusion] Fix ambiguous ref panic for cross-project publication models when used as v2 parser
• [fusion] Fix operation nodes missing alias, database, schema, tags, config, and index in manifest
• [dbt-core] Fix macro original_file_path prefixed with dbt_packages/ instead of being package-relative (#11381)
• [dbt-core] state:modified no longer flags seeds whose meta config is set as environment-aware Jinja in dbt_project.yml. (#15286)
• [dbt-core] state:modified no longer flags snapshots whose target_schema, target_database, or alias configs are set as environment-aware Jinja in dbt_project.yml. (#15286)
• [fusion] Fix explorer breadcrumbs, layout, and filter view behavior; hide analyses everywhere when the hasAnalysis feature flag is off
• [fusion] Read has_dbt_state from the capabilities API instead of hardcoding false; hide the dbt State upsell for projects that already have dbt state enabled
• [fusion] When warn_error_options upgrades a Jinja exceptions.warn() call to an error, the node message in run_results.json now shows a clean Compilation Error with the warning text, matching dbt-core behavior
• [dbt-index] Redshift warehouse tools now accept 'dbname' field in profiles.yml (standard dbt-redshift field name)
• [fusion] Use unrendered configs to flag changes for models and sources in state:modified selector
• [dbt-core] state:modified no longer flags snapshots whose dbt_valid_to_current config is set as environment-aware Jinja in dbt_project.yml. (#15286)
• [fusion] Fix dbt State evaluate_volatile_sql config semantics so true evaluates volatile SQL and false allows reuse.
• [dbt-core] Include the snapshot filename in the snapshot fqn to match dbt-core, fixing false-positive state:modified results when dbt-core compares against a Fusion-generated manifest (#15286)
• [dbt-index] Fix dbt-index regressions: CLL parquet not produced on baseline→strict static-analysis transition
• [internal] route tests to manifest.disabled when both parent model and test are explicitly disabled
• [fusion] Hide the completions subcommand from dbt help output
• [dbt-core] state:modified no longer flags data tests whose tags or meta configs are set as environment-aware Jinja in dbt_project.yml. (#15286)
• [fusion] Use redshift_database_name when checking Redshift SVV_EXTERNAL_TABLES.

Under the Hood

• [fusion] Resolve send_anonymous_usage_stats for docs serve with precedence --no-send-anonymous-usage-stats > DBT_SEND_ANONYMOUS_USAGE_STATS env > dbt_project.yml flags block > default true, and wire it into analytics_enabled on GET /api/v1/identity
• [fusion] Migrate dbt-docs-v2 data layer from hand-rolled fetch hooks to TanStack Query
• [fusion] Consolidate nine near-identical FilterView components into a shared GenericFilterView adapter, removing ~1100 lines of duplication
• [fusion] Implement array_except as a native DuckDB extension function (sf_array_except) instead of a SQL macro

Contributors

• @Wolfram.Schulte
• @aiguofer (#11381)
• @b-per
• @dataders
• @debrin-og
• @eakmanrq
• @eddowh
• @j-clemons
• @jasonlin45
• @jcserv
• @kczimm
• @lottaquestions (#15286, #15286, #15286, #15286, #15286)
• @mach-kernel
• @ragesh-g
• @serramatutu
• @versusfacit

2.0.0-alpha.3

Released June 29, 2026

Features

• [dbt-fusion] Sqlfluff parity
• [dbt-fusion] For versioned models, automatically create a view at the unsuffixed model name (e.g. dim_customers) pointing to the latest version (e.g. dim_customers_v2). Enabled by default; disable per-model with latest_version_pointer: {enabled: false} or globally with the project flag latest_version_pointer_enabled_by_default: false. Customize the pointer alias via the latest_version_pointer.alias config or by overriding the generate_latest_version_pointer_alias macro.
• [dbt-fusion] Redshift: use SHOW GRANTS ON TABLE for grants when datasharing is enabled
• [dbt-fusion] Make the maximum seed size hashed for state:modified comparison configurable via --maximum-seed-size-mib, the DBT_MAXIMUM_SEED_SIZE_MIB (or DBT_ENGINE_MAXIMUM_SEED_SIZE_MIB) env var, and dbt_project.yml flags (default 1 MiB; 0 disables the limit). Seed contents are now hashed incrementally with line-ending normalization, plus a Windows legacy-checksum fallback for state comparison.
• [dbt-extension] Signing in from the extension now uses the dbt login command.
• [dbt-fusion] Support catalog federation between Snowflake Horizon and Unity Catalog
• [dbt-fusion] Added support for Javascript UDFs in Snowflake and BigQuery
• [dbt-fusion] Setup catalogs.yml to provide json schemas.
• [dbt-fusion] Add dbt man --schema catalogs to export a type-discriminated JSON schema for catalogs.yml v2
• [dbt-fusion] Issue compatibility warnings for package versions based on manual compatibility verification when available in Package Hub
• [dbt-fusion] Support the insert_overwrite incremental strategy for the Spark adapter
• [dbt-fusion] Classification
• [dbt-fusion] Honor per-node +compute config on unit_test nodes, allowing a unit_test to override the global --compute flag (e.g. +compute: sidecar under global --compute remote).
• [dbt-fusion] Support the reservation config for BigQuery, allowing query jobs to be routed to a specific BigQuery reservation at the profile, project (+reservation), or model ({{ config(reservation=...) }}) level.
• [dbt-fusion] Allow the source application identifier sent during OAuth login to be configured via AuthChainBuilder or the DBT_OAUTH_SOURCE_APP environment variable
• [dbt-fusion] Expose has_dbt_state on GET /api/v1/capabilities
• [dbt-core] support the latest duckdb version 1.5.4 (#15279)

Fixes

• [dbt-fusion] BigQuery source freshness now correctly handles dotted project IDs (e.g. mycompany.io) by using relation component accessors instead of splitting the FQN on '.'. Also fixes a secondary bug where each per-dataset query included a redundant table_id IN (...) filter built from relations in unrelated datasets.
• [dbt-fusion] (fix redshift) always quote materialized view path
• [dbt-fusion] --write-index no longer produces catalog.json (was unintended side effect of #10750; pass --write-index --write-catalog to restore). --write-metadata alone no longer queries the warehouse. Catalog data is now fetched at most once per invocation and shared across all consumers.
• [dbt-fusion] Discover source() calls inside conditional branches that evaluate to false during the parse render.
• [dbt-fusion] Fix field-level manifest conformance gaps for metrics and semantic_models: metric label falls back to name at resolve time (matching dbt-core); semantic model entity description defaults to empty string and entity config defaults to {meta: {}} when unset. Fields where Fusion emits richer values than dbt-core (tags, meta, unrendered_config) are left as-is — these are improvements, not bugs.
• [dbt-fusion] Databricks: under catalogs v2, use CREATE OR REPLACE TABLE for managed Iceberg tables (table_format: iceberg) regardless of file_format, instead of plain CREATE TABLE
• [dbt-fusion] Support incremental materializations on the Spark adapter (append strategy)
• [dbt-fusion] Surface cached data test failures in dbt State builds
• [dbt-fusion] LSP fix code lens when static analysis off
• [dbt-fusion] Report dbt State-reused data tests as reused in dbt test output
• [dbt-fusion] sidecar: empty-string CAST to NULL, *_from_parts zero-tuple to NULL, unknown format string to NULL, timestamp_ltz_from_parts bridges
• [dbt-fusion] Snapshot nodes now correctly serialize config.materialized as snapshot instead of table in the manifest
• [dbt-fusion] ISO date format support for microbatch dates.
• [dbt-fusion] Accept dbt-core-style type annotations on macro arguments (e.g. param: str)
• [dbt-fusion] Singular tests whose ref() or source() calls target a node that doesn't exist in the project are now excluded from the schedule (NodeNotFoundOrDisabled warning at parse time, no execution), matching dbt-core behavior. Previously Fusion scheduled and executed those tests, hitting a dbt1501 render error.
• [dbt-fusion] Accept dotted snapshot block names (e.g. {% snapshot snp.sql %}) by stopping at the first dot, matching dbt-core behavior
• [dbt-fusion] Support comma-separated expression lists in Jinja do blocks (e.g. {%- do a.append(x), b.append(y) -%})
• [dbt-fusion] fix standardize_grants_dict crash when show_grants returns 0 rows (Redshift, Snowflake, Databricks)
• [dbt-fusion] Support Jinja2 filter postfix attribute access (e.g. rows|first.col) in minijinja parser
• [dbt-fusion] Spark: correctly classify existing relations as views so view models drop with DROP VIEW instead of DROP TABLE
• [dbt-fusion] Promote SA to strict for unit tests with overridden compute, allow unit test nodes to access LP if compute is sidecar.
• [dbt-fusion] Test nodes on disabled models are now emitted into manifest.disabled instead of being silently dropped
• [dbt-fusion] Give each microbatch batch its own statement-result registry so concurrent_batches=true models no longer fail with "The 'statement' result named '' has already been loaded into a variable"
• [dbt-fusion] Unit tests on models that call dbt UDFs via function() no longer fail with a spurious JinjaError (dbt1501); the tested model's function dependencies are now allowed during unit test rendering
• [dbt-fusion] finally and consciously decouple the DuckDB adapter from it's weird cousin Extended
• [dbt-fusion] Fix BigQuery get_relation crash during replay when the INFORMATION_SCHEMA.SCHEMATA location query returns an empty (zero-column) batch; get_dataset_location now returns no location instead of erroring.
• [dbt-fusion] Map Spark EXTERNAL/MANAGED relation types to table so DROP renders a valid drop table instead of an invalid drop external. Spark 4 reports managed Hive tables as EXTERNAL (TRANSLATED_TO_EXTERNAL), which broke --full-refresh over Thrift
• [dbt-fusion] Prevent dbt system uninstall from removing a binary owned by Homebrew, pip, or winget; surface the package manager's uninstall command instead
• [dbt-fusion] preserve legacy seed checksum compatibility
• [dbt-fusion] Ensure that persisted_docs configs for seeds are deserialized to the manifest.
• [dbt-fusion] Add support for databricks configs view_update_via_alter, incremental_apply_config_changes, and use_safer_relation_operations
• [dbt-fusion] Fix dbt State support for custom materializations
• [dbt-fusion] Fix manifest emission of null for adapter-specific config fields (sources: external_location, formatter, sync, schema_origin; models: compute, sync, and other adapter extras) — these are now omitted when unset, matching dbt-core behavior
• [dbt-fusion] dbt docs serve now emits a clear error when target/index is missing instead of silently exiting with code 1
• [dbt-fusion] Log when commands auto-install dependencies without an existing package-lock.yml.
• [dbt-fusion] Fix wizard subagents hanging indefinitely due to deadlocked event forwarding, unbounded wait_agent retries, and DuckDB checkpoint race
• [fusion] (dbt-adapter): all ambiguous to_rfc3339 calls are mapped to microsecond precision for Bigquery. Unblocks bigquery microbatch use cases.
• [fusion] Support lag_tolerance seconds period
• [dbt-core] state:modified no longer flags environment-aware warehouse-specific configs (e.g. copy_grants) set as Jinja in dbt_project.yml. (#15263)
• [fusion] Fix cached dbt State warning tests
• [fusion] Per-version access field on versioned models is now respected
• [fusion] ref() version pins now preserve original type (int/float/string) in manifest refs
• [dbt-core] state:modified no longer flags environment-aware grants configs set as Jinja in dbt_project.yml (e.g. grants driven by target.name). The unrendered grants config is compared instead of the target-rendered values. Affects seeds in particular. (#15302)
• [fusion] Allow tests attached to disabled models to preserve manifest metadata without failing on legacy generic test argument syntax.
• [dbt-core] Fix state:modified to no longer flag seeds whose column_types config is set as environment-aware Jinja in dbt_project.yml. (#15286)
• [dbt-core] state:modified no longer flags seeds whose quote_columns config is set as environment-aware Jinja in dbt_project.yml. (#15286)
• [dbt-core] Report CV10 quoted literal style violations with their own rule identity instead of CV11 casting style. (#15328)
• [fusion] Yaml: fix quoted string values parsed as numbers

Under the Hood

• [dbt-index] grain_declared falls back to primary_key inferred during parse when no compile data is present
• [dbt-fusion] Added snowflake config in UDF configs
• [dbt-fusion] Add a catalog-free untyped BigQuery binder (bigquery-untyped dialect) for column lineage, producing the same LP shape and column names as the typed binder
• [dbt-fusion] Match Fusion manifest serialization for exposures with Core for manifest parity
• [dbt-fusion] Reuse the Bigquery grammar and binder for BigqueryUntyped column lineage, removing the duplicate parser, lexer, and grammar."
• [dbt-fusion] Emit a Vortex Login event on dbt login with success/failure, login type, user cookie, project ID, and platform identity fields from the JWT.
• [dbt-fusion] Removed DataFusion-backed task execution
• [dbt-fusion] Fix implementation of legacy valid_snapshot_target
• [dbt-fusion] Add unit tests for Spark incremental materializations
• [dbt-fusion] Group CommonArgs flags into labeled help sections (Project, Selection, Execution, Logging, Artifacts, Event Time) and add a Sample heading to the node-selection commands so per-subcommand --help shows a focused summary
• [dbt-fusion] Upgrade Rust toolchain to 1.96
• [dbt-fusion] Errors and logs now show phase accurate paths for analyses, funcs, seeds and sources
• [dbt-fusion] Errors and logs now report phase accurate paths for exposures, macros, hooks, and metrics
• [dbt-fusion] Add manage_state to invocation telemetry to track dbt State management (auto-deferral) enablement
• [internal] Allows the source application used in analytics to be specified when creating an interactive AuthChain or an OAuthInteractiveResolver directly.
• [internal] Bump up the duckdb driver checksums
• [internal] Add anonymous IDs to dbt Wizard error telemetry.
• [dbt-fusion] Update driver
• [dbt-fusion] Improve salesforce adapter jinja
• [fusion] Add registry-backed JSON deserialization support for dbt-tracing telemetry records.
• [internal] dbt-ci: pypi publish --download-base-url <url> --target <triple>... builds the download-at-install sdist (downloads the release wheels, hashes the live bytes, assembles the sdist) and publishes it (filetype=sdist) to PyPI
• [fusion] Bump Databricks
• [fusion] Fix subtraction underflow panic in partial-parse when operations have invalid spans after JSON deserialization
• [internal] Bump the extended DuckDB driver

Contributors

• @HannanNaeem
• @aahel
• @aiguofer
• @ajhlee-dbt
• @ajnovice
• @akbog
• @arjitj2
• @aswanson
• @chasewalden
• @chayac
• @colin-rogers-dbt
• @dataders (#15279)
• @debrin-og
• @eddowh
• @j-clemons
• @jasonlin45
• @jcserv
• @kczimm
• @kendru
• @lottaquestiions (#15263)
• @lottaquestions (#15302, #15286, #15286)
• @mach-kernel
• @maxmalkin
• @mishamsk
• @ragesh-g
• @sadboy
• @serramatutu
• @sriramr98
• @tauhid621
• @tomighita
• @versusfacit
• @vgapeyev
• @wolfram
• @xuliangs

2.0.0-alpha.2

Released June 18, 2026

Features

• [dbt-fusion] Added --empty support in seed command.
• [dbt-fusion] Homebrew distribution: install the dbt Fusion CLI with brew install dbt from the official tap.
• [dbt-fusion] GET /api/v1/models: add catalog field (row_count_stat, bytes_stat, last_modified_stat from warehouse INFORMATION_SCHEMA) and materialized field; dbt build --write-index now queries warehouse catalog stats and writes them to the parquet index
• [dbt-fusion] Detect how dbt was installed (Homebrew, pip, winget, or the standalone installer) and surface the matching upgrade command; dbt system update now refuses to overwrite a binary managed by a package manager unless --force is passed.
• [dbt-fusion] Redshift: use SHOW TABLES FROM SCHEMA for cross-database source freshness when datasharing is enabled
• [dbt-fusion] Emit project-wide catalogs count on the parse-time ResourceCounts telemetry event
• [dbt-fusion] (fabric) supports dbt init
• [dbt-fusion] Interactive dbt login honors the DBT_OAUTH_SCOPES env var to request additional OAuth scopes.
• [dbt-fusion] dbt docs serve reports actual login status in GET /api/v1/distribution
• [dbt-fusion] Add Workload Identity Federation auth for BigQuery via Microsoft Entra
• [internal] Add daily conformance-analysis collection: scheduled GHA collects the previous UTC day and uploads per-day error-lines parquet to S3; new cargo conformance fetch/push sync the bucket and collect --start/--end + log-overlap --days N enable multi-day analysis
• [internal] Add cargo conformance report: a self-contained static HTML UI for an log-overlap run — templates ranked by impact, the concrete strings filling each drain3 <*> wildcard, and drill-down into the original log lines

Fixes

• [dbt-fusion] (fix adapters/databricks) restore token-first dispatch for Databricks OAuth so dbt Studio's U2M flow works correctly.
• [dbt-fusion] equals macro now uses IS NOT DISTINCT FROM clause for comparison
• [dbt-fusion] update try_or_compiler_error to match dbt-core
• [dbt-index] Preserve runtime invocation/run-result timestamps during direct fusion metadata ingest so dbt_rt.invocations.generated_at and dbt_rt.run_results.created_at are populated again
• [dbt-fusion] Fix /api/v1/search returning 500 when dbt_rt.run_results parquet is absent (project never run with --use-index)
• [dbt-fusion] Fix v2-parser path - preserve raw user-provided source identifier (including any embedded quote characters) on source_attr.identifier so dbt-core's source(...).identifier round-trips for packages like fivetran/zendesk that pre-quote reserved-word table names (e.g. Snowflake's GROUP)
• [dbt-fusion] source freshness on_run_end hooks can now access result.node (unique_id, relation_name, etc.) — fixes compatibility with elementary and other packages that read result.node in on_run_end macros
• [dbt-fusion] dbt State auth no longer caches the organization ID; it is always resolved from the live token scope, avoiding unnecessary browser re-authentication when a user's organization access changes between invocations
• [dbt-fusion] Fix v2-parser path - hydrate ColumnInfo.dimension and ColumnInfo.entity from the column when YAML omits required fields, and skip serializing Option::None so dbt-core's mashumaro can deserialize fusion's writable manifest into ColumnDimension/ColumnEntity dict-form variants
• [dbt-fusion] Fix v2-parser path - only blank path and original_file_path on public model nodes imported via publication artifacts; keep paths for public models from locally-resolved (local/git/registry) packages so dbt-core can write per-model compiled SQL instead of crashing with Errno 21 trying to write to an empty path
• [dbt-fusion] Fix v2-parser path - emit hook operation nodes with original_file_path of ./dbt_project.yml (package-internal) and path with .sql extension so dbt-core writes compiled hook artifacts to the same per-package location it does without --use-v2-parser
• [dbt-fusion] Fix Databricks panic when flattening STRUCT keys that were not string.
• [dbt-core] Fix YAML selector selector: shorthand being silently ignored inside exclude/union, and fix nested exclude being dropped from the serialized manifest (#15140)
• [dbt-fusion] Show a clear warning when dbt_cloud.yml fails to parse instead of a misleading 'no credentials configured' error
• [dbt-fusion] Fix schema routing for test failures when +schema: null is set in dbt_project.yml with store_failures: true
• [dbt-fusion] Read DuckDB catalog column_index as a 32-bit integer instead of a decimal, fixing a type-mismatch error when collecting DuckDB column metadata
• [dbt-fusion] Fix re.findall Capture objects to be sliceable sequences when pattern has 3+ capture groups
• [dbt-fusion] Disable dbt State for unsupported adapters
• [dbt-fusion] Fix manifest deserialization failing on no configs
• [dbt-fusion] Fix manifest deserialization for fields that are not present
• [dbt-fusion] Include Databricks-specific config attributes (auto_liquid_cluster, databricks_tags) in the semantic extras so dbt state comparison detects changes to them
• [dbt-fusion] Search results are now ranked by relevance: exact name matches appear first, followed by prefix matches, then field-priority matches (name, column, tag, fqn, description), with resource type and modeling layer as tiebreakers.
• [dbt-fusion] (fix adapter/databricks) retry on retryable errors
• [dbt-fusion] Capture and surface failures for unit test schema fetch phase
• [dbt-fusion] Relation now renders properly when the region is set on project or database
• [dbt-fusion] Fix model storing none values as undefined
• [dbt-fusion] LSP false dbt1089 warning
• [dbt-fusion] Honor model-level full_refresh: false config on microbatch models under dbt build --full-refresh
• [dbt-fusion] Emit M015 (DepsInstallInfo) only on successful package install, not M016
• [dbt-fusion] Allow target variables to be used in dbt_project.yml
• [dbt-fusion] fix seed configs rejecting valid fields
• [dbt-fusion] sidecar: DATEADD on TIMESTAMPTZ no longer fails the DuckDB binder under --compute sidecar
• [dbt-fusion] Fix dbt State reuse for new data tests without cached results

Under the Hood

• [dbt-fusion] Remove "models" path segment in computed fqn for manifest parity with Core
• [dbt-fusion] Manifest parity with core fixes for groups
• [dbt-fusion] Snapshot errors and logs now show phase-accurate paths for artifacts
• [internal] Add cargo ci homebrew render and cargo ci homebrew publish subcommands for rendering and publishing Homebrew formulas.
• [internal] Add reusable publish-homebrew.yml workflow that renders the formula and pushes it to a Homebrew tap. Used by the release pipeline and invokable ad-hoc via workflow_dispatch.
• [dbt-fusion] Improve ClickHouse init: remove database and make password optional
• [dbt-fusion] Extract package resolution behind PackageResolver trait per package kind, with concurrent resolution per BFS level
• [dbt-fusion] Serialize external and its subfields for manifest parity with Core
• [dbt-fusion] Refactor dbt-deps install to a trait-based PackageInstaller running concurrently via futures::join_all; per-variant impls only do install work and populate a shared InstallOutcome, while span lifecycle, telemetry, and error-path partial-progress stamping live in the trait default
• [fusion] Route view-traversal source extraction through TypeOps so the run-cache uses sdf-frontend bind-context in proprietary builds and the SA sqlparser path otherwise
• [dbt-fusion] Execute hooks on dbt State reuse
• [dbt-index] perf(dbt-lineage): --write-lineage overhead reduced from +20s to +2.4s at 5 843 models: bypass build_lineage_environment via direct LineageRow→CLL edge extraction, fix redundant epoch-0 compaction
• [internal] Add a dedicated dbt Core changelog (CHANGELOG-dbtcore.md) and sync it through copybara so dbt-core publishes its own changelog, starting at 2.0.0-alpha.1, separate from the dbt-fusion changelog
• [dbt-fusion] Bump dbt-docs-v2 UI bundle to add dbt State banner (a0c6c196807e9e6f2b9ea4fa953e99c2d1031657)
• [internal] Unify TypeOps source-extraction methods into a single extract_upstreams; absorb the standalone sdf_frontend dep_analysis::extract_sources_from_str into the same canonical path
• [dbt-fusion] Emit catalog_type on the RunModel telemetry event, resolved from the model's catalog_name via the active write integration in catalogs.yml
• [dbt-fusion] Re-enable and re-wire the dbt-repl integration test suite, disabled during the dbt-main modularization
• [dbt-fusion] Use lag_tolerance in freshness reuse messages
• [internal] Centralize server version lookup: DistInfoProvider gains a default server_version() method so env!("CARGO_PKG_VERSION") is defined in one place.
• [dbt-fusion] Remove quoting field from SourceConfig; adapter-specific quoting defaults are now applied directly during source resolution instead of being propagated through the config struct
• [internal] conformance: add resolve-repro subcommand (run_id → S3 artifact path via Datadog) and broaden fetch-repro to resolve the Teleport app + bucket per cell (global prod/prod-emea/prod-au, us-multicell, jp1), with --app/--aws-role/--bucket overrides for cells whose account isn't auto-resolved (eu/us2/us3/onprem)
• [dbt-fusion] Bump bigquery driver for WIF auth support

Contributors

• @HannanNaeem
• @agarovat
• @aiguofer
• @ajhlee-dbt
• @akbog
• @b-per
• @dataders
• @dbtagarovat
• @eakmanrq
• @eddowh
• @itsnamangoyal
• @izeigerman
• @j-clemons
• @jcserv
• @kczimm
• @koletzilla
• @lottaquestions (#15140)
• @mach-kernel
• @ragesh-g
• @serramatutu
• @sriramr98
• @tauhid621
• @vgapeyev
• @xuliangs

dbt-core 1.12.0-b3 - June 15, 2026

Fixes

• Allow for setting of OSI documents directory as project config (#13088)
• Support lowercase "osi" directory (#13087)
• Add a direct_parents attribute to model nodes carrying the nearest public ancestors only, and emit it in dbt ls --output=json for models. Lineage consumers can now render DAG edges from direct_parents instead of depends_on.nodes, which carries the full transitive closure across plugin boundaries (still required for node selection and cycle detection). The new attribute is runtime-only and is stripped during manifest serialization, so the manifest.json contract is unchanged. (#)
• Make the latest_version_pointer collision check quoting/case aware so an unquoted latest-version alias differing from the pointer name only by case is correctly detected on case-insensitive warehouses (#15210)

Under the Hood

• sync JSON schemas from dbt-fusion (#N/A)

Contributors

• @QMalcolm (#13088, #13087)
• @aahel (#15210)
• @fa-assistant (#N/A)
• @sriramr98 (#)

• Fix: If you use the Administrator API to manage SCIM to sync users from your identity provider, the /api/v3/accounts/{account_id}/scim/v2/Users response now returns value and display on each embedded group reference. id and displayName are retained so existing integrations keep working — this is a non-breaking change.

• Enhancement: The Administrative API v3 now supports private endpoint operations — list, create, retrieve, update, and delete. Use these endpoints to manage private connectivity programmatically.

• Enhancement: You can download OpenTelemetry (OTel) logs for individual dbt command steps in Fusion job runs.

• Enhancement: You can now configure dbt State for the Studio IDE directly in the dbt platform UI — either as a team-wide default on your development environment, or as a personal override. For more information, refer to Enabling dbt State in Studio.

• New: Model query history for Redshift and Databricks is now generally available (GA).

• Behavior change: On September 1, 2026, several behavior change flags on the dbt platform Latest release track will reach maturity (enabled by default). Refer to Flags reaching maturity to see which flags may affect your project and how to opt out before then.

• Beta: The dbt Fusion engine now supports the Salesforce Data 360 connection in the dbt platform. For more information, refer to Connect Salesforce Data 360.

• Private beta: The Analyst read permission set is available for Enterprise plans.

  • New: Analyst read is a project-level permission set that provides read-only access to analyze dbt models and project resources. The OAuth integration that lets read-only users connect to analysis features (such as the dbt MCP server) is available to use, while the Analyst read permission set and read-only permission changes are in private beta. To enable them, contact your account manager.

• Beta: Workspace-level Private Link for Microsoft Fabric is now available in beta. Configure a private connection between the dbt platform and your Fabric workspace so SQL traffic stays on Azure's private network. For more information, refer to Configuring Private Link for Microsoft Fabric.

• Beta: Cost Insights now supports Amazon Redshift Serverless and provisioned clusters. Configure your platform metadata credentials with the sys:monitor role or SYSLOG ACCESS UNRESTRICTED permission to allow dbt to read cross-user query history, then set your pricing in Cost Insights settings. For more information, refer to Set up Cost Insights.

dbt-core 1.12.0-b2 - June 01, 2026

Features

• Make MAXIMUM_SEED_SIZE_MIB configurable (#7117, #7124)
• automatically create a latest-version pointer (e.g. dim_customers) for versioned models, opt-in via latest_version_pointer_enabled_by_default flag or per-model latest_version_pointer config (#7442)
• Add support for private git packages in packages.yml and dependencies.yml. Resolves URLs from a configured environment variable when present, otherwise falls back to constructing an SSH URL. (#12874)
• Add catalogs.yml v2 support gated behind use_catalogs_v2 flag, with adapter-owned bridge architecture (#12930)
• Begin writing OSI SL document at end of parsing (#12786)
• Support parsing OSI semantic layer documents from a project's OSI/ directory into the dbt manifest (#12787)
• Bundle the dbt-state plugin (>=2.18,<3.0) as an install dependency of dbt-core. The plugin is opt-in: PluginManager skips auto-discovery unless the user passes --manage-state on the CLI, sets DBT_ENGINE_MANAGE_STATE=true, or sets manage_state to true in the flags block of dbt_project.yml (equivalently in the config block of profiles.yml). Discovery filters disabled modules before importlib.import_module is called, so the default opt-in-off state incurs no import cost. (#13014)
• Add --use-v2-parser to delegate parsing to the fusion parser, load its manifest.json into a runtime Manifest, and bypass dbt-core's parser. Configurable via --v2-parser / DBT_ENGINE_V2_PARSER (defaults to dbt-core-experimental-parser parse) or the flags: section of dbt_project.yml. (#13029)
• Add support for user settings with flags reading writing (#13031)
• Add dbt login command (#13032)

Fixes

• Fix version_to_str returning empty string for float NodeVersion values, causing unquoted YAML version scalars (e.g. v: 4.5) to be silently dropped and mis-routed as non-versioned models (#12947)
• Handle Reused node status in on-run-end summary printer so plugins that emit RunResult(status=Reused, ...) don't crash with unhandled result. (#12972)
• Skip jsonschema_validation if adapter_type is not available (#12992)
• Fix deferred function references to use alias instead of bare name (#12895)
• Cap the Python recursion limit while resolving the selector: method so a circular selector dependency raises a clean DbtRecursionError instead of crashing the process. The previous code relied on Python's default recursion limit (1000) tripping before the OS thread stack overflowed, but on platforms with smaller default stacks (notably Windows, ~1 MB vs ~8 MB on Linux/macOS) the margin can disappear once instrumentation (e.g. coverage) or stack-heavy plugins join the call chain. Lower the limit locally (restored in finally) so the catchable RecursionError fires first on every platform. (#13014)
• Honor --manage-state when DBT_ENGINE_MANAGE_STATE is set to false. The bundled dbt-state plugin reads DBT_ENGINE_MANAGE_STATE directly in its initialize(), so a CLI override of an opt-out env var was previously dropped silently: PluginManager loaded the plugin but the plugin self-disabled on import. PluginManager now normalizes os.environ to the Click-resolved value before importing each bundled plugin, so all three opt-in surfaces (--manage-state CLI, DBT_ENGINE_MANAGE_STATE env var, manage_state in dbt_project.yml / profiles.yml) behave consistently end-to-end. (#13014)
• Strip dbt-core-only DBT_ENGINE_* env vars (e.g. DBT_ENGINE_USE_V2_PARSER, DBT_ENGINE_V2_PARSER) from the v2-parser subprocess env, and expand ~ in --v2-parser paths. Fusion hard-errors on unknown DBT_ENGINE_* vars, so enabling the v2 parser via DBT_ENGINE_USE_V2_PARSER previously broke the handoff. Stripping is keyed off click-bound options, so future core-only DBT_ENGINE_* additions are handled automatically. Non-click vars (DBT_ENGINE_STATE_*, recorder, deps) pass through unchanged. (#13029)
• Write manage_state user_settings in all platform login flows unless explicitly disabled (#13032)
• Make sure that expires_at in oauth_sessions is int so that its rust interoperable (#13032)

Under the Hood

• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• Annotate PARAM_TYPE_MAP to fix mypy failure with click 8.4.0 (#N/A)
• Allow-list additional DBT_ENGINE_STATE_* engine env vars (EMIT_REUSED_STATUS, OAUTH_CLIENT_ID, AUTH_URL, TOKEN_URL, API_URL) (#13002)
• sync JSON schemas from dbt-fusion (#N/A)
• Add v2-parser telemetry — forward dbt-core's invocation_id and set DBT_INVOCATION_ENV=dbt-core-v2-parser on the parser subprocess so embedded telemetry correlates with the host invocation, and emit V2ParserStart/V2ParserEnd events around the handoff so pre-startup failures (missing binary, schema mismatch) are also captured. Bumps dbt-protos lower bound to 1.0.514 for the new event messages. (#13029)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)

Dependencies

• Bump dbt-adapters lower bound to >=1.24.1 (#12985)
• Bump the minimum dbt-core-experimental-parser to 2.0.0a1 (#13065)

Contributors

• @QMalcolm (#12786, #12787)
• @aahel (#7442, #12930, #12985)
• @acurtis-evi (#7117, #7124)
• @aiguofer (#13029, #13029, #13029)
• @ash2shukla (#13031, #13032, #12992, #13032, #13032)
• @colin-rogers-dbt (#13014, #12972, #13014, #13014, #N/A, #13002)
• @dbeatty (#12874)
• @fa-assistant (#N/A, #N/A, #N/A, #N/A, #N/A, #N/A)
• @fothergill (#12895)
• @noppaz (#7117, #7124)
• @tauhid621 (#12947, #13065)

The following features are new or enhanced as part of dbt Labs announcements at Snowflake Summit 2026 in San Francisco from June 1–4, 2026

• Alpha: dbt Core v2.0 is now available in alpha!

  • New: dbt Core v2.0 is the open-source Apache 2.0 foundation that the dbt Fusion engine builds on, delivering a faster, Rust-based runtime. It ships as two distributions: dbt-core (OSS, Apache 2.0) and dbt (Fusion distribution, proprietary).

• Beta: dbt lint is now available in beta!

  • New: dbt lint is a high-performance SQL linter built into the dbt platform, available on projects running the dbt Fusion engine. It is SQLFluff-compatible; it reads your existing .sqlfluff config, uses the same rule codes, and respects -- noqa suppression comments. In benchmarks, it runs roughly 50× faster than single-threaded SQLFluff.

• Preview: dbt Docs v2 is now available in preview!

  • New: dbt Docs v2 is a next-generation open-source catalog experience available with the dbt Fusion engine and dbt Core v2. It uses a compact binary index instead of loading the full manifest.json in the browser, making it significantly faster for large projects.
  • New: dbt Docs v2 includes a redesigned UI, Semantic Layer metadata, column-level lineage (Fusion only), and a REST API at /api/v1/ so AI agents and MCP servers can query your dbt project metadata without a browser.
  • New: Generate and serve dbt Docs v2 with the dbt Fusion engine or dbt Core v2 by running a dbt command with --use-index, then dbt docs serve. Add --write-catalog for richer column type metadata.

• Preview: dbt State is now available in preview!

  • New: dbt State skips or clones nodes when the logic and data haven't changed, rather than rebuilding everything on every run. Available in dbt Core v1.12+, dbt v2.0, the dbt platform, and the dbt Fusion engine. To get started, refer to Set up dbt State.
  • New: dbt State pricing is usage-based at $0.094 per daily unique reuse. New organizations receive a 30-day free trial with no usage limit.
  • Behavior change: State-aware orchestration is no longer being enabled for new customers. Refer to Migrate to dbt State for more information.

• New: dbt Wizard is available in dbt platform as a public preview. Introducing dbt Wizard CLI as a public beta. Purpose-built for agentic governed data development in dbt, dbt Wizard understands your project through a native metadata engine, unlike general-purpose coding agents.

  • New: Support for Anthropic as a BYOK provider for dbt AI.
  • New: dbt login is a new CLI command available in dbt Core v2.0 and later. It opens browser-based authentication and shares your login state across the CLI, dbt VS Code extension, dbt State, and dbt Wizard CLI with no separate sign-in flows needed.

• New: OAuth client registrations now accept custom-scheme redirect URIs (for example, cursor:// or vscode://), so you can build native app OAuth integrations with Cursor and VS Code.

• New: Public REST API endpoints at /api/ide/v3/{environment_id}/files/ support Studio IDE workspace file operations, including stat, read, write, list, delete, mkdir, and rename. Pass file paths as query parameters.

• New: The GET /api/ide/v3/{environment_id}/status endpoint returns the dbt_version and is_fusion status for a given environment.

• New: The dbt CLI Python client's create_invocation() method now supports a workspace parameter, so you can run invocations against persisted workspace files on workers.

What's Changed

• fix(#12947): handle float NodeVersion in version_to_str by @tauhid621 in #12948
• Add latest_version_view for versioned models by @aahel in #12779
• Revert "Add latest_version_view for versioned models" by @aahel in #12953
• Add AI summary to docs issue workflow by @mirnawong1 in #12882
• regen json_schema by @aahel in #12961
• chore: sync JSON schemas from dbt-fusion by @fa-assistant in #12963
• Add latest_version_view for versioned models by @aahel in #12954
• chore: sync JSON schemas from dbt-fusion by @fa-assistant in #12967
• emit osi_document.json at parse time alongside semantic_manifest.json by @QMalcolm in #12955
• Revert "fix: resolve --select via selector API in show/compile task_end_messages" by @tauhid621 in #12978
• Revert "fix: use tuple membership check instead of substring match in selection_arg" by @aahel in #12979
• Rename latest_version_view to latest_version_pointer by @aahel in #12970
• chore: sync JSON schemas from dbt-fusion by @fa-assistant in #12980
• Native private packages in packages.yml and dependencies.yml by @dbeatty10 in #12902
• Handle Reused node status in on-run-end summary by @colin-rogers-dbt in #12972
• fix: annotate PARAM_TYPE_MAP to satisfy mypy with click 8.4.0 by @colin-rogers-dbt in #12982
• feat: catalogs.yml v2 with adapter-owned bridge architecture by @aahel in #12930
• deps: bump dbt-adapters lower bound to 1.24.1 by @aahel in #12985
• Parse OSI semantic layer documents from OSI/ directory into the manifest by @QMalcolm in #12971
• Skip jsonschema_validation when adapter_type is empty by @ash2shukla in #12993
• RC release workflow bug fix by @sriramr98 in #13005
• Fix/cut release branch hatch failure by @sriramr98 in #13006
• added 1.11 changelog to previous releases by @sriramr98 in #13008
• Cleanup main after cutting new 1.12.latest branch by @FishtownBuildBot in #13007
• Allow-list DBT_ENGINE_STATE_EMIT_REUSED_STATUS and DBT_ENGINE_STATE_OAUTH_CLIENT_ID by @colin-rogers-dbt in #13002
• Update test durations for pytest-split by @FishtownBuildBot in #12974
• chore: sync JSON schemas from dbt-fusion by @fa-assistant in #13016
• Defensively cap recursion limit while resolving selector: references by @colin-rogers-dbt in #13024
• ci: add workflow to fast-forward 1.latest from main by @tauhid621 in #13021
• Add User Settings Support by @ash2shukla in #13025
• Bundle dbt-state as an install dependency of dbt-core (opt-in via --manage-state / DBT_ENGINE_MANAGE_STATE / manage_state) by @colin-rogers-dbt in #13014
• chore: sync JSON schemas from dbt-fusion by @fa-assistant in #13038
• Fix --manage-state being silently overridden by DBT_ENGINE_MANAGE_STATE=false in the plugin by @colin-rogers-dbt in #13039
• Implement dbt Login Command by @ash2shukla in #13020
• Add --use-v2-parser to delegate parsing to the fusion parser by @aiguofer in #13029
• chore: sync JSON schemas from dbt-fusion by @fa-assistant in #13051
• add dbt login fixes for post login flow by @ash2shukla in #13056
• allow skipping ddtrace in pytest by @ash2shukla in #13060
• Add v2-parser telemetry (invocation correlation + start/end events) by @aiguofer in #13044
• Strip core-only DBT_ENGINE_* env vars from v2 parser subprocess; expand ~ in --v2-parser by @aiguofer in #13058
• Update test durations for pytest-split by @FishtownBuildBot in #13064
• ci: point workflows at 1.latest ahead of main cutover by @tauhid621 in #13065
• Core v2 release workflow by @tauhid621 in #13067

Full Changelog: v1.12.0b1...v2.0.0-alpha.1