Preguntas frecuentes

Esta página contiene respuestas a algunas preguntas frecuentes sobre la ingesta de datos en la nube.

¿Con qué frecuencia puede ejecutarse una sincronización de CDI?

Las sincronizaciones recurrentes pueden ejecutarse con una frecuencia de hasta cada 5 minutos o tan poco como una vez al mes. De forma predeterminada, el intervalo más corto que puedes configurar en el panel es de 15 minutos, lo que ayuda a gestionar los costos de cómputo de tu almacén de datos y el volumen de solicitudes. Para sincronizar con una frecuencia de hasta cada 5 minutos, ponte en contacto con el soporte de Braze o con tu administrador de éxito del cliente. Para sincronizar en cuanto cambien tus datos, llama al endpoint Desencadenar una sincronización. Para más información, consulta Cómo funciona.

¿Por qué recibí un correo electrónico con el asunto “Error in CDI Sync”?

Este tipo de correo electrónico suele indicar que hay un problema con tu configuración de CDI. Estos son algunos problemas habituales y cómo solucionarlos:

CDI no puede acceder al almacén de datos o a la tabla con tus credenciales

Esto podría significar que las credenciales en CDI son incorrectas o que están mal configuradas en el almacén de datos. Para más información, consulta los pasos de configuración en tu página de origen.

No se encuentra la tabla

Prueba a actualizar tu integración con la configuración correcta de la base de datos o crea los recursos correspondientes en el almacén de datos, como database/table.

No se encuentra el catálogo

El catálogo configurado en la integración no existe en el catálogo de Braze. Es posible que el catálogo se haya eliminado después de configurar la integración. Para resolver el problema, actualiza la integración para que use otro catálogo o crea un nuevo catálogo que coincida con el nombre del catálogo de la integración.

¿Por qué recibí un correo electrónico con el asunto “Row errors in your CDI sync”?

Este tipo de correo electrónico significa que algunos de tus datos no se pudieron procesar durante la sincronización. Para conocer el error específico, puedes revisar los registros en Braze; para ello, ve a CDI > Registro de sincronización.

¿Cómo soluciono el error “Time must be string in ISO8601 Format” en la configuración de CDI?

Este error significa que el valor time del evento en tu carga útil de CDI no está en un formato de fecha y hora compatible.

Para las cargas útiles de eventos y compras, da formato a time como:

• Una cadena ISO 8601, o
• yyyy-MM-dd'T'HH:mm:ss:SSSZ

Si se omite time, Braze utiliza UPDATED_AT como hora del evento.

Para conocer todos los requisitos de la carga útil, consulta Configuración de tablas para la ingesta de datos en la nube.

¿Cómo soluciono los errores de Test Connection y de los correos electrónicos de soporte?

Test Connection se ejecuta en tu almacén de datos, así que aumentar la capacidad del almacén puede mejorar su velocidad. Usar una instancia de SQL sin servidor reduce el tiempo de preparación y mejora el rendimiento de las consultas, aunque puede suponer unos costes de integración algo más altos.

Para ver los mensajes de error específicos de tu fuente, consulta la sección de solución de problemas en la página de esa fuente:

¿Cómo actualizo mis preferencias de alertas por correo electrónico para las integraciones de CDI?

Cada integración tiene su propia preferencia de notificación. Ve a la página de CDI y selecciona el nombre de la integración que quieres actualizar. En la sección Preferencias de notificación puedes actualizar cómo recibes las alertas relacionadas con la integración seleccionada.

¿Por qué veo un error “Incorrect Integration Object”?

Este error se produce cuando intentas actualizar las preferencias de notificación de una integración de CDI y dos o más espacios de trabajo tienen integraciones que apuntan al mismo contenedor o carpeta de almacenamiento en el cloud. Cada ubicación de almacenamiento en el cloud solo puede utilizarla una integración a la vez.

Para resolverlo:

1. Identifica qué otro espacio de trabajo tiene una integración de CDI que utiliza la misma ubicación de almacenamiento.
2. Elimina o vuelve a configurar la integración en conflicto en el otro espacio de trabajo.
3. Después de eliminar el conflicto, podrás actualizar las preferencias de notificación.

