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.

Integraciones de almacenamiento de almacén de datos

Esta página explica cómo utilizar la ingesta de datos de Cloud (CDI) de Braze para sincronizar datos relevantes con tu integración de Snowflake, Redshift, BigQuery y Databricks.

Configuración de integraciones con el almacén de datos

Las integraciones de ingesta de datos en la nube requieren cierta configuración tanto del lado de Braze como en la instancia de tu almacén de datos. Sigue estos pasos para configurar la integración:

En tu instancia de Snowflake, configura las tablas o vistas que deseas sincronizar con Braze.
Crea un nuevo origen de Snowflake en el panel de Braze.
Recupera la clave pública proporcionada en el panel de Braze y añádela al usuario de Snowflake para la autenticación.
Crea una sincronización en el panel de Braze, prueba la integración e inicia la sincronización.

Consejo

La guía de inicio rápido de Snowflake proporciona código de ejemplo y recorre los pasos necesarios para crear una canalización automatizada usando Snowflake Streams y CDI para sincronizar datos con Braze.

Asegúrate de que el acceso de Braze esté permitido a las tablas de Redshift que deseas sincronizar. Braze se conecta a Redshift a través de Internet.
En tu instancia de Redshift, configura las tablas o vistas que deseas sincronizar con Braze.
Crea un nuevo origen y sincronización en el panel de Braze.
Prueba la integración e inicia la sincronización.

Nota

Las filas procesadas por sincronización dependen del rendimiento de tu almacén, la latencia de red y la cantidad de datos nuevos que coincidan con la consulta de sincronización. Usa el Historial de sincronización de la integración en el panel para ver la duración y el conteo de filas de las ejecuciones recientes.

Crea una cuenta de servicio y permite el acceso al proyecto o proyectos y conjunto(s) de datos de BigQuery que contengan los datos que deseas sincronizar.
En tu cuenta de BigQuery, configura las tablas o vistas que deseas sincronizar con Braze.
Crea un nuevo origen y sincronización en el panel de Braze.
Prueba la integración e inicia la sincronización.

Crea un principal de servicio (OAuth M2M) o un token de acceso personal, y permite el acceso a los catálogos y esquemas de Databricks que contengan los datos que deseas sincronizar.
En tu cuenta de Databricks, configura las tablas o vistas que deseas sincronizar con Braze.
Crea un nuevo origen y sincronización en el panel de Braze.
Prueba la integración e inicia la sincronización.

Importante

Puede haber de dos a cinco minutos de tiempo de calentamiento cuando Braze se conecta a instancias SQL Classic y Pro, lo que puede provocar retrasos durante la configuración y las pruebas de conexión, así como al inicio de las sincronizaciones programadas. Usar una instancia SQL serverless minimiza el tiempo de calentamiento y mejora el rendimiento de las consultas, pero puede resultar en costos de integración ligeramente más altos.

Crea un principal de servicio y otorga acceso a las API de Fabric.
Configura un espacio de trabajo compartido y otorga al principal de servicio acceso a él.
En el espacio de trabajo compartido de Fabric, configura las tablas o vistas que deseas sincronizar con Braze.
Crea un nuevo origen y sincronización en el panel de Braze.
Prueba la integración e inicia la sincronización.

Paso 1: Configurar tablas o vistas

Los pasos de esta sección crean una tabla con una columna PAYLOAD. Si planeas mapear columnas con Visual o escribir una consulta con SQL en el paso de Definición de datos, puedes usar una tabla o vista existente en su lugar. Omite el paso de creación de tabla para tu almacén y otorga a Braze acceso de lectura a las tablas o vistas que deseas sincronizar. Para una comparación de opciones, consulta Elegir una opción de definición de datos.

Nota

Si usas una columna PAYLOAD, tu tabla o vista de origen puede incluir columnas que no se enumeran para tu almacén en las pestañas de la siguiente sección (por ejemplo, auditoría o hashing). Braze solo lee las columnas descritas en esas pestañas; las demás columnas no se utilizan durante las sincronizaciones de ingesta de datos en la nube.

