Ir al contenido

Ingesta de datos en la nube para Microsoft Fabric

Esta página explica todo lo que necesitas para sincronizar datos de Microsoft Fabric con Braze mediante la ingesta de datos en la nube (CDI): los recursos que debes crear en Fabric, cómo conectar el origen y crear una sincronización en Braze, la tabla de origen para cada tipo de datos y la solución de problemas específica de Fabric.

Resumen de la configuración

  1. Configura la autenticación para Braze con uno de los métodos de autenticación admitidos y concede acceso a las API de Fabric.
  2. Configura un espacio de trabajo compartido y concede acceso a la entidad de servicio.
  3. En el espacio de trabajo compartido de Fabric, configura las tablas o vistas que quieras sincronizar con Braze.
  4. Crea un nuevo origen y una nueva sincronización en el panel de Braze.
  5. Valida la integración e inicia la sincronización.

Paso 1: Configura la autenticación

Braze se conecta a tu almacén de Fabric 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

Braze se conecta a tu almacén de Fabric mediante una entidad de servicio con autenticación de Microsoft Entra ID. Crea una nueva entidad de servicio para que la use Braze y concédele acceso a los recursos de Fabric en los siguientes pasos. 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.

Paso 2: Concede acceso a los recursos de Fabric

Proporciona acceso a Braze para que pueda conectarse a tu instancia de Fabric. En tu portal de administración de Fabric, ve a Configuración > Gobernanza e información > Portal de administración > Configuración del inquilino.

  • En Configuración de desarrollador, habilita Las entidades de servicio pueden usar las API de Fabric para que Braze pueda conectarse mediante Microsoft Entra ID.
  • En Configuración de OneLake, habilita Los usuarios pueden acceder a los datos almacenados en OneLake con aplicaciones externas a Fabric para que la entidad de servicio pueda acceder a los datos desde una aplicación externa.

Paso 3: Configura un espacio de trabajo compartido y concede acceso

Cualquier recurso de Fabric que quieras conectar a Braze debe estar en un espacio de trabajo compartido. Si solo has estado usando el espacio predeterminado My Workspace, crea un nuevo espacio de trabajo compartido:

  1. En el menú de navegación, selecciona Workspaces y, a continuación, selecciona + New workspace.
  2. Introduce un Name para el espacio de trabajo y, a continuación, selecciona Apply.

Cuando tengas un espacio de trabajo compartido, concede acceso a la entidad de servicio:

  1. Selecciona el espacio de trabajo y, a continuación, selecciona Manage Access.
  2. Selecciona + Add people or groups.
  3. Busca y selecciona el nombre de la entidad de servicio que creaste en el paso 1. Si no aparece, confirma que habilitaste la configuración Service principals can use Fabric APIs en el paso 2.
  4. En el desplegable de roles, selecciona Contributor.

Ahora la entidad de servicio puede acceder a los recursos del almacén de datos de Fabric en este espacio de trabajo a través de sus endpoints SQL, incluido el almacén de datos que usarás para Braze.

Paso 4: Configura tu tabla de origen

Los pasos de esta sección crean una tabla con una columna PAYLOAD. Si prefieres dar forma a tus datos en el paso Definición de datos, puedes usar una tabla o vista existente. En ese caso, omite el paso de creación de la tabla y concede a Braze acceso de lectura a las tablas o vistas que quieras sincronizar. Para comparar las opciones, consulta Elegir una opción de definición de datos.

Braze admite tanto tablas como vistas en los almacenes de Fabric. Si necesitas crear un almacén nuevo, créalo dentro del espacio de trabajo compartido del paso 3. En la consola de Fabric, ve a Create > Data Warehouse > Warehouse.

Puedes poner el nombre que quieras al almacén, al esquema y a la tabla o vista, pero los nombres de las columnas deben coincidir con las definiciones de las siguientes pestañas.

Selecciona la pestaña del tipo de datos que quieres sincronizar.

