Ingesta de datos en la nube para Azure Blob Storage
En esta página encontrarás todo lo que necesitas para sincronizar datos de Azure Blob Storage con Braze mediante la ingesta de datos en la nube (CDI): los recursos de Azure que debes crear, cómo conectar el origen y crear una sincronización en Braze, el formato de archivo para cada tipo de datos y la solución de problemas específica de Azure.
Cómo funciona
Las integraciones de Azure Blob Storage se basan en eventos en lugar de en programaciones. Cuando se crean nuevos archivos en el contenedor, una suscripción a eventos de Azure Event Grid publica un evento Blob Created en una cola de Azure Storage. Braze lee esos mensajes de la cola para ingerir el nuevo archivo.
La integración requiere los siguientes recursos:
- Una cuenta de almacenamiento con un contenedor de blobs para el almacenamiento de datos
- Una cola de Azure Storage y una suscripción a eventos para las notificaciones de nuevos archivos
- Una entidad de servicio de Microsoft Entra ID que CDI utiliza para leer el contenedor y la cola
Definiciones de Azure
| Término | Definición |
|---|---|
| Cuenta de almacenamiento | Una cuenta de almacenamiento es el recurso de Azure de nivel superior que contiene tanto el contenedor del que CDI lee los archivos como la cola de la que CDI lee las notificaciones. |
| Contenedor | Un contenedor almacena los archivos de datos que quieres que CDI ingiera. Los contenedores se encuentran dentro de una cuenta de almacenamiento. |
| Cola de Azure Storage | Una cola recibe las notificaciones de nuevos archivos de tu contenedor. CDI lee y confirma los mensajes de esta cola para saber qué archivos debe ingerir. |
| Suscripción a eventos | Una suscripción a eventos dirige los eventos de tu cuenta de almacenamiento a un destino mediante el servicio Azure Event Grid. La configuras para que envíe eventos Blob Created a tu cola. |
| Tema del sistema | Un tema del sistema representa el origen de los eventos. Event Grid crea uno para tu cuenta de almacenamiento cuando añades la primera suscripción a eventos. |
| Entidad de servicio | Una entidad de servicio es una identidad de Microsoft Entra ID con la que CDI se autentica. La creas mediante el registro de una aplicación e introduces sus credenciales en Braze. |
| Asignación de roles de Azure | Una asignación de roles concede a una entidad de servicio un conjunto de permisos en un ámbito determinado. Asignas tres roles integrados a la entidad de servicio de Braze en tu cuenta de almacenamiento. |
Configurar la ingesta de datos en el cloud en Azure
Paso 1: Crear un contenedor
El contenedor y la cola deben estar en la misma cuenta de almacenamiento. Puedes reutilizar una cuenta de almacenamiento existente. Si aún no tienes una, ve a Storage accounts > + Create en el portal de Azure para crearla.
- En el portal de Azure, ve a tu cuenta de almacenamiento y, a continuación, ve a Data storage > Containers.
- Selecciona + Add container y ponle un nombre.
Anota el nombre de la cuenta de almacenamiento y el nombre del contenedor. Necesitarás ambos cuando configures el origen en Braze.
Paso 2: Crear una cola
- En la misma cuenta de almacenamiento, ve a Data storage > Queues.
- Selecciona + Queue y ponle un nombre.
Anota el nombre de la cola. Lo necesitarás cuando crees la sincronización. Cada sincronización necesita su propia cola.
Paso 3: Crear una suscripción a eventos
Crea una suscripción a eventos para que tu contenedor avise a la cola cada vez que llegue un archivo.
- En la misma cuenta de almacenamiento, ve a Events y selecciona + Event Subscription.
- En Event Subscription Details, introduce un Name y establece Event Schema en Event Grid Schema.
- En Topic Details, revisa el System Topic Name. Si tu cuenta de almacenamiento aún no tiene un tema del sistema, introduce un nombre para crear uno. Si ya tiene uno, el campo muestra ese nombre y no se puede cambiar. Todas las suscripciones a eventos de una cuenta de almacenamiento usan el mismo tema del sistema.
- En Event Types, establece Filter to Event Types solo en Blob Created. Blob Deleted también está seleccionado de forma predeterminada, así que desmárcalo.
- En Endpoint Details, establece Endpoint Type en Storage Queue. El enlace Configure an endpoint aparece después de elegir un tipo de endpoint.
- Selecciona Configure an endpoint y, a continuación, elige la cuenta de almacenamiento con la que estás trabajando.
- Selecciona Select existing queue y, a continuación, elige la cola que creaste en el paso 2.
- Selecciona Select para confirmar el endpoint.
- Selecciona Create.
Paso 4: Configurar la autenticación
CDI se conecta a tu cuenta de almacenamiento con el siguiente método de autenticación:
| Método | Cómo se autentica Braze | Qué introduces en Braze |
|---|---|---|
| Service principal | Braze authenticates as a Microsoft Entra ID service principal with a client secret. | Tenant ID, Principal ID, and Client Secret |
Service principal
CDI se conecta a tu cuenta de almacenamiento mediante una entidad de servicio con autenticación de Microsoft Entra ID. Braze necesita los siguientes datos para conectarse:
- ID de tenant (también llamado directorio) de tu cuenta de Azure
- ID de principal (también llamado ID de aplicación) del service principal
- Secreto de cliente para que Braze se autentique
Para registrar una aplicación, necesitas permiso para crear registros de aplicaciones en Microsoft Entra ID. Si no lo tienes, pide a un administrador de Entra que complete este paso y comparta las credenciales contigo.
- En el portal de Azure, ve al centro de administración de Microsoft Entra y luego a App Registrations.
- Selecciona + New registration en Identity > Applications > App registrations.
- Introduce un nombre y selecciona
Accounts in this organizational directory onlycomo tipo de cuenta compatible. Luego, selecciona Register. - Selecciona la aplicación (entidad de servicio) que acabas de crear y luego ve a Certificates & secrets > + New client secret.
- Introduce una descripción para el secreto y establece un periodo de caducidad para el secreto. Luego, selecciona Add.
- Toma nota del secreto de cliente creado para usarlo en la configuración de Braze.

