Sincronizar datos de BrazeAI Decisioning Studio
Esta página explica cómo sincronizar datos de tu almacén de datos directamente con BrazeAI Decisioning Studio™ mediante la ingesta de datos en la nube (CDI).
Con el destino de Decisioning Studio de CDI, CDI también puede sincronizar datos del almacén directamente con BrazeAI Decisioning Studio. Los datos de estas sincronizaciones se ponen a disposición de Decisioning Studio para su activación, pero tus perfiles de usuario y espacios de trabajo de Braze permanecen sin cambios.
Esta característica se encuentra en acceso anticipado. Ponte en contacto con tu CSM o director de cuentas para obtener acceso.
Cómo funciona
Cuando creas una sincronización, elige Decisioning Studio como destino y escribe una consulta SQL que devuelva los datos que quieres sincronizar. CDI ejecuta esa consulta según la programación que establezcas y entrega los resultados como un activo de Decisioning Studio. Cada sincronización se asigna a un único activo, por lo que no puedes dirigir más de una sincronización al mismo activo.
A diferencia de las sincronizaciones con la plataforma de datos de Braze, las sincronizaciones de Decisioning Studio no asignan tus datos a perfiles de usuario, eventos ni catálogos.
Para conocer otras formas de poner los datos a disposición de Decisioning Studio, consulta Conecta tus datos.
Requisitos previos
- Acceso a Braze y a BrazeAI Decisioning Studio.
- Un origen de almacén de datos de Cloud Data Ingestion activo. Si aún no has configurado uno, consulta Orígenes de Cloud Data Ingestion.
- La tabla o vista que quieres sincronizar.
- Una columna (o columnas) de esa tabla para usar como clave primaria y una columna de marca de tiempo que CDI pueda usar para la sincronización incremental.
Crear una sincronización de Decisioning Studio
Paso 1: Crea la sincronización y selecciona el destino
- Ve a Configuración de datos > Ingesta de datos en la nube > Sincronizaciones.
- Selecciona Crear sincronización de datos.
- Introduce un Nombre de la integración y, a continuación, selecciona tu origen en Orígenes de datos.
- En Destino, establece Destino de los datos en BrazeAI Decisioning Studio™.
- En Categoría de datos, selecciona el tipo de Datos de Decisioning Studio que mejor se ajuste a tu tabla. Elige entre Perfil del cliente, Eventos de interacción con mensajes, Eventos de conversión u Otros. Esto etiqueta los datos para Decisioning Studio y no cambia la forma en que CDI procesa tus filas.
Paso 2: Escribe tu consulta SQL
En el paso Definición de datos, escribe una consulta SQL que devuelva los datos de la tabla o vista que quieres sincronizar. El resultado de la consulta se convierte en el esquema de tu sincronización.
Puedes usar el explorador de orígenes para examinar las tablas y vistas disponibles, o el generador de SQL con IA para que te ayude a escribir tu consulta.
Tu consulta debe devolver una columna UPDATED_AT, ya que CDI usa UPDATED_AT para la sincronización incremental y el seguimiento de cambios. En cada ejecución de sincronización, CDI sincroniza solo las filas en las que UPDATED_AT es posterior al último valor sincronizado. Si la columna de marca de tiempo que identificaste no se llama ya UPDATED_AT, puedes asignarle un alias en tu consulta:
SELECT *, LAST_MODIFIED AS UPDATED_AT FROM my_table
Para obtener más información sobre cómo UPDATED_AT controla la sincronización incremental, incluido lo que ocurre cuando lo retrocedes, consulta Comprender la columna UPDATED_AT.
Solo se admiten consultas de solo lectura con una única instrucción, incluidas las cláusulas JOIN. CDI ejecuta consultas de solo lectura y no modifica tus tablas subyacentes.
Paso 3: Obtén una vista previa y valida tu consulta
Selecciona Vista previa y validar para ejecutar tu consulta. La sección Vista previa de la consulta (primeras 10 filas) muestra las primeras 10 filas devueltas por tu origen, junto con el tipo de datos detectado de cada columna, para que puedas confirmar que los datos son correctos antes de continuar.
Paso 4: Selecciona una clave primaria
Toda sincronización de Decisioning Studio necesita una clave primaria o compuesta, es decir, una o varias columnas que identifiquen de forma única cada fila. Cuando la validación se complete correctamente, abre el desplegable Clave primaria y selecciona una columna que sirva como clave primaria. Si seleccionas varias columnas, se forma una clave compuesta.
Una buena clave primaria es única para cada fila, nunca está vacía y se mantiene estable entre ejecuciones de sincronización. Evita los valores generados en el momento de la consulta, como UUID() o CURRENT_TIMESTAMP, ya que pueden provocar filas duplicadas o descartadas.
Paso 5: Configura las notificaciones y la programación, y crea la sincronización
- En el paso Notificaciones, introduce uno o varios Correos electrónicos de contacto para recibir notificaciones de errores de sincronización. También puedes activar las notificaciones de Error de fila y Sincronización correcta.
- En el paso Programación, activa Sincronización recurrente para ejecutar la sincronización automáticamente según una programación. Con Sincronización recurrente desactivada, la sincronización solo se ejecuta cuando la desencadenas, ya sea manualmente desde el panel o mediante el endpoint Desencadenar una sincronización.
- Revisa el Resumen y, a continuación, crea la sincronización.
Editar una sincronización
Cuando editas una sincronización existente, cualquier cambio en tu consulta SQL requiere una nueva validación antes de que puedas guardar. Las claves primarias y compuestas no se pueden cambiar y la consulta debe seguir devolviéndolas.
Los cambios válidos se aplican en la siguiente ejecución de la sincronización.
Gestión de cambios de esquema
CDI gestiona los cambios en el esquema de origen de forma aditiva. En cada ejecución de sincronización, CDI compara tu esquema de origen con el activo existente de Decisioning Studio y añade las columnas nuevas, conservando las que ya existen.
| Cambio en tu tabla de origen | Comportamiento de la sincronización |
|---|---|
| Se añade una columna nueva | CDI añade la columna al activo de Decisioning Studio. Las filas entregadas antes de que existiera la columna muestran null en ella. |
| Se elimina una columna | CDI deja de actualizar esa columna, pero la columna y sus datos existentes permanecen en el activo. Las demás columnas siguen sincronizándose. |
| Se cambia el nombre de una columna | Se trata como una columna eliminada más una columna nueva. La columna original permanece en el activo y se añade la columna nueva. |
| Cambia el tipo de datos de una columna | CDI convierte los valores cuando puede. Las filas que no puede convertir se notifican como errores de fila en los detalles de ejecución de la sincronización. |
Cuando CDI detecta un cambio de esquema, se muestra en los detalles de ejecución de la sincronización y en la página de edición de la sincronización, y tus contactos de notificación reciben una alerta por correo electrónico. Para cambiar qué columnas se entregan, actualiza tu consulta SQL y vuelve a validarla.