Ingesta de datos en la nube para Amazon Redshift
Esta página cubre todo lo que necesitas para sincronizar datos de Amazon Redshift con Braze mediante la ingesta de datos en la nube (CDI): los recursos que debes crear en Redshift, 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 Redshift.
Resumen de la configuración
- En tu instancia de Redshift, configura las tablas o vistas que quieras sincronizar con Braze.
- Elige uno de los métodos de autenticación compatibles para Braze y concede al usuario de base de datos de Braze acceso a tus tablas.
- Asegúrate de que Braze tenga acceso permitido a las tablas de Redshift que quieras sincronizar. Braze se conecta a Redshift a través de Internet.
- Crea un nuevo origen y una nueva sincronización en el panel de Braze.
- Valida la integración e inicia la sincronización.

Las filas procesadas en cada sincronización dependen del rendimiento de tu almacén de datos, la latencia de la 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 número de filas de las ejecuciones recientes.
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 comparar las opciones, consulta Elegir una opción de definición de datos.
Puedes nombrar la base de datos, el esquema y la tabla como 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.
Opcionalmente, configura una nueva base de datos y un nuevo esquema para alojar tu tabla de origen:
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Si usas una columna PAYLOAD, tu tabla o vista de origen puede incluir columnas que no aparecen en las siguientes pestañas (por ejemplo, de auditoría o de hash). Braze solo lee las columnas descritas en estas pestañas; las demás columnas no se usan durante las sincronizaciones de la ingesta de datos en la nube.
Selecciona la pestaña del tipo de datos que quieres sincronizar.
Los atributos de usuario, los eventos personalizados y los eventos de compra usan la misma estructura de tabla de origen. Solo cambia el contenido de PAYLOAD.
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)
)
UPDATED_AT: la hora en que esta fila se actualizó o se agregó a la tabla. Braze sincroniza las filas en las queUPDATED_ATes 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 dealias_nameyalias_label,braze_id,emailophone). 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 deexternal_idque se usa en Braze.ALIAS_NAMEyALIAS_LABEL: estas dos columnas crean un objeto de alias de usuario.alias_namedebe ser un identificador único, yalias_labelespecifica el tipo de alias. Los usuarios pueden tener varios alias con diferentes etiquetas, pero solo unalias_namepor cadaalias_label.BRAZE_ID: el identificador de usuario de Braze. Lo genera el SDK de Braze, y no se pueden crear nuevos usuarios con un ID de Braze mediante la ingesta de datos en la nube. Para crear nuevos usuarios, especifica un ID de usuario externo o un alias de usuario.EMAIL: la dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se prioriza para las actualizaciones el perfil actualizado más recientemente. Si incluyes tanto el correo electrónico como el teléfono, el correo electrónico se usa como identificador principal.PHONE: el número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se prioriza para las actualizaciones el perfil actualizado más recientemente.
PAYLOAD: es una cadena JSON con los campos que quieres sincronizar con el usuario en Braze.
Para las sincronizaciones de atributos, PAYLOAD sigue el formato del objeto de atributos de usuario. Puedes incluir atributos personalizados anidados, matrices de objetos y estados del grupo de suscripción. Para ver ejemplos de carga útil, consulta Configuración de tablas.
Los eventos personalizados usan la misma tabla de origen que los atributos de usuario. Crea la tabla que se muestra en la pestaña Atributos de usuario y, a continuación, rellena PAYLOAD con un objeto de eventos.
Para sincronizar eventos, es obligatorio un nombre de evento. Da formato al campo time como una cadena ISO 8601 o con el 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 de usuario. Crea la tabla que se muestra en la pestaña Atributos de usuario y, a continuación, rellena PAYLOAD con un objeto de compras.
Para sincronizar eventos de compra, son obligatorios product_id, currency y price. Da formato al campo opcional time como una cadena ISO 8601 o con el 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 TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC (
updated_at timestamptz default sysdate not null,
--ID of the catalog item to be created or updated
id varchar not null,
--Catalog fields and values that should be added or updated
payload varchar(max),
--The catalog item associated with this ID should be deleted
deleted boolean
)
Concede al usuario de Braze acceso a esta tabla junto con tus otras tablas de origen:
GRANT SELECT ON TABLE CATALOGS_SYNC TO braze_user;
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 lo siguiente:
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC AS
SELECT
CURRENT_TIMESTAMP as UPDATED_AT,
Product_id as id,
JSON_SERIALIZE(
OBJECT (
'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 TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC (
updated_at timestamptz default sysdate not null,
object_id varchar not null,
payload varchar(max) not null,
--the data object record associated with this object_id should be deleted
deleted boolean
)
| Nombre del campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | 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 queUPDATED_ATes 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 deobject_idque 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 estrue, Braze elimina el registro en lugar de actualizarlo. Deja este valor nulo o enfalsepara 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 usuario de Braze acceso a esta tabla:
GRANT SELECT ON TABLE ACCOUNTS_SYNC TO braze_user;
En el paso Definición de datos, selecciona el tipo de datos Objetos de datos y, a continuación, 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 a las cuentas a las que pertenecen. Crea la relación en Braze antes de sincronizarla.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_USERS_SYNC (
updated_at timestamptz default sysdate not null,
object_id varchar not null,
--at least one of external_id, alias_name and alias_label, email, or phone is required
external_id varchar,
--if using user alias, both alias_name and alias_label are required
alias_name varchar,
alias_label varchar,
email varchar,
phone varchar,
payload varchar(max),
deleted boolean
)
| Nombre del campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
timestamptz | 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(max) | 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 cualquier campo definido en la propia relación.

BRAZE_ID no se admite en las sincronizaciones de relaciones de usuarios, a diferencia de las sincronizaciones de atributos de usuario. Usa uno de los identificadores indicados anteriormente.
UPDATED_AT: la hora en que se actualizó o se añadió esta fila a la tabla. Braze sincroniza las filas en las queUPDATED_ATes 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 deobject_idque 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 estrue, Braze elimina el registro en lugar de actualizarlo. Deja este valor nulo o enfalsepara 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, a continuación, elige un Nombre de relación, como User (Account-User).
Usa esta sincronización para conectar registros de objetos de datos entre sí, por ejemplo, para vincular cuentas con sus cuentas principales. Crea la relación en Braze antes de sincronizarla.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_SUBACCOUNTS_SYNC (
updated_at timestamptz default sysdate not null,
object_id varchar not null,
related_object_id varchar not null,
payload varchar(max),
deleted boolean
)
| Nombre del campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
RELATED_OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | 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 cualquier campo definido en la propia relación.
UPDATED_AT: la hora en que se actualizó o se añadió esta fila a la tabla. Braze sincroniza las filas en las queUPDATED_ATes 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 deobject_idque 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 estrue, Braze elimina el registro en lugar de actualizarlo. Deja este valor nulo o enfalsepara 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, a continuación, elige un Nombre de relación, como Subaccount (Account-Account).
Los desencadenantes de Canvas impulsan la personalización sin copia. Para conocer la configuración del Canvas de destino y otras consideraciones, consulta Personalización sin copia.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
updated_at timestamptz default sysdate not null,
--at least one of external_id or alias_name and alias_label is required
external_id varchar not null,
--if using user alias, both alias_name and alias_label are required
alias_label varchar,
alias_name varchar,
properties varchar(max)
);
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.
PROPERTIESsustituye a la columnaPAYLOAD. 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 queUPDATED_ATes 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 bienALIAS_NAMEyALIAS_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 deexternal_idque se utiliza en Braze.ALIAS_NAMEyALIAS_LABEL: estas columnas crean un objeto de alias de usuario.alias_namedebe ser un identificador único yalias_labelespecifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero solo unalias_namepor cadaalias_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.