Los atributos del usuario, los eventos personalizados y los eventos de compra usan la misma estructura de tabla de origen. Solo cambia el contenido de PAYLOAD.

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
  --If you include both email and phone, email is used as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO
  • UPDATED_AT: la hora en que esta fila se actualizó o se agregó a la tabla. Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado. Las filas que coincidan exactamente con la marca de tiempo límite pueden volver a sincronizarse si hay nuevas filas que comparten esa misma marca de tiempo.
  • Columnas de identificador de usuario: tu tabla puede contener una o más columnas de identificador de usuario. Cada fila solo debe contener un identificador (ya sea external_id, la combinación de alias_name y alias_label, braze_id, email o phone). Una tabla de origen puede tener columnas para uno, dos, tres, cuatro o los cinco tipos de identificador.
    • EXTERNAL_ID: identifica al usuario que quieres actualizar. Debe coincidir con el valor de external_id que se usa 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 diferentes etiquetas, 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, el correo electrónico se usa 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.
  • PAYLOAD: es una cadena JSON con los campos que quieres sincronizar con el usuario en Braze.

Para las sincronizaciones de atributos, PAYLOAD sigue el formato del objeto de atributos del usuario. Puedes incluir atributos personalizados anidados, matrices de objetos y estados del grupo de suscripción. Para ver ejemplos de carga útil, consulta Configuración de tablas.

Los eventos personalizados usan la misma tabla de origen que los atributos del usuario. Crea la tabla que se muestra en la pestaña Atributos del usuario y, después, rellena PAYLOAD con un objeto de eventos.

Para sincronizar eventos, se requiere un nombre de evento. Da formato al campo time como una cadena ISO 8601 o en formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Si el campo time no está presente, Braze usa el valor de la columna UPDATED_AT como hora del evento. Los demás campos, incluidos app_id y properties, son opcionales.

Puedes sincronizar un evento por fila.

{
    "app_id" : "your-app-id",
    "name" : "rented_movie",
    "time" : "2013-07-16T19:20:45+01:00",
    "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
    }
}

Los eventos de compra usan la misma tabla de origen que los atributos del usuario. Crea la tabla que se muestra en la pestaña Atributos del usuario y, después, rellena PAYLOAD con un objeto de compras.

Para sincronizar eventos de compra, se requieren product_id, currency y price. Da formato al campo opcional time como una cadena ISO 8601 o en formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Si el campo time no está presente, Braze usa el valor de la columna UPDATED_AT como hora del evento. Los demás campos, incluidos app_id, quantity y properties, son opcionales.

Puedes sincronizar un evento de compra por fila.

{
    "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
    "product_id" : "Completed Order",
    "currency" : "USD",
    "price" : 219.98,
    "time" : "2013-07-16T19:20:30+01:00",
    "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
        ]
    }
}

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.

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  ID VARCHAR NOT NULL,
  DELETED BIT
)
GO

El nombre de la integración debe coincidir exactamente con el nombre del catálogo que creaste en Braze.

Braze recomienda crear una vista a partir de los datos de tu catálogo para que la tabla de origen se actualice por completo cada vez que se ejecute una sincronización. Por ejemplo, si tienes una tabla de datos de productos (product_catalog) con id y cuatro atributos adicionales, podrías sincronizar la siguiente vista:

CREATE VIEW [braze].[user_update_example]
AS SELECT
    id as ID,
    CURRENT_TIMESTAMP as UPDATED_AT,
    JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD

FROM [braze].[product_catalog] ;

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.

CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNTS_SYNC]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  OBJECT_ID VARCHAR NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --the data object record associated with this OBJECT_ID should be deleted
  DELETED BIT
)
GO
Nombre del campo Tipo Modo
UPDATED_AT DATETIME2 REQUIRED
OBJECT_ID VARCHAR REQUIRED
PAYLOAD VARCHAR REQUIRED
DELETED BIT NULLABLE
  • UPDATED_AT: la hora en que se actualizó o se añadió esta fila a la tabla. Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado. Es posible que las filas con la marca de tiempo límite exacta se vuelvan a sincronizar si hay filas nuevas que comparten esa misma marca de tiempo.
  • OBJECT_ID: el identificador del registro del objeto de datos. Debe coincidir con el valor de object_id que se utiliza en Braze para este tipo de objeto de datos.
  • PAYLOAD: una cadena JSON con los campos y valores que se van a sincronizar. Cada clave debe coincidir con un campo definido en el tipo de objeto de datos en Braze.
  • DELETED: cuando es true, Braze elimina el registro en lugar de actualizarlo. Deja este valor nulo o en false para las filas que quieras crear o actualizar.

Los nombres de campo dentro de PAYLOAD distinguen entre mayúsculas y minúsculas. Una clave llamada NAME no coincide con un campo llamado name. Si las mayúsculas y minúsculas no coinciden, la validación indica que la clave es un campo no definido y que falta el campo que debía rellenar. Asigna a tus claves exactamente los mismos nombres con los que aparecen los campos en Configuración de datos > Objetos de datos.

Braze no crea ni modifica tipos de objetos de datos durante una sincronización. Define el tipo y todos sus campos en Braze antes de crear la sincronización. Para añadir un campo más adelante, añádelo primero al tipo y, después, actualiza tu tabla de origen o tu consulta.

Por ejemplo, un valor de PAYLOAD para una cuenta con los campos name y team_id tiene este aspecto:

{"name": "Acme Corp", "team_id": 42}

En el paso Definición de datos, selecciona el tipo de datos Objetos de datos y, después, elige tu Tipo de objeto de datos. Las sincronizaciones de objetos de datos admiten Tabla y SQL.

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.

CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNT_USERS_SYNC]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  OBJECT_ID VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, or phone is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  EMAIL VARCHAR,
  PHONE VARCHAR,
  PAYLOAD VARCHAR,
  DELETED BIT
)
GO
Nombre del campo Tipo Modo
UPDATED_AT DATETIME2 REQUIRED
OBJECT_ID VARCHAR REQUIRED
EXTERNAL_ID VARCHAR NULLABLE
ALIAS_NAME VARCHAR NULLABLE
ALIAS_LABEL VARCHAR NULLABLE
EMAIL VARCHAR NULLABLE
PHONE VARCHAR NULLABLE
PAYLOAD VARCHAR NULLABLE
DELETED BIT NULLABLE

Cada fila necesita OBJECT_ID y al menos un identificador de usuario: EXTERNAL_ID, la combinación de ALIAS_NAME y ALIAS_LABEL, EMAIL o PHONE. Usa PAYLOAD para cualquier campo definido en la propia relación.

  • UPDATED_AT: la hora en que se actualizó o se añadió esta fila a la tabla. Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado. Es posible que las filas con la marca de tiempo límite exacta se vuelvan a sincronizar si hay filas nuevas que comparten esa misma marca de tiempo.
  • OBJECT_ID: el identificador del registro del objeto de datos. Debe coincidir con el valor de object_id que se utiliza en Braze para este tipo de objeto de datos.
  • PAYLOAD: una cadena JSON con los campos y valores que se van a sincronizar. Cada clave debe coincidir con un campo definido en el tipo de objeto de datos en Braze.
  • DELETED: cuando es true, Braze elimina el registro en lugar de actualizarlo. Deja este valor nulo o en false para las filas que quieras crear o actualizar.

Los nombres de campo dentro de PAYLOAD distinguen entre mayúsculas y minúsculas. Una clave llamada NAME no coincide con un campo llamado name. Si las mayúsculas y minúsculas no coinciden, la validación indica que la clave es un campo no definido y que falta el campo que debía rellenar. Asigna a tus claves exactamente los mismos nombres con los que aparecen los campos en Configuración de datos > Objetos de datos.

