pnclENGINEObter acesso à API

NOTAS DE CAPACIDADE

Una duas bases de histórico de odds sem duplicatas

Dois pollers, dois bancos, um histórico. A chave primária que torna a fusão idempotente, e a ordem de operações que a mantém segura.

Acontece depois de uma migração, um segundo poller, ou um experimento de um colega: dois armazenamentos, ambos guardando histórico de odds da Pinnacle, com cobertura sobreposta. A fusão é segura se você se apoiar na única coisa que o guia de armazenamento desenhou exatamente para isso: uma chave primária que nomeia uma observação de preço por completo, verificado em 2026-10-14.

A chave que torna fusões sem graça

A tabela price_changes do guia de armazenamento chaveia cada linha pela identidade completa da observação: evento, período, mercado, lado, pontos e o momento em que você a observou. Dois armazenamentos que viram o mesmo preço no mesmo instante guardam a mesma chave. Dois armazenamentos que discordam guardam chaves diferentes. Essa é a fusão inteira.

Uma inserção que pula chaves existentes, INSERT ... ON CONFLICT DO NOTHING em termos de Postgres, torna a fusão idempotente: rode duas vezes e a segunda não faz nada.

A ordem das operações

Faça a fusão em três passos, e mantenha as duas fontes em modo de leitura enquanto faz. Primeiro, aponte os dois esquemas para uma tabela de destino nova, para que uma execução errada não custe nada. Segundo, insira do armazenamento mais novo, depois do mais antigo, pulando conflitos; a contagem de conflitos é o seu relatório de sobreposição. Terceiro, rode as checagens de sanidade em que você já confia: contagens de linhas por dia, algumas verificações pontuais de partidas que você lembra, e as consultas de captura de fechamento que o guia de armazenamento descreve.

Só quando as checagens passam a tabela fundida vira a fonte. Os dois armazenamentos antigos ficam em modo de leitura até você ter certeza, porque a fusão é reversível até você deletar algo.

O que fazer com conflitos genuínos

Um conflito real, a mesma chave com um preço diferente, significa que os dois armazenamentos discordaram sobre qual era o preço num momento. Isso acontece quando os dois pollers leram snapshots diferentes ou quando um deles tinha um bug de parser. Escolha o armazenamento com a melhor trilha de monitoramento, registre cada conflito que você resolver, e guarde a linha perdedora numa tabela de quarentena em vez de deletá-la.

As métricas do guia de monitoramento são como você julga qual armazenamento estava mais saudável durante a janela de sobreposição.

Mantenha as lacunas marcadas

Cada armazenamento tem suas próprias janelas de queda, e o histórico fundido herda ambas. Se você registrou quedas seguindo o conselho do guia de armazenamento, una também as tabelas de quedas, para que uma consulta sobre o histórico fundido ainda consiga distinguir um mercado quieto de um ausente. O armazenamento fundido deve saber o que ele não sabe.

Uma chave, inserções idempotentes, conflitos em quarentena, lacunas marcadas. Assim dois históricos viram um, e a fusão é um script que você pode rodar de novo da próxima vez.