MetricSign
EN|NLRequest Access
High severityconfiguration

Power BI Refresh Error:
DbtProjectError

What does this error mean?

dbt encountered an error loading or validating the dbt_project.yml configuration file. This prevents the project from starting.

Common causes

  • 1An unrecognized configuration key in dbt_project.yml
  • 2An invalid model path or seed path configuration
  • 3The dbt version specified in require-dbt-version is incompatible with the installed dbt version
  • 4A YAML syntax error in dbt_project.yml
  • 5An invalid dispatch configuration in the project

How to fix it

  1. 1Run dbt parse to see the specific error in dbt_project.yml
  2. 2Validate the YAML syntax of dbt_project.yml using a YAML linter
  3. 3Check the require-dbt-version constraint against the installed dbt version: dbt --version
  4. 4Review recent changes to dbt_project.yml for new configuration keys
  5. 5Compare against the dbt project configuration documentation to verify all keys are valid

Frequently asked questions

What does require-dbt-version do?

It specifies the dbt version(s) required to run the project. If the installed version doesn't match, dbt raises a DbtProjectError.

Can I have multiple model paths in dbt_project.yml?

Yes — model-paths accepts a list of directories. All must exist relative to the project root.

Other configuration errors