dbt Core

2.0.0-alpha.5

Released July 20, 2026

Features

• Migrate Redshift catalog macros to SHOW TABLES and SVV_REDSHIFT_COLUMNS when datasharing is enabled, so catalog generation works for cross-database relation
• Adds defer_job_id support via DBT_CLOUD_DEFER_JOB_ID env var. When set alongside defer_env_id, appends ?job_id= to the manifest download URL for job-specific deferral.
• Add catalog_database support to v2 catalogs.yml: when set, catalog_database takes highest priority in generate_database_name over model database config and target.database. Uses the existing build_catalog_relation pattern — no new adapter method. Supported for Snowflake (all types), BigQuery (biglake_metastore), and Databricks (unity, optional, falls back to catalog_name).
• Fire telemetry event on static analysis propagation completion
• Add POST /api/v1/analytics/events relay endpoint (docs v2 → Vortex)
• docs analytics: add distribution field and hydrate server-authoritative fields (distribution, dbt_version, is_logged_in, dbt Cloud IDs) on POST /api/v1/analytics/events

Fixes

• Populate defer_relation on graph.nodes entries (models, snapshots, seeds) so node.defer_relation works in Jinja, matching dbt-core
• Correct defer_relation wire shape on graph.nodes to match dbt-core's DeferRelation dataclass (drop unique_id, add description/compiled_code/meta/tags/config)
• Prevent panic when calling insert() on a mutable list with an out-of-bounds index; return a proper template error instead. This was the primary panic causing cascading lock poisoned panics in minijinja's MutableVec.
• Parse-time config.get(name) now matches dbt-core's ParseConfigObject.get (core/dbt/context/providers.py:554) by returning "" for every key except meta. The meta key keeps a permissive chainable stub (ParseConfigValue) so dbt-autofix's recommended config.get('meta').custom_key migration pattern (see dbt-autofix/manual_fixes/custom_configuration.md) keeps working during Fusion's static-analysis compile of materialization bodies. Separately, adapter.get_relation now coerces None/Undefined args to "" at the strict &str unwrap so the compile-phase CompileConfig.get('database') → None path (mirroring Python's RuntimeConfigObject.get) flows through without crashing the prefetch-recording call. Together this unblocks the Anisi customer project (account 303 / project 3580) whose snowflake_external_table materialization in dbt_external_tables calls adapter.get_relation(database=config.get('database'), ...). Broader audit of where the same None-tolerance coercion belongs across other adapter methods is a follow-up dbt-core ↔ dbt-fusion parity investigation.
• Add +resource_tags config support for seeds and snapshots in dbt_project.yml
• stop using schema cache (prefetch at parse time) for adapter.get_columns_in_relation if it's using in a selected node without using strict static analysis.
• Resolve event_time from seed and snapshot inputs for microbatch models (matches core v1)
• dbt State view reuse during full-refresh runs
• Generic test nodes with long names no longer have empty depends_on.macros in the manifest
• Spark: fix schema existence and listing on the Hive metastore. check_schema_exists now resolves via show databases instead of the nonexistent information_schema.schemata (fixing snapshots and other guard-then-create paths), and list_schemas reads the show databases result column name-agnostically (namespace on OSS Spark, databaseName on Databricks). Databricks behavior is unchanged.
• Implement symbolic linter
• Replace panic with a user-facing error when an exposure depends_on entry does not resolve to a ref(), source(), or metric() call
• Improve the Snowflake dbt State metadata error when database or schema is empty.
• model.original_file_path now resolves to the correct path in Jinja macro context during parse phase instead of returning '.'.
• persist_docs: warn about and skip columns documented in YAML that are not present in the database, instead of failing the model build or silently mis-applying column comments (ports dbt-labs/dbt-adapters#1690)
• Stop /api/v1/health from leaking the absolute index_dir path; replace with project_loaded + generation (snapshot timestamp) and an X-Docs-Generation header
• Reduce dbt State auth token request timeout to 15 seconds and retry transient auth service failures.
• Add graceful shutdown/drain to dbt docs server so rollout restarts don't reset in-flight readers
• Implement normalize() on pytz timezone objects so unit-test fixtures using modules.pytz.timezone(...).normalize(...) parse instead of failing with an opaque dbt1013 deserialization error
• Treat an empty or zero-byte selectors.yml as no selector definitions, matching dbt Core behavior instead of raising SelectorError dbt1600
• Analysis nodes now have compiled, compiled_code, and compiled_path populated in the manifest after dbt compile
• state:modified no longer flags models whose persist_docs config is set as environment-aware Jinja.
• Include YAML-supplied generic test config in manifest raw_code.
• Restore the Snowflake warehouse using its canonical upper-cased name (matching dbt Core's current_warehouse()-based restore), so per-model snowflake_warehouse overrides no longer cause record/replay SQL mismatches
• Snapshots no longer appear in their own depends_on.macros; fixed by skipping self-referential macro dep recording in the DAG listener
• LSP fix deferral for show (preview CTE) and compile file (#14542)
• Match Python re.sub behavior for empty regex matches in dbt Jinja modules.re.
• Bump Snowflake Driver to 0.21.14 to fix Timestamp Freshness
• BigQuery: treat 403 access-control failures (missing bigquery.datasets.create IAM permission or VPC Service Controls policy violations) as ignorable permission errors during schema creation, matching dbt-core; runs against centrally-provisioned datasets in governed/VPC-SC environments no longer fail on the eager CREATE SCHEMA step
• BigQuery unit tests: fixture values that are SQL expressions for STRUCT or GEOGRAPHY columns (e.g. STRUCT(...), ST_GEOGPOINT(...)) are now injected verbatim instead of being single-quoted as string literals, so BigQuery can CAST them to the target type; matches dbt-core
• Bump pyo3 workspace dependency from 0.27 to 0.29 to support Python 3.15 in CI runner images
• Fix a client-cancellation panic in the Snowflake ADBC driver on long-running queries.
• Resolve project flags case-insensitively in the Jinja flags context so a flag set in dbt_project.yml is reachable whether a macro reads it lower-case or upper-case, matching dbt Core
• Fix show --inline broken when root package is disabled
• Redshift POSIX regex-negation operators !~ and !~* no longer raise a false-positive dbt0101 SyntaxInvalid diagnostic (#15249)
• Report cached dbt State data tests attached to unchanged views as no-change reuse.
• Stop raising a false dbt1159 "Test cannot have the same key '' at the top-level and in config" when a data test has a top-level config key (e.g. where) and a config: block that does not set that key
• state:modified no longer flags data tests whose schema.yml config uses environment-aware Jinja (where/severity/tags/meta), and now correctly detects genuine changes to a test's where/limit/severity: data tests join the wholesale unrendered_config comparison (dbt-core#15286).
• Remove synthetic materialization macro call coordinates from runtime error locations.
• Filter synthetic snapshot macro uids (snapshot..snapshot_) from depends_on.macros in snapshot nodes; these Fusion-internal uids never appear in manifest.macros and caused a dangling reference.
• Fix unit tests on Redshift failing with an internal error (SQLSTATE XX000) when the tested model uses QUALIFY
• state:modified no longer flags seeds or snapshots whose config uses environment-aware Jinja (e.g. persist_docs, quote_columns, grants, meta), and now correctly detects genuine changes to a snapshot's meta while no longer over-selecting snapshot group-only changes: seeds and snapshots join the wholesale unrendered_config comparison (dbt-core#15286).
• Allow default generic tests to aggregate and render task-time aggregation SQL
• Prevent dbt State metadata MapReduce from stalling behind a speculative connection attempt after worker results are ready.
• Normalized back-slashes to forward-slashes for path, original_file_path and patch_path
• state:modified — retire the per-key unrendered config grafts for models and sources
• Support meta_get on Jinja map values that represent dbt node configs.
• Support context-backed Jinja map caches that use get and update.
• state:modified for data tests now follow dbt-core TestConfig key allowlist
• Report an accurate, path-normalized error when a local: package cannot be resolved: distinguish a missing package directory ("Package directory not found") from a directory that lacks a dbt_project.yml, resolve .. segments in the reported path, and add dbt Core-style guidance
• Tolerate a partially-migrated package-lock.yml that mixes the name/no-name entry forms: the deprecated lock parser now accepts (and ignores) a name key instead of failing the build with UnusedConfigKey (dbt1060) errors, matching dbt Core
• Expose model.path relative to the resource root (e.g. staging/orders.sql) in both the config() block and the model body, matching dbt-core; previously it was empty inside config() and carried the models/ prefix in the body
• Fix microbatch lookback off-by-one so a lookback of N produces N+1 batches (current batch plus N previous), matching dbt-core and the microbatch docs (#15477)
• dbt retry now preserves --full-refresh from the original run, so incremental models retried after a failed full-refresh build use full-refresh (drop + recreate) semantics instead of incremental merge semantics
• Hide the internal --write-metadata flag in favor of --write-index, fix 'dbt parse --write-index' to generate the index instead of failing with a save_artifact_meta IO error, and make the dbt-index warnings reference --write-index and respect warn_error_options
• Reduce BigQuery dbt State freshness fanout by using schema-level metadata refreshes for non-override submit-time misses.
• Quote grantees when revoking grants, so revoking a grant whose name contains special characters no longer fails with a syntax error.
• Jinja parser now accepts keyword-argument names spelled like literal keywords (none, true, false), e.g. namespace(gold=0, unknown=0, none=0), matching dbt Core. Previously these raised MacroSyntaxInvalid (dbt1502): non-keyword arg after keyword arg.
• Support non-ASCII Jinja macro names in Fusion parsing.
• Ensure data tests submit zero freshness tolerance to dbt State.
• Translate legacy BigQuery seed +column_types aliases (e.g. float, integer, text) to their canonical types (FLOAT64/INT64/STRING) instead of failing with 'Invalid column description', matching dbt Core
• Allow dbt State submissions to include upstream dependencies whose last modified timestamp could not be resolved, instead of bypassing state for the model.
• Bump BigQuery ADBC driver to 0.21.0.dev+dbt0.21.13, wiring HTTPS_PROXY/NO_PROXY support into the OAuth token-exchange transport

Under the Hood

• Serialize config for macros for manifest parity with core
• remove unused calculate_freshness_from_metadata_batch method
• Add live Snowflake ADBC client cancellation regression test
• Generic and column data tests now include their schema.yml config (where, severity, limit, tags, meta, ...) in unrendered_config, matching models/seeds/snapshots. Preparatory for correct state:modified comparison of data tests.
• Add ClickHouse to the list of non experimental adapters.
• Publish pre-release versions to Homebrew and winget during the pre-stable window, and fix the empty-version bug in the release-v2 publish jobs.
• Add clickhouse-0.1.0 ADBC driver to CDN checksums

Security

• Remove unused ad-hoc SQL query endpoints (POST /api/v1/query, GET /api/v1/tables) from dbt docs server

Contributors

• @@koletzilla
• @HannanNaeem
• @Thrasi
• @VersusFacit
• @aahel
• @aiguofer
• @ajhlee-dbt
• @ajnovice
• @akbog (#15477)
• @alexander-bogdanowicz
• @ashtonwalden
• @b-per
• @claude
• @dataders
• @debrin-og
• @eliasdefaria
• @itsnamangoyal
• @j-clemons (#14542)
• @jasonlin45
• @jcserv
• @kczimm
• @lottaquestions
• @mach-kernel
• @r-jais (#15249)
• @ragesh-g
• @sadboy
• @vgapeyev
• @xuliangs

dbt-core 1.12.0 - Alecia Beth Moore-Hart (P!NK) (July 16, 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)
• Flags introduced in 1.9 and 1.10 defaults to true (#12713)

Features

• Make MAXIMUM_SEED_SIZE_MIB configurable (#7117, #7124)
• Support partial parsing for function nodes (#12072)
• Add UnparsedMetricV2 to read in new-style YAML Semantic Layer Metrics. (#12157)
• Allow for defining funciton arguments with default values (#12044)
• Add directory change instruction after dbt init (#9041)
• Raise jsonschema-based deprecation warnings by default (#12240)
• :bug: :snowman: Disable unit tests whose model is disabled (#10540)
• Implement config.meta_get and config.meta_require (#12012)
• Deprecate null return values from generate_schema_name macro, behind require_valid_schema_from_generate_schema_name flag (#12347)
• Add ability to indicate dbt Model also represents a Semantic Model. (Not fully supported yet.) (#.)
• Added ability to parse semantic layer dimensions added to columns as part of new YAML. (Not ready for use until more of the new yaml is implemented.) (#.)
• Add parsing for new YAML for semantic layer entities attached to dbt models. (#12395)
• Process semantic metrics in v2 YAML if they are not merged into a model. (#12161)
• Add parsing for v2 metrics on models and finish implementing their dependency behaviors. (#12397)
• Add the ability to process derived semantic entities to dbt models, as required by new YAML schema. (#12401)
• Enable parsing derived dimensions for v2 semantic layer YAML. (#12404)
• Add unit tests to the Jinja graph object, enabling tools like dbt-project-evaluator to run checks on unit tests. (#12033)
• Implement agg_time_dimension for new semantic YAML. (#12410)
• Implement parsing of semantic model object-style configuration in v2 semantic YAML. (#12413)
• Implement primary_entity field for semantic models in semantic YAML v2. (#12414)
• add config.meta_get to python model parsing (#12458)
• Allow jinja suffixed extensions for markdown and sql files (#11097, #3484)
• Allow continue running child on parent error (#2142)
• Added support for vars.yml to declare project variables (#11144, #2955)
• execute dbt debug logic after creating a new project in dbt init (#12510)
• Write compiled SQL for snapshots to target/compiled/ during dbt compile (#7867)
• Add "selector" selector method (#5009)
• env vars can now be loaded from .env file (#12106)
• dbt seed now supports --empty to create the tables without loading data (#8981)
• 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 catalogs.yml usage tracking (#1122)
• Add --sql flag to dbt run-operation for executing ad-hoc SQL/Jinja statements (#12478)
• support for javascript udfs (#12332)
• Allow event deferral for Parse events (#12339)
• Support overloaded UDFs via overloads block in function YAML entries (#12250)
• 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 support for python 3.14 (#12098)
• Add Reused to NodeStatus and RunStatus (#12912)
• Add per-overload start and result log events for overloaded UDFs (LogStartOverload, LogOverloadResult) (#12250)
• 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)
• 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)
• 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)
• Add hints for cli users based on dbt usage (#15510)

Fixes

• Address Click 8.2+ deprecation warning (#12038)
• Allow dbt deps to run when vars lack defaults in dbt_project.yml (#8913)
• Include macros in unit test parsing (#10157)
• Restore DuplicateResourceNameError for intra-project node name duplication, behind behavior flag require_unique_project_resource_names (#12152)
• Allow the usage of function with --exclude-resource-type flag (#12143)
• Fix bug where schemas of functions weren't guaranteed to exist (#12142)
• :bug: :snowman: Correctly reference foreign key references when --defer and --state provided (#11885)
• Fix generation of deprecations summary (#12146)
• :bug: :snowman: Add exception when using --state and referring to a removed test (#10630)
• :bug: :snowman: Stop emitting NoNodesForSelectionCriteria three times during build command (#11627)
• :bug: :snowman: Fix long Python stack traces appearing when package dependencies have incompatible version requirements (#12049)
• :bug: :snowman: Fixed issue where changing data type size/precision/scale (e.g., varchar(3) to varchar(10)) incorrectly triggered a breaking change error fo (#11186)
• :bug: :snowman: Support unit testing models that depend on sources with the same name (#11975, #10433)
• Fix bug in partial parsing when updating a model with a schema file that is referenced by a singular test (#12223)
• :bug: :snowman: Avoid retrying successful run-operation commands (#11850)
• :bug: :snowman: Fix dbt deps --add-package crash when packages.yml contains warn-unpinned: false (#9104)
• :bug: :snowman: Improve dbt deps --add-package duplicate detection with better cross-source matching and word boundaries (#12239)
• :bug: :snowman: Fix false positive deprecation warning of pre/post-hook SQL configs (#12244)
• :bug: :snowman: Fix ref resolution within package when duplicate nodes exist, behind require_ref_searches_node_package_before_root behavior change flag (#11351)
• Ensure recent deprecation warnings include event name in message (#12264)
• Improve error message clarity when detecting nodes with space in name (#11835)
• :bug: :snowman:Propagate exceptions for NodeFinished callbacks in dbtRunner (#11612)
• Adds omitted return statement to RuntimeConfigObject.meta_require method (#12288)
• Do not raise deprecation warning when encountering dataset or project configs for bigquery (#12285)
• Pin sqlparse <0.5.5 to avoid max tokens issue (#12303)
• Avoid deadlock edgecases of concurret microbatch/batch execution (#11420)
• Begin emitting deprecation warnings for DSI produced ValidationFutureError issues (#NA)
• Add @requires.catalogs decorator to compile command to fix REST Catalog-Linked database compilation (#12353)
• Validate and filter out non-existent columns from seed column types (#12379)
• Fix false deprecation warning (#12327)
• Return correctly resolved project path when changing dirs (#9138)
• Normalize whitespace prior to computing partial parsing checksum when loading model files (#12432)
• Dont fire config problem event if loaded_at_query is defined for adapters that dont support metadata-based freshness (#12451)
• Stop raising deprecation warnings for internal python model configs (#12314)
• Fix foreign key constraint ref() resolving to deferred relation even when target model is selected for build (#12455)
• Skip raising CustomKeyInConfigDeprecation for config key alias in sql (#12396)
• Provide user-friendly validations that dimensions with 'validity_params' also have granularities. (#12473)
• Use resolved profile and target names to allow partial parsing for default profile and target (#7612)
• Ensure that all locked packages are installed in packages directory (#12509)
• Fix static_analysis: off being interpreted as boolean false instead of string "off" in manifest.json (#12015)
• Set expr to column name for column-based dimensions and entities when the semantic layer name differs from the column name, so MetricFlow queries the correct warehouse column (#12512)
• Correctly map 'hidden' field of metrics to 'is_private' field in manifests. (#12518)
• Fix dbt retry for microbatch models to use the original invocation time instead of the current time when recomputing batches (#11423)
• Fix Dimension() jinja in nested metric filters (input_metrics, numerator, denominator) being incorrectly rendered during YAML parsing for v2 semantic layer schema (#12529)
• Improve logic for detecting config with missing plus prefix in dbt_project.yml (#12371)
• Fix v2 metric parsing using model name instead of custom semantic_model.name for generated_from, causing conversion metric validation to fail (#12532)
• Fix doc() Jinja in derived_semantics dimension and entity descriptions being incorrectly rendered during v2 YAML parsing (#12535)
• Enable sql_header config for data tests gated behind require_sql_header_in_test_configs behavior change flag. (#9775)
• Better error formatting for semantic manifest validation errors (#9849)
• Allow macros invoked via run-operation to ref() private and protected models (#8248)
• Better error and warnings logs with [WARNING] / [ERROR] messages prepended to the logs (#9849)
• Fix substring match bug in show and compile task selection causing models with reserved substrings in name to be incorrectly filtered (#12539)
• Add config and allow meta and docs to exist under it for macros (#12383, #9447)
• DBT_ENGINE prefixed env vars picked up by CLI (#12583)
• Fix state:modified not detecting .yml property changes for resource_type:function (#12547)
• Fix duplicate CTE race condition in ephemeral model compilation (#12602)
• Allow deferral for UDFs (#12080)
• Resolve full node description while running udfs for better logging (#12600)
• Update URL and name of behavior change flag for require_ref_searches_node_package_before_root (#12324)
• Raise PropertyMovedToConfigDeprecation instead of MissingArgumentsPropertyInGenericTestDeprecation (#12572)
• Fix list-type metric filters under models key being incorrectly rendered at parse time, causing 'Dimension is undefined' errors (#12618)
• Add @requires.catalogs decorator to test command to fix custom catalog integration support (#12662)
• Raise custom key in config deprecation warning for invalid config keys in dbt_project.yml (#12542)
• Fix IndexError when parsing semantic model that references a disabled or missing model (#12671)
• Support custom ref kwargs in unit tests and generic data tests, behind behavior flag support_custom_ref_kwargs (#12148)
• Fix AttributeError when docs block argument is non-constant (#12673)
• Fix AttributeError when generic test config is non-dictionary (#12674)
• handle jinja2.Undefined in msgpack_encoder (#12677)
• Fix inheritance for defaults.agg_time_dimension in semantic models. (#12678)
• Fix case-insensitive env var lookup on Windows (#10422)
• Ensure MAX_GROUPING_TOKENS and MAX_GROUPING_DEPTH default to None independently (#12694)
• Fix EISDIR error when compiling snapshots where a snapshot name matches the source filename (#12568)
• fix: guard against KeyError for custom constraints in same_contract() (#12699)
• Suppress stacktrace when snapshot validation fails due to missing strategy or unique_key (#12692)
• Fixed a bug where UDF function schema was not available in jinja context of on-run-end hook (#12516)
• fix: handle null tables value in source YAML to prevent TypeError (#12704)
• We can now enable/disable analyses from dbt_project.yml on a project level or a folder level (#11427)
• Fix "Cannot use selector" error in dbt source freshness (#12718)
• Ensure property depr checks check for aliases with plus prefix (#12327)
• Include exception message in run_results.json for run-operation failures (#12730)
• fix: exclude test_name not inherited when using selector method (#12753)
• catch InvalidFieldValue and raise ParsingError during context config generation (#12758)
• Improve partial parsing of semantic models using new-style yaml. (#12763)
• Fix regression where node.path for snapshots in subdirectories omitted the subdirectory path (#12783)
• Skip schema-time rendering of version-level data_tests so they can be rendered later with full context (#12805)
• Sources and Semantic Model now raise a warning if name contains spaces. Use REQUIRE_SOURCE_AND_SEMANTIC_MODEL_NAMES_WITHOUT_SPACES to raise errors instead. (#12767)
• Add back the removed descriptions render condition (#12865)
• Fix regression from #12562 where dbt show and dbt compile filtered out every result when --select used a graph operator (+model, model+, @model) or a method selector (e.g. tag:foo, state:modified, fqn:model). The membership check ran against the raw --select strings, so any non-bare selector matched nothing. Filter the streamed ShowNode / CompiledNode events by the resolved set of directly-selected unique_ids instead, using the same selector parser dbt already uses for execution. The substring fix from #12562 (originally #12539) is preserved structurally. (#12562)
• Allow column-level entity definitions in V2 semantic YAML to omit name, falling back to the column name to match the existing dimension behavior (#DI-4133)
• 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)
• Reconstruct unrendered config kwarg values as readable expressions instead of raw AST repr (#15336)
• 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)
• 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)
• Fix intermittent "references a model that does not exist" parsing error when unit testing versioned models, caused by non-deterministic filesystem parse order (#11139)
• 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 (#)
• Carry ref/source/function dependencies declared inside an overloaded UDF's overload body onto the root function node, so they are not dropped from the DAG when the overload SQL file is absorbed (#15501)
• Update reuse relations hint text (#15510)
• Fix macro namespace resolution so a dbt project named after a macro no longer crashes with 'MacroGenerator' during dispatch (#15556)
• Persist hint_ts in dbt_home and gate rw on bare Except clause to be more defensive (#15510)

Docs

• Enable display of unit tests (dbt-docs/#501)
• Unit tests not rendering (dbt-docs/#506)
• Add support for Saved Query node (dbt-docs/#486)
• Fix npm security vulnerabilities as of June 2024 (dbt-docs/#513)
• Bump form-data from 3.0.1 to 3.0.4 (dbt-docs/#554)
• Add support for UDF (function) resource type in lineage graph (dbt-docs/#574)

Under the Hood

• Update schema file order test (#11869)
• Update jsonschemas for schema.yml and dbt_project.yml deprecations (#12180)
• Replace setuptools and tox with hatch for build, test, and environment management. (#12151)
• Add add_catalog_integration call even if we have a pre-existing manifest (#12262)
• Bump lower bound for dbt-common to 1.37.2 (#12284)
• sync JSON schemas from dbt-fusion (#N/A)
• Handle missing column time granularities during parsing. (#12472)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• Make test case for parsing metric filters slightly more robust. (#12528)
• sync JSON schemas from dbt-fusion (#N/A)
• Unpin sqlparse dependency, and introduce --sqlparse CLI option for configuring sqlparse limits (#12329)
• sync JSON schemas from dbt-fusion (#N/A)
• Update jsonschemas for more accurate deprecation warnings: macro.config should not warn (#12670)
• sync JSON schemas from dbt-fusion (#N/A)
• Update the naming of the jsonschema file used for project files (#NA)
• Recategorize unhandled exceptions to DbtException subclasses (#11191)
• Ensure catalogs.yml is loaded for any command that requires loading a manifest (#12705)
• sync JSON schemas from dbt-fusion (#N/A)
• Improve error message for bad semantic_model config object with disallowed fields in V2 SL YAML. (#12766)
• Improve type hinting for BaseRunner so that more type errors are caught during development (#12803)
• sync JSON schemas from dbt-fusion (#N/A)
• GenericSqlRunner (used for programmatic SQL execution via SqlCompileRunner/SqlExecuteRunner) is now a standalone class instead of inheriting from CompileRunner. This fixes a latent AttributeError in handle_exception and correctly separates the programmatic SQL execution path from the DAG runner hierarchy. (#12811)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• Drop usage of deprecated warn_or_error handler method (#8133)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• sync JSON schemas from dbt-fusion (#N/A)
• 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)
• sync JSON schemas from dbt-fusion (#N/A)
• Reduce parse-time memory and macro-generation overhead by virtualizing macros and switching flat_graph/WritableManifest to lazy no-copy views (#15524)

Dependencies

• Use EventCatcher from dbt-common instead of maintaining a local copy (#12124)
• Upgrading dbt-semantic-interfaces to 0.10.x (#None)
• Bump minimum click to 8.2.0 (#12305)
• Bump DSI minimum to 0.10.2 (#NA)
• Bump dbt-protos minimum to 1.0.418 (#NA)
• Move click minimum to 8.3.0 (#12378)
• Bump minimum version of dbt-common to 1.37.3 (#12575)
• Bump libpq-dev in Docker image from 13.23-0+deb11u1 to 13.23-0+deb11u2 to fix build failure due to superseded package version (#NA)
• Begin depending on MetricFlow instead of dbt-semantic-interfaces (#12893)
• Bump libpq-dev in Docker image from 13.23-0+deb11u2 to 13.23-0+deb11u3 to fix build failure due to superseded package version (#NA)
• Remove unused pytest-logbook and logbook test dependencies from both the default and ci hatch envs. dbt-core dropped its logbook-based logger in (#NA)
• Bump dbt-adapters lower bound to >=1.24.1 (#12985)
• Bump the minimum dbt-core-experimental-parser to 2.0.0a1 (#13065)
• 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)
• Bump dbt-adapters to 1.24.5 lowerbound (#, #)

Contributors

• @3loka (#8913, #12124)
• @ChenyuLInx (#486)
• @MichelleArk (#12671, #15336)
• @QMalcolm (#12072, #12044, #12786, #12787, #12143, #12142, #11627, #12264, #11420, #NA, #12314, #12583, #13088, #13087, #NA, #12803, #12811, #8133, #12305, #NA, #NA, #12378, #12893)
• @Thrasi (#12547)
• @WilliamDee (#None)
• @aahel (#7867, #7442, #12478, #12250, #12250, #12930, #15156, #11423, #9775, #8248, #12148, #10422, #12568, #12783, #15210, #15501, #574, #12985)
• @abhishek09827 (#12379)
• @acurtis-evi (#7117, #7124)
• @aiguofer (#13029, #13029, #13029)
• @ajnovice (#12885, #NA)
• @akshatha-code71 (#7612)
• @alexaustin007 (#12327)
• @aranke (#506, #513)
• @ash2shukla (#11097, #3484, #2142, #5009, #1122, #12339, #12098, #13031, #13032, #15510, #9138, #12451, #12396, #7612, #12509, #12371, #12383, #9447, #12080, #12600, #12542, #12718, #12327, #12805, #12865, #12992, #13032, #13032, #15510, #15556, #15510, #15524, #, #)
• @asiunov (#12146)
• @b-per (#12033, #12455, #12015, #12512)
• @chinar-amrutkar (#12692)
• @claygeo (#12730)
• @colin-rogers-dbt (#12912, #13014, #12602, #12972, #13014, #13014, #12262, #N/A, #13002)
• @dbeatty (#12874)
• @dbeatty10 (#12324)
• @edgarrmondragon (#12038)
• @emmyoop (#10630, #12049, #11186, #9104, #12239, #12151, #12575)
• @fa-assistant (#N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A, #N/A)
• @fothergill (#12895)
• @gshank (#12012, #501, #11869)
• @itsnamangoyal (#NA, #12713, #11139, #)
• @kalluripradeep (#9041, #12353, #12539, #12572)
• @mattogburke (#12223)
• @michellark (#11885)
• @michelleark (#12240, #10540, #12347, #10157, #12152, #11975, #10433, #11850, #12244, #11351, #11835, #11612, #12285, #12303, #12432, #12673, #12674, #12677, #12694, #12699, #12704, #12753, #12758, #554, #12180, #12284, #12329, #12670, #11191, #12705)
• @mjsqu (#12288)
• @nathanskone (#10157)
• @noppaz (#7117, #7124)
• @peterallenwebb (#15524)
• @rrittsteiger (#12662)
• @sriramr98 (#11144, #2955, #12510, #12106, #8981, #12332, #9849, #9849, #12516, #11427, #12767, #)
• @tauhid621 (#12947, #NA, #NA, #NA, #13065, #15391, #13065)
• @tauhidanjum (#12562)
• @theyostalservice (#12157, #., #., #12395, #12161, #12397, #12401, #12404, #12410, #12413, #12414, #12473, #12518, #12529, #12532, #12535, #12618, #12678, #12763, #DI-4133, #12472, #12528, #12766)
• @venkaa28 (#12458)

---

Alecia Beth Moore-Hart (P!NK) (b. 1979)

Thanks to @colin-rogers-dbt for writing this biography of Alecia Beth Moore-Hart (P!NK)—a famous Philadelphian, and the namesake of this dbt Core release.

If you existed on the planet between 2000 and 2012 you have heard her music. The kind of pop music that's inescapable; relentlessly played, parodied, derided and loved. Songs that were sincere to the point of discomfort, unconcerned with following a formula, with no subject being off limits.

Their writer and singer, Alecia Beth Moore-Hart, was born September 8, 1979 in Doylestown, Pennsylvania a small town roughly 40 miles outside of Philadelphia. Growing up in a volatile household she nearly didn't make it: nearly overdosing at a rave on Thanksgiving at 16 years old. The DJ told her to come back the following night for a guest spot on the condition she never touch hard drugs again. She showed up the following night and by the following week was auditioning for labels the following week. What has followed is an unlikely career spanning nine albums and countless tours for millions of fans.

A career defined not be her first album: a commercially successful pop album that she personally hated but by her second. She used the leverage bought by her grammy winning cover of "Lady Marmalade" for the Moulin Rouge soundtrack to demand the freedom to make the album she wanted. The result was "Missundaztood", a confessional genre bending mashup of blues, hip hop and rockl made largely with Linda Perry of 4 Non Blondes. Topically, it covers her parents' divorce, her own self-loathing and the absurdity of pop fame. The label expected disaster. It sold fifteen million copies. The rest is history.

dbt-core 1.12.0-rc3 - July 14, 2026

Features

• Add hints for cli users based on dbt usage (#15510)

Fixes

• Carry ref/source/function dependencies declared inside an overloaded UDF's overload body onto the root function node, so they are not dropped from the DAG when the overload SQL file is absorbed (#15501)
• Update reuse relations hint text (#15510)

Under the Hood

• Reduce parse-time memory and macro-generation overhead by virtualizing macros and switching flat_graph/WritableManifest to lazy no-copy views (#15524)

Contributors

• @aahel (#15501)
• @ash2shukla (#15510, #15510, #15524)
• @peterallenwebb (#15524)

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

dbt-core 1.11.12 - July 01, 2026

Fixes

• Stop emitting spurious deprecation warnings for state model configs (pre_clone, lag_tolerance, require_fresh_data_from, etc.) by adding the ModelState schema to the bundled jsonschemas (#13016)

Contributors

• @tauhid621 (#13016)

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 (#)