Braze no crea ni modifica tipos de objetos de datos durante una sincronización. Define el tipo y todos sus campos en Braze antes de crear la sincronización. Para añadir un campo más adelante, añádelo primero al tipo y, después, actualiza tu tabla de origen o tu consulta.

En el paso Definición de datos, selecciona el tipo de datos Relaciones de usuarios con objetos de datos y, después, elige un Nombre de relación, como User (Account-User).

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.

CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNT_SUBACCOUNTS_SYNC]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  OBJECT_ID VARCHAR NOT NULL,
  RELATED_OBJECT_ID VARCHAR NOT NULL,
  PAYLOAD VARCHAR,
  DELETED BIT
)
GO
Nombre del campo Tipo Modo
UPDATED_AT DATETIME2 REQUIRED
OBJECT_ID VARCHAR REQUIRED
RELATED_OBJECT_ID VARCHAR REQUIRED
PAYLOAD VARCHAR NULLABLE
DELETED BIT NULLABLE

OBJECT_ID es el registro desde el que parte la relación y RELATED_OBJECT_ID es el registro al que apunta. Ambos son obligatorios en cada fila. Usa PAYLOAD para cualquier campo definido en la propia relación.

  • UPDATED_AT: la hora en que se actualizó o se añadió esta fila a la tabla. Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado. Es posible que las filas con la marca de tiempo límite exacta se vuelvan a sincronizar si hay filas nuevas que comparten esa misma marca de tiempo.
  • OBJECT_ID: el identificador del registro del objeto de datos. Debe coincidir con el valor de object_id que se utiliza en Braze para este tipo de objeto de datos.
  • PAYLOAD: una cadena JSON con los campos y valores que se van a sincronizar. Cada clave debe coincidir con un campo definido en el tipo de objeto de datos en Braze.
  • DELETED: cuando es true, Braze elimina el registro en lugar de actualizarlo. Deja este valor nulo o en false para las filas que quieras crear o actualizar.

Los nombres de campo dentro de PAYLOAD distinguen entre mayúsculas y minúsculas. Una clave llamada NAME no coincide con un campo llamado name. Si las mayúsculas y minúsculas no coinciden, la validación indica que la clave es un campo no definido y que falta el campo que debía rellenar. Asigna a tus claves exactamente los mismos nombres con los que aparecen los campos en Configuración de datos > Objetos de datos.

Braze no crea ni modifica tipos de objetos de datos durante una sincronización. Define el tipo y todos sus campos en Braze antes de crear la sincronización. Para añadir un campo más adelante, añádelo primero al tipo y, después, actualiza tu tabla de origen o tu consulta.

En el paso Definición de datos, selecciona el tipo de datos Relaciones entre objetos de datos y, después, elige un Nombre de relación, como Subaccount (Account-Account).

Los desencadenantes de Canvas impulsan la personalización sin copia. Para ver la configuración del Canvas de destino y las consideraciones, consulta Personalización sin copia.

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PROPERTIES VARCHAR NOT NULL,
  --at least one of external_id or alias_name and alias_label is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR
)
GO

Las sincronizaciones de desencadenantes de Canvas se diferencian de otras sincronizaciones de datos de usuario en tres aspectos:

  • Solo se admiten como identificadores el ID externo o el alias de usuario. El correo electrónico y los números de teléfono no son identificadores admitidos.
  • Solo se pueden sincronizar usuarios existentes de Braze. No se pueden crear usuarios nuevos.
  • PROPERTIES sustituye a la columna PAYLOAD. Se trata de una cadena JSON con los campos que quieres usar como propiedades de entrada en Canvas para la personalización.