Paso 1.1: Configurar la tabla

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     --braze_id can only be used to update existing users created through the Braze SDK
     BRAZE_ID VARCHAR(16777216),
     --If you include both email and phone, email is used as the primary identifier
     EMAIL VARCHAR(16777216),
     PHONE VARCHAR(16777216),
     PAYLOAD VARCHAR(16777216) NOT NULL
);

Puedes nombrar la base de datos, el esquema y la tabla como prefieras, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - La hora en que esta fila fue actualizada o añadida 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 resincronizarse si nuevas filas 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 debe contener solo 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 deseas 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 múltiples alias con diferentes etiquetas, pero solo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario de Braze. Es generado por el SDK de Braze, y no se pueden crear nuevos usuarios usando un Braze ID a través de 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 múltiples perfiles con la misma dirección de correo electrónico, se prioriza el perfil actualizado más recientemente. Si incluyes tanto correo electrónico como teléfono, el correo electrónico se usa como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen múltiples perfiles con el mismo número de teléfono, se prioriza el perfil actualizado más recientemente.
PAYLOAD - Esta es una cadena JSON de los campos que deseas sincronizar con el usuario en Braze.

Paso 1.2: Configurar el rol y los permisos de la base de datos

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 SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Actualiza los nombres según sea necesario, pero los permisos deben coincidir con el ejemplo anterior.

Paso 1.3: 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 marca de auto-resume. Si no la tiene, otorga a Braze privilegios adicionales de OPERATE en el almacén para que Braze pueda activarlo cuando se ejecute la consulta.

Paso 1.4: Configurar el usuario

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Después de este paso, comparte la información de conexión con Braze para recibir una clave pública que se añadirá al usuario.

Nota

Al conectar diferentes espacios de trabajo a la misma cuenta de Snowflake, debes crear un usuario único para cada espacio de trabajo de Braze donde 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 falla si un usuario de la misma cuenta de Snowflake se duplica entre espacios de trabajo.

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

Dependiendo de la configuración de tu cuenta de Snowflake, puede que necesites permitir las siguientes direcciones IP en tu política de red de Snowflake. Para más información sobre cómo habilitarlo, 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 1.1: Configurar la tabla

Opcionalmente, configura una nueva base de datos y esquema para alojar tu tabla de origen

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Crea una tabla (o vista) para usar con tu integración CDI

CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --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_label varchar,
   alias_name 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,
   payload varchar(max)
)

Puedes nombrar la base de datos, el esquema y la tabla como prefieras, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - La hora en que esta fila fue actualizada o añadida 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 resincronizarse si nuevas filas 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 debe contener solo 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 deseas 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 múltiples alias con diferentes etiquetas, pero solo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario de Braze. Es generado por el SDK de Braze, y no se pueden crear nuevos usuarios usando un Braze ID a través de 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 múltiples perfiles con la misma dirección de correo electrónico, se prioriza el perfil actualizado más recientemente. Si incluyes tanto correo electrónico como teléfono, el correo electrónico se usa como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen múltiples perfiles con el mismo número de teléfono, se prioriza el perfil actualizado más recientemente.
PAYLOAD - Esta es una cadena JSON de los campos que deseas sincronizar con el usuario en Braze.

Paso 1.2: Crear usuario y otorgar permisos

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

Estos son los permisos mínimos requeridos para este usuario. Si estás creando múltiples integraciones CDI, puede que desees otorgar permisos a un esquema o gestionar permisos usando un grupo.

Paso 1.3: 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. Un ejemplo del endpoint de URL de Redshift es “example-cluster.ap-northeast-2.redshift.amazonaws.com”.

Algunos aspectos importantes a tener en cuenta:

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 tabla 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”.
El endpoint del clúster de Redshift debe ser accesible públicamente para que Braze pueda conectarse a tu clúster.
- Si no deseas que tu clúster de Redshift sea accesible públicamente, puedes configurar una VPC e instancia EC2 para usar un túnel SSH para acceder a los datos de Redshift. Para más información, consulta la publicación del Centro de Conocimiento de AWS.

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 1.1: Configurar la tabla