El error ya no debería aparecer y deberías poder actualizar tus preferencias de notificación correctamente. Si sigues teniendo problemas, abre un ticket de soporte.

¿Qué ocurre si se sincroniza un UPDATED_AT futuro con una integración?

CDI utiliza UPDATED_AT para decidir qué datos son nuevos. Después de sincronizar un UPDATED_AT futuro, no se procesarán los datos anteriores a esa fecha y hora futuras. Para solucionarlo:

1. Corrige UPDATED_AT.
2. Elimina los datos antiguos que ya se hayan sincronizado con Braze.
3. Crea una nueva integración para volver a procesar esa tabla.

¿Por qué “Rows Synced” no coincide con el número de mi almacén de datos?

CDI usa UPDATED_AT para decidir qué registros recoger durante una sincronización. Consulta esta ilustración para ver cómo funciona. Al comienzo de una ejecución de sincronización, CDI consulta tu almacén de datos para obtener todos los registros con un UPDATED_AT posterior al último valor de UPDATED_AT procesado. Los registros con la marca de tiempo exacta del límite también pueden volver a sincronizarse si hay filas nuevas que comparten esa marca de tiempo. Cualquier registro recogido en el momento en que se ejecuta la consulta se sincroniza en Braze. Estos son algunos casos habituales en los que un registro podría no sincronizarse:

• Estás añadiendo registros a la tabla con un valor de UPDATED_AT que ya se ha procesado.
• Estás actualizando los valores de registros después de que una sincronización los haya procesado, pero sin cambiar UPDATED_AT.
• Estás añadiendo o actualizando registros mientras hay una sincronización en curso. Dependiendo de cuándo se ejecute la consulta de CDI, podrían producirse condiciones de carrera que provoquen que no se recojan algunos registros.

Consejo

Para evitar estos comportamientos en el futuro, te recomendamos usar valores de UPDATED_AT que aumenten de forma monótona y no actualizar la tabla durante la ejecución de la sincronización programada.

¿Necesito valores de UPDATED_AT mayoritariamente distintos para importaciones grandes de CDI?

Sí. En ejecuciones de gran volumen (por ejemplo, más de aproximadamente 10 millones de filas), asegúrate de que tus datos de origen tengan valores de UPDATED_AT mayoritariamente distintos. Si demasiadas filas comparten la misma marca de tiempo, es más probable que CDI vuelva a seleccionar filas en las marcas de tiempo límite en ejecuciones posteriores. Esto puede aumentar las sincronizaciones duplicadas y el consumo de puntos de datos.

Para más información sobre el comportamiento de CDI en los límites, consulta Evita volver a sincronizar filas con marcas de tiempo duplicadas.

¿Dónde ejecuto estas comprobaciones SQL?

Ejecuta las comprobaciones directamente en el editor SQL de tu almacén de datos, sobre la misma tabla o vista que utiliza tu integración de CDI:

• Snowflake: Projects > Worksheets (para más información, consulta Snowflake Worksheets)
• Redshift: Query Editor v2 (para más información, consulta Uso de Amazon Redshift Query Editor v2)
• BigQuery: espacio de trabajo SQL de BigQuery Studio (para más información, consulta Introducción a BigQuery Studio)
• Databricks: editor SQL (SQL warehouse) (para más información, consulta Editor SQL de Databricks)
• Fabric: editor de consultas SQL

Sigue este proceso antes de habilitar o escalar una sincronización grande:

1. Identifica la tabla o vista de origen exacta de CDI y la ventana de sincronización que quieres validar.
2. Abre el editor SQL de tu almacén de datos y selecciona la misma base de datos y el mismo esquema que utiliza CDI; después, usa un rol con acceso de lectura a la tabla o vista de origen.
3. Ejecuta la consulta de recuento de marcas de tiempo distintas para medir cuántos valores distintos de UPDATED_AT existen en esa ventana.
4. Ejecuta la consulta que agrupa por UPDATED_AT y cuenta las filas para encontrar marcas de tiempo con un número de filas inusualmente alto.
5. Si muchas filas comparten marcas de tiempo idénticas, ajusta tu proceso de ingesta para que los lotes consecutivos usen valores de UPDATED_AT progresivamente más recientes, o aumenta la precisión de las marcas de tiempo para que las filas estén más distribuidas.
6. Vuelve a ejecutar ambas consultas hasta reducir la concentración y, después, lanza o escala tu sincronización.
7. Tras el lanzamiento, supervisa CDI > Registro de sincronización para detectar volúmenes inesperados de resincronización en las marcas de tiempo límite.

