Versões do dbt Core compatíveis com o dbt Projects on Snowflake¶

O Snowflake fornece ambientes de execução gerenciados para projetos dbt, garantindo um ambiente de execução seguro e previsível. Como as versões do dbt Core podem introduzir alterações incompatíveis ou vulnerabilidades de segurança, o Snowflake segue um ciclo de vida estruturado para cada versão. Essa política permite que os usuários fixem versões específicas para governança e reprodutibilidade, além de fornecer um cronograma claro para as migrações necessárias.

Versões compatíveis com projetos dbt¶
Versão do dbt Core compatível	Nível do suporte Snowflake	Suporte do dbt Labs
1.10.15	Suporte ativo	Suporte crítico desde 15 de junho de 2026
1.9.4	Suporte ativo	Descontinuado

O parâmetro DBT_VERSION define implicitamente o mecanismo de execução com base na versão, conforme mostrado na tabela abaixo.

Mapeamento do mecanismo baseado em versão¶
Entrada do usuário (DBT_VERSION)	Condição	Mecanismo resultante
“1.x” (por exemplo, `1.9.4`)	Versão `< 2.0`	dbt Core (baseado em Python)

Visualizar versões compatíveis do dbt Core¶

Para visualizar as versões compatíveis do dbt Core, execute a função do sistema SYSTEM$SUPPORTED_DBT_VERSIONS, conforme mostrado no exemplo a seguir:

SELECT SYSTEM$SUPPORTED_DBT_VERSIONS();

Copy

[{"dbt_version":"1.9.4","type":"dbt Core"},{"dbt_version":"1.10.15","type":"dbt Core"}]

Alterar a versão de execução do dbt Core¶

Para alterar a versão do dbt Core que o objeto de projeto dbt executará, execute o comando ALTER DBT PROJECT conforme mostrado no exemplo a seguir:

ALTER DBT PROJECT my_dbt_project SET DBT_VERSION = '1.10.15';

Copy

Criar um projeto dbt vinculado a uma versão¶

O exemplo a seguir cria um projeto dbt vinculado à versão 1.10.15 do dbt:

CREATE OR REPLACE DBT PROJECT my_dbt_project
  FROM '@my_stage/dbt_files'
  DBT_VERSION = '1.10.15';

Copy

Para obter mais informações e exemplos, consulte CREATE DBT PROJECT e ALTER DBT PROJECT.

Como funcionam a descontinuação e a desativação¶

Versões com suporte Snowflake: essas versões estão disponíveis para todos os projetos novos e existentes. O Snowflake oferece suporte técnico completo, incluindo patches de segurança.
Versões obsoletas do Snowflake: essas versões chegaram ao fim do ciclo de desenvolvimento ativo. Embora continuem totalmente funcionais para projetos existentes, não recomendamos que os usuários iniciem novos projetos em uma versão obsoleta.
Versões desativadas do Snowflake: essas versões foram oficialmente removidas do ambiente Snowflake. Nesse estágio, nenhum projeto vinculado a uma versão desativada será executado até que seja atualizado para uma versão compatível atualmente.
Níveis de suporte do dbt Core: mesmo que uma versão atinja o status de Suporte crítico, Obsoleta ou Fim da vida útil de acordo com o dbt Labs, ela permanece compatível no Snowflake. Isso significa que você não precisa fazer atualizações imediatas e pode manter seu ambiente existente pelo tempo que desejar.