Skip to main content

Project-level configuration for analyses

require_corrected_analysis_fqnsdbt v1 Latestdbt v1
Introduced2026.31.12.0
Matured (default → true)——
Removed——

Previously, project-level configuration for analyses in dbt_project.yml was silently ignored. Fully qualified names (FQNs) for analyses also contained an extra analyses path segment that was inconsistent with other resource types.

When require_corrected_analysis_fqns is set to true, dbt:

  • Routes analysis configurations from the analyses block in dbt_project.yml, enabling project-level configurations to take effect.
  • Removes the extra FQN segment so that analysis FQNs are consistent with other resource types (for example, your_project.my_analysis instead of your_project.analyses.my_analysis).

To configure analyses at the project level, set the require_corrected_analysis_fqns flag to true and add an analyses block in your dbt_project.yml. The project-level configuration applies to existing analyses in the analyses/ folder — for example, setting +enabled: false disables them all.

dbt_project.yml
flags:
  require_corrected_analysis_fqns: true

analyses:
  +enabled: true | false
Report incorrect code

For more information, refer to Analyses and Analysis properties.

Was this page helpful?

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

0