Migrar desde el Data Warehouse legacy
El warehouse legacy (client_analytics) está deprecado. Sigue funcionando, sin cambios, durante el periodo de migración — migras a tu propio ritmo actualizando dos cosas en tus queries: el nombre de la base de datos y, donde cambiaron, los nombres de tablas y columnas. Tus credenciales y el host de conexión también pueden cambiar; tu Account Manager lo confirmará.
La base de datos legacy client_analytics será dada de baja después del periodo de migración. Toda integración nueva debe construirse únicamente contra treble_client_analytics.
Mapeo de tablas
Renombres de columnas a tener en cuenta
Diferencias de comportamiento que debes conocer
- Historia completa. El warehouse legacy recortaba la mayoría de las tablas a una ventana móvil de 3 meses. El nuevo warehouse sirve todo. Si tus queries dependían de esa ventana como filtro implícito, agrega filtros de fecha explícitos (también es bueno para el rendimiento).
- “Hoy” más fresco, consolidación declarada. Los datos aterrizan en minutos en lugar de horas, y las cifras de un día se consolidan por completo dentro de 48 horas (mira el contrato de datos). Durante una comparación de migración puedes ver el nuevo warehouse ligeramente adelantado respecto al legacy en el día más reciente — eso es rezago de actualización del legacy, no una discrepancia.
- Los mensajes de conversaciones eliminadas se excluyen de
fact_agent_conversation_messages por diseño (la conversación a la que pertenecen ya no existe).
- El enriquecimiento de contacto en conversaciones antiguas se congela.
helpdesk_contact_id y contact_wa_id en conversaciones de agente de más de 90 días conservan el valor que tenían — los cambios del CRM ya no se propagan hacia atrás en ellas.
- Dos refinamientos de fórmula documentados en
fact_agent_daily: el tiempo de primera respuesta ahora viene del cálculo propio de la plataforma, y los promedios de CSAT consideran solo conversaciones con calificación (rating != 0). Ambos son correcciones; la paridad histórica se verificó antes del lanzamiento.
- Sin alias. Los nombres legacy no están espejados en la nueva base de datos — el mapeo de arriba se aplica una sola vez, en tus queries, y ambos sistemas coexisten mientras lo haces.
Ruta de migración sugerida
- Apunta una copia de tu dashboard/reporte a
treble_client_analytics usando el mapeo de arriba.
- Ejecuta ambas versiones en paralelo durante unos días; espera coincidencias exactas en los días consolidados.
- Haz el cambio definitivo, manteniendo filtros de fecha explícitos.
- Avísale a tu Account Manager cuando ya no uses
client_analytics — nos ayuda a programar la baja definitiva.