Azure no permite una caducidad ilimitada en los secretos de las entidades de servicio. Recuerda renovar las credenciales antes de que caduquen para mantener el flujo de datos hacia Braze.
Te recomendamos crear una entidad de servicio que se use solo para CDI, de modo que su acceso se limite al contenedor y a la cola que estás sincronizando. Si ya tienes una configurada para una fuente de Microsoft Fabric, puedes reutilizarla, pero entonces tendrá acceso a ambos. En cualquier caso, necesita las asignaciones de roles del siguiente paso.
Paso 5: Asignar permisos a la entidad de servicio
CDI solo necesita el acceso suficiente para leer tus archivos y procesar los mensajes de la cola. Asigna estos tres roles integrados en la propia cuenta de almacenamiento, no en la suscripción ni en el grupo de recursos, porque las asignaciones de roles se heredan hacia abajo. No asignes roles más amplios como Storage Blob Data Contributor, Storage Account Contributor u Owner, que conceden permisos de escritura y administración que CDI nunca usa.
- Ve a tu cuenta de almacenamiento y, a continuación, ve a Access Control (IAM).
- Selecciona Add > Add role assignment.
- Busca por nombre la entidad de servicio que creaste en el paso 4.
- Asígnale los siguientes roles integrados:
- Storage Blob Data Reader: permite a CDI leer los archivos de tu contenedor.
- Storage Queue Data Reader: permite a CDI leer la propia cola, para que pueda encontrar la cola que indicaste en la sincronización y comprobar sus propiedades.
- Storage Queue Data Message Processor: permite a CDI inspeccionar, recuperar y eliminar mensajes de tu cola.
Puedes usar un rol personalizado en su lugar, siempre que conceda solo acceso de lectura a los blobs del contenedor, acceso de lectura a la cola y la capacidad de recibir y eliminar mensajes de la cola.

Si Add role assignment aparece en gris, tu cuenta no puede asignar roles en esta cuenta de almacenamiento. Para ello se necesita un rol como Owner o User Access Administrator. Pide a un administrador de Azure que complete este paso.
Configurar la ingesta de datos en la nube en Braze
- En Braze, ve a Configuración de datos > Ingesta de datos en la nube > Fuentes, selecciona Añadir origen de datos y, a continuación, selecciona Azure Blob.

