<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

dbt do zero: transformação de dados com SQL versionado

DA

7 min

dbt do zero: transformação de dados com SQL versionado

Aprenda dbt do zero: modelos em SQL versionado, dependência com ref, testes, documentação e o caminho do zero ao primeiro projeto organizado.

Neste artigo

A camada SQL de uma empresa costuma ser o código mais crítico e menos cuidado ao mesmo tempo: consultas copiadas entre pastas, lógica repetida com pequenas diferenças e ninguém capaz de dizer qual tabela sustenta qual relatório. O dbt ataca exatamente esse problema: transforma o SQL em projeto de software, com arquivos versionados, dependência declarada, teste automatizado e documentação que se escreve junto com o código.

Dbt é uma ferramenta de linha de comando em que cada transformação vira um arquivo SQL com configuração, chamado modelo; os modelos se referenciam entre si com a função ref, o dbt monta a ordem de execução a partir dessas dependências, e os testes rodam junto. Para aproveitar a ferramenta, o SQL tem que estar em dia, e o guia de SQL do primeiro select à performance cobre a base que os modelos usam.

O que é o dbt e qual problema ele resolve?

dbt, sigla histórica de data build tool, cuida da camada de transformação: o dado já está no banco analítico, e o trabalho é converter tabela bruta em tabela de consumo, com regra de negócio, renomeação e agregação. O problema que ele resolve é organizacional antes de ser técnico: a mesma lógica escrita em dez lugares com dez variações, sem teste e sem histórico. Com o dbt, a lógica mora em um lugar, passa por revisão no Git e seu efeito aparece em todo modelo que depende dela. É a fronteira onde o trabalho de dados ganha método de engenharia.

Como funciona um modelo dbt?

Um modelo é um arquivo SQL com um bloco de configuração no topo. O exemplo típico transforma vendas brutas em resumo por cliente:

SELECT
    cliente_id,
    COUNT(*) AS total_pedidos,
    SUM(valor) AS receita_total
FROM {{ ref('stg_vendas') }}
GROUP BY cliente_id

A função ref faz duas coisas de uma vez: resolve o nome real da tabela no ambiente configurado e declara a dependência. Com ela, o dbt sabe que este modelo precisa rodar depois de stg_vendas, e monta a ordem de execução sozinho, sem script de controle. Troque o ambiente e a mesma linha aponta para a tabela do ambiente novo, o que elimina a família de erros que nasce de hardcode de nome de tabela.

O que o dbt adiciona além do SQL?

Três camadas vêm junto. A ordem de execução, que sai do grafo de dependências declaradas e elimina a coreografia manual de scripts. O materialização, a estratégia de como cada modelo vira objeto no banco, tabela, view ou incremental, definida em configuração e não em comando avulso. E o ambiente: o mesmo projeto roda em desenvolvimento e produção com troca de configuração, e cada pessoa trabalha em schema próprio sem colidir. O resultado prático é que a transformação ganha histórico, revisão e rollback, como qualquer código do time.

💡 Dica: comece pelo padrão de camadas: staging para limpar o bruto, intermediate para consolidar regra e marts para entregar consumo. Um projeto com três camadas bem definidas supera qualquer coleção de scripts soltos.

Como ficam teste e documentação?

Os testes são declarações no próprio arquivo: coluna única, não nula, valor dentro de uma lista aceita, relacionamento que existe. Rodar o conjunto é um comando, e a suíte acompanha cada mudança:

dbt test --select clientes

A documentação nasce do mesmo material: descrições escritas nos arquivos geram o catálogo automático do projeto, com linhagem completa mostrando de qual tabela bruta cada métrica veio. É esse grafo que responde em segundos a pergunta que custava tarde inteira: se a regra de receita mudar, quais relatórios sentem? Quando a resposta aponta para problema na origem dos dados, o guia de erros de modelagem que custam caro ajuda a separar falha de transformação de falha de desenho.

Como começar um projeto dbt do zero?

O caminho curto tem cinco passos: instale o dbt e inicie o projeto apontando para o banco analítico; traga uma tabela bruta e escreva o primeiro modelo de staging; declare um teste simples, como unicidade da chave; documente a fonte; e suba tudo no Git desde o primeiro arquivo, porque o versionamento é a peça central e não o enfeite. Escolha um domínio pequeno para o começo, como vendas, e cresça por domínio. Para o contexto maior em que o dbt se encaixa, o curso gratuito de fundamentos de engenharia de dados da DSA cobre o papel da transformação na esteira completa.

Os erros que atrapalham o primeiro projeto dbt

O primeiro é replicar a bagunça da origem: copiar a tabela bruta com coluna mal nomeada e regra implícita para o modelo final, sem deixar a camada de staging limpar e renomear. O dbt funciona quando o projeto tem camadas com papel definido, e a economia de pular a limpeza cobra juros em cada modelo seguinte. O segundo erro é escrever lógica de negócio espalhada em modelos soltos, sem fonte única para a métrica central; quando a receita aparece calculada de três formas diferentes, a confiança no projeto cai e não volta fácil.

O terceiro erro é negligenciar os testes declarados, rodando só o build. A suíte de teste é o que transforma o projeto dbt em contrato: unicidade de chave, não nulidade e valores aceitos detectam a quebra na origem antes de o relatório entregar número errado para a diretoria. Por fim, o erro organizacional: iniciar por um domínio grande e cheio de exceção, como faturamento com regra fiscal, quando um domínio pequeno e estável ensina o fluxo inteiro em menos tempo e com menos atrito.

Perguntas frequentes

Não para o uso corrente: modelos são SQL e configuração em YAML. Python aparece em casos avançados, como macros e hooks, e na operação de quem integra o dbt ao orquestrador. Para começar, SQL sólido resolve o essencial.

O dbt executa o dado ou só o SQL?

Ele compila e envia o SQL para o banco de destino: a execução acontece no motor do warehouse ou do banco analítico. O dbt não extrai nem carrega dado; ele organiza, versiona e testa a transformação que roda dentro do destino.

dbt funciona com MySQL e PostgreSQL?

Funciona com os dois, entre dezenas de adaptações disponíveis. Em bancos transacionais, o cuidado extra é o volume: transformações pesadas competem com a operação, e o desenho incremental ganha importância desde o começo.

O dbt substitui o orquestrador?

Não. Ele resolve a ordem interna do projeto de transformação; agendamento, monitoramento e retry entre projetos continuam com o orquestrador, que chama o dbt como tarefa. As ferramentas se complementam em camadas distintas.

Quanto tempo leva para valer a pena?

No primeiro domínio, o ganho aparece quando a segunda pessoa reusa um modelo pronto em vez de reescrever a lógica. Em time de uma pessoa, o retorno chega pela suíte de teste, que pega a quebra antes do relatório errado chegar ao negócio.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas de analista de dados →
DA

Escrito por

Dagmar

Atualizado em 06/10/2026 •

Ver perfil do autor

COMPARTILHAR