Ingesta de datos en la nube: Mapeador visual
Esta página explica cómo usar el mapeador visual para sincronizar una tabla o vista de tu almacén de datos con Braze sin escribir SQL ni reestructurar tus datos.
El mapeador visual está disponible para sincronizaciones de atributos, eventos personalizados y desencadenadores de Canvas en todos los orígenes de almacén de datos de la ingesta de datos en la nube. Para otros tipos de sincronización, consulta Elegir una opción de definición de datos.
Con el mapeador visual, puedes sincronizar una tabla o vista existente de tu almacén de datos sin escribir SQL ni reestructurar tus datos. En lugar de crear una tabla específica de Braze con las columnas EXTERNAL_ID, UPDATED_AT y PAYLOAD, mapeas las columnas de tu tabla existente a campos de Braze directamente en el panel.
Requisitos previos
Antes de crear una sincronización con el mapeador visual, necesitarás:
- Un origen de datos de almacén de datos de ingesta de datos en la nube activo. Si aún no has configurado uno, consulta Integraciones de almacén de datos.
- El nombre de la tabla o vista que deseas sincronizar, tal como aparece en tu almacén de datos.
- Una columna en tu tabla que contenga un identificador de usuario compatible, y una columna con una marca de tiempo que Braze pueda usar para el seguimiento de cambios.
Braze solo ejecuta consultas de solo lectura en tus datos y no modifica las tablas subyacentes. Es posible que se creen objetos temporales durante la ejecución de la consulta, pero no se conservan de forma persistente.
Creación de una sincronización con el mapeador visual
Paso 1: Configura la sincronización
- Ve a Configuración de datos > Ingesta de datos en la nube > Sincronizaciones y, a continuación, selecciona Crear sincronización de datos.
- Elige un nombre para tu sincronización y selecciona un origen de datos activo. Solo se pueden utilizar orígenes activos.
- En Destino de datos, selecciona Braze Data Platform.
- Selecciona un Tipo de datos.
- Selecciona Siguiente: Definición de datos.
Paso 2: Mapea el esquema del origen
- En el paso Definición de datos, selecciona Visual.
- Introduce el nombre de la tabla o vista tal como aparece en tu almacén de datos.
- Selecciona Mapear esquema del origen. Braze lee el esquema de tu tabla o vista y muestra cada columna con su tipo de datos detectado para que puedas mapearla a un campo de Braze.
Paso 3: Revisa tus mapeados
La sección Revisar mapeado hace un seguimiento de dos mapeados obligatorios. Tu sincronización no se puede crear hasta que ambos estén completos:
- Mapea una columna a un identificador de usuario aceptado por Braze:
external_id,braze_id,email,phoneo un alias de usuario. Las opciones de identificador aparecen en Identificadores en el menú desplegable del campo de destino. - Mapea una columna a
updated_at. Braze utiliza esta marca de tiempo para el seguimiento de cambios, donde cada ejecución de sincronización importa las filas en las queupdated_ates posterior al último valor sincronizado.
Para cada columna restante, puedes:
- Mantener el mapeado predeterminado. Cada columna se mapea a un campo de Braze con el mismo nombre. Si el campo aún no existe en tu espacio de trabajo, se marca como Nuevo atributo y se crea durante la primera ejecución de la sincronización.
- Mapear a un campo existente. Busca en el menú desplegable del campo de destino para mapear una columna a un atributo predeterminado o personalizado existente en tu espacio de trabajo.
- Mapear a un campo nuevo. Escribe directamente en el menú desplegable del campo de destino para mapear una columna a un nuevo atributo personalizado.
- Excluir la columna. Desmarca la casilla Importar para dejar una columna fuera de la sincronización.
Antes de crear un nuevo atributo, busca uno existente en el menú desplegable de destino. Por ejemplo, si tu tabla tiene una columna fav_color pero tu espacio de trabajo ya hace seguimiento de favorite_color, considera mapear fav_color a favorite_color en lugar de crear otro atributo.
Los campos cuyo tipo de datos no coincida con el tipo detectado de tu columna muestran una advertencia de Discrepancia de tipo. Puedes continuar de todas formas, pero los valores no coincidentes pueden fallar durante la sincronización y generar errores de fila. Puedes ver los errores de fila en los detalles de ejecución de una sincronización.
Paso 4: Vista previa y validación
Selecciona Vista previa y validación para ejecutar una comprobación de solo lectura en tu tabla o vista. La vista previa muestra las primeras 10 filas con los nombres de campo mapeados y solo incluye las columnas que estás importando.
Paso 5: Termina de crear la sincronización
- En el paso Notificaciones, introduce al menos un correo electrónico de contacto para las notificaciones de errores de sincronización. De forma opcional, puedes activar las alertas de Error de fila (que se envían cuando un porcentaje de filas no se actualiza) y las notificaciones de Sincronización exitosa.
- En el paso Programación, activa Sincronización recurrente para ejecutar la sincronización de forma programada, o déjala desactivada para una sincronización única.
- Revisa el paso Resumen. Muestra tu configuración, qué atributos son nuevos frente a los existentes y las columnas excluidas de la importación debido a problemas de tipo de datos o tus selecciones.
- Selecciona Crear sincronización. También puedes seleccionar Guardar como borrador en cualquier paso para terminar más tarde.
Gestión de cambios en el esquema
El mapeador visual verifica el esquema de tu tabla o vista en cada ejecución de sincronización y responde según el tipo de cambio:
| Cambio en tu tabla de origen | Comportamiento de la sincronización |
|---|---|
| Se añade una nueva columna | La sincronización continúa, pero las nuevas columnas no se sincronizan automáticamente. Para incluir una, edita la sincronización y mapéala. |
| Se elimina una columna mapeada | La ejecución de la sincronización falla y la sincronización se pausa. El cambio de esquema se muestra en los detalles de ejecución de la sincronización, y tus contactos de notificación reciben una alerta por correo electrónico. |
| Se renombra una columna mapeada | Se trata como una columna eliminada más una nueva columna. |
| Cambia el tipo de datos de una columna | No se detecta como un cambio de esquema. Los valores incompatibles se reportan como errores de fila en los registros de sincronización. |
Para reanudar una sincronización pausada después de que se elimine una columna, selecciona Editar sincronización y revisa tus mapeados. La columna eliminada se marca y ya no aparece en el mapeador. Guardar tus mapeados confirma que la sincronización debe continuar sin esa columna. Alternativamente, si los datos se movieron a una columna diferente, mapea la nueva columna antes de guardar.
Preguntas frecuentes
¿Puedo editar mis mapeados después de crear una sincronización?
Sí. Edita la sincronización y selecciona Ver y editar mapeado. Se carga el esquema actual de la tabla de origen, con los mapeados previos que guardaste al crear la sincronización. Puedes editar tus mapeados desde ahí.
¿Puedo transformar mis datos en el mapeador visual?
No. El mapeador visual sincroniza los valores de las columnas exactamente como aparecen en tu origen. No admite transformaciones, lógica condicional ni uniones entre tablas. Para esos ejemplos, usa la opción SQL en el paso de definición de datos para dar forma a tus datos con una consulta. Para más información, consulta Ingesta de datos en la nube: editor SQL.
¿Cambian mis sincronizaciones CDI existentes?
No. Las sincronizaciones que usan el formato de tabla existente con las columnas EXTERNAL_ID, UPDATED_AT y PAYLOAD siguen funcionando, y aún puedes crearlas.
¿Cómo se ve afectado mi uso de Braze?
Cada columna que importas y mapeas se escribe como una actualización de campo de Braze, y la facturación de puntos de datos funciona igual que en otras sincronizaciones de datos de usuario de CDI. Excluir las columnas que no necesitas mantiene tus sincronizaciones eficientes. Para más información, consulta Prácticas recomendadas de ingesta de datos en la nube.