Ir al contenido

Ingesta de datos en la nube para Snowflake

En esta página encontrarás todo lo que necesitas para sincronizar datos de Snowflake con Braze mediante la ingesta de datos en la nube (CDI): los recursos que debes crear en Snowflake, 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 Snowflake.

Resumen de la configuración

  1. En tu instancia de Snowflake, configura las tablas o vistas que quieras sincronizar con Braze.
  2. Configura un rol y un almacén de datos para Braze.
  3. Configura un usuario de Snowflake para Braze con uno de los métodos de autenticación compatibles.
  4. Crea un nuevo origen de Snowflake en el panel de Braze y completa la autenticación en Snowflake.
  5. Crea una sincronización en el panel de Braze, valida la integración e inicia la sincronización.

Paso 1: 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. 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 ver una comparación de las opciones, consulta Elegir una opción de definición de datos.

Puedes ponerle a la base de datos, al esquema y a la tabla el nombre que quieras, pero los nombres de las columnas deben coincidir con las definiciones de las siguientes pestañas. También puedes usar una vista o una vista materializada en lugar de una tabla.

Selecciona la pestaña del tipo de datos que quieras 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 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
);
  • 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.

En las sincronizaciones de atributos, PAYLOAD sigue el formato del objeto de atributos de usuario. Puedes incluir atributos personalizados anidados, matrices de objetos y estados de grupos de suscripción. Para ver ejemplos de cargas útiles, 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 luego rellena PAYLOAD con un objeto de eventos.

Para sincronizar eventos, se requiere un nombre de evento. Formatea el 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 luego rellena PAYLOAD con un objeto de compras.

Para sincronizar eventos de compra, se requieren product_id, currency y price. Formatea el 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 DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --ID of the catalog item to be created or updated
     ID VARCHAR(16777216) NOT NULL,
     --Catalog fields and values that should be added or updated
     PAYLOAD VARCHAR(16777216) NOT NULL,
     --The catalog item associated with this ID should be deleted
     DELETED BOOLEAN
);

Concede al rol de Braze acceso a esta tabla junto con tus otras tablas de origen:

GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

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_1) con product_id y tres atributos adicionales, podrías sincronizar la siguiente vista:

CREATE VIEW BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC AS
SELECT
    CURRENT_TIMESTAMP as UPDATED_AT,
    product_id as id,
    TO_JSON(
        OBJECT_CONSTRUCT (
            'attribute_1',
            attribute_1,
            'attribute_2',
            attribute_2,
            'attribute_3',
            attribute_3)
    )as PAYLOAD FROM "product_catalog_1";

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 REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC (
    UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
    OBJECT_ID VARCHAR(16777216) NOT NULL,
    PAYLOAD VARCHAR(16777216) NOT NULL,
    --the data object record associated with this OBJECT_ID should be deleted
    DELETED BOOLEAN
);
Nombre del campo Tipo Modo
UPDATED_AT TIMESTAMP_NTZ REQUIRED
OBJECT_ID VARCHAR REQUIRED
PAYLOAD VARCHAR REQUIRED
DELETED BOOLEAN 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}

Concede al rol de Braze acceso a esta tabla:

GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

En el paso Definición de datos, selecciona el tipo de datos Objetos de datos y luego 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 REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_USERS_SYNC (
    UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
    OBJECT_ID VARCHAR(16777216) NOT NULL,
    --at least one of external_id, alias_name and alias_label, email, or phone is required
    EXTERNAL_ID VARCHAR(16777216),
    --if using user alias, both alias_name and alias_label are required
    ALIAS_NAME VARCHAR(16777216),
    ALIAS_LABEL VARCHAR(16777216),
    EMAIL VARCHAR(16777216),
    PHONE VARCHAR(16777216),
    PAYLOAD VARCHAR(16777216),
    DELETED BOOLEAN
);
Nombre del campo Tipo Modo
UPDATED_AT TIMESTAMP_NTZ 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 BOOLEAN 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 los campos definidos 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 luego elige un Nombre de la 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 REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_SUBACCOUNTS_SYNC (
    UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
    OBJECT_ID VARCHAR(16777216) NOT NULL,
    RELATED_OBJECT_ID VARCHAR(16777216) NOT NULL,
    PAYLOAD VARCHAR(16777216),
    DELETED BOOLEAN
);
Nombre del campo Tipo Modo
UPDATED_AT TIMESTAMP_NTZ REQUIRED
OBJECT_ID VARCHAR REQUIRED
RELATED_OBJECT_ID VARCHAR REQUIRED
PAYLOAD VARCHAR NULLABLE
DELETED BOOLEAN 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 los campos definidos 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 luego elige un Nombre de la 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 DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id or alias_name and alias_label 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),
     PROPERTIES VARCHAR(16777216)
);

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.