No es necesario incluir propiedades en todas las filas ni para todos los usuarios. Sin embargo, los valores de las propiedades deben ser una cadena JSON válida. Introduce una cadena {} vacía si la fila no tiene propiedades.
Concede al usuario de Braze acceso a esta tabla:
GRANT SELECT ON TABLE CANVAS_TRIGGERS_SYNC TO braze_user;
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 queUPDATED_ATes 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 dealias_nameyalias_label, obraze_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 deexternal_idutilizado en Braze.ALIAS_NAMEyALIAS_LABEL- Estas dos columnas crean un objeto de alias de usuario.alias_namedebe ser un identificador único, yalias_labelespecifica el tipo de alias. Los usuarios pueden tener varios alias con diferentes etiquetas, pero solo unalias_namepor cadaalias_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.

No incluyas una columna PAYLOAD en tu tabla para la eliminación de usuarios. Para evitar la eliminación accidental y permanente de usuarios, la sincronización falla si se proporciona una columna de carga útil en la tabla de origen. Puedes incluir cualquier otra columna, pero Braze las ignora.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_DELETES (
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
);
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.

La eliminación de perfiles de usuario no se puede deshacer. La acción de eliminar borra usuarios de forma permanente, lo que puede provocar discrepancias en tus datos. Para más detalles, consulta Efectos de eliminar perfiles de usuario.
Paso 2: Configura la autenticación
Braze se conecta a Redshift como usuario de base de datos. Elige uno de los siguientes métodos de autenticación para configurar ese usuario:
| Método | Cómo se autentica Braze | Qué introduces en Braze |
|---|---|---|
| IAM role | Braze assumes an AWS Identity and Access Management (IAM) role in your account, using an external ID that Braze generates for your workspace, and then requests temporary database credentials. | Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier |
| Username and password | Braze connects as a Redshift database user with a password. | Username and Password |
IAM role
Braze asume un rol de AWS Identity and Access Management (IAM) en tu cuenta de AWS y solicita credenciales temporales de base de datos. Braze no almacena ninguna contraseña de base de datos. Braze asume el rol desde la misma cuenta de AWS que utiliza para los orígenes de Amazon S3.
Braze genera un ID externo para tu espacio de trabajo. Tu rol utiliza este ID para confirmar que una solicitud para asumir el rol procede de tu espacio de trabajo de Braze.
Tus credenciales actuales de nombre de usuario y contraseña siguen funcionando, así que no necesitas migrarlas.
Requisitos previos
Necesitas permiso para crear roles y políticas de IAM en tu cuenta de AWS. También necesitas permiso para ejecutar instrucciones CREATE USER y GRANT en tu base de datos de Redshift.