- Completa los campos de Detalles de conexión de Azure Blob:
- Credenciales: los campos del método de autenticación que configuraste en el paso 4. Introduce Tenant ID, Principal ID, and Client Secret.
- Configuración: Cuenta de almacenamiento y Contenedor

- Selecciona Probar conexión y, a continuación, Conectar con la fuente.
- Crea una sincronización. Ve a Configuración de datos > Ingesta de datos en la nube > Sincronizaciones y selecciona Crear sincronización de datos.
- En Configuraciones, elige un nombre para la sincronización, selecciona tu origen de Azure Blob y selecciona un Tipo de datos (como Atributos de usuario, Eventos personalizados, Eventos de compra, Catálogo o Eliminar usuarios).
- En Definición de datos, especifica lo siguiente:
- Nombre de la cola de almacenamiento: la cola que creaste en el paso 2. Cada sincronización necesita su propia cola (consulta Sincronizar una carpeta en un contenedor compartido).
- Ruta de la carpeta (opcional): un prefijo de ruta dentro del contenedor

- Selecciona Vista previa y validación para confirmar que CDI puede acceder a la cola y enumerar los archivos disponibles para ingerir. Una prueba correcta enumera los archivos existentes en el contenedor, pero esos archivos no se sincronizan automáticamente. La sincronización no está activa hasta que la conexión se valida correctamente.
- En Notificaciones, añade direcciones de correo electrónico de contacto para las notificaciones de errores.
- Programación no tiene opciones para las sincronizaciones de almacenamiento de archivos. Las sincronizaciones de Azure Blob Storage se basan en eventos, así que CDI ingiere los archivos nuevos a medida que se cargan.
- Revisa el Resumen y, a continuación, selecciona Crear sincronización.
Sincronizar una carpeta en un contenedor compartido
Puedes reutilizar un mismo contenedor en varias sincronizaciones, pero cada sincronización necesita su propia cola de almacenamiento y su propia carpeta.

Dos sincronizaciones no pueden usar la misma cola de almacenamiento. Si introduces una cola que ya utiliza otra sincronización, CDI la marca y enlaza a la sincronización existente.
Para cada carpeta que quieras sincronizar en un contenedor compartido:
- Crea una cola para esa carpeta, como en el paso 2.
- Crea una suscripción a eventos que envíe los eventos Blob Created del contenedor a esa cola, como en el paso 3.
- Cuando crees la sincronización en Braze, introduce el Nombre de la cola de almacenamiento de esa carpeta y establece Ruta de la carpeta (opcional) en el prefijo de la carpeta, como
attributes/. CDI solo ingiere los archivos cuya ruta empiece por ese prefijo.
Formatos de archivo obligatorios
La ingesta de datos en la nube admite archivos JSON, CSV y Parquet. Las columnas obligatorias dependen del tipo de datos. Braze no impone ningún requisito adicional sobre los nombres de archivo más allá de los que establezca tu proveedor de almacenamiento de archivos. Los nombres de archivo deben ser únicos; añadir una marca de tiempo ayuda a garantizarlo.

