> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prefect.io/llms.txt
> Use this file to discover all available pages before exploring further.

# prefect-dbt

## 0.7.25

*Released on June 05, 2026*

**Features**

* Add dbt Cloud asset materializations [#21763](https://github.com/PrefectHQ/prefect/pull/21763) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

**Bug Fixes**

* Restore dbt-core 1.7.0 compatibility [#21996](https://github.com/PrefectHQ/prefect/pull/21996) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Support dbt unit tests in `PrefectDbtRunner` [#21989](https://github.com/PrefectHQ/prefect/pull/21989) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

**Documentation**

* Document dbt-core 1.7/1.8 import compatibility rules [#21999](https://github.com/PrefectHQ/prefect/pull/21999) by [@app/github-actions](https://github.com/app/github-actions)
* Document `UnitTestDefinition` attribute pitfall [#21994](https://github.com/PrefectHQ/prefect/pull/21994) by [@app/github-actions](https://github.com/app/github-actions)
* Document `run_results` None pitfall and structure [#21743](https://github.com/PrefectHQ/prefect/pull/21743) by [@app/github-actions](https://github.com/app/github-actions)

**Maintenance**

* Add generic dependency-override compatibility testing to integration matrix [#22000](https://github.com/PrefectHQ/prefect/pull/22000) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

***

## 0.7.24

*Released on April 30, 2026*

**Features**

* Add lifecycle hooks to `PrefectDbtRunner` and `PrefectDbtOrchestrator` [#21523](https://github.com/PrefectHQ/prefect/pull/21523) by [@harsh21234i](https://github.com/harsh21234i)

**Enhancements**

* Add typing overloads for hook decorators [#21740](https://github.com/PrefectHQ/prefect/pull/21740) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

**Maintenance**

* Add runner lifecycle hook integration test [#21744](https://github.com/PrefectHQ/prefect/pull/21744) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

***

## 0.7.23

*Released on April 22, 2026*

**Features**

* Render edges between dbt task runs in `PER_NODE` graph [#21659](https://github.com/PrefectHQ/prefect/pull/21659) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

**Bug Fixes**

* Fail flow runs when dbt nodes error (new `raise_on_failure` arg on `PrefectDbtOrchestrator`, defaults to `True`) [#21654](https://github.com/PrefectHQ/prefect/pull/21654) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Silence dbt console output during `plan()` [#21653](https://github.com/PrefectHQ/prefect/pull/21653) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Cache models with injected test edges under `IMMEDIATE` + `PER_NODE` [#21656](https://github.com/PrefectHQ/prefect/pull/21656) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

***

## 0.7.22

*Released on April 17, 2026*

**Enhancements**

* Use dbt `relation_name` for asset display name instead of node name [#21559](https://github.com/PrefectHQ/prefect/pull/21559) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

***

## 0.7.21

*Released on April 15, 2026*

**Bug Fixes**

* Fix `PrefectDbtRunner` hanging on long dbt docs descriptions [#21061](https://github.com/PrefectHQ/prefect/pull/21061) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

**Maintenance**

* Replace RST-style double backticks with single backticks in docstrings [#21211](https://github.com/PrefectHQ/prefect/pull/21211) by [@desertaxle](https://github.com/desertaxle)

***

## 0.7.20

*Released on March 05, 2026*

**Experimental 🧪**

* Pool dbt adapter connections across `PER_NODE` invocations [#20968](https://github.com/PrefectHQ/prefect/pull/20968) by [@desertaxle](https://github.com/desertaxle)
* Replace wave-based execution with eager DAG scheduler for `PER_NODE` mode [#20975](https://github.com/PrefectHQ/prefect/pull/20975) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Add `plan()` dry-run method to `PrefectDbtOrchestrator` [#20965](https://github.com/PrefectHQ/prefect/pull/20965) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Add optional `dbt deps` step to `DbtCoreExecutor` [#20960](https://github.com/PrefectHQ/prefect/pull/20960) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Add `CacheConfig` dataclass for cross-run caching [#20957](https://github.com/PrefectHQ/prefect/pull/20957) by [@desertaxle](https://github.com/desertaxle)
* Add `PREFECT_CLIENT_SERVER_VERSION_CHECK_ENABLED` setting to skip version checks in worker subprocesses [#20973](https://github.com/PrefectHQ/prefect/pull/20973) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Bump the default process worker cap for `PrefectDbtOrchestrator` [#20958](https://github.com/PrefectHQ/prefect/pull/20958) by [@desertaxle](https://github.com/desertaxle)

***

## 0.7.19

*Released on March 02, 2026*

**Experimental 🧪**

* Add `DbtCloudExecutor` for per-node cloud orchestration [#20784](https://github.com/PrefectHQ/prefect/pull/20784) by [@desertaxle](https://github.com/desertaxle)
* Add hook for `ProcessPoolTaskRunner` subprocess message processing and dbt log dedupe [#20869](https://github.com/PrefectHQ/prefect/pull/20869) by [@desertaxle](https://github.com/desertaxle)
* Distinguish cached nodes from executed nodes in result payload [#20856](https://github.com/PrefectHQ/prefect/pull/20856) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Add `validate_for_orchestrator` to `PrefectDbtSettings` [#20841](https://github.com/PrefectHQ/prefect/pull/20841) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Log artifact locations after `run_build()` completes [#20839](https://github.com/PrefectHQ/prefect/pull/20839) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Improve `PER_NODE` performance, client API checks, and benchmark isolation [#20875](https://github.com/PrefectHQ/prefect/pull/20875) by [@desertaxle](https://github.com/desertaxle)
* Use `deque` for BFS queues in dbt freshness and settings scripts [#20900](https://github.com/PrefectHQ/prefect/pull/20900) by [@giulio-leone](https://github.com/giulio-leone)
* Pre-compute cache keys for isolated node selections [#20898](https://github.com/PrefectHQ/prefect/pull/20898) by [@desertaxle](https://github.com/desertaxle)
* Cascade `IMMEDIATE` test failures to downstream nodes [#20862](https://github.com/PrefectHQ/prefect/pull/20862) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Prefer per-node artifact message over "unknown error" in dbt orchestrator [#20861](https://github.com/PrefectHQ/prefect/pull/20861) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Make `_DbtNodeError` pickle-safe for `ProcessPoolTaskRunner` [#20833](https://github.com/PrefectHQ/prefect/pull/20833) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Raise `ValueError` when retries used with `PER_WAVE` mode [#20825](https://github.com/PrefectHQ/prefect/pull/20825) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Avoid `None` asset descriptions in events [#20840](https://github.com/PrefectHQ/prefect/pull/20840) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

**Maintenance**

* Correct return type annotation for `dbt_runner_freshness_success` fixture [#20903](https://github.com/PrefectHQ/prefect/pull/20903) by [@giulio-leone](https://github.com/giulio-leone)
* Add `PrefectDbtOrchestrator` benchmarks and CI workflow [#20829](https://github.com/PrefectHQ/prefect/pull/20829) by [@desertaxle](https://github.com/desertaxle)

***

## 0.7.18

*Released on February 20, 2026*

**Experimental 🧪**

* Add `extra_cli_args` passthrough to `run_build()` [#20770](https://github.com/PrefectHQ/prefect/pull/20770) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Change default test\_strategy to IMMEDIATE [#20759](https://github.com/PrefectHQ/prefect/pull/20759) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Surface dbt execution detail in task run logs [#20762](https://github.com/PrefectHQ/prefect/pull/20762) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Auto-generate manifest in `run_build()` when none is present [#20758](https://github.com/PrefectHQ/prefect/pull/20758) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Add `target` parameter to `run_build()` [#20761](https://github.com/PrefectHQ/prefect/pull/20761) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Improve task run names for dbt nodes [#20760](https://github.com/PrefectHQ/prefect/pull/20760) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Support `disable_assets` flag on `PrefectDbtOrchestrator` [#20757](https://github.com/PrefectHQ/prefect/pull/20757) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Add artifact creation and asset tracking to per-node dbt orchestrator [#20743](https://github.com/PrefectHQ/prefect/pull/20743) by [@desertaxle](https://github.com/desertaxle)
* Add configurable test execution strategies to dbt orchestrator [#20701](https://github.com/PrefectHQ/prefect/pull/20701) by [@desertaxle](https://github.com/desertaxle)
* Add cross-run caching to PER\_NODE dbt orchestration [#20644](https://github.com/PrefectHQ/prefect/pull/20644) by [@desertaxle](https://github.com/desertaxle)
* Source freshness integration for per-node dbt orchestrator [#20671](https://github.com/PrefectHQ/prefect/pull/20671) by [@desertaxle](https://github.com/desertaxle)

**Documentation**

* Set up automatic prefect-dbt API reference docs via mdxify [#20716](https://github.com/PrefectHQ/prefect/pull/20716) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

***

## 0.7.17

*Released on February 12, 2026*

**Experimental 🧪**

* Add PER\_NODE execution mode to PrefectDbtOrchestrator [#20608](https://github.com/PrefectHQ/prefect/pull/20608) by [@desertaxle](https://github.com/desertaxle)
* Add `PrefectDbtOrchestrator` with wave-by-wave execution [#20591](https://github.com/PrefectHQ/prefect/pull/20591) by [@desertaxle](https://github.com/desertaxle)
* Add selector resolution and node filtering for per-node dbt orchestration [#20579](https://github.com/PrefectHQ/prefect/pull/20579) by [@desertaxle](https://github.com/desertaxle)
* Add `DbtNode`, `ExecutionWave`, and `ManifestParser` for per-node dbt orchestration [#20561](https://github.com/PrefectHQ/prefect/pull/20561) by [@desertaxle](https://github.com/desertaxle)

**Bug Fixes**

* Fix error message in PrefectDbtRunner [#20648](https://github.com/PrefectHQ/prefect/pull/20648) by [@lostkamp](https://github.com/lostkamp)
* fix: use `timeout_seconds_override` as `max_wait_seconds` when polling for dbt Cloud job completion [#20583](https://github.com/PrefectHQ/prefect/pull/20583) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)
* Fix `DbtCoreOperation` sync methods after `prefect-shell` `async_dispatch` migration [#20562](https://github.com/PrefectHQ/prefect/pull/20562) by [@desertaxle](https://github.com/desertaxle)

**Documentation**

* Add DbtCoreExecutor for per-node dbt command execution [#20589](https://github.com/PrefectHQ/prefect/pull/20589) by [@desertaxle](https://github.com/desertaxle)

**Maintenance**

* Bump `prefect` lower bound to `>=3.6.17` [#20659](https://github.com/PrefectHQ/prefect/pull/20659) by [@desertaxle](https://github.com/desertaxle)
* chore(deps-dev): bump ruff from 0.14.14 to 0.15.0 [#20540](https://github.com/PrefectHQ/prefect/pull/20540) by [@app/dependabot](https://github.com/app/dependabot)

***

## 0.7.15

*Released on January 15, 2026*

**Features**

* Add create and delete job tasks to prefect-dbt Cloud integration [#20216](https://github.com/PrefectHQ/prefect/pull/20216) by [@zzstoatzz](https://github.com/zzstoatzz)

**Bug Fixes**

* Fix PrefectDbtRunner for multi-word commands [#20221](https://github.com/PrefectHQ/prefect/pull/20221) by [@lostkamp](https://github.com/lostkamp)

***

## 0.7.14

*Released on December 29, 2025*

**Bug Fixes**

* Fix incorrect handling of dbt ephemeral models in PrefectDbtRunner [#19962](https://github.com/PrefectHQ/prefect/pull/19962) by [@vyagubov](https://github.com/vyagubov)

***

## 0.7.13

*Released on December 16, 2025*

**Bug Fixes**

* Skip asset creation for ephemeral models in `_call_task` [#19822](https://github.com/PrefectHQ/prefect/pull/19822) by [@app/devin-ai-integration](https://github.com/app/devin-ai-integration)

***

## 0.7.12

*Released on December 16, 2025*

**Bug Fixes**

* Skip ephemeral models in upstream node lookup [#19708](https://github.com/PrefectHQ/prefect/pull/19708) by [@zzstoatzz](https://github.com/zzstoatzz)

***

## 0.7.11

*Released on December 09, 2025*

**Bug Fixes**

* fix command detection when flags precede command [#19694](https://github.com/PrefectHQ/prefect/pull/19694) by [@zzstoatzz](https://github.com/zzstoatzz)

***

## 0.7.10

**Bug Fixes**

* Fix task caching bug by [@desertaxle](https://github.com/desertaxle) in [#19597](https://github.com/PrefectHQ/prefect/pull/19597)

* Fix a bug where `_stop_callback_processor` did not reset instance variables and caused deadlocks by [@zzstoatzz](https://github.com/zzstoatzz) in [#19601](https://github.com/PrefectHQ/prefect/pull/19601)

## 0.7.9

**Enhancements**

* Queue dbt callbacks and filter queued tasks more aggressively by [@kevingrismore](https://github.com/kevingrismore) in [#19432](https://github.com/PrefectHQ/prefect/pull/19432)

## 0.7.8

*Released on September 18, 2025*

**Bug Fixes**

* Fix dbt kwargs handling to preserve positional args and validate command flags by [@zzstoatzz](https://github.com/zzstoatzz) in [#18981](https://github.com/PrefectHQ/prefect/pull/18981)

## 0.7.7

*Released on September 17, 2025*

**Enhancements**

* Handle dbt kwargs as args by [@kevingrismore](https://github.com/kevingrismore) in [#18952](https://github.com/PrefectHQ/prefect/pull/18952)