Tu tabla de desencadenantes de Canvas necesita las siguientes columnas:

  • UPDATED_AT: la hora en que esta fila se actualizó o se añadió a la tabla. Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado. Las filas con la marca de tiempo exacta del límite pueden volver a sincronizarse si hay filas nuevas que comparten esa misma marca de tiempo.
  • EXTERNAL_ID, o bien ALIAS_NAME y ALIAS_LABEL, como columna de identificador de usuario. Estas columnas identifican a los usuarios para los que quieres desencadenar la mensajería de Canvas.
    • EXTERNAL_ID: identifica al usuario que entrará en el Canvas. Debe coincidir con el valor de external_id que se utiliza en Braze.
    • ALIAS_NAME y ALIAS_LABEL: estas 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: una cadena JSON de campos que estarán disponibles como propiedades de personalización en tu Canvas. Debe contener información específica del usuario.

Crea una entidad de servicio y concede los permisos. Si ya tienes credenciales de otra sincronización, puedes reutilizarlas, pero asegúrate de que tengan acceso a la tabla de desencadenantes de Canvas.

Para empezar, selecciona el tipo de datos Desencadenantes de Canvas al crear una nueva sincronización.

Las tablas de origen para eliminaciones de usuarios deben incluir uno o más tipos de identificador de usuario y una marca de tiempo UPDATED_AT. Las columnas de carga útil no son compatibles con los datos de eliminación de usuarios.

  • UPDATED_AT - La hora en que se actualizó o agregó esta fila a la tabla. Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado. Las filas con la marca de tiempo exacta del límite podrían volver a sincronizarse si hay filas nuevas que comparten esa misma marca de tiempo.
  • Columnas de identificador de usuario - Cada fila solo debe contener un identificador: external_id, la combinación de alias_name y alias_label, o braze_id. Una tabla de origen puede contener columnas para uno, dos o los tres tipos de identificador.
    • EXTERNAL_ID - Identifica al usuario que quieres actualizar. Debe coincidir con el valor de 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 diferentes etiquetas, 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.
CREATE OR ALTER TABLE [warehouse].[schema].[users_deletes]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  --at least one of external_id, alias_name and alias_label, or braze_id is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR
)
GO

En la página Crear sincronización de importación, establece el Tipo de datos en Eliminar usuarios para que se realicen las acciones adecuadas durante la ejecución de la integración. Para más información, consulta Eliminar usuarios con Cloud Data Ingestion.

Paso 5: Obtén la cadena de conexión del almacén

Para obtener el endpoint SQL de tu almacén, ve al espacio de trabajo en Fabric, pasa el cursor sobre el nombre del almacén en la lista de elementos y selecciona Copiar cadena de conexión SQL.

La página "Fabric Console" en Microsoft Azure, donde los usuarios deben obtener la cadena de conexión SQL.

Paso 6: Permite las IP de Braze en tu firewall (opcional)

Según la configuración de tu cuenta de Microsoft Fabric, es posible que tengas que permitir las siguientes direcciones IP en tu firewall para admitir el tráfico de Braze. Para más información sobre cómo habilitarlo, consulta la documentación correspondiente sobre Entra Conditional Access.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estas 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

Para la instancia US-08, estas 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

Para la instancia US-10, estas 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

Para la instancia AU-01, estas 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

Para la instancia ID-01, estas son las direcciones IP correspondientes:

  • 108.136.157.246
  • 108.137.30.207
  • 16.78.128.71
  • 16.78.14.134
  • 16.78.162.208
  • 43.218.73.35

Para la instancia JP-01, estas son las direcciones IP correspondientes:

  • 13.159.155.212
  • 54.199.221.241
  • 13.192.23.16
  • 54.250.120.139
  • 18.181.114.232
  • 3.114.38.100

Para la instancia KR-01, estas son las direcciones IP correspondientes:

  • 43.200.215.4
  • 52.79.67.175
  • 52.79.113.60
  • 3.34.212.92
  • 54.116.134.231
  • 3.37.197.225

Paso 7: Crea un nuevo origen en el panel de Braze

En el panel de 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 Microsoft Fabric.

Paso 7.1: Añade la información de conexión de Microsoft Fabric

