Ir al contenido

Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

Fuentes conectadas

Las fuentes conectadas son una alternativa de copia cero a la sincronización directa de datos con la función de ingesta de datos en la nube (CDI) de Braze. Una fuente conectada consulta directamente tu almacén de datos para crear nuevos segmentos sin copiar ninguno de los datos subyacentes a Braze.

Después de añadir una fuente conectada a tu espacio de trabajo de Braze, puedes crear un segmento CDI dentro de las extensiones de segmento. Las extensiones de segmento CDI te permiten escribir SQL que consulta directamente tu almacén de datos (utilizando los datos disponibles a través de tu fuente conectada CDI) y crea y mantiene un grupo de usuarios a los que puedes dirigirte dentro de Braze.

Para obtener más información sobre cómo crear un segmento con esta fuente, consulta Extensiones de segmento CDI.

Advertencia

Dado que las fuentes conectadas se ejecutan directamente en tu almacén de datos, incurrirás en todos los costes asociados a la ejecución de estas consultas en tu almacén de datos. Las fuentes conectadas no registran puntos de datos y las extensiones de segmento CDI no consumen créditos de segmento SQL.

Integración de fuentes conectadas

Paso 1: Conectar tus recursos

Las fuentes conectadas de la ingesta de datos en el cloud requieren cierta configuración en Braze y en tu instancia. Sigue estos pasos para configurar la integración−algunos pasos se realizarán en tu almacén de datos y otros se realizarán en tu panel de Braze.

En tu almacén de datos

Crea un rol y concede permisos para consultar y crear tablas en un esquema.
Configura tu almacén y da acceso a ese rol.
Crea un usuario para ese rol.
Según tu configuración, es posible que necesites permitir las IP de Braze en tu política de red de Snowflake.

En el panel de Braze

Crea una nueva fuente conectada en el panel de Braze.
Configura los detalles de sincronización para la fuente conectada.
Obtén la clave pública proporcionada en el panel de Braze.

En tu almacén de datos

Añade la clave pública del panel de Braze al usuario de Snowflake para la autenticación. Cuando hayas terminado, puedes usar la fuente conectada para crear una o más extensiones de segmento CDI.

Configura los datos de origen y los recursos necesarios en tu entorno de Redshift.
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Configura los datos de origen y los recursos necesarios en tu entorno de BigQuery.
Crea una cuenta de servicio a la que Braze acceda a través de Workload Identity Federation o una clave de cuenta de servicio, y permite el acceso a los proyectos y conjuntos de datos de BigQuery que contienen los datos que deseas sincronizar.
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Configura los datos de origen y los recursos necesarios en tu entorno de Databricks.
Crea un principal de servicio para la autenticación OAuth de máquina a máquina (M2M) o un token de acceso personal, y permite el acceso a los catálogos y esquemas de Databricks que contienen los datos que deseas sincronizar.
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Importante

Puede haber de dos a cinco minutos de tiempo de calentamiento cuando Braze se conecta a instancias de SQL Classic y Pro, lo que provocará retrasos durante la configuración y prueba de la conexión, así como durante la creación y actualización de las extensiones de segmento CDI. Usar una instancia de SQL serverless minimizará el tiempo de calentamiento y mejorará el rendimiento de las consultas, pero puede resultar en costos de integración ligeramente más altos.

Crea un principal de servicio y permite el acceso al espacio de trabajo de Fabric que se utilizará para tu integración.
En tu espacio de trabajo de Fabric, configura los datos de origen y concede permisos a tu principal de servicio.
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Paso 2: Configurar tu almacén de datos

Configura los datos de origen y los recursos necesarios en tu entorno de almacén de datos. La fuente conectada puede hacer referencia a una o más tablas, así que asegúrate de que tu usuario de Braze tenga permiso para acceder a todas las tablas que desees en la fuente conectada.

Paso 2.1: Crear un rol y conceder permisos

Crea un rol para que lo use tu fuente conectada. Este rol se utilizará para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar tablas de origen con el fin de crear nuevos segmentos. Después de crear la fuente conectada, Braze descubrirá los nombres y la descripción de todas las tablas disponibles para el usuario en el esquema de origen.

El permiso create table es necesario para que Braze pueda crear una tabla con los resultados de la consulta de tu extensión de segmento CDI antes de actualizar el segmento en Braze. Braze creará una tabla temporal por segmento, y la tabla solo persistirá mientras Braze esté actualizando el segmento.

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Paso 2.2: Configurar el almacén y dar acceso al rol de Braze

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Nota