Opcionalmente, configura un nuevo proyecto o conjunto de datos para alojar tu tabla de origen.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Crea una o más tablas para usar con tu integración CDI con los siguientes campos:

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp,
  --At least one of external_id, alias_name and alias_label, or braze_id is required
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, email is used as the primary identifier
  email STRING,
  phone STRING,
  payload JSON
);

Nombre del campo	Tipo	Modo
`UPDATED_AT`	TIMESTAMP	REQUIRED
`PAYLOAD`	JSON	REQUIRED
`EXTERNAL_ID`	STRING	NULLABLE
`ALIAS_NAME`	STRING	NULLABLE
`ALIAS_LABEL`	STRING	NULLABLE
`BRAZE_ID`	STRING	NULLABLE
`EMAIL`	STRING	NULLABLE
`PHONE`	STRING	NULLABLE

Puedes nombrar el proyecto, el conjunto de datos y la tabla como prefieras, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - La hora en que esta fila fue actualizada o añadida 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 resincronizarse si nuevas filas 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 debe contener solo 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 deseas 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 múltiples alias con diferentes etiquetas, pero solo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario de Braze. Es generado por el SDK de Braze, y no se pueden crear nuevos usuarios usando un Braze ID a través de 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 múltiples perfiles con la misma dirección de correo electrónico, se prioriza el perfil actualizado más recientemente. Si incluyes tanto correo electrónico como teléfono, el correo electrónico se usa como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen múltiples perfiles con el mismo número de teléfono, se prioriza el perfil actualizado más recientemente.
PAYLOAD - Esta es una cadena JSON de los campos que deseas sincronizar con el usuario en Braze.

Importante

Particionamiento de BigQuery

CDI admite particiones para BigQuery. Si particionas por una función de UPDATED_AT (por ejemplo, con granularidad de día, semana u hora, dependiendo del tamaño de tu conjunto de datos), BigQuery puede recortar los datos que necesita escanear. Esto mejora el rendimiento y la eficiencia para tablas muy grandes.

No particiones por otros campos. Prueba diferentes configuraciones para encontrar la mejor configuración para tus datos específicos.

Todas las consultas de CDI filtran por UPDATED_AT, pero este comportamiento podría cambiar. Diseña el esquema de tu tabla para que no requiera que las consultas incluyan esta cláusula.

Para más información, consulta la documentación de particionamiento de BigQuery.

Paso 1.2: Crear una cuenta de servicio y otorgar permisos

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:

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

Después de crear la cuenta de servicio y otorgar permisos, genera una clave JSON. Para más información, consulta Crear y eliminar claves de cuentas de servicio. Sube esta clave al panel de Braze en un paso posterior.

Paso 1.3: Permitir el acceso a las IP de Braze

Si tienes políticas de red en vigor, 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 1.1: Configurar la tabla

Opcionalmente, configura un nuevo catálogo o esquema para alojar tu tabla de origen.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Crea una o más tablas para usar con tu integración CDI con los siguientes campos:

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp(),
  --At least one of external_id, alias_name and alias_label, or braze_id is required
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, email is used as the primary identifier
  email STRING,
  phone STRING,
  payload STRING, STRUCT, or MAP
);

Nombre del campo	Tipo	Modo
`UPDATED_AT`	TIMESTAMP	REQUIRED
`PAYLOAD`	STRING, STRUCT, or MAP	REQUIRED
`EXTERNAL_ID`	STRING	NULLABLE
`ALIAS_NAME`	STRING	NULLABLE
`ALIAS_LABEL`	STRING	NULLABLE
`BRAZE_ID`	STRING	NULLABLE
`EMAIL`	STRING	NULLABLE
`PHONE`	STRING	NULLABLE