A diferencia de las fuentes de almacén de datos, la columna UPDATED_AT no es obligatoria ni se admite en las sincronizaciones de almacenamiento de archivos.
Para ver ejemplos de todos los tipos de archivo admitidos, consulta los archivos de muestra en braze-examples.
Selecciona la pestaña del tipo de datos que quieres sincronizar.
Cada fila necesita exactamente un identificador de usuario y una columna PAYLOAD. Un archivo de origen puede contener filas con distintos tipos de identificador, pero cada fila individual solo debe usar uno.
| Identificador | Descripción |
|---|---|
EXTERNAL_ID |
Identifica al usuario que quieres actualizar. Debe coincidir con el valor external_id utilizado en Braze. |
ALIAS_NAME y ALIAS_LABEL |
Estas dos columnas crean un objeto de alias de usuario. alias_name debe ser un identificador único, y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero solo un alias_name por cada alias_label. |
BRAZE_ID |
El identificador de usuario de Braze. Lo genera el SDK de Braze, y no se pueden crear nuevos usuarios con un ID de Braze mediante la ingesta de datos en la nube. Para crear nuevos usuarios, especifica un ID de usuario externo o un alias de usuario. |
EMAIL |
La dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se prioriza para las actualizaciones el perfil actualizado más recientemente. Si incluyes tanto el correo electrónico como el teléfono, Braze utiliza el correo electrónico como identificador principal. |
PHONE |
El número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se prioriza para las actualizaciones el perfil actualizado más recientemente. |
La columna PAYLOAD contiene una cadena JSON con los campos que quieres sincronizar con el usuario en Braze, siguiendo el formato del objeto de atributos del usuario.
Ejemplo JSON
{"external_id":"s3-qa-0","payload":"{\"name\": \"GT896\", \"age\": 74, \"subscriber\": true, \"retention\": {\"previous_purchases\": 21, \"vip\": false}, \"last_visit\": \"2023-08-08T16:03:26.600803\"}"}
{"external_id":"s3-qa-1","payload":"{\"name\": \"HSCJC\", \"age\": 86, \"subscriber\": false, \"retention\": {\"previous_purchases\": 0, \"vip\": false}, \"last_visit\": \"2023-08-08T16:03:26.600824\"}"}
{"external_id":"s3-qa-2","payload":"{\"name\": \"YTMQZ\", \"age\": 43, \"subscriber\": false, \"retention\": {\"previous_purchases\": 23, \"vip\": true}, \"last_visit\": \"2023-08-08T16:03:26.600831\"}"}
Ejemplo CSV
external_id,payload
s3-qa-load-0-d0daa196-cdf5-4a69-84ae-4797303aee75,"{""name"": ""SNXIM"", ""age"": 54, ""subscriber"": true, ""retention"": {""previous_purchases"": 19, ""vip"": true}, ""last_visit"": ""2023-08-08T16:03:26.598806""}"
s3-qa-load-1-d0daa196-cdf5-4a69-84ae-4797303aee75,"{""name"": ""0J747"", ""age"": 73, ""subscriber"": false, ""retention"": {""previous_purchases"": 22, ""vip"": false}, ""last_visit"": ""2023-08-08T16:03:26.598816""}"

Cada línea de tu archivo de origen debe contener JSON válido; de lo contrario, se omite el archivo.
Los eventos personalizados utilizan las mismas columnas de identificador de usuario que los atributos del usuario. La columna PAYLOAD sigue el formato del objeto de eventos.
{"external_id":"s3-qa-0","payload":"{\"app_id\": \"YOUR_APP_ID\", \"name\": \"view-206\", \"time\": \"2024-04-02T14:34:08\", \"properties\": {\"bool_value\": false, \"preceding_event\": \"unsubscribe\", \"important_number\": 206}}"}
{"external_id":"s3-qa-1","payload":"{\"app_id\": \"YOUR_APP_ID\", \"name\": \"view-206\", \"time\": \"2024-04-02T14:34:08\", \"properties\": {\"bool_value\": false, \"preceding_event\": \"unsubscribe\", \"important_number\": 206}}"}

Cada línea de tu archivo de origen debe contener JSON válido; de lo contrario, se omite el archivo.
Los eventos de compra utilizan las mismas columnas de identificador de usuario que los atributos del usuario. La columna PAYLOAD sigue el formato del objeto de compras.
{"external_id":"s3-qa-0","payload":"{\"app_id\": \"YOUR_APP_ID\", \"product_id\": \"product-11\", \"currency\": \"BSD\", \"price\": 8.511527858335066, \"time\": \"2024-04-02T14:34:08\", \"quantity\": 19, \"properties\": {\"is_a_boolean\": true, \"important_number\": 40, \"preceding_event\": \"click\"}}"}
{"external_id":"s3-qa-1","payload":"{\"app_id\": \"YOUR_APP_ID\", \"product_id\": \"product-11\", \"currency\": \"BSD\", \"price\": 8.511527858335066, \"time\": \"2024-04-02T14:34:08\", \"quantity\": 19, \"properties\": {\"is_a_boolean\": true, \"important_number\": 40, \"preceding_event\": \"click\"}}"}