La política de confianza de tu rol debe exigir el ID externo exacto del formulario de credenciales de Braze. Cuando pruebas o guardas una credencial, Braze intenta asumir tu rol con un ID externo diferente. Si AWS permite ese intento, la prueba de conexión falla. Esto ocurre cuando el rol no exige un ID externo o cuando acepta un patrón como braze-cdi-*.
Copia el ID de cuenta de Braze y el ID externo
- 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 Amazon Redshift.
- Como método de autenticación, selecciona Rol de IAM.
- En el paso Configuración de AWS, copia el ID de cuenta de Braze y el ID externo. Mantén el formulario abierto, porque volverás a él en Introduce los valores en Braze.
Crea el rol de IAM
- En la consola de AWS, ve a IAM > Roles y, a continuación, selecciona Crear rol.
- Selecciona Cuenta de AWS como tipo de entidad de confianza y, a continuación, selecciona Otra cuenta de AWS.
- Pega el ID de cuenta de Braze. Selecciona Requerir ID externo y, a continuación, pega el ID externo.
- Omite el paso de permisos. Introduce un nombre de rol y, a continuación, selecciona Crear rol. Añadirás la política de permisos en Añade la política de permisos.
- Copia el nombre de recurso de Amazon (ARN) del rol. Lo introducirás en Braze en Introduce los valores en Braze.
La política de confianza del rol tiene un aspecto similar al del siguiente ejemplo. Sustituye BRAZE_ACCOUNT_ID y EXTERNAL_ID por los valores del formulario de credenciales.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::BRAZE_ACCOUNT_ID:root"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "EXTERNAL_ID"
}
}
}
]
}
Añade la política de permisos
Añade una política de permisos insertada al rol. En la pestaña Permisos del rol, selecciona Agregar permisos > Crear política insertada y, a continuación, pega el JSON correspondiente a tu tipo de clúster de las siguientes pestañas.
Para Redshift Serverless, la política debe permitir redshift-serverless:GetCredentials en tu grupo de trabajo. En el valor Resource, utiliza el ID del grupo de trabajo, que es distinto del nombre del grupo de trabajo. Para encontrar el ID, abre tu grupo de trabajo en la consola de Redshift y copia el ID del ARN del grupo de trabajo.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": "arn:aws:redshift-serverless:REGION:AWS_ACCOUNT_ID:workgroup/WORKGROUP_ID"
}
]
}
Sustituye REGION, AWS_ACCOUNT_ID y WORKGROUP_ID por los valores de tu grupo de trabajo.
Para un clúster aprovisionado, la política debe permitir redshift:GetClusterCredentialsWithIAM en la base de datos desde la que sincronizas.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift:GetClusterCredentialsWithIAM",
"Resource": "arn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME"
}
]
}
Sustituye REGION, AWS_ACCOUNT_ID, CLUSTER_IDENTIFIER y DATABASE_NAME por los valores de tu clúster.
Crea el usuario de base de datos y concede acceso
Braze inicia sesión en Redshift como un usuario de base de datos llamado IAMR:ROLE_NAME, donde ROLE_NAME es el nombre del rol de IAM que creaste. Este usuario es distinto de braze_user, por lo que los permisos que concediste a otros usuarios de base de datos no se le aplican.
Antes de probar la conexión en Braze, ejecuta la siguiente instrucción en tu base de datos de Redshift para crear el usuario. Puedes ejecutar la instrucción con seguridad antes de que Braze se conecte por primera vez:
CREATE USER "IAMR:ROLE_NAME" PASSWORD DISABLE;
A continuación, concede a este usuario acceso a tu tabla de origen. Utiliza las mismas instrucciones GRANT que en el Paso 3: Concede permisos al usuario y sustituye braze_user por "IAMR:ROLE_NAME". Mantén las comillas dobles, porque el nombre de usuario contiene dos puntos.
Si también utilizas Redshift como origen conectado, concede a este usuario los mismos permisos que se indican en esa sección.
Introduce los valores en Braze
Vuelve al formulario de credenciales de Braze. En el paso Configuración de Braze, introduce los siguientes valores:
| Campo de Braze | Qué introducir |
|---|---|
| Tipo de clúster | Serverless (el predeterminado) o Provisioned. |
| ARN del rol | El ARN del rol que creaste, con el formato arn:aws:iam::123456789012:role/ROLE_NAME. |
| Región | La región de AWS en la que se ejecuta tu clúster o grupo de trabajo de Redshift, como us-east-1. Puede ser distinta de la región de tu instancia de Braze. |
| Nombre del grupo de trabajo o Identificador del clúster | Para Serverless, el nombre de tu grupo de trabajo. Para un clúster aprovisionado, el identificador de tu clúster. |
| Host | El endpoint de tu clúster o grupo de trabajo. Para Serverless, Braze rellena este campo a partir de tu ARN del rol, Región y Nombre del grupo de trabajo, y puedes editarlo. Para un clúster aprovisionado, introduce el endpoint. |
| Puerto | El puerto de tu clúster o grupo de trabajo. El valor predeterminado es 5439. Introduce un valor entre 1024 y 65535. |