Concede al rol de Braze acceso a esta tabla:

GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

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 REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_DELETES (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, 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)
);

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 la ingesta de datos en la nube.

Paso 2: Configura el rol y el almacén

Paso 2.1: Configura 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 2.2: Configura el almacén y da acceso al rol de Braze

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

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

Según la configuración de tu cuenta de Snowflake, es posible que tengas que permitir las siguientes direcciones IP en tu política de red de Snowflake. Para obtener más información sobre cómo habilitarlo, consulta la documentación de Snowflake sobre cómo 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 3: Configura la autenticación

Braze se conecta a Snowflake como un usuario de Snowflake que tiene el rol del paso 2. Configura el usuario con uno de los siguientes métodos de autenticación:

Método Cómo se autentica Braze Qué introduces en Braze
Key pair authentication Braze generates an RSA key pair and connects as a Snowflake user that has the public key assigned. Username and Role

Key pair authentication

Con la autenticación por par de claves, Braze genera un par de claves RSA cuando guardas tus credenciales en el panel de Braze. Después, asignas la clave pública a un usuario de Snowflake con el que Braze se conecta.

Configurar el usuario

Crea un usuario para Braze y concédele el rol que creaste:

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Añadir la clave pública al usuario

Completa este paso después de introducir tus credenciales en el panel de Braze y seleccionar Guardar credenciales. Braze genera el par de claves y muestra la clave pública. Añade la clave pública al usuario que creaste para Braze:

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

Para asignar la clave necesitas acceso SECURITYADMIN o superior en Snowflake. Para más información, consulta la documentación de Snowflake.

Para rotar las claves, ve a Gestión del acceso a datos en Ingesta de datos en la nube y selecciona Generar nueva clave para la cuenta. Después, asigna la nueva clave pública al usuario. Si reutilizas el mismo usuario y rol en varias integraciones, no necesitas volver a añadir la clave pública.

Paso 4: Crea una nueva fuente 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 Snowflake.

Paso 4.1: Añade la información de conexión de Snowflake

Elige un nombre para tu fuente e introduce tus credenciales y la configuración de Snowflake. Después, pasa al siguiente paso. Selecciona el método de autenticación que configuraste en el Paso 3 e introduce sus credenciales:

Antes de continuar, comprueba el valor que introduces en Localizador de cuenta de Snowflake.

En el campo Localizador de cuenta de Snowflake, introduce tu identificador de cuenta de Snowflake. Introduce 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:

  1. En Snowsight, selecciona el menú de tu cuenta.
  2. Selecciona View account details.
  3. Copia el valor de Account identifier.
  4. Si lo copias de una URL de Snowflake, usa solo el valor que aparece antes de .snowflakecomputing.com.

Paso 4.2: Completa la autenticación en Snowflake

Después de introducir tus credenciales y la configuración, selecciona Guardar credenciales. Para la autenticación con par de claves, Braze genera un par de claves RSA y muestra la clave pública. Vuelve a Snowflake y añade la clave pública al usuario que creaste para Braze.

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

Configurar los detalles de la sincronización y definir tus datos

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

Cuando la validación se realice correctamente, aparecerá una vista previa de los datos. Selecciona Siguiente: Notificaciones para continuar. Si la validación falla, aparecerá un mensaje de error para ayudarte 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.

Ejecutar la sincronización

Una vez activada, tu sincronización se ejecuta según la programación que configuraste durante la instalació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 con regularidad. Para iniciar una sincronización automáticamente cuando se actualicen tus datos, llama al endpoint Desencadenar una sincronización desde tu pipeline.

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 cuenta de Snowflake.

Si reutilizas el mismo usuario y rol en varias integraciones, no necesitas volver a añadir la clave pública.

Usar Snowflake como fuente conectada

Una fuente conectada es una alternativa sin copia a la sincronización de datos con Braze. Braze consulta directamente tu instancia de Snowflake para crear Segments CDI, sin copiar los datos subyacentes. Para conocer los conceptos, las limitaciones y las implicaciones de costes, consulta Fuentes conectadas.

Paso 1: Crea un rol y concede permisos

Crea un rol para que lo use tu fuente conectada. Este rol se usa para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar las tablas de origen al crear nuevos Segments. Después de crear la fuente conectada, Braze detecta los nombres y la descripción 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. Todas las tablas a las que tenga acceso el rol de Braze estarán disponibles para consultarlas 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 Segment en Braze. Braze crea una tabla temporal por cada Segment, y la tabla solo persiste mientras Braze actualiza el Segment.

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;

