Skip to main content
The first step to using dbt in Omni is to connect the Git repository containing your dbt project to Omni. Use the guide for your Git provider to get started:

Azure DevOps

GitHub

GitLab

Next steps

After you successfully connect your dbt repository, you need to:
  1. Configure your production dbt environment
  2. Sync dbt with Omni
  3. Set up Virtual Schemas. This isn’t required to use the dbt integration, but enabling Virtual Schemas before you start building in Omni avoids migrating later.

Common questions

While reading metadata from your database provides basic descriptions, you won’t be able to:
  • Push SQL changes or new fields created in Omni back to dbt
  • Sync personal development branches in Omni to your development dbt environment
  • Auto-generate primary keys and relationships from dbt YAML constraints
Omni strongly recommends using two separate repositories: one for your dbt project and one for your Omni semantic model. This gives you:
  • Clear ownership — Separates data engineering from business logic.
  • Faster iteration — Prevents semantic refreshes from being tied to dbt compilation times.
  • Cleaner Git history — Keeps automatic commits from the Omni IDE out of your dbt pull requests.
  • Coordinated deployments — Ensures Omni model changes only apply after related dbt runs complete, so downstream content doesn’t break.
If you decide to keep Omni and dbt in the same repository, use separate branches for changes. See the Git integration best practices for more information.
Yes. This is common when using different credentials for different environments, such as using separate Snowflake accounts for different departments.
You must configure dbt settings and environment variables for each individual connection to ensure models map to the correct database and schema.
No. Currently, Omni supports one dbt repository per database connection. If your architecture relies on multiple interconnected projects in separate repositories, Omni cannot ingest all projects into a single connection at this time.