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 origen. 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 almacén de datos de Cloud Data Ingestion activo. Si aún no has configurado uno, consulta Orígenes de Cloud Data Ingestion.
- El nombre de la tabla o vista que quieres sincronizar, tal como aparece en tu almacén de datos.
- Una columna de tu tabla que contenga un identificador de usuario compatible y una columna con una marca de tiempo que Braze pueda utilizar para el seguimiento de cambios.
Braze solo ejecuta consultas de lectura sobre tus datos y no modifica tus tablas subyacentes. Es posible que se creen objetos temporales durante la ejecución de la consulta, pero no se conservan.
Crear 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 selecciona Crear sincronización de datos.
- Elige un nombre para tu sincronización y selecciona un origen de datos activo. Solo puedes usar orígenes activos.
- En Destino de los datos, selecciona Braze Data Platform.
- Selecciona un Tipo de datos.
- Selecciona Siguiente: Definición de datos.
Paso 2: Mapea el esquema de 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 de 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 controla dos mapeados obligatorios. No puedes crear la sincronización 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 desplegable del campo de destino. - Mapea una columna a
updated_at. Braze usa esta marca de tiempo para el seguimiento de cambios: cada ejecución de la sincronización importa las filas cuyoupdated_atsea posterior al último valor sincronizado.
Para cada una de las columnas restantes, 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 desplegable del campo de destino para mapear una columna a un atributo predeterminado o personalizado que ya exista en tu espacio de trabajo.
- Mapear a un campo nuevo. Escribe directamente en el 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 atributo nuevo, busca en el desplegable de destino si ya existe uno. Por ejemplo, si tu tabla tiene una columna fav_color pero tu espacio de trabajo ya hace seguimiento de favorite_color, plantéate mapear fav_color a favorite_color en lugar de crear otro atributo.
Los campos cuyo tipo de datos no coincide con el tipo detectado de tu columna muestran una advertencia de Discrepancia de tipo. Puedes continuar igualmente, pero es posible que los valores no coincidentes no se sincronicen y aparezcan como errores de fila. Puedes ver los errores de fila en los detalles de ejecución de una sincronización.
Paso 4: Obtén una vista previa y valida
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 vas a importar.
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. Opcionalmente, 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 correcta.
- 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 y cuáles ya existen, y las columnas excluidas de la importación por problemas de tipo de datos o por 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 comprueba 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 agrega 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 en el esquema se muestra en los detalles de la ejecución de la sincronización, y tus contactos de notificación reciben una alerta por correo electrónico. |
| Se cambia el nombre de una columna mapeada | Se trata como una columna eliminada más una columna nueva. |
| Cambia el tipo de datos de una columna | No se detecta como un cambio en el esquema. Los valores incompatibles se notifican como errores de fila en los registros de sincronización. |
Para reanudar una sincronización pausada después de eliminar una columna, selecciona Editar sincronización y revisa tus mapeados. La columna eliminada aparece marcada y ya no se muestra en el mapeador. Al guardar tus mapeados, confirmas que la sincronización debe continuar sin esa columna. Como alternativa, si los datos se trasladaron a otra columna, 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 que guardaste al crear la sincronización. Desde ahí puedes editar tus mapeados.
¿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 casos, 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 de 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 afecta esto a 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 la eficiencia de tus sincronizaciones. Para más información, consulta Prácticas recomendadas de la ingesta de datos en la nube.