Elige un nombre para tu origen e introduce tus credenciales y la configuración de Microsoft Fabric.

  • Nombre de las credenciales es una etiqueta para estas credenciales en Braze; aquí puedes establecer un valor que te resulte útil.
  • Para el método de autenticación que configuraste en el Paso 1, introduce sus credenciales. Introduce Tenant ID, Principal ID, and Client Secret.
  • Para Cadena de conexión, consulta el Paso 5.

Paso 7.2: Prueba la conexión y conéctate al origen

A continuación, selecciona Probar conexión. Si la prueba se realiza correctamente, completa el resto de la configuración y haz clic en Conectar al origen. Si la conexión falla, aparecerá un mensaje de error para ayudarte a solucionar el problema.

Paso 8: Crea una nueva sincronización en el panel de Braze

Ve a Configuración de datos > Ingesta de datos en la nube > Sincronizaciones y selecciona Crear sincronización de datos.

Configura los detalles de la sincronización y define tus datos

Introduce un nombre para tu sincronización. A continuación, selecciona un origen activo y un tipo de datos de sincronización. Después, selecciona un modo de sincronización y define tus datos. Luego, selecciona Vista previa y validar.

Cuando la validación se complete correctamente, aparecerá una vista previa de los datos. Selecciona Siguiente: Notificaciones para continuar. Si la validación falla, aparecerá un mensaje de error que te ayudará a solucionar el problema.

Añadir preferencias de notificación

Introduce uno o varios correos electrónicos de contacto para las notificaciones de errores de sincronización. Braze utiliza esta información de contacto para enviar notificaciones sobre errores de integración, como la pérdida inesperada de acceso a una tabla.

Los correos electrónicos de contacto solo reciben notificaciones de errores globales o a nivel de sincronización, como tablas que faltan, permisos y otros. No reciben notificaciones de problemas a nivel de fila. Los errores globales indican problemas críticos con la conexión que impiden que se ejecuten las sincronizaciones.

Estos problemas pueden ser los siguientes:

  • Problemas de conectividad
  • Falta de recursos
  • Problemas de permisos
  • El nivel de catálogo se ha quedado sin espacio (solo sincronizaciones de catálogo)

Establecer la programación

Por último, configura tu sincronización como no recurrente o recurrente.

Las sincronizaciones no recurrentes solo se ejecutan cuando seleccionas Sincronizar ahora en el panel o llamas al endpoint Desencadenar una sincronización.

Las sincronizaciones recurrentes pueden ejecutarse con una frecuencia de hasta cada 5 minutos o con tan poca frecuencia como una vez al mes. De forma predeterminada, el intervalo más corto que puedes establecer en el panel es de 15 minutos, lo que ayuda a gestionar los costos de computación de tu almacén 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 de cliente. Braze programa las sincronizaciones recurrentes en UTC.

Ejecuta la sincronización

Una vez activada, tu sincronización se ejecuta según la programación configurada durante la configuración. Si quieres ejecutar la sincronización fuera de su programación o para obtener los datos más recientes, selecciona Sincronizar ahora. Esta ejecución no afecta a las futuras sincronizaciones programadas regularmente. Para iniciar una sincronización automáticamente cuando se actualicen tus datos, llama al endpoint Desencadenar una sincronización desde tu canalización.

Configurar integraciones o usuarios adicionales (opcional)

Puedes configurar varias integraciones con Braze. Al crear sincronizaciones adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Fabric.

Si reutilizas el mismo usuario en varias integraciones, no podrás eliminarlo en el panel de Braze hasta que lo quites de todas las sincronizaciones activas.

Usar Microsoft Fabric como origen conectado

Un origen conectado es una alternativa sin copia a la sincronización de datos en Braze. Braze consulta directamente tu almacén de Fabric para crear segmentos CDI, sin copiar los datos subyacentes. Para conocer los conceptos, las limitaciones y las implicaciones de costos, consulta Orígenes conectados.