El almacén necesita tener activada la función de reanudación automática. Si no lo está, tendrás que conceder a Braze privilegios adicionales de OPERATE sobre el almacén para que Braze pueda activarlo cuando sea momento de ejecutar la consulta.

Paso 2.3: Configurar el usuario

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Compartirás la información de conexión con Braze y recibirás una clave pública para añadir al usuario en un paso posterior.

Nota

Cuando conectes diferentes espacios de trabajo a la misma cuenta de Snowflake, debes crear un usuario único para cada espacio de trabajo de Braze en el que estés creando una integración. Dentro de un espacio de trabajo, puedes reutilizar el mismo usuario en distintas integraciones, pero la creación de la integración fallará si un usuario de la misma cuenta de Snowflake está duplicado en diferentes espacios de trabajo.

Paso 2.4: Permitir las IP de Braze en tu política de red de Snowflake (opcional)

Según la configuración de tu cuenta de Snowflake, es posible que necesites permitir las siguientes direcciones IP en tu política de red de Snowflake. Para obtener más información sobre cómo hacerlo, consulta la documentación relevante de Snowflake sobre modificar una política de red.

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 2.1: Crear un usuario y conceder permisos

CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT CREATE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

Crea un usuario para que lo use tu fuente conectada. Este usuario se utilizará para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar tablas de origen con el fin de crear nuevos segmentos. Después de crear la fuente conectada, Braze descubrirá los nombres y la descripción de todas las tablas disponibles para el usuario en el esquema de origen. Si creas múltiples integraciones CDI, es posible que desees conceder permisos a un esquema o gestionar los permisos usando un grupo.

Puedes elegir conceder acceso a todas las tablas de un esquema o conceder privilegios solo a tablas específicas. Las tablas a las que el rol de Braze tenga acceso estarán disponibles para consultar en la extensión de segmento CDI. Asegúrate de conceder acceso a cualquier tabla nueva al usuario cuando se creen, o establece permisos predeterminados para el usuario.

El permiso create table es necesario para que Braze pueda crear una tabla con los resultados de la consulta de tu extensión de segmento CDI antes de actualizar el segmento en Braze. Braze creará una tabla temporal por segmento, que solo persistirá mientras Braze actualice el segmento.

Paso 2.2: Permitir el acceso a las IP de Braze

Si tienes un firewall u otras políticas de red, debes dar a Braze acceso de red a tu instancia de Redshift. Permite el acceso desde las siguientes IP correspondientes a la región de tu panel de Braze.

Es posible que también necesites cambiar tus grupos de seguridad para permitir que Braze acceda a tus datos en Redshift. Asegúrate de permitir explícitamente el tráfico entrante en las IP de la siguiente sección y en el puerto utilizado para consultar tu clúster de Redshift (el predeterminado es 5439). Debes permitir explícitamente la conectividad TCP de Redshift en este puerto incluso si las reglas de entrada están configuradas como “permitir todo”. Además, es importante que el endpoint del clúster de Redshift sea accesible públicamente para que Braze pueda conectarse a tu clúster.

Si no quieres que tu clúster de Redshift sea accesible públicamente, puedes configurar una VPC y una instancia EC2 para usar un túnel SSH para acceder a los datos de Redshift. Para obtener más información, consulta AWS: ¿Cómo puedo acceder a un clúster privado de Amazon Redshift desde mi máquina local?

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 2.1: Crear credenciales para Braze

Crea una cuenta de servicio en GCP para que Braze la use para conectarse y leer datos de tu(s) tabla(s). La cuenta de servicio debe tener los siguientes permisos en la siguiente sección:

BigQuery Connection User: Permite a Braze realizar conexiones.
BigQuery User: Proporciona a Braze acceso para ejecutar consultas, leer metadatos de conjuntos de datos y listar tablas.
BigQuery Data Viewer: Proporciona a Braze acceso para ver conjuntos de datos y su contenido.
BigQuery Job User: Proporciona a Braze acceso para ejecutar trabajos.
bigquery.tables.create Proporciona a Braze acceso para crear tablas temporales durante la actualización de segmentos.

Crea una cuenta de servicio para que la use tu fuente conectada. Este usuario se utilizará para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar tablas de origen con el fin de crear nuevos segmentos. Después de crear la fuente conectada, Braze descubrirá los nombres y la descripción de todas las tablas disponibles para el usuario en el esquema de origen.

