NOTAS DE CAPACIDADE
Mude o esquema de odds sem quebrar o poller
Sua tabela de preços vai precisar de uma coluna nova um dia. Mudanças só aditivas, uma view para consumidores, e backfill como trabalho separado.
Chega o dia em que a sua tabela de preços precisa de mais um campo: uma idade da fonte, um preço justo computado na ingestão, um flag para especiais. Uma mudança de esquema num pipeline ao vivo é onde projetos de fim de semana vão morrer, a menos que você siga três regras: mudanças são apenas aditivas, consumidores leem por uma view, e backfills são um trabalho separado com orçamento separado.
Adicione, nunca mude
A única migração segura numa tabela em produção é a adição. Adicione a coluna anulável, ou com um padrão que signifique desconhecido, e as inserções do poller continuam funcionando porque elas nunca nomearam a coluna. O desenho de tabela do guia de armazenamento, uma linha por preço alterado com a identidade completa na chave, é amigável a exatamente isso: a chave nunca muda, só o payload ao lado dela, verificado em 2026-10-16.
Renomeações, mudanças de tipo e mudanças de significado são para a próxima tabela, não para esta. Uma coluna cujo significado muda é uma coluna nova, e a antiga se aposenta pela view.
Consumidores leem por uma view
Seu painel e suas exportações nunca devem tocar a tabela física. Uma view apresenta o formato atual: as colunas que os consumidores esperam, na ordem que esperam, com a coluna nova aparecendo quando estiver pronta. Quando a próxima migração chega, a tabela cresce e a view absorve, e nada a jusante percebe.
É também aqui que a coluna aposentada some: ela fica na tabela enquanto a sua retenção a guardar, e a view simplesmente para de selecioná-la.
Backfills são um trabalho próprio
Uma coluna nova começa vazia, e a tentação é preenchê-la inline, dentro do poller. Resista. O backfill é um trabalho separado que percorre a tabela em ordem de chave, computa o novo campo para linhas antigas, e escreve em lotes, na sua própria agenda e com seu próprio orçamento de taxa. A regra de folga do guia de limites de taxa também se aplica aqui se o backfill precisar de dados da fonte: ele roda dentro da mesma cota do seu polling, não ao lado dele.
Um backfill que consegue parar e retomar, chaveado na última linha que tocou, é um backfill que sobrevive ao deploy que o iniciou.
Teste a migração como o parser
O hábito de teste offline também se aplica a esquemas: reproduza uma semana de respostas gravadas pelo novo código, e confirme que a coluna nova preenche exatamente como esperado antes de a tabela sequer vê-la. Uma migração testada em fixtures é uma migração que roda uma vez, de dia, com um log que você consegue ler.
Só adicione, view na frente, backfill como trabalho. Assim o esquema cresce como os dados crescem: uma linha cuidadosa por vez.