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 até 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();

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

Definir a versão padrão no nível da conta¶

Os administradores de conta podem definir uma versão padrão do dbt para todos os objetos de projeto dbt futuros na conta usando o parâmetro de conta DEFAULT_DBT_VERSION. Isso permite que você ative as versões mais recentes sem exigir que os usuários especifiquem DBT_VERSION em cada instrução CREATE DBT PROJECT.

ALTER ACCOUNT SET DEFAULT_DBT_VERSION = '1.10.15';

Essa versão padrão também é usada por espaços de trabalho para definir a versão inicial do tempo de execução do espaço de trabalho dbt.

Objetos de projeto dbt individuais ainda podem substituir o padrão da conta especificando DBT_VERSION no momento da criação, usando ALTER DBT PROJECT ou durante cada execução com EXECUTE DBT PROJECT.

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';

Criar um objeto de projeto dbt fixado a uma versão¶

O exemplo a seguir cria um objeto de projeto dbt fixado à 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';

Nota

Você também pode substituir a versão do dbt em uma única execução especificando DBT_VERSION na instrução EXECUTE DBT PROJECT.

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.