Migración de Datos

Cómo realizar una migración de datos con el Portal de Migración de Datos.

🤔 ¿Qué es el Portal de Migración de Datos?

El Portal de Migración de Datos te ayuda con cualquier migración de datos que quieras realizar hacia Fast Track CRM. Con la ayuda del portal, ahora eres completamente independiente para realizar migraciones de datos. Sin dependencias de Fast Track, puedes trabajar a tu propio ritmo y según tu propio horario. Sin embargo, si necesitas asistencia, por favor contacta a tu Gerente de Integración en Fast Track.

🔎 Dónde encontrar el Portal de Migración de Datos

Para encontrar y acceder al Portal de Migración de Datos, tu usuario necesita tener asignado el rol de Administrador de Gestión de Integración.

Cómo navegar:

  1. Desde el menú lateral de Fast Track CRM, haz clic en el botón Configuración
  2. Haz clic en Integraciones
  3. Selecciona Migración de Datos
Navegando al Portal de Migración de Datos
Navegando al Portal de Migración de Datos

⚙️ Cómo realizar una Migración de Datos

Paso 1: Planificación

  1. Decide qué tablas y columnas quieres migrar.
  2. Aquí necesitas entender qué Campos de Segmento serán afectados por tu migración.
  3. Ten en cuenta que los Campos de Segmento en Fast Track CRM se llaman nombre_tabla-nombre_campo. Por ejemplo, el Campo de Segmento con el nombre payment_activity-deposit_count se refiere a la columna deposit_count de la tabla payment_activity.
  4. Es importante tener en cuenta que si un campo no es migrado, entonces usarlo en Segmentación puede resultar en comportamiento no deseado debido al hecho de que los jugadores podrían tener valores nulos para los campos no migrados.
  5. Debes indicar si una tabla debe ser truncada antes de la migración de datos. ⚠‍ Seleccionar esta opción limpiará la tabla antes de llenarla con los datos migrados. Esta opción no debe ser seleccionada si solo planeas migrar los datos para un subconjunto de tus jugadores.
  6. Una vez que hayas seleccionado tus tablas, debes descargar plantillas CSV para las tablas seleccionadas. Necesitarás estas para subir archivos en el siguiente paso.
Mantente atento 👀‍​
  1. Al planificar, ten en cuenta la granularidad de las tablas que estás migrando. Si estás migrando payment_events, cada fila en tu archivo CSV subido debe corresponder a un cambio de estado en una transacción de pago. Si estás migrando casino_activity, cada fila corresponderá a un solo jugador, por lo que los datos deben representar un resumen agregado para ese jugador.
  2. Ten cuidado con cuándo debes truncar tablas;
    1. Si estás migrando un historial completo de eventos, es seguro truncar la tabla.
    2. Si estás migrando una tabla agregada, solo debes truncar si planeas incluir todos los jugadores en tu migración.
    3. Si estás migrando una selección de columnas de una tabla agregada, no debes truncar.

Paso 2: Subida

  1. Necesitarás guardar la migración antes de proceder a subir tus datos de prueba.
  2. Para cada tabla seleccionada en la etapa anterior, debes subir tus archivos en la sección de subida. Puedes subir múltiples archivos para la misma tabla. Nos encargaremos de consolidarlos en un solo archivo para ti.
  3. Los archivos necesitan tener la misma estructura que las plantillas descargadas en el paso anterior.
  4. Procede al mapeo; aquí necesitas mapear los archivos subidos a las tablas seleccionadas para migración. Si mapeas un archivo que no tiene la estructura correcta según la plantilla descargada, obtendrás un error al intentar mapearlo a la tabla.
Mantente atento 👀‍​
  1. Al extraer archivos de datos para tu subida, presta especial atención a las columnas de timestamp/fecha. Todas las columnas de timestamp/fecha migradas deben estar en formato YYYY-MM-DD y en tiempo UTC.
  2. Al subir archivos para la ejecución de prueba, te aconsejamos usar una gran porción (si no todos) de tus jugadores. Esto asegura que cualquier problema potencial en los datos sea detectado en la ejecución de prueba, antes de comenzar la migración completa de datos.

Paso 3: Ejecución de Prueba

  1. Solo haz clic en el botón.
  2. Espera a que la migración se complete.
  3. Cuando tu migración esté completa, ve a la etapa de QA.

Paso 4: QA

  1. Aquí obtendrás un resumen de los datos migrados.
  2. También se te presentará un conjunto de verificaciones de validación que se realizaron y si esas validaciones pasaron o no.
  3. Sigue cada paso en el QA y verifica que todo se vea bien.
  4. Descarga los archivos de reconciliación y verifica que los datos que fueron migrados se vean bien.
  5. Cuando estés satisfecho con los resultados, aprueba la ejecución de prueba y procede a realizar la ejecución completa.