No puedes cambiar estos detalles de conexión después de guardar la credencial. Para cambiar cualquiera de ellos, crea una credencial nueva. Después, puedes trasladar tu origen a la nueva credencial.
La autenticación con rol de IAM funciona con o sin túnel SSH. Para configurar el túnel y la lista de IP permitidas, sigue el Paso 4: Permite el acceso a las IP de Braze, igual que con otros métodos. Después de guardar la credencial, puedes cambiarle el nombre. Si utilizas un túnel, también puedes rotar la clave del túnel.
Cómo prueba Braze la conexión
Cuando pruebas la conexión, y cada vez que Braze se conecta, Braze intenta primero asumir tu rol con un ID externo de prueba que no pertenece a ningún espacio de trabajo: braze-cdi-000000000000000000000000. Tu rol debe denegar este intento con un error AccessDenied. Si AWS lo permite, la prueba de conexión falla. Para obtener ayuda, consulta Tu rol de IAM no exige su ID externo.
AWS CloudTrail muestra estos intentos como llamadas AssumeRole con el nombre de sesión Braze-CDI-Redshift. El intento denegado es el comportamiento esperado y no da a Braze acceso a tus datos. No añadas una condición que rechace solo este ID externo, porque tu rol seguiría confiando en otros espacios de trabajo de Braze.
Retira el acceso de Braze
Para impedir que Braze acceda a tus datos, elimina el rol o quita la instrucción de confianza para la cuenta de Braze de la política de confianza del rol. También puedes eliminar el usuario de base de datos IAMR:ROLE_NAME.
Configura con la AWS CLI
Como alternativa, utiliza la interfaz de línea de comandos de AWS (CLI) para crear el rol y adjuntar la política de permisos. Este ejemplo utiliza un grupo de trabajo Serverless. Para un clúster aprovisionado, sustituye el documento de política por la política de la pestaña Provisioned de Añade la política de permisos.
aws iam create-role --role-name braze-cdi \
--assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": {"AWS": "arn:aws:iam::BRAZE_ACCOUNT_ID:root"},
"Action": "sts:AssumeRole",
"Condition": {"StringEquals": {"sts:ExternalId": "EXTERNAL_ID"}}
}]
}'
aws iam put-role-policy --role-name braze-cdi \
--policy-name braze-cdi-redshift \
--policy-document '{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": "arn:aws:redshift-serverless:REGION:AWS_ACCOUNT_ID:workgroup/WORKGROUP_ID"
}]
}'
Sustituye los siguientes marcadores de posición:
BRAZE_ACCOUNT_IDyEXTERNAL_ID: los valores del formulario de credencialesREGION,AWS_ACCOUNT_IDyWORKGROUP_ID: los valores de tu grupo de trabajo
El comando create-role devuelve el ARN del rol en su salida. Para más información, consulta create-role en la referencia de comandos de la AWS CLI. Copia el ARN y, a continuación, continúa con Crea el usuario de base de datos y concede acceso.
Username and password
Braze se conecta a Redshift como un usuario de base de datos con contraseña. Crea un usuario para Braze:
CREATE USER braze_user PASSWORD '{password}';
Guarda el nombre de usuario y la contraseña en un lugar seguro hasta que tengas que introducirlos en el panel de Braze al crear la fuente.
Paso 3: Concede permisos al usuario
Concede al usuario de la base de datos con el que se conecta Braze acceso a tu tabla de origen. El siguiente ejemplo utiliza braze_user. Si utilizas la autenticación mediante rol de IAM, sustituye braze_user por "IAMR:ROLE_NAME". Para más detalles, consulta Crear el usuario de la base de datos y conceder acceso.
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 necesarios para este usuario. Si creas varias integraciones de CDI, quizá te convenga conceder permisos sobre un esquema o administrar los permisos mediante un grupo.
Paso 4: Permite 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 de endpoint de URL de Redshift es “example-cluster.ap-northeast-2.redshift.amazonaws.com”.
Algunas cosas importantes que debes saber:
- Es posible que también tengas que 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 que se usa para consultar tu clúster de Redshift (el predeterminado es 5439). Debes permitir explícitamente la conectividad TCP de Redshift en este puerto aunque las reglas de entrada estén configuradas como “permitir todo”.
- El endpoint del clúster de Redshift debe ser de acceso público para que Braze pueda conectarse a tu clúster.
- Si no quieres que tu clúster de Redshift sea de acceso público, puedes configurar una VPC y una instancia EC2 para usar un túnel SSH y acceder a los datos de Redshift. Para más información, consulta la publicación del AWS Knowledge Center.
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.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para la instancia US-08, estas son las direcciones IP correspondientes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para la instancia US-10, estas son las direcciones IP correspondientes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para la instancia AU-01, estas son las direcciones IP correspondientes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para la instancia ID-01, estas son las direcciones IP correspondientes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para la instancia JP-01, estas son las direcciones IP correspondientes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para la instancia KR-01, estas son las direcciones IP correspondientes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Paso 5: 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 fuente de datos y, a continuación, selecciona Amazon Redshift.
Paso 5.1: Añade la información de conexión de Redshift y la tabla de origen
Elige un nombre para tu fuente e introduce tus credenciales y la configuración de Redshift. Selecciona el método de autenticación que configuraste en el Paso 2 e introduce sus credenciales:
- IAM role: Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier
- Username and password: Username and Password
Si utilizas un túnel de red privada, activa el control deslizante e introduce la información del túnel. Después, continúa con el siguiente paso.

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 bases de datos.
Paso 5.2: Prueba la conexión y conéctate a la fuente
A continuación, selecciona Probar conexión. Cuando la prueba se complete correctamente, termina de configurar los ajustes restantes y haz clic en Conectar con la fuente. Si la conexión falla, aparecerá un mensaje de error para ayudarte a solucionar el problema.
Paso 6: Crea una nueva sincronización en el panel de Braze
Ve a Configuración de datos > Ingesta de datos en la nube > Sincronizaciones y selecciona Crear sincronización de datos.
Configura los detalles de la sincronización y define tus datos
Introduce un nombre para tu sincronización. A continuación, selecciona un origen activo y un tipo de datos de sincronización. Después, selecciona un modo de sincronización y define tus datos. Luego, selecciona Vista previa y validar.
Cuando la validación se complete correctamente, aparecerá una vista previa de los datos. Selecciona Siguiente: Notificaciones para continuar. Si la validación falla, aparecerá un mensaje de error para ayudarte a solucionar el problema.