Cada línea de tu archivo de origen debe contener JSON válido; de lo contrario, se omite el archivo.
Los archivos de catálogo utilizan identificadores distintos a los de los archivos de datos de usuario. Antes de crear una sincronización de catálogo, crea el catálogo de destino en Braze. Para ver el flujo de trabajo completo del catálogo, consulta Sincronizar y eliminar datos del catálogo.
| Columna | Obligatorio | Descripción |
|---|---|---|
ID |
Sí | El identificador único del artículo del catálogo. Se utiliza para crear, actualizar o eliminar el artículo en Braze. |
PAYLOAD |
Sí | Una cadena JSON con los campos y valores del catálogo que quieres sincronizar. Debe coincidir con el esquema de tu catálogo en Braze. |
DELETED |
No | Cuando es true, el artículo del catálogo con el ID coincidente se elimina del catálogo en Braze. Omite esta columna o establécela en false para las operaciones de creación o actualización. |
Ejemplo JSON
{"id":"85","payload":"{\"product_name\":\"Product 85\",\"price\":85.85}"}
{"id":"86","payload":"{\"product_name\":\"Product 86\",\"price\":86.86}"}
{"id":"1","payload":"{\"product_name\":\"Product 1\",\"price\":1.01}","deleted":true}
Ejemplo CSV con la columna DELETED
ID,PAYLOAD,DELETED
85,"{""product_name"": ""Product 85"", ""price"": 85.85}",false
86,"{""product_name"": ""Product 86"", ""price"": 86.86}",false
1,"{""product_name"": ""Product 1"", ""price"": 1.01}",true
Ejemplo CSV sin la columna DELETED
ID,PAYLOAD
85,"{""product_name"": ""Product 85"", ""price"": 85.85}"
86,"{""product_name"": ""Product 86"", ""price"": 86.86}"
Antes de crear una sincronización de objetos de datos, crea el tipo de objeto de datos y sus campos en Braze. Para ver el flujo de trabajo completo, consulta Sincronizar objetos de datos.
A diferencia de las fuentes de almacén de datos, las fuentes de almacenamiento de archivos incluyen los campos del objeto de datos en una columna PAYLOAD en lugar de usar una columna por campo.
| Columna | Obligatorio | Descripción |
|---|---|---|
OBJECT_ID |
Sí | El identificador del registro del objeto de datos. Se utiliza para crear, actualizar o eliminar el registro en Braze. |
PAYLOAD |
Sí | Una cadena JSON con los campos y valores que quieres sincronizar. Cada clave debe coincidir con un campo definido en el tipo de objeto de datos en Braze, incluidas las mayúsculas y minúsculas. |
DELETED |
No | Cuando es true, el registro con el OBJECT_ID coincidente se elimina en Braze. Omite esta columna o establécela en false para las operaciones de creación o actualización. |
Ejemplo JSON
{"object_id":"acct-001","payload":"{\"name\":\"Acme Corp\",\"team_id\":42}"}
{"object_id":"acct-002","payload":"{\"name\":\"Initech\",\"team_id\":17}"}
{"object_id":"acct-003","payload":"{\"name\":\"Hooli\",\"team_id\":5}","deleted":true}
Ejemplo CSV
OBJECT_ID,PAYLOAD,DELETED
acct-001,"{""name"": ""Acme Corp"", ""team_id"": 42}",false
acct-002,"{""name"": ""Initech"", ""team_id"": 17}",false
acct-003,"{""name"": ""Hooli"", ""team_id"": 5}",true
Usa esta sincronización para conectar usuarios con registros de objetos de datos, por ejemplo, para vincular usuarios con las cuentas a las que pertenecen. Crea la relación en Braze antes de sincronizarla.
Cada fila necesita OBJECT_ID y al menos un identificador de usuario.
| Columna | Obligatorio | Descripción |
|---|---|---|
OBJECT_ID |
Sí | El identificador del registro del objeto de datos con el que está relacionado el usuario. |
EXTERNAL_ID |
Sí, al menos un identificador de usuario por fila | Coincide con el external_id utilizado en Braze. |
ALIAS_NAME y ALIAS_LABEL |
Sí, al menos un identificador de usuario por fila | Ambas columnas juntas identifican al usuario por su alias. |
EMAIL |
Sí, al menos un identificador de usuario por fila | La dirección de correo electrónico del usuario. |
PHONE |
Sí, al menos un identificador de usuario por fila | El número de teléfono del usuario. |
PAYLOAD |
No | Una cadena JSON con los campos y valores de la propia relación. |
DELETED |
No | Cuando es true, se elimina la relación entre el registro y el usuario. |

