09 de outubro de 2025: projetos dbt no Snowflake: Melhorias recentes (Versão preliminar)¶

Falhas no projeto dbt aparecem como consultas com falha¶

Quaisquer erros de projeto de dbt – como falhas de compilação ou de teste – agora aparecem como falhas de consulta. Isso torna mais fácil lidar com eles com tarefas ou outras ferramentas de orquestração. Você pode visualizar os logs detalhados usando SELECT SYSTEM$get_dbt_log('<query_id>’).

Compilar na criação¶

Sempre que você implanta ou atualiza um objeto dbt Project, ele é compilado automaticamente para que os artefatos de construção estejam atualizados e Snowsight funciona sem problemas.

Isso poderá causar uma alteração interruptiva se você estiver implantando projetos que falham durante a compilação.

A compilação usa atualmente o perfil em seu profiles.yml por padrão. Como alternativa, você pode atualizar seu profiles.yml antes da implementação para apontar para a meta de produção antes da implementação. Em um lançamento futuro, você poderá substituir isso por DEFAULT_TARGET no objeto de projeto.

Instalar deps na compilação¶

Opcionalmente, você pode executar dbt deps durante a implantação para instalar dependências do projeto, definindo EXTERNAL_ACCESS_INTEGRATIONS=[...ext] em seus comandos de implementação ou atualização. Isso significa que você não precisa mais incluir /dbt_packages ao implantar projetos com dependências externas.

Em um lançamento futuro, a compilação na criação oferecerá suporte à sintaxe local:.

Privilégio MONITOR¶

Os projetos dbt agora oferecem suporte ao privilégio MONITOR. Isso permite que você veja o histórico de execução, baixe os artefatos de compilação de um objeto dbt Project e baixe os artefatos de compilação de cada execução do dbt Project. Esse privilégio pode ser concedido no nível DATABASE ou SCHEMA.

Acesso aos resultados de execução é mais fácil¶

Você pode baixar artefatos de construção diretamente da página Query History ou use as seguintes novas funções do sistema:

• SELECT SYSTEM$LOCATE_DBT_ARTIFACTS($latest_query_id): Retorna o caminho do arquivo para artefatos do dbt Project de uma execução (por exemplo, snow://dbt/DB_TEST.PUBLIC.DBT_PROJECT_TEST/results/query_id_01bf3f5a-010b-4d87-0000-53493abb7cce/).

• SELECT SYSTEM$LOCATE_DBT_ARCHIVE($latest_query_id): Retorna o local do zip do arquivo de saída do projeto dbt.

• SELECT SYSTEM$GET_DBT_LOG($latest_query_id): Retorna as últimas 1000 linhas do arquivo dbt.log. Para obter logs completos, baixe o arquivo zip.

Use a Snowflake CLI para baixar esses artefatos do estágio de resultados, por exemplo:

snowsql -q “GET 'snow://dbt_project/DB_TEST.PUBLIC.DBT_PROJECT_TEST/results/query_id_01bf3f89-0300-0001-0000-0000000c1229/dbt_artifacts.zip' file:///Users/user_name/Code/temp"

Essa nova abordagem substitui OUTPUT_ARCHIVE_URL e melhora a interoperabilidade com o Snowflake CLI e outros serviços.

Para obter mais informações, consulte Projetos dbt no Snowflake.