Usa comprobaciones como estas en tu almacén de datos:

1
2
3
4
5
6
7

SELECT
  COUNT(*) AS total_rows,
  COUNT(DISTINCT UPDATED_AT) AS distinct_timestamps,
  ROUND(COUNT(*) * 1.0 / NULLIF(COUNT(DISTINCT UPDATED_AT), 0), 2) AS avg_rows_per_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP);

1
2
3
4
5
6
7
8
9

SELECT
  UPDATED_AT,
  COUNT(*) AS rows_at_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP)
GROUP BY UPDATED_AT
ORDER BY rows_at_timestamp DESC
LIMIT 20;

Si tu almacén de datos no admite LIMIT (por ejemplo, Fabric), usa una sintaxis equivalente, como TOP.

¿Por qué una sincronización de CDI con pocas filas puede tardar varios minutos?

Una sincronización de CDI incluye un periodo de inicio fijo antes de que comience el procesamiento de filas. Como este tiempo de inicio es similar sea cual sea el tamaño de la sincronización, una sincronización pequeña puede tardar igualmente varios minutos y parecer más lenta en filas por minuto. El tiempo total de sincronización sigue dependiendo de la complejidad de la consulta de origen, la estructura de los datos y la capacidad disponible en tu almacén de datos. Para más información, consulta Fuentes de ingesta de datos en la nube.

Durante una sincronización, ¿se conserva el orden si varios registros comparten el mismo ID?

El orden de procesamiento no es 100 % predecible. Por ejemplo, si hay varias filas con el mismo EXTERNAL_ID en la tabla durante una sincronización, no podemos garantizar qué valor quedará en el perfil final. Si estás actualizando el mismo EXTERNAL_ID con atributos diferentes en la columna de carga útil, todos los cambios se reflejan cuando se completa la sincronización.

¿Por qué no se crean nuevos usuarios desde mi sincronización de CDI?

Si tu integración de CDI tiene habilitada la opción Actualizar solo usuarios existentes, solo se actualizan los usuarios que ya existen en Braze y no se crean usuarios nuevos. Esto significa que, si una fila de tu tabla de sincronización hace referencia a un EXTERNAL_ID que no coincide con ningún usuario existente de Braze, esa fila se omite.

Para crear nuevos usuarios mediante CDI, desactiva la opción Actualizar solo usuarios existentes en la configuración de tu integración. Ve a Configuración de datos > Ingesta de datos en la nube y selecciona una integración.

¿Cuáles son las medidas de seguridad para CDI?

Nuestras medidas

Braze tiene implementadas las siguientes medidas para CDI:

• Todas las credenciales están cifradas en nuestra base de datos y solo determinados empleados tienen acceso autenticado a ellas.
• Usamos conexiones cifradas para llevar los datos a los almacenes de datos de los clientes.
• Hacemos solicitudes a los endpoints de la API de Braze usando las mismas claves de API y conexiones TLS que recomendamos a nuestros clientes.
• Actualizamos periódicamente nuestras bibliotecas y aplicamos todos los parches de seguridad.

Tus medidas

Te recomendamos que tú y tu equipo configuréis las siguientes medidas de seguridad por vuestra parte:

• Restringe el acceso de las credenciales al mínimo necesario para que CDI funcione. Esto se debe a que necesitamos poder ejecutar select (y count) en las tablas y vistas específicas.
• Restringe las IP que pueden acceder a las tablas a las IP de Braze publicadas oficialmente. Cada página de fuente enumera las IP que debes permitir para esa fuente.