Puedes elegir conceder acceso a todas las tablas de un conjunto de datos o conceder privilegios solo a tablas específicas. Las tablas a las que el rol de Braze tenga acceso estarán disponibles para consultar en la extensión de segmento CDI.

Braze puede acceder a la cuenta de servicio con Workload Identity Federation o una clave de cuenta de servicio. Las credenciales de clave de cuenta de servicio existentes siguen funcionando y no necesitas migrarlas. Una credencial de Workload Identity Federation puede servir tanto para fuentes de BigQuery como de Google Cloud Storage.

workload identity federation
clave de cuenta de servicio

Configura un grupo de identidades de carga de trabajo, un proveedor y la cuenta de servicio, y vincula el principal de Braze a la cuenta de servicio. Para ver los pasos, consulta Configurar Google Cloud para Workload Identity Federation. Si ya configuraste Workload Identity Federation para otra fuente de BigQuery o Google Cloud Storage, no necesitas repetirlo. Concede a la cuenta de servicio existente los permisos indicados en este paso.

Después de crear la cuenta de servicio y conceder los permisos, genera una clave JSON. Para obtener más información, consulta Google Cloud: Crear y eliminar claves de cuentas de servicio. La cargarás en el panel de Braze más adelante.

Paso 2.2: Permitir el acceso a las IP de Braze

Si tienes políticas de red implementadas, debes dar a Braze acceso de red a tu instancia de BigQuery. Permite el acceso desde las siguientes IP correspondientes a la región de tu panel de Braze.

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 2.1: Crear credenciales para Braze

Braze puede conectarse a Databricks usando OAuth de máquina a máquina (M2M) con un principal de servicio, o con un token de acceso personal. Braze recomienda OAuth M2M. Las credenciales de token de acceso personal existentes siguen funcionando y no necesitas migrarlas.

Independientemente del método que elijas, Braze usa estas credenciales para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar tablas de origen con el fin de crear nuevos segmentos. Después de crear la fuente conectada, Braze descubre los nombres y las descripciones de todas las tablas disponibles para el usuario en el esquema de origen.

Puedes conceder acceso a todas las tablas de un esquema o conceder privilegios solo a tablas específicas. Las tablas a las que el rol de Braze tenga acceso estarán disponibles para consultar en la extensión de segmento CDI.

El permiso CREATE TABLE es necesario para que Braze pueda crear una tabla con los resultados de la consulta de tu extensión de segmento CDI antes de actualizar el segmento en Braze. Braze crea una tabla temporal por segmento, que persiste solo mientras Braze actualiza el segmento.

oauth m2m
token de acceso personal

Crea un principal de servicio, genera un secreto de cliente y concede al principal de servicio el permiso Can use en tu almacén SQL. Para ver los pasos, consulta Crear credenciales para Braze.
Concede al principal de servicio acceso al esquema utilizado para la fuente conectada, incluyendo CREATE TABLE. Usa el ID de aplicación del principal de servicio (el mismo valor que el ID de cliente) como beneficiario.

GRANT USE CATALOG ON CATALOG `BRAZE-CLOUD-PRODUCTION` TO `APPLICATION_ID`;
GRANT USE SCHEMA, CREATE TABLE ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;
GRANT SELECT ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;

Reemplaza APPLICATION_ID con el ID de aplicación de tu principal de servicio.

Guarda el ID de cliente y el secreto en un lugar seguro hasta que necesites ingresarlos en el panel de Braze durante el paso de creación de credenciales.

En tu espacio de trabajo de Databricks, selecciona tu nombre de usuario de Databricks en la barra superior y luego selecciona User Settings en el menú desplegable.
Asegúrate de que la cuenta de servicio tenga privilegios de CREATE TABLE en el esquema utilizado para la fuente conectada.
En la pestaña Access tokens, selecciona Generate new token.
Ingresa un comentario que te ayude a identificar este token, como “Braze CDI”, y cambia la vida útil del token a sin vida útil dejando la casilla de Lifetime (days) vacía (en blanco).
Selecciona Generate.
Copia el token mostrado y luego selecciona Done.

Guarda el token en un lugar seguro hasta que necesites ingresarlo en el panel de Braze durante el paso de creación de credenciales.

Paso 2.2: Permitir el acceso a las IP de Braze

Si tienes políticas de red implementadas, debes dar a Braze acceso de red a tu instancia de Databricks. Permite el acceso desde las siguientes IP correspondientes a la región de tu panel de Braze.

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 2.1: Conceder acceso a los recursos de Fabric