A diferencia de las sincronizaciones de atributos del usuario, BRAZE_ID no se admite en las sincronizaciones de relaciones de usuario. Usa uno de los identificadores indicados anteriormente.
Ejemplo JSON
{"object_id":"acct-001","external_id":"user-1","payload":"{\"role\":\"admin\"}"}
{"object_id":"acct-001","email":"[email protected]","payload":"{\"role\":\"member\"}"}
{"object_id":"acct-002","external_id":"user-9","deleted":true}
Usa esta sincronización para conectar registros de objetos de datos entre sí, por ejemplo, para vincular cuentas con sus cuentas principales. Crea la relación en Braze antes de sincronizarla.
| Columna | Obligatorio | Descripción |
|---|---|---|
OBJECT_ID |
Sí | El registro desde el que parte la relación. |
RELATED_OBJECT_ID |
Sí | El registro al que apunta la relación. |
PAYLOAD |
No | Una cadena JSON con los campos y valores de la propia relación. |
DELETED |
No | Cuando es true, se elimina la relación entre los dos registros. |
Ejemplo JSON
{"object_id":"acct-001","related_object_id":"acct-010","payload":"{\"tier\":\"parent\"}"}
{"object_id":"acct-001","related_object_id":"acct-011","payload":"{\"tier\":\"parent\"}"}
{"object_id":"acct-002","related_object_id":"acct-020","deleted":true}
Los desencadenantes de Canvas hacen posible la personalización sin copia. Para ver la configuración del Canvas de destino y otras consideraciones, consulta Personalización sin copia.
| Campo | Obligatorio | Descripción |
|---|---|---|
EXTERNAL_ID |
Sí, uno de external_id o alias_name y alias_label |
Identifica al usuario que quieres actualizar. Debe coincidir con el valor external_id utilizado en Braze. |
ALIAS_NAME y ALIAS_LABEL |
Sí, uno de external_id o alias_name y alias_label |
Estas dos columnas crean un objeto de alias de usuario. alias_name debe ser un identificador único, y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero solo un alias_name por cada alias_label. |
PROPERTIES |
Sí | Cadena JSON con los campos que quieres poner a disposición como propiedades de personalización en tu Canvas. Debe contener información específica del usuario. |
Para empezar, selecciona el tipo de datos Desencadenantes de Canvas al crear una nueva sincronización.
Para eliminar perfiles de usuario en Braze mediante archivos de tu contenedor de origen:
- Crea una nueva sincronización de ingesta de datos en la nube con la misma configuración que para las demás sincronizaciones.
- Al configurar la sincronización en Braze, establece Tipo de datos en Eliminar usuarios.
- Sube a tu contenedor de origen archivos que contengan solo columnas de identificador de usuario. No incluyas una columna
PAYLOAD: para evitar eliminaciones accidentales, la sincronización falla si hay una carga útil.
Cada fila del archivo debe identificar exactamente a un usuario mediante uno de los siguientes identificadores:
| Identificador | Descripción |
|---|---|
EXTERNAL_ID |
Coincide con el external_id utilizado en Braze. |
ALIAS_NAME y ALIAS_LABEL |
Ambas columnas juntas identifican al usuario por su alias. |
BRAZE_ID |
ID de usuario generado por Braze (solo usuarios existentes). |
Ejemplo JSON
{"external_id":"user-to-delete-001"}
{"external_id":"user-to-delete-002"}
{"braze_id":"braze-id-from-profile"}
Ejemplo CSV
external_id
user-to-delete-001
user-to-delete-002
Cuando se ejecuta la sincronización, Braze procesa los archivos nuevos del contenedor y elimina los perfiles de usuario correspondientes.