Mantente atento 👀‍​
  1. Si algo sale mal en la ejecución de prueba, por ejemplo, notas inconsistencias en los datos durante el proceso de QA, es seguro abortar tu migración y comenzar una nueva. Esto es porque ningún dato de producción es modificado durante la ejecución de prueba.
  2. Usa el proceso de QA de la ejecución de prueba para verificar y confirmar que tus datos migrados son perfectos. Si no estás convencido de que tus datos se ven correctos, contacta a tu Gerente de Integración de Fast Track para asistencia.

Paso 5: Ejecución Completa

La ejecución completa de la migración sigue el mismo flujo que la ejecución de prueba. Lo que es importante tener en cuenta aquí es que para realizar la ejecución completa, Fast Track necesitará pausar el procesamiento de eventos en tiempo real y la activación de Actividades CRM. Esto se hace para asegurar la consistencia de datos y para asegurarse de que no se activen Actividades basadas en datos de Segmentación obsoletos.

Paso 5.1: Pausar Colas

  1. El primer paso en ejecutar la ejecución completa de la migración es pausar las colas.
  2. Cuando hagas clic en el botón pausar colas, se te pedirá confirmación. Tras la confirmación, el sistema pausará el procesamiento de mensajes de las colas.
  3. Se te proporcionará el timestamp exacto del último mensaje procesado antes de que las colas fueran pausadas. Es importante tomar nota de este timestamp.
  4. Al realizar exportaciones de datos, todos los campos incluidos en la migración deben ser calculados hasta el timestamp proporcionado. Cuando el procesamiento en tiempo real se reanude, el sistema Fast Track continuará agregando eventos en tiempo real desde ese timestamp en adelante, asegurando la consistencia de los datos.

Paso 5.2: Subir Archivos para Ejecución Completa

  1. La estructura de los archivos permanece igual que los archivos subidos en la ejecución de prueba.
  2. Ahora debes subir archivos para cada una de las tablas migradas. Te recordamos que los datos en los archivos deben estar agregados hasta el timestamp proporcionado en el paso anterior.
  3. Una vez que hayas subido los archivos para todas tus tablas, procede al siguiente paso.

Paso 5.3: Ejecutar

  1. Inicia el proceso de migración haciendo clic en el botón ejecutar.
  2. Espera a que la migración se complete - esto puede tomar algo de tiempo, dependiendo del volumen de datos que se está migrando.
  3. Cuando la migración de datos haya sido completada, procede al paso de Aseguramiento de Calidad.

Paso 5.4: QA

  1. El proceso de QA es similar al proceso de verificación que se realizó en la ejecución de prueba.
  2. En este punto, debes asegurarte de que todos los datos sean correctos.
  3. Si apruebas la migración, los servicios de Fast Track se reanudarán y el procesamiento de mensajes continuará desde el timestamp proporcionado anteriormente en adelante.
​ℹ‍Debes ver el siguiente banner una vez que la ejecución completa de la migración esté terminada:
​
​

Paso 5.5: Monitoreo de Servicios

  1. Después de que la migración de datos haya sido completada, los servicios de Fast Track se reanudarán. En este punto, debes dirigirte al portal de servicios y verificar que tu sistema Fast Track se vea saludable.
  2. Debes tener en cuenta que los mensajes que estaban en la cola continuarán siendo procesados - se espera una acumulación de mensajes en las siguientes colas ya que no se procesaron mensajes durante toda la duración de la migración:
    1. integration.api
    2. activitymanager.timeinstance
    3. activitymanager.lf-timeinstance
    4. activitymanager.sdtinstance
    5. singularity
    6. singularity-time
  3. Verifica que los mensajes estén siendo procesados y que el número de mensajes en las colas esté disminuyendo - se te debe dar un tiempo estimado de cuándo la cola será completamente procesada y el sistema esté de vuelta en tiempo real.
  4. Si los mensajes no están siendo procesados o algo no se ve bien, contacta a tu Gerente de Integración de Fast Track para obtener ayuda.
Mantente atento 👀‍​
  1. Si has comenzado una ejecución completa de tu migración de datos y por alguna razón quieres detener la migración, debes contactar a tu Gerente de Integración de Fast Track para asistencia.
  2. Si notas algo incorrecto con tus datos durante el proceso de QA, puedes revertir la migración, haciendo clic en Revertir. Esto revertirá tus datos de producción al estado en que estaban antes de que comenzara la migración. Alternativamente, puedes finalizar tu migración y ejecutar otra nueva.
  3. Es importante verificar que tus servicios estén funcionando nuevamente después de tu migración de datos. Si piensas que algo está mal con tus servicios de Fast Track, contacta a tu Gerente de Integración de Fast Track para asistencia.