Skip to main content


dbt is a transformation workflow that helps you get more work done while producing higher quality results. You can use dbt to modularize and centralize your analytics code, while also providing your data team with guardrails typically found in software engineering workflows. Collaborate on data models, version them, and test and document your queries before safely deploying them to production, with monitoring and visibility.

dbt-databend-cloud is a plugin developed by Databend with the primary goal of enabling smooth integration between dbt and Databend. By utilizing this plugin, you can seamlessly perform data modeling, transformation, and cleansing tasks using dbt and conveniently load the output into Databend. The table below illustrates the level of support that the dbt-databend-cloud plugin offers for commonly used features in dbt:

FeatureSupported ?
Table MaterializationYes
View MaterializationYes
Incremental MaterializationYes
Ephemeral MaterializationNo
Custom Data TestsYes
Docs GenerateYes
Connection RetryYes

Installing dbt-databend-cloud

Installing the dbt-databend-cloud plugin has been streamlined for your convenience, as it now includes dbt as a required dependency. To effortlessly set up both dbt and the dbt-databend-cloud plugin, run the following command:

pip3 install dbt-databend-cloud

However, if you prefer to install dbt separately, you can refer to the official dbt installation guide for detailed instructions.

Tutorial: Run dbt Project jaffle_shop

If you're new to dbt, Databend recommends completing the official dbt tutorial available at Before you start, follow Installing dbt-databend-cloud to install dbt and dbt-databend-cloud.

This tutorial provides a sample dbt project called "jaffle_shop," offering hands-on experience with the dbt tool. By configuring the default global profile (~/.dbt/profiles.yml) with the necessary information to connect to your Databend instance, the project will generate tables and views defined in the dbt models directly in your Databend database. Here's an example of the file profiles.yml that connects to a local Databend instance:

target: dev
type: databend
port: 8000
schema: sjh_dbt
user: databend
pass: ********

If you're using Databend Cloud, you can refer to this Wiki page for step-by-step instructions on how to run the jaffle_shop dbt project.

Did this page help you?
Explore Databend Cloud for FREE
Fast Analytics
Easy Data Ingestion
Elastic Scaling
Try it today