Braze se conectará a tu almacén de Fabric usando un principal de servicio con autenticación de Entra ID. Crearás un nuevo principal de servicio para que Braze lo use y concederás acceso a los recursos de Fabric según sea necesario. Braze necesitará 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

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 only como 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.

Nota

Azure no permite caducidad ilimitada en los secretos de los principales de servicio. Recuerda actualizar las credenciales antes de que caduquen para mantener el flujo de datos hacia Braze.

Paso 2.2: Conceder acceso a los recursos de Fabric

Proporcionarás acceso para que Braze se conecte 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 “Los principales de servicio pueden usar las API de Fabric” para que Braze pueda conectarse usando 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 el principal de servicio pueda acceder a los datos desde una aplicación externa.

Paso 2.3: Obtener la cadena de conexión del almacén

Necesitarás el endpoint SQL de tu almacén para que Braze pueda conectarse. Para obtener el endpoint SQL, ve al espacio de trabajo en Fabric, y en la lista de elementos, pasa el cursor sobre el nombre del almacén y selecciona Copiar cadena de conexión SQL. Guarda este valor disponible para la configuración de credenciales en el paso 3.

Paso 2.4: Permitir las IP de Braze en el firewall (opcional)

Según la configuración de tu cuenta de Microsoft Fabric, es posible que necesites permitir las siguientes direcciones IP en tu firewall para permitir el tráfico desde Braze. Para obtener más información sobre cómo habilitarlo, consulta la documentación relevante sobre Acceso condicional de Entra.

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 3: Crear una fuente conectada en el panel de Braze

Paso 3.1: Agregar la información de conexión de Snowflake y la tabla de origen

Crea una fuente conectada en el panel de Braze. Ve a Configuración de datos > Ingesta de datos en el cloud > Fuentes conectadas, selecciona Agregar origen de datos y luego selecciona Snowflake.

En Configurar origen, ingresa lo siguiente:

Credenciales: Account Locator, Username y Role
Configuración: Warehouse, Database y Schema

Si estás creando nuevas credenciales de Snowflake, selecciona Guardar credenciales y generar clave RSA antes de probar la conexión.

Paso 3.2: Configurar los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo máximo de ejecución para esta fuente. Braze cancelará automáticamente cualquier consulta que exceda el tiempo máximo de ejecución. El tiempo máximo de ejecución permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos incurridos en tu cuenta de Snowflake. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluyendo las sincronizaciones y las extensiones de segmento CDI que la utilicen.

Nota

Si las consultas están agotando el tiempo de espera de forma constante y has establecido un tiempo máximo de ejecución de 60 minutos, considera intentar optimizar el tiempo de ejecución de tus consultas o dedicar un almacén más grande al usuario de Braze.

Paso 3.3: Anotar la clave pública

En el paso Probar conexión, toma nota de la clave pública RSA. La necesitarás para completar la integración en Snowflake.

Paso 3.1: Agregar la información de conexión de Redshift y la tabla de origen

En Configurar origen, ingresa lo siguiente:

Credenciales: Redshift Host URL, Username, Password y Port
Configuración: Database y Schema

Si es necesario, habilita Conectar con túnel SSH e ingresa Tunnel Host, Tunnel Port y Tunnel Username.

Paso 3.2: Configurar los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo máximo de ejecución para esta fuente. Braze cancelará automáticamente cualquier consulta que exceda el tiempo máximo de ejecución. El tiempo máximo de ejecución permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos incurridos en tu cuenta de Redshift. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluyendo las sincronizaciones y las extensiones de segmento CDI que la utilicen.

Nota

Paso 3.3: Anotar la clave pública (opcional)

Si tus credenciales tienen Conectar con túnel SSH seleccionado, toma nota de la clave pública RSA en el paso Probar conexión. La necesitarás para completar la integración en Redshift.

Paso 3.1: Agregar la información de conexión de BigQuery y la tabla de origen

En Configurar origen, ingresa lo siguiente:

Credenciales: Nombre de credencial y método de autenticación, además de Project number, Workload identity pool ID, Provider ID y Service account email (Workload Identity Federation) o tu clave JSON cargada (clave de cuenta de servicio)
Configuración: Project y Dataset

Paso 3.2: Configurar los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo máximo de ejecución para esta fuente. Braze cancelará automáticamente cualquier consulta que exceda el tiempo máximo de ejecución. El tiempo máximo de ejecución permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos incurridos en tu cuenta de BigQuery. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluyendo las sincronizaciones y las extensiones de segmento CDI que la utilicen.