Puedes nombrar el esquema y la tabla como prefieras, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - La hora en que esta fila fue actualizada o añadida 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 resincronizarse si nuevas filas 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 debe contener solo 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 deseas 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 múltiples alias con diferentes etiquetas, pero solo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario de Braze. Es generado por el SDK de Braze, y no se pueden crear nuevos usuarios usando un Braze ID a través de 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 múltiples perfiles con la misma dirección de correo electrónico, se prioriza el perfil actualizado más recientemente. Si incluyes tanto correo electrónico como teléfono, el correo electrónico se usa como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen múltiples perfiles con el mismo número de teléfono, se prioriza el perfil actualizado más recientemente.
PAYLOAD - Esta es una cadena o estructura de los campos que deseas sincronizar con el usuario en Braze.

Paso 1.2: Crear credenciales para Braze

Braze puede conectarse a Databricks con cualquiera de los siguientes métodos de autenticación:

OAuth M2M (recomendado): Braze se autentica como un principal de servicio de Databricks usando un ID de cliente y un secreto de cliente. Databricks recomienda la autenticación OAuth máquina a máquina (M2M) para conexiones desatendidas como la ingesta de datos en la nube.
Token de acceso personal: Braze se autentica con un token generado en tu espacio de trabajo de Databricks.

Las credenciales existentes de tokens de acceso personal siguen funcionando, y no necesitas migrarlas. Sin embargo, los tokens de acceso personal suelen caducar según un calendario establecido por el administrador de tu espacio de trabajo, y las sincronizaciones se detienen cuando el token caduca. Para migrar un origen existente a OAuth M2M, crea una credencial OAuth M2M y selecciónala cuando edites el origen.

oauth m2m
personal access token

Braze se conecta a tu espacio de trabajo de Databricks usando un principal de servicio con autenticación OAuth M2M. Crea un nuevo principal de servicio para que Braze lo use, y otórgale acceso a tu almacén SQL y tablas de origen. Braze necesita los siguientes datos para conectarse:

ID de cliente (también llamado ID de aplicación) del principal de servicio
Secreto de cliente para que Braze se autentique

Crear el principal de servicio

En tu espacio de trabajo de Databricks, selecciona tu nombre de usuario en la barra superior y luego selecciona Configuración.
Ve a Identidad y acceso, y luego selecciona Administrar junto a Principales de servicio.
Selecciona Añadir principal de servicio > Añadir nuevo.
Ingresa un nombre que te ayude a identificar el principal de servicio, como “Braze CDI”, y luego selecciona Añadir.
Selecciona el principal de servicio que creaste. En la pestaña Configuraciones, asegúrate de que Acceso SQL de Databricks esté seleccionado.

Generar un secreto de cliente

En la página del principal de servicio, selecciona la pestaña Secretos y luego selecciona Generar secreto.
Ingresa un tiempo de vida para el secreto, en días. Databricks permite un tiempo de vida máximo de 730 días.
Selecciona Generar.
Copia los valores de Secreto e ID de cliente, y luego selecciona Listo.

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. Databricks muestra el secreto solo una vez.

Nota

Databricks no permite tiempos de vida ilimitados en los secretos de los principales de servicio. Recuerda reemplazar el secreto antes de que caduque para mantener el flujo de datos hacia Braze. Para ver los pasos, consulta Actualizar el secreto de cliente.

Otorgar acceso al almacén SQL

Braze necesita permiso para ejecutar consultas en tu almacén SQL, pero no necesita acceso de administrador del espacio de trabajo.

En la barra lateral, selecciona SQL Warehouses y luego selecciona el almacén que deseas que Braze use.
Selecciona Permisos.
Busca y selecciona el principal de servicio que creaste.
En el menú desplegable de permisos, selecciona Can use y luego selecciona Añadir.

Otorgar acceso a las tablas de origen

Otorga al principal de servicio acceso de lectura al catálogo, esquema y tablas que configuraste en el paso 1.1. 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 ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `<application-id>`;
GRANT SELECT ON TABLE `BRAZE-CLOUD-PRODUCTION`.INGESTION.USERS_ATTRIBUTES_SYNC TO `<application-id>`;

Actualiza los nombres según sea necesario, pero los permisos deben coincidir con el ejemplo anterior.

Actualizar el secreto de cliente