Debes validar correctamente una sincronización antes de avanzar a los siguientes pasos. Si necesitas cerrar la página de creación de la sincronización, selecciona Guardar como borrador para conservar tu trabajo en curso.
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.

Debes validar correctamente una integración antes de que pueda pasar del estado Borrador al estado 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 validarla.
Ejecuta la sincronización
Cuando está activada, tu sincronización se ejecuta según la programación configurada durante la configuración. Si quieres ejecutar la sincronización fuera de su programación o para obtener los datos más recientes, selecciona Sincronizar ahora. Esta ejecución no afecta a las futuras sincronizaciones programadas habitualmente. Para iniciar una sincronización automáticamente cuando se actualicen tus datos, llama al endpoint Desencadenar una sincronización desde tu canalización.
Configurar integraciones o usuarios adicionales (opcional)
Puedes configurar varias integraciones con Braze. Al crear sincronizaciones adicionales, puedes reutilizar credenciales existentes si te conectas a la misma cuenta de Redshift.
Si reutilizas el mismo usuario en varias integraciones, no podrás eliminarlo en el panel de Braze hasta que se haya quitado de todas las sincronizaciones activas.
Usar Redshift como fuente conectada
Una fuente conectada es una alternativa sin copia a la sincronización de datos en Braze. Braze consulta directamente tu instancia de Redshift para crear Segments de CDI, sin copiar los datos subyacentes. Para conocer los conceptos, las limitaciones y las implicaciones de costes, consulta Fuentes conectadas.
Paso 1: Crea el usuario y concede permisos
Elige uno de los métodos del Paso 2: Configurar la autenticación para Braze. Después, concede al usuario de la base de datos de Braze los siguientes permisos. El ejemplo usa braze_user. Si usas la autenticación con rol de IAM, sustituye braze_user por "IAMR:ROLE_NAME".
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT CREATE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;
Crea un usuario para que lo use tu fuente conectada. Este usuario se utiliza para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar las tablas de origen al crear nuevos Segments. Una vez creada la fuente conectada, Braze descubre los nombres y la descripción de todas las tablas disponibles para el usuario en el esquema de origen. Si creas varias integraciones de CDI, quizá te convenga conceder permisos a un esquema o gestionar los permisos mediante un grupo.
Puedes elegir 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. Asegúrate de conceder al usuario acceso a las tablas nuevas cuando se creen, o establece permisos predeterminados para el usuario.
El permiso create table es necesario para que Braze pueda crear una tabla con los resultados de la consulta de tu extensión de segmento CDI antes de actualizar el Segment en Braze. Braze crea una tabla temporal por cada Segment, que solo persiste mientras Braze actualiza el Segment.
La configuración del acceso a la red coincide con el Paso 4.
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 origen de datos y, a continuación, selecciona Amazon Redshift.
En Configurar fuente, introduce lo siguiente:
- Credenciales: URL del host de Redshift, Puerto y los campos de tu método de autenticación. Para IAM role, introduce Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier. Para Username and password, introduce Username and Password.
- Configuración: Base de datos y Esquema
Si es necesario, habilita Conectar con túnel SSH e introduce Host del túnel, Puerto del túnel y Nombre de usuario del túnel.
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 en tu cuenta de Redshift. 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 utilizan.
Paso 3: Finaliza la configuración de Redshift
Si tus credenciales tienen seleccionada la opción Conectar con túnel SSH, anota la clave pública RSA en el paso Probar conexión y añádela al usuario del túnel SSH.
Después de añadir la clave al usuario, selecciona Probar conexión en Braze y, a continuación, selecciona Hecho. 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 fuentes adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Redshift.
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 completar la sincronización con Braze. Usa esta consulta en Redshift para formatear las columnas de origen en 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,
JSON_SERIALIZE(
OBJECT (
'attribute_1',
attribute_1,
'attribute_2',
attribute_2,
'yet_another_attribute',
attribute_3)
) as PAYLOAD FROM "EXAMPLE_USER_DATA";
Para obtener más orientación sobre optimización, consulta Prácticas recomendadas para la ingesta de datos en la nube.
Solución de problemas
La prueba de conexión se ejecuta lentamente
La prueba de conexión se ejecuta en tu almacén de datos, por lo que aumentar la capacidad 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, pero puede suponer costos de integración ligeramente más altos.
Permiso denegado para la relación {table_name}
Si recibes este error:
- Concede el permiso
usagesobre el esquema a ese usuario. - Concede el permiso
selectsobre la tabla a ese usuario.
Tu rol de IAM no requiere su ID externo
Si usas la autenticación con rol de IAM, la prueba de conexión puede fallar con el siguiente error:
The IAM role on this credential does not require its external ID. Braze assumed the role with an external ID that belongs to no Braze workspace and AWS allowed it, so another Braze customer who learns the role ARN could read this data. In the role’s trust policy, add a StringEquals condition on sts:ExternalId with the external ID shown in the credential form to every statement that allows Braze’s AWS principal to assume the role. A pattern that also matches other Braze workspaces, such as braze-cdi-*, does not require it. Then test the connection again.
Este error significa que AWS permitió el ID externo de prueba descrito en Cómo prueba Braze la conexión. Para solucionarlo, actualiza la política de confianza de tu rol:
- En la consola de AWS, abre el rol y selecciona la pestaña Trust relationships.
- En cada instrucción que permita a la cuenta de Braze asumir el rol, añade una condición
StringEqualssobrests:ExternalIdque use exactamente el ID externo del formulario de credenciales. Elimina cualquier condición con patrón, comobraze-cdi-*. - En Braze, vuelve a probar la conexión.
Braze no pudo confirmar que tu rol requiera su ID externo
Si usas la autenticación con rol de IAM, la prueba de conexión puede fallar con el siguiente error:
Braze could not confirm that the IAM role on this credential requires its external ID. The check needs AWS to explicitly refuse an attempt to assume the role with a different external ID, and this attempt failed for another reason instead. Please try again; if it keeps happening, contact support.
Braze no pudo completar la comprobación, así que este error no significa que tu rol sea demasiado amplio. Vuelve a probar la conexión. Si el error continúa, ponte en contacto con el soporte de Braze.
No se puede asumir el rol de IAM
Si usas la autenticación con rol de IAM y la prueba de conexión falla con un error que empieza por “Unable to assume IAM role”, comprueba lo siguiente:
- La política de confianza del rol incluye como entidad principal de confianza el ID de cuenta de Braze que aparece en el formulario de credenciales.
- La política de confianza del rol requiere exactamente el ID externo del formulario de credenciales.
- El Role ARN que introdujiste en Braze coincide con el ARN del rol que creaste.
- Si tu instancia de Braze está en una región de AWS que no está habilitada de forma predeterminada, como Yakarta (ID-01), tu cuenta de AWS tiene esa región habilitada.
AWS devuelve el mismo error AccessDenied para todas estas causas, así que revisa cada una de ellas.
No se pueden obtener las credenciales de la base de datos de Redshift
Si usas la autenticación con rol de IAM y la prueba de conexión falla con un error que empieza por “Unable to get Redshift database credentials as IAM role”, comprueba lo siguiente:
- La política de permisos del rol permite
redshift-serverless:GetCredentialspara Serverless, oredshift:GetClusterCredentialsWithIAMpara un clúster aprovisionado. - En Serverless, el valor
Resourcede la política usa el ID del grupo de trabajo, que es distinto del nombre del grupo de trabajo. - En un clúster aprovisionado, el valor
Resourcede la política es el ARNdbnamede tu clúster y base de datos, con el formatoarn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME. - Los valores de Region, Workgroup name o Cluster identifier que introdujiste en Braze coinciden con tu clúster o grupo de trabajo.
Permiso denegado tras una prueba de conexión correcta
Si la prueba de conexión se realiza correctamente, pero una sincronización o validación devuelve un error de permiso denegado, probablemente concediste acceso a otro usuario, como braze_user. Con la autenticación con rol de IAM, Braze inicia sesión como "IAMR:ROLE_NAME". Concede los permisos de esquema y tabla a ese usuario. Para más información, consulta Crear el usuario de la base de datos y conceder acceso.
Error al crear la conexión
Si recibes este error, verifica que el endpoint y el puerto de Redshift sean correctos.
Error al crear el túnel SSH
Si recibes este error:
- Verifica que la clave pública de tu panel de Braze esté en el host EC2 utilizado para el túnel SSH.
- Verifica que tu nombre de usuario sea correcto.
- Verifica que el túnel SSH sea correcto.
Identificador de instantánea no válido
Si Braze devuelve un error Invalid snapshot identifier durante la Prueba de conexión o la configuración de la sincronización, Redshift no puede resolver la referencia de instantánea que se usa al consultar tu objeto de origen.
En Redshift, una instantánea es una copia de seguridad de un clúster en un momento determinado. Cada instantánea tiene un identificador único que Redshift usa para hacer referencia a ese estado de la copia de seguridad. Para más información, consulta Instantáneas y copias de seguridad de Amazon Redshift.
Este error puede producirse cuando los metadatos cambian mientras Braze valida el objeto de origen, por ejemplo, durante operaciones de copia, restauración o replicación de instantáneas. Para más información, consulta copiar instantáneas en otra región de AWS y restaurar un clúster a partir de una instantánea.
Para solucionar el problema:
- Verifica la configuración del origen en Braze, incluidos el endpoint del clúster, la base de datos, el esquema y el nombre del objeto.
- Ejecuta la misma consulta directamente en Redshift para confirmar que la tabla o vista se puede leer y es estable.
- Vuelve a intentarlo cuando finalice la actividad de instantánea, restauración, cambio de tamaño o replicación en curso.
- Si el problema persiste, consulta una vista materializada en lugar de una tabla base que cambie con frecuencia.
Una vista materializada almacena resultados de consultas precalculados que puedes actualizar según una programación, lo que puede hacer que las lecturas sean más estables para las sincronizaciones de 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 su nombre como objeto de origen en tu sincronización de CDI de Braze en lugar de la tabla base.
Dónde ejecutar las comprobaciones SQL
Ejecuta las comprobaciones de validación directamente en el editor SQL de Redshift, sobre la misma tabla o vista que usa tu integración de CDI. Usa Query Editor v2. Para más información, consulta Uso de Amazon Redshift Query Editor v2.
Páginas relacionadas
- Configuración de tablas para conocer las columnas obligatorias y el formato de la carga útil
- Buenas prácticas para la programación de sincronizaciones y el uso eficiente de los puntos de datos
- Registros de sincronización y observabilidad para supervisar las ejecuciones de sincronización
- Preguntas frecuentes para resolver dudas comunes sobre todas las fuentes