São três da manhã e um relatório crítico apareceu vazio. A investigação começa e, horas depois, descobre-se a causa: uma equipa de outra área mudou o nome de uma coluna na origem, sem saber que meia dúzia de pipelines dependia dela. Este cenário repete-se em empresas de todo o tamanho. Os contratos de dados existem para o acabar.
O problema dos pipelines que partem sem aviso
Os dados fluem entre equipas: quem os produz (uma aplicação, um sistema) e quem os consome (relatórios, modelos, outras equipas). O problema é que quem produz muitas vezes não sabe quem depende dos seus dados — muda um campo, um formato, um significado, e a jusante tudo parte silenciosamente. A confiança erode-se a cada surpresa destas.
O que é um contrato de dados
Um contrato de dados é um acordo explícito entre quem produz e quem consome sobre a forma e o significado dos dados: que campos existem, de que tipo, o que significam, com que qualidade e frequência chegam. Como um contrato de API, torna a promessa formal — e verificável — em vez de uma suposição implícita que se descobre partida quando já é tarde.
O que um bom contrato define
- Esquema: os campos, tipos e estrutura — e a garantia de que não mudam sem aviso.
- Semântica: o que cada campo significa de facto (o que conta como "cliente ativo").
- Qualidade: regras que os dados prometem cumprir (sem nulos aqui, valores neste intervalo).
- Compromisso de mudança: como e com que antecedência se avisa antes de alterar algo.
A mudança de mentalidade: dados como produto
Os contratos de dados fazem parte de uma ideia maior — tratar dados como um produto, com um dono responsável, e não como um subproduto que se despeja e alguém que se desenrasque a jusante. Quem produz passa a ter responsabilidade sobre quem consome, e essa responsabilidade muda tudo: os dados deixam de partir por descuido.
Como isto evita o desastre das 3 da manhã
Com um contrato em vigor e verificado automaticamente, a mudança perigosa é apanhada na origem: quando a equipa produtora tenta alterar o esquema, a validação falha antes de chegar a produção, e a mudança é coordenada com quem depende dela. O problema deixa de aparecer às 3 da manhã num relatório vazio — é travado à entrada, quando ainda é barato resolver.
Não é só tecnologia — é acordo
A parte técnica (validar esquemas, testar qualidade) é a mais fácil. O difícil e valioso é o acordo humano: as equipas falarem entre si, assumirem responsabilidades, tratarem os dados que produzem com o cuidado de um produto. A tecnologia materializa o contrato, mas é a cultura que o faz cumprir.
Na prática
Se vives a apanhar pipelines partidos por mudanças que ninguém avisou, os contratos de dados são a resposta estrutural — não mais um remendo. Começa pelo fluxo mais crítico: escreve o que ele promete, valida-o, e acorda como se comunicam mudanças. Quantas das tuas falhas de dados vinham, afinal, de uma mudança na origem que ninguém combinou?