Braze almacena un secreto de cliente por credencial. Cuando lo actualizas, cada origen y sincronización que usa la credencial cambia al nuevo secreto. Para reemplazar el secreto:

En Databricks, genera un nuevo secreto para el principal de servicio siguiendo los pasos en Generar un secreto de cliente. No elimines el secreto anterior todavía.
En el panel de Braze, ve a Configuración de datos > Ingesta de datos en la nube > Credenciales, y luego selecciona tu credencial OAuth M2M. La sección Usado por lista cada origen y sincronización que usa esta credencial.
Pausa las sincronizaciones que usan esta credencial, o planifica la actualización para un momento en que ninguna de ellas esté programada para ejecutarse. Esto evita que una sincronización comience mientras se está actualizando la credencial.
Selecciona Editar credencial, ingresa el nuevo secreto de cliente y luego selecciona Guardar. El cambio se aplica a cada origen y sincronización que usa esta credencial.
Reanuda las sincronizaciones que pausaste.
Después de que Braze guarde el nuevo secreto, elimina el secreto anterior en Databricks.

Para que Braze acceda a Databricks, es necesario crear un token de acceso personal.

En tu espacio de trabajo de Databricks, selecciona tu nombre de usuario de Databricks en la barra superior, y luego selecciona Configuración de usuario en el menú desplegable.
En la pestaña de tokens de acceso, selecciona Generar nuevo token.
Ingresa un comentario que te ayude a identificar este token, como “Braze CDI”, y cambia el tiempo de vida del token a sin límite dejando el campo Tiempo de vida (días) vacío (en blanco).
Selecciona Generar.
Copia el token mostrado y luego selecciona Listo.

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 1.3: Permitir el acceso a las IP de Braze

Si tienes políticas de red en vigor, 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 1.1: Configurar el principal de servicio y otorgar acceso

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

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 1.2: Otorgar acceso a los recursos de Fabric

Proporciona acceso para que Braze se conecte a tu instancia de Fabric. En tu portal de administración de Fabric, navega 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 datos almacenados en OneLake con aplicaciones externas a Fabric para que el principal de servicio pueda acceder a datos desde una aplicación externa.

Paso 1.3: Configurar un espacio de trabajo compartido y otorgar acceso

Todos los recursos de Fabric que desees conectar a Braze deben estar ubicados en un espacio de trabajo compartido. Si solo has estado usando el Mi espacio de trabajo predeterminado, crea un nuevo espacio de trabajo compartido:

En el menú de navegación, selecciona Espacios de trabajo y luego selecciona + Nuevo espacio de trabajo.
Ingresa un Nombre para el espacio de trabajo y luego selecciona Aplicar.

Después de tener un espacio de trabajo compartido, otorga acceso al principal de servicio:

Selecciona el espacio de trabajo y luego selecciona Administrar acceso.
Selecciona + Añadir personas o grupos.
Busca y selecciona el nombre del principal de servicio que creaste en el paso 1.1. Si no aparece, confirma que hayas habilitado la configuración Los principales de servicio pueden usar las API de Fabric en el paso 1.2.
En el menú desplegable de rol, selecciona Colaborador.

El principal de servicio ahora puede acceder a los recursos del almacén de Fabric en este espacio de trabajo a través de sus endpoints SQL, incluyendo el almacén que se usará para Braze.

Paso 1.4: Configurar la tabla

Braze admite tanto tablas como vistas en almacenes de Fabric. Si necesitas crear un nuevo almacén, créalo dentro del espacio de trabajo compartido del paso 1.3. Ve a Crear > Almacén de datos > Almacén en la consola de Fabric.

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

Puedes nombrar el almacén, el esquema y la tabla o vista como prefieras, pero los nombres de las columnas deben coincidir con la definición anterior.

