Analytics Warehouse
O Analytics Warehouse é a nova geração da plataforma de dados da Treble. Ele te dá acesso SQL direto aos seus dados operacionais com atualização quase em tempo real, histórico completo e vários datasets que nunca estiveram disponíveis antes — incluindo o rastro completo de mensagens de cada conversa e o percurso nó a nó de cada fluxo.O Analytics Warehouse substitui o Data Warehouse anterior (
client_analytics), que agora está descontinuado. Ambos permanecem disponíveis durante o período de migração. Se você está migrando queries existentes, comece pelo Guia de Migração.O que há de novo
Conexão
Uma vez habilitado o acesso, você receberá credenciais para se conectar:
Você pode usar qualquer cliente compatível com ClickHouse: DBeaver, DataGrip,
clickhouse-client, ou conectar diretamente a partir de Metabase, Looker, Power BI, Google Sheets ou outra ferramenta de BI.
O acesso está disponível para empresas que solicitarem o onboarding. Entre em contato com seu Account Manager ou com o suporte para iniciar o processo.
O contrato de dados
Três promessas definem como o warehouse se comporta. Entendê-las vai te poupar tempo:- Os dados são quase em tempo real. Novas sessões, mensagens e envios de campanha aparecem minutos depois de acontecerem.
- Hoje é provisório; o histórico é definitivo. Os dados operacionais continuam mudando enquanto estão em andamento — um envio de campanha que está “em processamento” às 10:00 pode estar “entregue” às 11:00, tanto na Treble quanto no seu warehouse. Os números de qualquer dia se consolidam completamente em até 48 horas, e o warehouse se autocorrige continuamente (a cada 30 minutos) durante essa janela. Os dados históricos além dessa janela são imutáveis.
- Cada linha te diz quando chegou. Todas as tabelas expõem uma coluna
synced_at: o momento em que a linha (ou sua correção mais recente) foi gravada. É isso que viabiliza a sincronização incremental confiável para os seus próprios sistemas.
Glossário de nomenclatura
O warehouse usa um vocabulário consistente em todas as tabelas:Segurança e limites
- Segurança em nível de linha: suas credenciais só conseguem ver as linhas da sua empresa — garantido pelo banco de dados em todas as tabelas, em todas as consultas.
- Somente leitura: seu usuário não pode modificar, criar nem excluir nada.
- Limites de proteção: as consultas têm um tempo máximo de execução de 30 segundos e limites de linhas e memória que mantêm a plataforma estável para todos. Consulte Otimização de Consultas para saber como se manter bem dentro deles.