Ir al contenido

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.

  1. En el portal de Azure, ve a tu cuenta de almacenamiento y, a continuación, ve a Data storage > Containers.
  2. 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

  1. En la misma cuenta de almacenamiento, ve a Data storage > Queues.
  2. 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.

  1. En la misma cuenta de almacenamiento, ve a Events y selecciona + Event Subscription.
  2. En Event Subscription Details, introduce un Name y establece Event Schema en Event Grid Schema.
  3. 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.
  4. 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.
  5. En Endpoint Details, establece Endpoint Type en Storage Queue. El enlace Configure an endpoint aparece después de elegir un tipo de endpoint.
  6. Selecciona Configure an endpoint y, a continuación, elige la cuenta de almacenamiento con la que estás trabajando.
  7. Selecciona Select existing queue y, a continuación, elige la cola que creaste en el paso 2.
  8. Selecciona Select para confirmar el endpoint.
  9. 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.

  1. En el portal de Azure, ve al centro de administración de Microsoft Entra y luego a App Registrations.
  2. Selecciona + New registration en Identity > Applications > App registrations.
  3. Introduce un nombre y selecciona Accounts in this organizational directory only como tipo de cuenta compatible. Luego, selecciona Register.
  4. Selecciona la aplicación (entidad de servicio) que acabas de crear y luego ve a Certificates & secrets > + New client secret.
  5. Introduce una descripción para el secreto y establece un periodo de caducidad para el secreto. Luego, selecciona Add.
  6. Toma nota del secreto de cliente creado para usarlo en la configuración de 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.

  1. Ve a tu cuenta de almacenamiento y, a continuación, ve a Access Control (IAM).
  2. Selecciona Add > Add role assignment.
  3. Busca por nombre la entidad de servicio que creaste en el paso 4.
  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.

Configurar la ingesta de datos en la nube en Braze

  1. 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.

La pantalla "Añadir nueva fuente" con Azure Blob seleccionado en la lista de orígenes de datos.

  1. 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

El formulario de detalles de conexión de Azure Blob con los campos ID de inquilino, ID de entidad principal, secreto de cliente, cuenta de almacenamiento y contenedor.

  1. Selecciona Probar conexión y, a continuación, Conectar con la fuente.
  2. Crea una sincronización. Ve a Configuración de datos > Ingesta de datos en la nube > Sincronizaciones y selecciona Crear sincronización de datos.
  3. 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).
  4. En Definición de datos, especifica lo siguiente:

El formulario de sincronización de Azure Blob con los campos nombre de la cola de almacenamiento y ruta de la carpeta.

  1. 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.
  2. En Notificaciones, añade direcciones de correo electrónico de contacto para las notificaciones de errores.
  3. 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.
  4. 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.

Para cada carpeta que quieras sincronizar en un contenedor compartido:

  1. Crea una cola para esa carpeta, como en el paso 2.
  2. Crea una suscripción a eventos que envíe los eventos Blob Created del contenedor a esa cola, como en el paso 3.
  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.

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""}"

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}}"}

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\"}}"}

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.

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:

  1. Crea una nueva sincronización de ingesta de datos en la nube con la misma configuración que para las demás sincronizaciones.
  2. Al configurar la sincronización en Braze, establece Tipo de datos en Eliminar usuarios.
  3. 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.

Eliminar elementos del catálogo

Para eliminar artículos de un catálogo mediante el almacenamiento de archivos:

  1. Usa la misma sincronización que utilizas para sincronizar datos del catálogo (tipo de datos Catálogos).
  2. En tus archivos CSV o JSON, añade una columna opcional deleted (o DELETED).
  3. Establece deleted en true para 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.

New Stuff!