Migrando do Data Warehouse legado
O warehouse legado (client_analytics) está descontinuado. Ele continua funcionando, sem alterações, durante o período de migração — você migra no seu próprio ritmo atualizando duas coisas nas suas queries: o nome do banco de dados e, onde mudaram, os nomes de tabelas e colunas. Suas credenciais e o host de conexão também podem mudar; seu Account Manager confirmará.
O banco de dados legado client_analytics será desativado após o período de migração. Todas as integrações novas devem ser construídas apenas contra treble_client_analytics.
Mapeamento de tabelas
Renomeações de colunas para ficar de olho
Diferenças de comportamento que você deve conhecer
- Histórico completo. O warehouse legado limitava a maioria das tabelas a uma janela móvel de 3 meses. O novo warehouse serve tudo. Se suas queries dependiam dessa janela como filtro implícito, adicione filtros de data explícitos (bom também para a performance).
- “Hoje” mais atualizado, consolidação declarada. Os dados chegam em minutos em vez de horas, e os números de um dia se consolidam completamente em até 48 horas (veja o contrato de dados). Durante uma comparação de migração, você pode ver o novo warehouse ligeiramente à frente do legado no dia mais recente — isso é atraso de atualização do legado, não uma discrepância.
- Mensagens de conversas apagadas são excluídas de
fact_agent_conversation_messages por design (a conversa à qual pertencem não existe mais).
- O enriquecimento de contato em conversas antigas congela.
helpdesk_contact_id e contact_wa_id em conversas de agentes com mais de 90 dias mantêm o valor que tinham — mudanças no CRM não se propagam mais retroativamente para elas.
- Dois refinamentos de fórmula documentados em
fact_agent_daily: o tempo de primeira resposta agora vem do cálculo da própria plataforma, e as médias de CSAT consideram apenas conversas com avaliação (rating != 0). Ambos são correções; a paridade histórica foi verificada antes do lançamento.
- Sem aliases. Os nomes legados não são espelhados no novo banco de dados — o mapeamento acima é aplicado uma vez, nas suas queries, e os dois sistemas coexistem enquanto você faz isso.
Caminho de migração sugerido
- Aponte uma cópia do seu dashboard/relatório para
treble_client_analytics usando o mapeamento acima.
- Rode as duas versões lado a lado por alguns dias; espere correspondências exatas nos dias consolidados.
- Faça a troca, mantendo filtros de data explícitos.
- Avise seu Account Manager quando você não usar mais o
client_analytics — isso nos ajuda a programar a desativação.