Nota

Paso 3.3: Probar la conexión

Selecciona Probar conexión para verificar que la lista de tablas visibles para el usuario sea la que esperas, luego selecciona Listo. Tu fuente conectada está ahora creada y lista para usarse en las extensiones de segmento CDI.

Paso 3.1: Agregar la información de conexión de Databricks y la tabla de origen

En Configurar origen, ingresa lo siguiente:

Credenciales: Nombre de credencial, Método de autenticación, Hostname y HTTP path, además de Client ID y Client secret (OAuth M2M) o Access token (token de acceso personal)
Configuración: Catalog y Schema

Paso 3.2: Configurar los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo máximo de ejecución para esta fuente. Braze cancelará automáticamente cualquier consulta que exceda el tiempo máximo de ejecución. El tiempo máximo de ejecución permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos incurridos en tu cuenta de Databricks. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluyendo las sincronizaciones y las extensiones de segmento CDI que la utilicen.

Nota

Paso 3.3: Probar la conexión

Paso 3.1: Agregar la información de conexión de Microsoft Fabric y la tabla de origen

En Configurar origen, ingresa lo siguiente:

Credenciales: Nombre de credenciales, Tenant ID, Principal ID, Client Secret y Connection String
Configuración: Database y Schema

Si Conectar con túnel SSH está disponible en tu espacio de trabajo y es necesario para tu configuración, también ingresa Tunnel Host, Tunnel Port y Tunnel Username.

Paso 3.2: Configurar los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo máximo de ejecución para esta fuente. Braze cancelará automáticamente cualquier consulta que exceda el tiempo máximo de ejecución. El tiempo máximo de ejecución permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos incurridos en tu cuenta de Microsoft Fabric. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluyendo las sincronizaciones y las extensiones de segmento CDI que la utilicen.

Nota

Paso 3.3: Probar la conexión

Paso 4: Finalizar la configuración del almacén de datos

Añade la clave pública que anotaste durante el último paso a tu usuario en Snowflake. Esto permitirá que Braze se conecte a Snowflake. Para obtener detalles sobre cómo hacer esto, consulta la documentación de Snowflake.

Si deseas rotar las claves en algún momento, puedes crear una nueva clave pública yendo a Gestión de acceso a datos en Ingesta de datos en el cloud y seleccionando Generar nueva clave para la cuenta correspondiente.

ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='{INSERT_YOUR_KEY}';

Después de añadir la clave al usuario en Snowflake, selecciona Probar conexión en Braze y luego selecciona Listo. Tu fuente conectada está ahora creada y lista para usarse en las extensiones de segmento CDI.

Si te conectas con un túnel SSH, añade la clave pública que anotaste durante el último paso al usuario del túnel SSH.

Después de añadir la clave al usuario, selecciona Probar conexión en Braze y luego selecciona Listo. Tu fuente conectada está ahora creada y lista para usarse en las extensiones de segmento CDI.

Esto no aplica a BigQuery.

Esto no aplica a Databricks.

Esto no aplica a Microsoft Fabric.

Nota

Debes probar exitosamente una fuente antes de que pueda pasar del estado “borrador” al estado “activa”. Si necesitas cerrar la página de creación, tu integración se guardará y podrás volver a la página de detalles para hacer cambios y probar.

Configurar integraciones o usuarios adicionales (opcional)

Puedes configurar múltiples integraciones con Braze, pero cada integración debe conectarse a un esquema diferente. Al crear conexiones adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Snowflake.

Si reutilizas el mismo usuario y rol en distintas integraciones, no necesitarás añadir la clave pública de nuevo.

Puedes configurar múltiples orígenes de datos con Braze, pero cada origen debe conectarse a un esquema diferente. Al crear orígenes adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Redshift.

Puedes configurar múltiples orígenes de datos con Braze, pero cada origen debe conectarse a un conjunto de datos diferente. Al crear orígenes adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de BigQuery.

Uso del origen de datos conectado

Una vez creado el origen de datos, puedes usarlo para crear una o más extensiones de segmento de CDI. Para más información sobre cómo crear un segmento con este origen de datos, consulta la documentación de extensiones de segmento de CDI.

Nota

Si las consultas superan el tiempo de espera de forma constante y has establecido un tiempo máximo de ejecución de 60 minutos, considera optimizar el tiempo de ejecución de tu consulta o dedicar más recursos de cómputo (como un almacén de datos más grande) al usuario de Braze.

New Stuff!