Paso 1: Configura la autenticación y concede acceso

Sigue la misma configuración descrita en el Paso 1, el Paso 2 y el Paso 3. A continuación, obtén la cadena de conexión del almacén como se describe en el Paso 5 y permite las IP de Braze como se describe en el Paso 6.

En tu espacio de trabajo de Fabric, configura los datos de origen y concede permisos a tu entidad de servicio. El origen conectado puede hacer referencia a una o varias tablas, así que asegúrate de que tu entidad de servicio de Braze tenga permiso para acceder a todas las tablas que quieras incluir en el origen conectado.

Paso 2: Crea el origen conectado en Braze

Ve a Configuración de datos > Ingesta de datos en la nube > Orígenes conectados, selecciona Agregar origen de datos y, a continuación, selecciona Microsoft Fabric.

En Configurar origen, introduce lo siguiente:

  • Credenciales: Nombre de las credenciales, Cadena de conexión y los campos de tu método de autenticación. Introduce Tenant ID, Principal ID, and Client Secret.
  • Configuración: Base de datos y Esquema

Si Conectar con túnel SSH está disponible en tu espacio de trabajo y lo necesitas para tu configuración, introduce también Host del túnel, Puerto del túnel y Nombre de usuario del túnel.

Elige un nombre para el origen conectado. Este nombre se utiliza en la lista de orígenes disponibles cuando creas una nueva extensión de segmento CDI.

Configura un tiempo de ejecución máximo para este origen. Braze cancela automáticamente cualquier consulta que supere el tiempo de ejecución máximo. El tiempo de ejecución máximo permitido es de 60 minutos; un tiempo de ejecución menor reduce los costos que se generan en tu cuenta de Microsoft Fabric. Esta configuración se aplica a las consultas que se ejecutan a través de este origen, incluidas las sincronizaciones y las extensiones de segmento CDI que lo utilizan.

Selecciona Probar conexión para comprobar que la lista de tablas visibles para el usuario es la que esperas y, a continuación, selecciona Listo. Tu origen conectado ya está creado y listo para usarse en extensiones de segmento CDI.

Puedes configurar varios orígenes conectados con Braze, pero cada origen debe configurarse para conectarse a un esquema diferente. Al crear orígenes adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Azure.

Formatear una carga útil a partir de columnas existentes

Si prefieres almacenar internamente cada atributo en su propia columna, tienes que convertir esas columnas en una cadena JSON para rellenar la sincronización con Braze. Usa esta consulta en Microsoft Fabric para dar formato a las columnas de origen como campos de CDI.

CREATE TABLE [braze].[users] (
    attribute_1 VARCHAR,
    attribute_2 VARCHAR,
    attribute_3 VARCHAR,
    attribute_4 VARCHAR,
    user_id VARCHAR
)
GO

CREATE VIEW [braze].[user_update_example]
AS SELECT
    user_id as EXTERNAL_ID,
    CURRENT_TIMESTAMP as UPDATED_AT,
    JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD

FROM [braze].[users] ;

Para obtener más orientación sobre optimización, consulta Prácticas recomendadas de la ingesta de datos en la nube.

Solución de problemas

La prueba de conexión se ejecuta lentamente

La prueba de conexión se ejecuta en tu almacén de datos, por lo que aumentar la capacidad puede mejorar su velocidad.

El secreto de la entidad de servicio ha caducado

Azure no permite una caducidad ilimitada en los secretos de las entidades de servicio. Si las sincronizaciones empiezan a fallar con errores de autenticación, actualiza el secreto de cliente en Microsoft Entra ID y actualiza las credenciales en Braze.

Dónde ejecutar comprobaciones de SQL

Ejecuta las comprobaciones de validación directamente en el editor de consultas SQL de Fabric, sobre la misma tabla o vista que utiliza tu integración de CDI. Fabric no admite LIMIT, así que utiliza una sintaxis equivalente, como TOP.

New Stuff!