Preguntas más frecuentes
Esta página contiene respuestas a algunas preguntas frecuentes sobre la Ingesta de datos en la nube.
Por qué me enviaron un correo electrónico: ¿”Error en la sincronización CDI”?
Este tipo de correo electrónico suele significar que hay un problema con la configuración de su CDI. Aquí tienes algunos problemas comunes y cómo solucionarlos:
CDI no puede acceder al almacén de datos o a la tabla utilizando sus credenciales
Esto podría significar que las credenciales en CDI son incorrectas o están mal configuradas en el almacén de datos. Para más información, consulta Integración de almacenes de datos.
No se encuentra la tabla
Intente actualizar su integración con la configuración correcta de la base de datos o cree recursos coincidentes 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 Braze. Se puede eliminar un catálogo después de configurar la integración. Para resolver el problema, actualice la integración para utilizar un catálogo diferente o cree un catálogo nuevo que coincida con el nombre del catálogo en la integración.
Por qué me enviaron un correo electrónico: ¿”Errores de fila en su sincronización CDI”?
Este tipo de correo significa que algunos de tus datos no han podido ser procesados durante la sincronización. Para averiguar el error concreto, puedes revisar los registros en Braze yendo a CDI > Registro de sincronización.
¿Cómo corrijo los errores de Test Connection y de los correos electrónicos de asistencia?
La conexión de prueba va lenta
Test Connection se ejecuta en su almacén de datos, por lo que aumentar la capacidad del almacén puede mejorar su velocidad. El uso de una instancia SQL sin servidor minimizará el tiempo de calentamiento y mejorará el rendimiento de las consultas, pero puede dar lugar a costes de integración ligeramente superiores.
Error al conectar con la instancia Snowflake: Solicitud entrante con IP no autorizada para acceder a Snowflake
Intenta añadir las IPs oficiales de Braze a tu lista de IPs permitidas. veloperPara más información, consulta Integraciones de almacenes de datos, o permite las IP correspondientes:
Para las instancias US-01
, US-02
, US-03
, US-04
, US-05
, US-06
, US-07
, éstas son las direcciones IP correspondientes:
23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15
Por ejemplo US-08
, éstas son las direcciones IP correspondientes:
52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145
Por ejemplo US-10
, éstas son las direcciones IP correspondientes:
100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19
Para las instancias EU-01
y EU-02
, estas son las direcciones IP correspondientes:
52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88
Por ejemplo AU-01
, éstas son las direcciones IP correspondientes:
13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213
Error al ejecutar SQL debido a la configuración del cliente: 002003 (42S02): Error de compilación SQL: no existe o no está autorizado
Si la tabla no existe, créala. Si la tabla existe, compruebe que el usuario y la función tienen permisos para leer la tabla.
No se ha podido utilizar el esquema
Si recibe este error, conceda acceso a ese esquema para el usuario o rol especificado.
No se ha podido utilizar el rol
Si recibe este error, permita que ese usuario utilice el rol especificado.
Acceso de usuario desactivado
Si recibe este error, permita a ese usuario el acceso a su cuenta Snowflake.
Error al conectarse a la instancia Snowflake con la clave actual y la antigua
Si recibes este error, asegúrate de que el usuario está utilizando la clave pública actual que se muestra en tu panel Braze.
La conexión de prueba va lenta
Test Connection se ejecuta en su almacén de datos, por lo que aumentar la capacidad del almacén puede mejorar su velocidad. El uso de una instancia SQL sin servidor minimizará el tiempo de calentamiento y mejorará el rendimiento de las consultas, pero puede dar lugar a costes de integración ligeramente superiores.
Permiso denegado para la relación {table_name}
Si recibes este error:
- Concede el permiso
usage
en el esquema para ese usuario. - Concede el permiso
select
en la tabla para ese usuario.
Crear error de conexión
Si recibe este error, compruebe que el punto final y el puerto de Redshift son correctos.
Error al crear túnel SSH
Si recibes este error:
- Comprueba que la clave pública de tu panel de Braze está en el host ec2 utilizado para el túnel SSH.
- Compruebe que su nombre de usuario es correcto.
- Compruebe que el túnel SSH es correcto.
La conexión de prueba va lenta
Test Connection se ejecuta en su almacén de datos, por lo que aumentar la capacidad del almacén puede mejorar su velocidad. El uso de una instancia SQL sin servidor minimizará el tiempo de calentamiento y mejorará el rendimiento de las consultas, pero puede dar lugar a costes de integración ligeramente superiores.
El usuario no tiene permiso para consultar la tabla
Si recibes este error, añade permisos de usuario para consultar la tabla.
Su uso ha superado la cuota personalizada
Si recibes este error, es necesario actualizar tu cuota para que puedas seguir sincronizando al ritmo actual.
No se ha encontrado la tabla en la ubicación {region} Ubicación
Si recibe este error, compruebe que la tabla se encuentra en el proyecto y el conjunto de datos correctos.
Firma JWT no válida
Si recibes este error, comprueba que el servicio API BigQuery está habilitado para tu cuenta.
La conexión de prueba va lenta
Test Connection se ejecuta en su almacén de datos, por lo que aumentar la capacidad del almacén puede mejorar su velocidad. En el caso de Databricks, puede haber de dos a cinco minutos de tiempo de calentamiento cuando Braze se conecte a instancias Classic y Pro SQL, lo que provocará retrasos durante la configuración y las pruebas de conexión, así como al inicio de las sincronizaciones programadas. El uso de una instancia SQL sin servidor minimizará el tiempo de calentamiento y mejorará el rendimiento de las consultas, pero puede dar lugar a costes de integración ligeramente superiores.
El comando ha fallado porque el almacén estaba parado
Si recibes este error, asegúrate de que se está ejecutando el almacén de datos Databricks.
Servicio: Amazon S3; Código de estado: 403; Código de error: 403 Prohibido
Si recibe este error, consulte Databricks: Error prohibido al acceder a los datos de S3.
¿Cómo actualizo mis preferencias de alertas por correo electrónico para las integraciones CDI?
Cada integración tiene sus propias preferencias de notificación. Vaya a la página CDI y seleccione el nombre de la integración que desea actualizar. En la sección Preferencias de notificación puede actualizar cómo recibe las alertas relativas a la integración seleccionada.
¿Qué ocurre si un UPDATED_AT futuro se sincroniza 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:
- Correcto
UPDATED_AT
. - Elimina los datos antiguos que ya estén sincronizados con Braze
- Cree una nueva integración para procesar de nuevo esa tabla.
¿Por qué “Filas sincronizadas” no coincide con el número de mi almacén?
CDI utiliza UPDATED_AT
para decidir qué registros recoger durante una sincronización. Mira esta ilustración para ver cómo funciona. Al comienzo de una ejecución de sincronización, CDI consulta su almacén para obtener todos los registros con UPDATED_AT
posterior al valor procesado previamente. Cualquier registro recogido en el momento en que se ejecute la consulta se sincronizará en Braze. Estos son los casos habituales en los que un registro puede no estar sincronizado:
- Está añadiendo registros a la tabla con un valor
UPDATED_AT
que ya ha sido procesado. - Está actualizando los valores de los 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 se realiza una sincronización. Dependiendo del momento en que se ejecute la consulta CDI, puede haber condiciones de carrera que provoquen que no se recojan los registros.
Para evitar estos comportamientos en el futuro, recomendamos utilizar valores UPDATED_AT
que aumenten monotónicamente y no actualizar la tabla durante la ejecución de la sincronización programada.
Durante una sincronización, ¿se mantiene el orden si varios registros comparten el mismo ID?
El orden de procesamiento no es 100% predecible. Por ejemplo, si hay varias filas con la misma EXTERNAL_ID
en la tabla durante una sincronización, no podemos garantizar qué valor acabará 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 reflejarán cuando finalice la sincronización.
¿Cuáles son las medidas de seguridad del CDI?
Nuestras medidas
Braze cuenta con las siguientes medidas para la CDI:
- Todas las credenciales están encriptadas dentro de nuestra base de datos, y sólo determinados empleados tienen acceso autenticado a ellas.
- Utilizamos conexiones cifradas para hacer llegar los datos a los almacenes de los clientes.
- Realizamos solicitudes a los puntos finales de la API Braze utilizando las mismas claves de API y conexiones TLS que recomendamos utilizar a nuestros clientes.
- Actualizamos regularmente nuestras bibliotecas y recibimos todos los parches de seguridad.
Sus medidas
Le recomendamos que usted y su equipo establezcan las siguientes medidas de seguridad:
- Restringir el acceso a las credenciales al mínimo necesario para el funcionamiento del CDI. 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 Braze publicadas oficialmente.