UPDATED_AT - La hora en que esta fila fue actualizada o añadida 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 resincronizarse si nuevas filas 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 debe contener solo 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 deseas 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 múltiples alias con diferentes etiquetas, pero solo un alias_name por alias_label.
- BRAZE_ID - El identificador de usuario de Braze. Es generado por el SDK de Braze, y no se pueden crear nuevos usuarios usando un Braze ID a través de 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 múltiples perfiles con la misma dirección de correo electrónico, se prioriza el perfil actualizado más recientemente. Si incluyes tanto correo electrónico como teléfono, el correo electrónico se usa como identificador principal.
- PHONE - El número de teléfono del usuario. Si existen múltiples perfiles con el mismo número de teléfono, se prioriza el perfil actualizado más recientemente.
PAYLOAD - Esta es una cadena JSON de los campos que deseas sincronizar con el usuario en Braze.

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

Para recuperar 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 "Consola de Fabric" en Microsoft Azure, donde los usuarios deben recuperar la cadena de conexión SQL.

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

Dependiendo de la configuración de tu cuenta de Microsoft Fabric, puede que necesites permitir las siguientes direcciones IP en tu firewall para permitir el tráfico desde Braze. Para 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 2: Crear 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 > Orígenes, selecciona Añadir origen de datos y luego selecciona Snowflake.

Paso 2.1: Añadir la información de conexión de Snowflake

Elige un nombre para tu origen e ingresa tus credenciales y configuración de Snowflake, luego continúa al siguiente paso.

Antes de continuar, confirma el valor que ingresas en Localizador de cuenta de Snowflake.

Para el campo Localizador de cuenta de Snowflake, ingresa tu identificador de cuenta de Snowflake. Ingresa solo el valor del identificador de cuenta, como myorganization-myaccount. No incluyas https://, .snowflakecomputing.com ni ninguna ruta.

Para encontrar tu identificador de cuenta de Snowflake:

En Snowsight, selecciona el menú de tu cuenta.
Selecciona Ver detalles de la cuenta.
Copia el valor del Identificador de cuenta.
Si copias desde una URL de Snowflake, usa solo el valor antes de .snowflakecomputing.com.

Paso 2.2: Añadir una clave pública al usuario de Braze

Después de ingresar tus credenciales y configuración, haz clic en Guardar credenciales y genera una clave RSA, luego regresa a Snowflake para completar la configuración. Añade la clave pública mostrada en el panel al usuario que creaste para que Braze se conecte a Snowflake.

Para obtener información adicional sobre cómo hacerlo, consulta la documentación de Snowflake. Si deseas rotar las claves en cualquier momento, Braze puede generar un nuevo par de claves y proporcionarte la nueva clave pública.

ALTER USER BRAZE_INGESTION_USER SET RSA_PUBLIC_KEY='MIIBIjANBgkqhkiG9w0BA...';

En el panel de Braze, ve a Configuración de datos > Ingesta de datos en la nube > Orígenes, selecciona Añadir origen de datos y luego selecciona Amazon Redshift.

Paso 2.1: Añadir la información de conexión de Redshift y la tabla de origen

Elige un nombre para tu origen e ingresa tus credenciales y configuración de Redshift. Si estás usando un túnel de red privada, activa el interruptor e ingresa la información del túnel. Luego, continúa al siguiente paso.

Nota

En el panel de Braze, el campo Nombre de la base de datos solo acepta letras (A-Z, a-z), números (0-9) y guiones bajos (_), aunque Amazon Redshift admite caracteres adicionales en los identificadores de base de datos.

Paso 2.2: Probar la conexión y conectar al origen

A continuación, selecciona Probar conexión. Una vez exitosa, finaliza la configuración restante y haz clic en Conectar al origen. Si la conexión falla, aparece un mensaje de error para ayudar a solucionar el problema.

Solución de problemas: identificador de snapshot no válido

Si Braze devuelve un error Invalid snapshot identifier durante Probar conexión o la configuración de sincronización, Redshift no puede resolver la referencia de snapshot utilizada cuando se consulta tu objeto de origen.

En Redshift, un snapshot es una copia de seguridad en un punto en el tiempo de un clúster. Cada snapshot tiene un identificador único utilizado por Redshift para hacer referencia a ese estado de respaldo. Para más información, consulta Snapshots y copias de seguridad de Amazon Redshift.