La configuración del almacén coincide con el Paso 2.2, y la configuración de la política de red coincide con el Paso 2.3. Configura el usuario con el que se conecta Braze usando uno de los métodos del Paso 3: Configurar la autenticación.

Paso 2: Crea la fuente conectada en Braze

Ve a Configuración de datos > Ingesta de datos en la nube > Fuentes conectadas, selecciona Añadir fuente de datos y, a continuación, selecciona Snowflake.

En Configurar fuente, introduce lo siguiente:

  • Credenciales: Localizador de cuenta y los campos de tu método de autenticación. Introduce Username and Role.
  • Configuración: Almacén, Base de datos y Esquema

Para la autenticación con par de claves, si vas a crear nuevas credenciales de Snowflake, selecciona Guardar credenciales y generar clave RSA antes de probar la conexión.

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

Configura un tiempo de ejecución máximo para esta fuente. 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 costes generados en tu cuenta de Snowflake. Esta configuración se aplica a las consultas que se ejecutan a través de esta fuente, incluidas las sincronizaciones y las extensiones de segmento CDI que la usan.

Para la autenticación con par de claves, anota la clave pública RSA en el paso Probar conexión. La necesitarás para completar la integración en Snowflake.

Paso 3: Finaliza la configuración de Snowflake

Para la autenticación con par de claves, añade la clave pública que anotaste en el último paso a tu usuario en Snowflake, como se describe en Añadir la clave pública al usuario. Esto permite que Braze se conecte a Snowflake.

Cuando termines la autenticación en Snowflake, selecciona Probar conexión en Braze y, a continuación, selecciona Listo. Tu fuente conectada ya está creada y lista para usarse en las extensiones de segmento CDI.

Puedes configurar varias fuentes conectadas con Braze, pero cada fuente debe configurarse para 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 varias integraciones, no necesitas volver a añadir la clave pública.

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 Snowflake para formatear las columnas de origen como campos de CDI.

CREATE TABLE "EXAMPLE_USER_DATA"
    (attribute_1 string,
     attribute_2 string,
     attribute_3 number,
     my_user_id string);

SELECT
    CURRENT_TIMESTAMP as UPDATED_AT,
    my_user_id as EXTERNAL_ID,
    TO_JSON(
        OBJECT_CONSTRUCT (
            'attribute_1',
            attribute_1,
            'attribute_2',
            attribute_2,
            'yet_another_attribute',
            attribute_3)
    )as PAYLOAD FROM "EXAMPLE_USER_DATA";

Para eliminar por completo un atributo en lugar de establecerlo en null, usa TO_JSON(OBJECT_CONSTRUCT_KEEP_NULL(...)).

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

Solución de problemas

La prueba de conexión se ejecuta con lentitud

La prueba de conexión se ejecuta en tu almacén de datos, así que aumentar la capacidad del almacén puede mejorar su velocidad. Usar una instancia SQL sin servidor minimiza el tiempo de calentamiento y mejora el rendimiento de las consultas, aunque puede suponer costes de integración ligeramente más altos.

Error al conectar con la instancia de Snowflake: Incoming request with IP is not allowed to access Snowflake

Prueba a añadir las IP oficiales de Braze a tu lista de IP permitidas. Para más información, consulta Permitir las IP de Braze en la política de red de Snowflake.

Error al ejecutar SQL debido a la configuración del cliente: 002003 (42S02): SQL compilation error: does not exist or not authorized

Si la tabla no existe, créala. Si la tabla existe, verifica que el usuario y el rol tengan permisos de lectura sobre la tabla.

No se pudo usar el esquema

Si recibes este error, concede acceso a ese esquema al usuario o rol especificado.

No se pudo usar el rol

Si recibes este error, permite que ese usuario use el rol especificado.

Acceso de usuario desactivado

Si recibes este error, permite que ese usuario acceda a tu cuenta de Snowflake.

Error al conectar con la instancia de Snowflake con la clave actual y la antigua

Si recibes este error, asegúrate de que el usuario esté usando la clave pública actual que se muestra en tu panel de Braze. Para rotar las claves, consulta Añadir la clave pública al usuario.

Dónde ejecutar las comprobaciones SQL

Ejecuta las comprobaciones de validación directamente en el editor SQL de Snowflake, sobre la misma tabla o vista que usa tu integración de CDI. Ve a Projects > Worksheets. Para más información, consulta Snowflake Worksheets.

New Stuff!