quoting

dbt_project.yml
quoting:
  database: true | false
  schema: true | false
  identifier: true | false

Definition

Optionally configure whether dbt should quote databases, schemas, and identifiers when:

  • creating relations (tables/views)
  • resolving a ref function to a direct relation reference
BigQuery Terminology

Note that for BigQuery quoting configuration, database and schema should be used here, though these configs will apply to project and dataset names respectively

▶Changelog

Default

The default values vary by database.

For most adapters, quoting is set to true by default.

This is because creating relations with quoted identifiers does not inhibit the ability to select from them, and quoting allows you to use reserved words as object names (though that should probably be avoided)

dbt_project.yml
quoting:
  database: true
  schema: true
  identifier: true

Examples

Set quoting to false for a project:

dbt_project.yml
quoting:
  database: false
  schema: false
  identifier: false

dbt will then create relations without quotes:

create table analytics.dbt_alice.dim_customers

Recommendation

Snowflake

Set all quoting configs to False. This means that you cannot use reserved words as identifiers, however it's usually a good idea to avoid these reserved words anyway.

Explanation:

Whereas most databases will lowercase unquoted identifiers, Snowflake will uppercase unquoted identifiers. If a model name is lowercased and quoted, then it cannot be referred to without quotes! Check out the example below for more information.

snowflake_casing.sql
/*
    You can run the following queries against your database
    to build an intuition for how quoting works on Snowflake.
*/


-- This is the output of an example `orders.sql` model with quoting enabled
create table "analytics"."orders" as (


  select 1 as id


);


/*
    These queries WILL NOT work! Since the table above was created with quotes,
    Snowflake created the orders table with a lowercase schema and identifier.


    Since unquoted identifiers are automatically uppercased, both of the
    following queries are equivalent, and neither will work correctly.
*/


select * from analytics.orders;
select * from ANALYTICS.ORDERS;


/*
    To query this table, you'll need to quote the schema and table. This
    query should indeed complete without error.
*/


select * from "analytics"."orders";




/*
    To avoid this quoting madness, you can disable quoting for schemas
    and identifiers in your dbt_project.yml file. This means that you
    won't be able to use reserved words as model names, but you probably
    shouldn't be doing that anyway! Assuming schema and identifier quoting is
    disabled, the following query would indeed work:
*/


select * from analytics.orders;

Other warehouses

Leave the default values for your warehouse.

Edit this page