Preguntas más frecuentes

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

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

Este tipo de correo electrónico suele significar que hay un problema con tu configuración de CDI. A continuación se presentan algunos problemas comunes 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 están mal configuradas en el almacén de datos. Para obtener más información, consulta Integraciones de almacenes de datos.

No se puede encontrar la tabla

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

No se puede encontrar el catálogo

El catálogo configurado en la integración no existe en el catálogo de Braze. Un catálogo puede eliminarse después de que la integración se haya configurado. Para resolver el problema, actualiza la integración para utilizar un catálogo diferente o crea un nuevo catálogo que coincida con el nombre del catálogo en 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 pudieron procesarse durante la sincronización. Para conocer el error específico, puedes revisar los registros en Braze en CDI > Sync Log.

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

Este error significa que el valor de 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, formatea time como:

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

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

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

¿Cómo soluciono errores de Probar conexión y correos electrónicos de soporte?

• snowflake
• redshift
• bigquery
• databricks

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

Cada integración tiene sus propias preferencias de notificación. Ve a la página de CDI y selecciona el nombre de la integración que deseas actualizar. En la sección Notification preferences puedes actualizar cómo recibes alertas sobre la integración seleccionada.

¿Por qué aparece el error “Incorrect Integration Object”?

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

Para resolverlo:

1. Identifica qué otro espacio de trabajo tiene una integración CDI usando la misma ubicación de almacenamiento.
2. Elimina o reconfigura 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 determinar qué datos son nuevos. Después de que se sincroniza un UPDATED_AT futuro, cualquier dato anterior a esa fecha y hora futura no se procesará. Para solucionar esto:

1. Corrige UPDATED_AT.
2. Elimina cualquier dato antiguo que ya se haya sincronizado con Braze.
3. Crea una nueva integración para procesar esa tabla de nuevo.

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

CDI utiliza UPDATED_AT para decidir qué registros recoger durante una sincronización. Consulta esta ilustración para ver cómo funciona. Al inicio de una ejecución de sincronización, CDI consulta tu almacén de datos para obtener todos los registros con UPDATED_AT posterior al valor de UPDATED_AT previamente procesado. Los registros que se encuentran exactamente en la marca de tiempo límite también pueden volver a sincronizarse si nuevas filas comparten esa marca de tiempo. Cualquier registro recogido en el momento en que se ejecuta la consulta se sincroniza en Braze. Estos son los casos comunes 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 ha sido procesado.
• Estás actualizando valores de registros después de que hayan sido procesados por una sincronización, pero dejando UPDATED_AT sin cambios.
• Estás añadiendo o actualizando registros mientras una sincronización está en curso. Dependiendo de cuándo se ejecute la consulta de CDI, podrían existir condiciones de carrera que provoquen que los registros no sean recogidos.

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 sincronización programada.

¿Necesito valores UPDATED_AT mayoritariamente distintos para importaciones CDI grandes?

Sí. Para ejecuciones de alto volumen (por ejemplo, más de aproximadamente 10 millones de filas), asegúrate de que tus datos de origen tengan valores 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 obtener más información sobre el comportamiento de límite de CDI, consulta Evitar la resincronización de 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, contra la misma tabla o vista utilizada por tu integración CDI:

• Snowflake: Projects > Worksheets (para obtener más información, consulta Snowflake Worksheets)
• Redshift: Query Editor v2 (para obtener más información, consulta Using Amazon Redshift Query Editor v2)
• BigQuery: BigQuery Studio SQL workspace (para obtener más información, consulta BigQuery Studio introduction)
• Databricks: SQL editor (SQL warehouse) (para obtener más información, consulta Databricks SQL editor)
• Fabric: SQL query editor

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

1. Identifica la tabla o vista de origen CDI exacta y la ventana de sincronización que deseas validar.
2. Abre el editor SQL de tu almacén de datos y selecciona la misma base de datos y esquema utilizados por CDI, luego usa un rol con acceso de lectura a la tabla o vista de origen.
3. Ejecuta la consulta de conteo de marcas de tiempo distintas para medir cuántos valores UPDATED_AT distintos existen en esa ventana.
4. Ejecuta la consulta que agrupa por UPDATED_AT y cuenta filas para encontrar marcas de tiempo con conteos de filas inusualmente altos.
5. Si muchas filas comparten marcas de tiempo idénticas, ajusta tu proceso de ingesta para que los lotes consecutivos utilicen valores 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 que la concentración se reduzca, luego lanza o escala tu sincronización.
7. Después del lanzamiento, monitorea CDI > Sync Log para detectar volúmenes de resincronización inesperados 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 un número pequeño de filas puede tardar varios minutos?

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

Durante una sincronización, ¿se preserva 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 terminará en el perfil final. Si estás actualizando el mismo EXTERNAL_ID con diferentes atributos en la columna de carga útil, todos los cambios se reflejan cuando se completa la sincronización.

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

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

Para crear nuevos usuarios a través de CDI, desactiva la opción Update existing users only en la configuración de tu integración. Ve a Data Settings > Cloud Data Ingestion y selecciona una integración.

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

Nuestras medidas

Braze tiene las siguientes medidas implementadas para CDI:

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

Tus medidas

Te recomendamos que tú y tu equipo configuren las siguientes medidas de seguridad de su lado:

• Restringe el acceso a 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.