dbt Models

At Hightouch, we use dbt to build most of our models for analytics and reporting. We've built a first class way to use dbt models as the source code for your Hightouch models. When your setup is complete, you'll be able to create Hightouch models with dbt models like this.

Navigate to your integration settings and save your git credentials. For regular username / token authentication, use your personal access token (ex: Github, Gitlab) rather than password.

If you would like to scope Hightouch's access to a specific repository, we suggest you use our Github App! Make sure you select the "Github App" authentication method.

Under each source, you can enable using dbt models from your git repository in Hightouch.

The default schema is the schema where dbt would normally materialize your tables to unless otherwise specified in project file. Generally, this is something like public or production or dbt_production.

Hightouch allows you to optionally specify dbt selectors like tag:hightouch, but we will use * by default and sync all dbt models to Hightouch by default.

In addition, you can specify which version of dbt you would like to use. By default, Hightouch uses the most recent version available in the drop-down menu.

Hightouch will also automatically look for your dbt_project.yml file in the repository directory. However, if your file is named something else like dbt_project.yaml, or you have multiple dbt_project.yml files, you can specify a relative path to your project file, like ./hightouch/dbt/dbt_project.yaml.

After setting up the dbt model selector, dbt models will be available in the Hightouch model creation process. Select the dbt model tab in the query explorer and view all your dbt models there!

The compiled SQL shown in the preview is only used for preview purposes. When we query the warehouse, we'll be querying the table that is built by dbt.

Hightouch supports all dbt versions >= 0.19, you can set the version in the dbt setup page. If you need support for a version not listed, let us know!

We does not currently support the following features:

Hightouch compiles the project using dbt compile to resolve the schema of your data warehouse and to generate compiled SQL for preview purposes. When running the model in Hightouch, we query the materialized table directly.