La eliminación de usuarios es permanente y no se puede deshacer. Incluye solo a los usuarios que quieras eliminar. Para más información, consulta Eliminar usuarios con la ingesta de datos en la nube.
Eliminar elementos del catálogo
Para eliminar artículos de un catálogo mediante el almacenamiento de archivos:
- Usa la misma sincronización que utilizas para sincronizar datos del catálogo (tipo de datos Catálogos).
- En tus archivos CSV o JSON, añade una columna opcional
deleted(oDELETED). - Establece
deletedentruepara cualquier artículo que quieras eliminar del catálogo en Braze.
Cada fila sigue necesitando ID y PAYLOAD. En las filas marcadas para eliminación, la carga útil puede ser mínima; Braze elimina el artículo según su ID.
Cuando se ejecuta la sincronización, las filas con deleted: true hacen que se elimine el artículo correspondiente del catálogo en Braze. Para conocer el comportamiento completo de sincronización y eliminación de catálogos, consulta Sincronizar y eliminar datos del catálogo.
Aspectos que debes saber
- Los archivos que se añaden al contenedor de origen no deben superar los 512 MB. Este límite se aplica a Amazon S3, Google Cloud Storage y Azure Blob Storage. Los archivos de más de 512 MB generan un error y no se sincronizan con Braze. Azure Blob Storage admite de por sí archivos mucho más grandes, pero la CDI aplica el mismo límite de 512 MB a todas las fuentes de almacenamiento de archivos.
- Aunque no hay ningún límite adicional en el número de filas por archivo, Braze recomienda usar archivos más pequeños para que tus sincronizaciones se ejecuten más rápido. Por ejemplo, un archivo de 500 MB tardaría bastante más en ingerirse que cinco archivos independientes de 100 MB.
- No hay ningún límite adicional en el número de archivos que se cargan en un periodo determinado.
- No se admite la ordenación dentro de los archivos ni entre ellos. Braze recomienda agrupar las actualizaciones en lotes de forma periódica si estás vigilando posibles condiciones de carrera.
- La CDI solo procesa los archivos que se añaden después de crear la sincronización. Puedes usar archivos existentes para validar que Braze puede acceder a tu contenedor y detectar archivos para ingerir, pero no se sincronizan con Braze. Para que la CDI los procese, vuelve a cargar en el contenedor de origen los archivos existentes que quieras sincronizar.
Solución de problemas
Carga y procesamiento de archivos
CDI solo procesa los archivos cargados después de crear la sincronización. Cada nuevo blob desencadena un evento Blob Created en tu cola. Para ingerir archivos que ya existen en el contenedor, vuelve a cargarlos.
Gestionar errores inesperados de archivos
Si los archivos no se ingieren, comprueba lo siguiente:
- La suscripción a eventos existe en la cuenta de almacenamiento y está filtrada por Blob Created.
- La suscripción a eventos utiliza Event Grid Schema. CDI no puede leer eventos entregados en otro esquema.
- El endpoint de la suscripción a eventos apunta a la cola configurada en la sincronización, no a otra cola.
- La entidad de servicio de Braze tiene Storage Blob Data Reader, Storage Queue Data Reader y Storage Queue Data Message Processor en la cuenta de almacenamiento.
- El secreto de cliente de la entidad de servicio no ha caducado. Azure aplica una caducidad a los secretos de cliente, y un secreto caducado detiene la sincronización.
Para más información, consulta Azure Blob Storage como origen de Event Grid en la documentación de Microsoft.
Error de objeto de integración incorrecto
Este error se produce cuando 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 ver los pasos de resolución, consulta las preguntas frecuentes.
Páginas relacionadas
- Configuración de tablas para conocer las columnas obligatorias y el formato de la carga útil
- Buenas prácticas para la programación de sincronizaciones y el uso eficiente de los puntos de datos
- Registros de sincronización y observabilidad para supervisar las ejecuciones de sincronización
- Preguntas frecuentes para resolver dudas comunes sobre todas las fuentes