analysis-paths

dbt_project.yml

analysis-paths: [directorypath]

Definition

Specify a custom list of directories where analyses are located.

Default

Without specifying this config, dbt will not compile any .sql files as analyses.

However, the dbt init command populates this value as analyses (source).

Paths specified in analysis-paths must be relative to the location of your dbt_project.yml file. Avoid using absolute paths like /Users/username/project/analyses, as it will lead to unexpected behavior and outcomes.

• ✅ Do

  • Use relative path:

    analysis-paths: ["analyses"]

• ❌ Don't

  • Avoid absolute paths:

    analysis-paths: ["/Users/username/project/analyses"]

Examples

Use a subdirectory named analyses

This is the value populated by the dbt init command.

dbt_project.yml

analysis-paths: ["analyses"]

Use a subdirectory named custom_analyses

dbt_project.yml

analysis-paths: ["custom_analyses"]