Este error puede ocurrir cuando los metadatos cambian mientras Braze valida el objeto de origen, como durante operaciones de copia de snapshot, restauración o relacionadas con la replicación. Para más información, consulta copiar snapshots a otra región de AWS y restaurar un clúster desde un snapshot.

Para solucionar el problema:

Verifica la configuración del origen en Braze, incluyendo el endpoint del clúster, base de datos, esquema y nombre del objeto.
Ejecuta la misma consulta directamente en Redshift para confirmar que la tabla o vista es legible y estable.
Reintenta después de que finalice la actividad activa de snapshot, restauración, redimensionamiento o replicación.
Si el problema persiste, consulta una vista materializada en lugar de una tabla base que cambia con frecuencia.

Una vista materializada almacena resultados de consultas precalculados que puedes actualizar de forma programada, lo que puede hacer que las lecturas sean más estables para las sincronizaciones CDI. Para más información, consulta vistas materializadas en Amazon Redshift.

Ejemplo:

CREATE MATERIALIZED VIEW ingestion.users_attributes_mv AS
SELECT updated_at, external_id, alias_label, alias_name, braze_id, email, phone, payload
FROM ingestion.users_attributes_sync;

REFRESH MATERIALIZED VIEW ingestion.users_attributes_mv;

Después de crear la vista materializada, usa el nombre de la vista materializada como el objeto de origen en tu sincronización CDI de Braze en lugar de la tabla base.

En el panel de Braze, ve a Configuración de datos > Ingesta de datos en la nube > Orígenes, selecciona Añadir origen de datos y luego selecciona Google BigQuery.

Paso 2.1: Añadir la información de conexión de BigQuery y la tabla de origen

Elige un nombre para tu origen. Luego, sube la clave JSON y proporciona un nombre para la cuenta de servicio. A continuación, ingresa los campos de configuración restantes.

Paso 2.2: Probar la conexión y conectar al origen

En el panel de Braze, ve a Configuración de datos > Ingesta de datos en la nube > Orígenes, selecciona Añadir origen de datos y luego selecciona Databricks.

Paso 2.1: Añadir la información de conexión de Databricks y la tabla de origen

Ingresa un nombre para tu origen, y luego ingresa tus credenciales y configuración de Databricks:

Para Nombre de credencial, ingresa una etiqueta que te ayude a identificar estas credenciales en Braze.
Para Método de autenticación, selecciona OAuth M2M o Token de acceso personal para coincidir con las credenciales que creaste en el paso 1.2.
Para OAuth M2M, ingresa el ID de cliente y el Secreto de cliente de tu principal de servicio. Para un token de acceso personal, ingresa el Token de acceso.

Luego, continúa al siguiente paso.

Paso 2.2: Probar la conexión y conectar al origen

Nota

Debes probar exitosamente un origen antes de que pueda ser creado. Si cierras la página de creación, tu origen no se guarda.

En el panel de Braze, ve a Configuración de datos > Ingesta de datos en la nube > Orígenes, selecciona Añadir origen de datos y luego selecciona Microsoft Fabric.

Paso 2.1: Configurar una sincronización de ingesta de datos en la nube

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

Nombre de credenciales es una etiqueta para estas credenciales en Braze, puedes establecer un valor descriptivo aquí
Consulta los pasos de la sección 1 para obtener detalles sobre cómo recuperar el ID de inquilino, ID de principal, secreto de cliente y cadena de conexión

Paso 2.2: Probar la conexión y conectar al origen

Nota

Debes probar exitosamente un origen antes de que pueda ser creado. Si cierras la página de creación, tu origen no se guarda.

Paso 3: Crear 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.

Paso 3.1: Configurar los detalles de sincronización y definir tus datos

Ingresa un nombre para tu sincronización. Luego, selecciona un origen activo y un tipo de datos de sincronización. A continuación, selecciona Visual o Tabla e ingresa tu tabla de origen, o selecciona SQL para escribir una consulta SQL personalizada. Finalmente, selecciona Vista previa y validar.

