target

target contains information about your connection to the warehouse.

  • dbt CLI: These values are based on the target defined in your profiles.yml file
  • dbt Cloud Scheduler:
    • target.name is defined per job as described here.
    • For all other attributes, the values are defined by the deployment connection. To check any of these values, head to Environments (via the hamburger menu), select the relevant deployment environment, and select settings.
  • dbt Cloud IDE: The values are defined by your connection and credentials. To check any of these values, head to your account (via your profile image in the top right hand corner), and select the project under "Credentials".

Some configs are shared between all adapters, while others are adapter-specific.

Common

VariableExampleDescription
target.profile_namejaffle_shopThe name of the active profile
target.namedevName of the active target
target.schemadbt_aliceName of the dbt schema (or, dataset on BigQuery)
target.typepostgresThe active adapter being used. One of "postgres", "snowflake", "bigquery", "redshift"
target.threads4The number of threads in use by dbt

Adapter-specific

Snowflake

VariableExampleDescription
target.databaseRAWDatabase name specified in active target.
target.warehouseTRANSFORMName of the Snowflake virtual warehouse
target.userTRANSFORM_USERThe user specified in the active target
target.roleTRANSFORM_ROLEThe role specified in the active target
target.accountabc123The account specified in the active target

Postgres/Redshift

VariableExampleDescription
target.dbnameanalyticsDatabase name specified in active target.
target.hostabc123.us-west-2.redshift.amazonaws.comThe host specified in active target
target.userdbt_userThe user specified in the active target
target.port5439The port specified in the active profile

BigQuery

VariableExampleDescription
target.projectabc-123The project specified in the active profile

Examples

Use target.name to limit data in dev

As long as you use sensible target names, you can perform conditional logic to limit data when working in dev.

select
*
from source('web_events', 'page_views')
{% if target.name == 'dev' %}
where created_at >= dateadd('day', -3, current_date)
{% endif %}