Failures in on-run-start hooks

Removed in dbt Core v2

This flag was removed in dbt Core v2 and in Fusion. The new behavior is always enabled. If you're upgrading, remove this flag from your dbt_project.yml.

skip_nodes_if_on_run_start_fails	dbt Latest	dbt Core
Introduced	2024.10	1.9.0
Matured (default → true)	Sep 1, 2026	—
Removed	—	v2.0

Loading table...

Set the skip_nodes_if_on_run_start_fails flag to true to skip all selected resources from running if there is a failure on an on-run-start hook.

For more information, refer to on-run-start / on-run-end.

Impact when the flag matures

If your project uses on-run-start hooks for non-critical work (for example, telemetry, notifications, audit inserts, attaching session settings), your build will stop producing output whenever a hook fails. Tables and views that previously refreshed daily will stop updating the next time the hook fails.

 Recommended actions

If every model is skipped after an on-run-start hook fails, find which on-run-start hook failed in the run log — it appears as an ERROR immediately before all the nodes marked SKIP. From there, either remove the hook if it's not required, or fix the root cause of the failure by reviewing the hook's SQL statements.

To opt out of this behavior, set the flag to false:

dbt_project.yml

flags:
  skip_nodes_if_on_run_start_fails: false

Was this page helpful?

Privacy policyCreate a GitHub issue

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.