Después de que la validación sea exitosa, aparece una vista previa de los datos. Selecciona Siguiente: Notificaciones para continuar. Si la validación falla, aparece un mensaje de error para ayudar a solucionar el problema.

Nota

Debes validar exitosamente una sincronización antes de avanzar a los siguientes pasos. Si necesitas cerrar la página de creación de sincronización, selecciona Guardar como borrador para conservar tu trabajo en progreso.

Paso 3.2: Añadir preferencias de notificación

Ingresa la(s) dirección(es) de correo electrónico de contacto para 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 la tabla.

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

Dichos problemas pueden incluir los siguientes:

Problemas de conectividad
Falta de recursos
Problemas de permisos
El nivel del catálogo se quedó sin espacio (solo sincronizaciones de catálogo)

Paso 3.3: 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 cada 5 minutos o tan baja como una vez al mes. De forma predeterminada, el intervalo más corto que puedes configurar 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 cada 5 minutos, contacta a soporte de Braze o a tu administrador de éxito de cliente. Braze programa las sincronizaciones recurrentes en UTC.

Paso 3.1: Configurar los detalles de sincronización y definir tus datos

Nota

Paso 3.2: Añadir preferencias de notificación

Dichos problemas pueden incluir los siguientes:

Problemas de conectividad
Falta de recursos
Problemas de permisos
El nivel del catálogo se quedó sin espacio (solo sincronizaciones de catálogo)

Paso 3.3: 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.

Paso 3.1: Configurar los detalles de sincronización y definir tus datos

Nota

Paso 3.2: Añadir preferencias de notificación

Problemas de conectividad
Falta de recursos
Problemas de permisos
El nivel del catálogo se quedó sin espacio (solo sincronizaciones de catálogo)

Paso 3.3: 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.

Paso 3.1: Configurar los detalles de sincronización y definir tus datos

Nota

Paso 3.2: Añadir preferencias de notificación

Dichos problemas pueden incluir los siguientes:

Problemas de conectividad
Falta de recursos
Problemas de permisos
El nivel del catálogo se quedó sin espacio (solo sincronizaciones de catálogo)

Paso 3.3: 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.

Paso 3.1: Configurar los detalles de sincronización y definir tus datos

Nota

Paso 3.2: Añadir preferencias de notificación

Dichos problemas pueden incluir los siguientes:

Problemas de conectividad
Falta de recursos
Problemas de permisos
El nivel del catálogo se quedó sin espacio (solo sincronizaciones de catálogo)

Paso 3.3: 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.

Nota

Debes validar exitosamente una integración antes de que pueda pasar del estado Borrador a Activo. Si cierras la página de creación, tu integración se guarda, y puedes volver a la página de detalles para hacer cambios y validar.

Configurar integraciones o usuarios adicionales (opcional)

Puedes configurar múltiples integraciones con Braze. Al crear sincronizaciones 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 necesitas añadir de nuevo la clave pública.

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

Si reutilizas el mismo usuario en distintas integraciones, no puedes eliminar el usuario en el panel de Braze hasta que se haya eliminado de todas las sincronizaciones activas.

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

Si reutilizas el mismo usuario en distintas integraciones, no puedes eliminar el usuario en el panel de Braze hasta que se haya eliminado de todas las sincronizaciones activas.

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

Si reutilizas el mismo usuario en distintas integraciones, no puedes eliminar el usuario en el panel de Braze hasta que se haya eliminado de todas las sincronizaciones activas.

Puedes configurar múltiples 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 distintas integraciones, no puedes eliminar el usuario en el panel de Braze hasta que se haya eliminado de todas las sincronizaciones activas.

Ejecutar la sincronización

Cuando se activa, la sincronización se ejecuta según la programación configurada durante la configuración. Si deseas ejecutar la sincronización fuera de su programación o para obtener los datos más recientes, selecciona Sync Now. Esta ejecución no afecta a las futuras sincronizaciones programadas de forma regular. Para iniciar una sincronización de forma automática cuando se actualicen tus datos, llama al endpoint Desencadenar una sincronización desde tu pipeline.

New Stuff!