Ingestion de données cloud pour Amazon Redshift
Cette page couvre tout ce dont vous avez besoin pour synchroniser des données d’Amazon Redshift vers Braze avec l’ingestion de données cloud (CDI) : les ressources à créer dans Redshift, la connexion de la source et la création d’une synchronisation dans Braze, la table source pour chaque type de données, ainsi que la résolution des problèmes propres à Redshift.
Aperçu de la configuration
- Dans votre instance Redshift, configurez les tables ou les vues que vous souhaitez synchroniser avec Braze.
- Choisissez l’une des méthodes d’authentification prises en charge pour Braze, puis accordez à l’utilisateur de base de données Braze l’accès à vos tables.
- Assurez-vous que Braze est autorisé à accéder aux tables Redshift que vous souhaitez synchroniser. Braze se connecte à Redshift via Internet.
- Créez une nouvelle source et une nouvelle synchronisation dans le tableau de bord de Braze.
- Validez l’intégration et lancez la synchronisation.

Le nombre de lignes traitées par synchronisation dépend des performances de votre entrepôt de données, de la latence du réseau et du volume de nouvelles données correspondant à la requête de synchronisation. Consultez l’historique de synchronisation de l’intégration dans le tableau de bord pour connaître la durée et le nombre de lignes des exécutions récentes.
Étape 1 : Configurer votre table source
Les étapes de cette section créent une table avec une colonne payload. Si vous prévoyez plutôt de mettre en forme vos données à l’étape Définition des données, vous pouvez utiliser une table ou une vue existante. Dans ce cas, ignorez l’étape de création de table et accordez à Braze un accès en lecture aux tables ou vues que vous souhaitez synchroniser. Pour comparer les options, consultez la section Choisir une option de définition des données.
Vous pouvez nommer la base de données, le schéma et la table comme vous le souhaitez, mais les noms de colonnes doivent correspondre aux définitions des onglets suivants. Vous pouvez aussi utiliser une vue ou une vue matérialisée à la place d’une table.
Si vous le souhaitez, configurez une nouvelle base de données et un nouveau schéma pour héberger votre table source :
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Si vous utilisez une colonne payload, votre table ou vue source peut inclure des colonnes qui ne figurent pas dans les onglets suivants (par exemple, pour l’audit ou le hachage). Braze lit uniquement les colonnes décrites dans ces onglets ; les autres colonnes ne sont pas utilisées lors des synchronisations de l’ingestion de données cloud.
Sélectionnez l’onglet correspondant au type de données que vous souhaitez synchroniser.
Les attributs utilisateur, les événements personnalisés et les événements d’achat utilisent tous la même structure de table source. Seul le contenu de payload diffère.
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- L’heure à laquelle cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.- Colonnes d’identifiant utilisateur - Votre table peut contenir une ou plusieurs colonnes d’identifiant utilisateur. Chaque ligne ne doit contenir qu’un seul identifiant (soit
external_id, soit la combinaison dealias_nameetalias_label, soitbraze_id,emailouphone). Une table source peut comporter des colonnes pour un, deux, trois, quatre ou les cinq types d’identifiants.EXTERNAL_ID- Identifie l’utilisateur que vous souhaitez mettre à jour. Cette valeur doit correspondre à la valeurexternal_idutilisée dans Braze.ALIAS_NAMEetALIAS_LABEL- Ces deux colonnes créent un objet alias d’utilisateur.alias_namedoit être un identifiant unique, etalias_labelindique le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seulalias_nameparalias_label.BRAZE_ID- L’identifiant utilisateur Braze. Il est généré par le SDK de Braze, et il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un ID Braze via l’ingestion de données cloud. Pour créer de nouveaux utilisateurs, indiquez un ID utilisateur externe ou un alias d’utilisateur.EMAIL- L’adresse e-mail de l’utilisateur. Si plusieurs profils partagent la même adresse e-mail, le profil mis à jour le plus récemment est prioritaire pour les mises à jour. Si vous incluez à la fois l’e-mail et le numéro de téléphone, l’e-mail sert d’identifiant principal.PHONE- Le numéro de téléphone de l’utilisateur. Si plusieurs profils partagent le même numéro de téléphone, le profil mis à jour le plus récemment est prioritaire pour les mises à jour.
payload- Il s’agit d’une chaîne de caractères JSON contenant les champs que vous souhaitez synchroniser avec l’utilisateur dans Braze.
Pour les synchronisations d’attributs, payload suit le format de l’objet attributs utilisateur. Vous pouvez inclure des attributs personnalisés imbriqués, des tableaux d’objets et des statuts de groupe d’abonnement. Pour des exemples de payload, consultez la section Configuration de la table.
Les événements personnalisés utilisent la même table source que les attributs utilisateur. Créez la table présentée dans l’onglet Attributs utilisateur, puis renseignez payload avec un objet événements.
Pour synchroniser des événements, un nom d’événement est obligatoire. Formatez le champ time sous forme de chaîne de caractères ISO 8601 ou au format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Si le champ time est absent, Braze utilise la valeur de la colonne UPDATED_AT comme heure de l’événement. Les autres champs, notamment app_id et properties, sont facultatifs.
Vous pouvez synchroniser un événement par ligne.
{
"app_id" : "your-app-id",
"name" : "rented_movie",
"time" : "2013-07-16T19:20:45+01:00",
"properties": {
"movie": "The Sad Egg",
"director": "Alex Smith"
}
}
Les événements d’achat utilisent la même table source que les attributs utilisateur. Créez la table présentée dans l’onglet Attributs utilisateur, puis renseignez payload avec un objet achats.
Pour synchroniser des événements d’achat, product_id, currency et price sont obligatoires. Formatez le champ facultatif time sous forme de chaîne de caractères ISO 8601 ou au format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Si le champ time est absent, Braze utilise la valeur de la colonne UPDATED_AT comme heure de l’événement. Les autres champs, notamment app_id, quantity et properties, sont facultatifs.
Vous pouvez synchroniser un événement d’achat par ligne.
{
"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 }
]
}
}
Avant de créer une synchronisation de catalogue, créez le catalogue cible dans Braze. Pour connaître l’ensemble du processus, consultez la section Synchroniser et supprimer des données de catalogue.
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
)
Accordez à l’utilisateur Braze l’accès à cette table, en plus de vos autres tables sources :
GRANT SELECT ON TABLE CATALOGS_SYNC TO braze_user;
Le nom de l’intégration doit correspondre exactement au nom du catalogue que vous avez créé dans Braze.
Braze recommande de créer une vue à partir de vos données de catalogue afin que la table source soit entièrement actualisée à chaque exécution de la synchronisation. Par exemple, si vous disposez d’une table de données produit (product_catalog_1) avec un product_id et trois attributs supplémentaires, vous pourriez synchroniser ce qui suit :
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";
Avant de créer une synchronisation d’objets de données, créez le type d’objet de données et ses champs dans Braze. Pour connaître l’ensemble du processus, consultez la section Synchroniser des objets de données.
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
)
| Nom du champ | Type | Mode |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
payload |
varchar(max) | REQUIRED |
DELETED |
boolean | NULLABLE |
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée dans la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.OBJECT_ID- L’identifiant de l’enregistrement de l’objet de données. Il doit correspondre à la valeurobject_idutilisée dans Braze pour ce type d’objet de données.payload- Une chaîne de caractères JSON contenant les champs et les valeurs à synchroniser. Chaque clé doit correspondre à un champ défini sur le type d’objet de données dans Braze.DELETED- Lorsque la valeur esttrue, Braze supprime l’enregistrement au lieu de le mettre à jour. Laissez cette valeur nulle ou àfalsepour les lignes que vous souhaitez créer ou mettre à jour.
Les noms de champs dans payload sont sensibles à la casse. Une clé nommée NAME ne correspond pas à un champ nommé name. Si la casse ne correspond pas, la validation signale la clé comme un champ non défini et indique comme manquant le champ qu’elle devait renseigner. Nommez vos clés exactement comme les champs apparaissent dans Paramètres des données > Objets de données.
Braze ne crée ni ne modifie les types d’objets de données pendant une synchronisation. Définissez le type et tous ses champs dans Braze avant de créer la synchronisation. Pour ajouter un champ par la suite, ajoutez-le d’abord au type, puis mettez à jour votre table source ou votre requête.
Par exemple, une valeur payload pour un compte comportant un champ name et un champ team_id se présente ainsi :
{"name": "Acme Corp", "team_id": 42}
Accordez à l’utilisateur Braze l’accès à cette table :
GRANT SELECT ON TABLE ACCOUNTS_SYNC TO braze_user;
À l’étape Définition des données, sélectionnez le type de données Objets de données, puis choisissez votre Type d’objet de données. Les synchronisations d’objets de données prennent en charge Table et SQL.
Utilisez cette synchronisation pour associer des utilisateurs à des enregistrements d’objets de données, par exemple pour relier des utilisateurs aux comptes auxquels ils appartiennent. Créez la relation dans Braze avant de la synchroniser.
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
)
| Nom du champ | Type | Mode |
|---|---|---|
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 |
Chaque ligne nécessite un OBJECT_ID ainsi qu’au moins un identifiant utilisateur : EXTERNAL_ID, la combinaison de ALIAS_NAME et ALIAS_LABEL, EMAIL ou PHONE. Utilisez payload pour tous les champs définis sur la relation elle-même.

Contrairement aux synchronisations d’attributs utilisateur, BRAZE_ID n’est pas pris en charge pour les synchronisations de relations utilisateur. Utilisez l’un des identifiants indiqués précédemment.
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée dans la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.OBJECT_ID- L’identifiant de l’enregistrement de l’objet de données. Il doit correspondre à la valeurobject_idutilisée dans Braze pour ce type d’objet de données.payload- Une chaîne de caractères JSON contenant les champs et les valeurs à synchroniser. Chaque clé doit correspondre à un champ défini sur le type d’objet de données dans Braze.DELETED- Lorsque la valeur esttrue, Braze supprime l’enregistrement au lieu de le mettre à jour. Laissez cette valeur nulle ou àfalsepour les lignes que vous souhaitez créer ou mettre à jour.
Les noms de champs dans payload sont sensibles à la casse. Une clé nommée NAME ne correspond pas à un champ nommé name. Si la casse ne correspond pas, la validation signale la clé comme un champ non défini et indique comme manquant le champ qu’elle devait renseigner. Nommez vos clés exactement comme les champs apparaissent dans Paramètres des données > Objets de données.
Braze ne crée ni ne modifie les types d’objets de données pendant une synchronisation. Définissez le type et tous ses champs dans Braze avant de créer la synchronisation. Pour ajouter un champ par la suite, ajoutez-le d’abord au type, puis mettez à jour votre table source ou votre requête.
À l’étape Définition des données, sélectionnez le type de données Relations utilisateur des objets de données, puis choisissez un Nom de relation, par exemple Utilisateur (Compte-Utilisateur).
Utilisez cette synchronisation pour relier des enregistrements d’objets de données entre eux, par exemple pour associer des comptes à leurs comptes parents. Créez la relation dans Braze avant de la synchroniser.
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
)
| Nom du champ | Type | Mode |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
RELATED_OBJECT_ID |
varchar | REQUIRED |
payload |
varchar(max) | NULLABLE |
DELETED |
boolean | NULLABLE |
OBJECT_ID correspond à l’enregistrement d’où part la relation, et RELATED_OBJECT_ID à l’enregistrement vers lequel elle pointe. Les deux sont obligatoires dans chaque ligne. Utilisez payload pour tous les champs définis sur la relation elle-même.
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée dans la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.OBJECT_ID- L’identifiant de l’enregistrement de l’objet de données. Il doit correspondre à la valeurobject_idutilisée dans Braze pour ce type d’objet de données.payload- Une chaîne de caractères JSON contenant les champs et les valeurs à synchroniser. Chaque clé doit correspondre à un champ défini sur le type d’objet de données dans Braze.DELETED- Lorsque la valeur esttrue, Braze supprime l’enregistrement au lieu de le mettre à jour. Laissez cette valeur nulle ou àfalsepour les lignes que vous souhaitez créer ou mettre à jour.
Les noms de champs dans payload sont sensibles à la casse. Une clé nommée NAME ne correspond pas à un champ nommé name. Si la casse ne correspond pas, la validation signale la clé comme un champ non défini et indique comme manquant le champ qu’elle devait renseigner. Nommez vos clés exactement comme les champs apparaissent dans Paramètres des données > Objets de données.
Braze ne crée ni ne modifie les types d’objets de données pendant une synchronisation. Définissez le type et tous ses champs dans Braze avant de créer la synchronisation. Pour ajouter un champ par la suite, ajoutez-le d’abord au type, puis mettez à jour votre table source ou votre requête.
À l’étape Définition des données, sélectionnez le type de données Relations entre objets de données, puis choisissez un Nom de relation, par exemple Sous-compte (Compte-Compte).
Les déclencheurs de Canvas alimentent la personnalisation zero-copy. Pour la configuration du Canvas de destination et les points à prendre en compte, consultez la section Personnalisation zero-copy.
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)
);
Les synchronisations de déclencheurs Canvas diffèrent des autres synchronisations de données utilisateur sur trois points :
- Seuls les identifiants de type ID externe ou alias d’utilisateur sont pris en charge. Les adresses e-mail et les numéros de téléphone ne sont pas des identifiants pris en charge.
- Seuls les utilisateurs Braze existants peuvent être synchronisés. Il n’est pas possible de créer de nouveaux utilisateurs.
PROPERTIESremplace la colonnepayload. Il s’agit d’une chaîne de caractères JSON contenant les champs que vous souhaitez utiliser comme propriétés d’entrée du Canvas pour la personnalisation.
Votre table de déclencheurs Canvas doit contenir les colonnes suivantes :
UPDATED_AT- Le moment où cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.- Soit
EXTERNAL_ID, soitALIAS_NAMEetALIAS_LABELcomme colonne d’identifiant utilisateur. Ces colonnes identifient les utilisateurs pour lesquels vous souhaitez déclencher des messages Canvas.EXTERNAL_ID- Identifie l’utilisateur à faire entrer dans le Canvas. Cette valeur doit correspondre à la valeurexternal_idutilisée dans Braze.ALIAS_NAMEetALIAS_LABEL- Ces colonnes créent un objet alias d’utilisateur.alias_namedoit être un identifiant unique, etalias_labelindique le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seulalias_nameparalias_label.
PROPERTIES- Une chaîne de caractères JSON contenant les champs à rendre disponibles comme propriétés de personnalisation dans votre Canvas. Elle doit contenir des informations propres à chaque utilisateur.

Les propriétés ne sont pas obligatoires pour chaque ligne ou chaque utilisateur. En revanche, leurs valeurs doivent être une chaîne de caractères JSON valide. Si la ligne ne comporte aucune propriété, saisissez une chaîne vide {}.
Accordez à l’utilisateur Braze l’accès à cette table :
GRANT SELECT ON TABLE CANVAS_TRIGGERS_SYNC TO braze_user;
Pour commencer, sélectionnez le type de données Déclencheurs de Canvas lors de la création d’une nouvelle synchronisation.
Les tables sources pour les suppressions d’utilisateurs doivent inclure un ou plusieurs types d’identifiants utilisateur ainsi qu’un horodatage UPDATED_AT. Les colonnes de payload ne sont pas prises en charge pour les données de suppression d’utilisateurs.
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.- Colonnes d’identifiant utilisateur - Chaque ligne ne doit contenir qu’un seul identifiant : soit
external_id, soit la combinaison dealias_nameetalias_label, soitbraze_id. Une table source peut contenir des colonnes pour un, deux ou les trois types d’identifiants.EXTERNAL_ID- Identifie l’utilisateur que vous souhaitez mettre à jour. Cette valeur doit correspondre à la valeurexternal_idutilisée dans Braze.ALIAS_NAMEetALIAS_LABEL- Ces deux colonnes créent un objet alias d’utilisateur.alias_namedoit être un identifiant unique, etalias_labelindique le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seulalias_nameparalias_label.BRAZE_ID- L’identifiant utilisateur Braze. Il est généré par le SDK de Braze, et il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un ID Braze via Cloud Data Ingestion. Pour créer de nouveaux utilisateurs, indiquez un ID utilisateur externe ou un alias d’utilisateur.

N’incluez pas de colonne payload dans votre table pour la suppression d’utilisateurs. Pour éviter toute suppression accidentelle et définitive d’utilisateurs, la synchronisation échoue si une colonne de payload est présente dans la table source. Toutes les autres colonnes sont autorisées, mais Braze les ignore.
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
);
Sur la page Créer une synchronisation d’importation, définissez le Type de données sur Supprimer des utilisateurs afin que les actions appropriées soient effectuées lors de l’exécution de l’intégration. Pour plus d’informations, consultez la section Supprimer des utilisateurs avec l’ingestion de données cloud.

La suppression de profils utilisateurs est irréversible. L’action de suppression retire définitivement les utilisateurs, ce qui peut entraîner des écarts dans vos données. Pour plus de détails, consultez la section Effets de la suppression de profils utilisateurs.
Étape 2 : Configurer l’authentification
Braze se connecte à Redshift en tant qu’utilisateur de base de données. Choisissez l’une des méthodes d’authentification suivantes pour configurer cet utilisateur :
| Méthode | Mode d’authentification de Braze | Informations à saisir dans 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 endosse un rôle AWS Identity and Access Management (IAM) dans votre compte AWS et demande des identifiants de base de données temporaires. Braze ne stocke aucun mot de passe de base de données. Braze endosse le rôle depuis le même compte AWS que celui utilisé pour les sources Amazon S3.
Braze génère un ID externe pour votre espace de travail. Votre rôle utilise cet ID pour vérifier qu’une demande d’endossement du rôle provient bien de votre espace de travail Braze.
Vos identifiants existants (nom d’utilisateur et mot de passe) continuent de fonctionner : vous n’avez donc pas besoin de les migrer.
Conditions préalables
Vous devez disposer de l’autorisation de créer des rôles et des politiques IAM dans votre compte AWS. Vous devez également pouvoir exécuter des instructions CREATE USER et GRANT dans votre base de données Redshift.

La politique d’approbation de votre rôle doit exiger l’ID externe exact indiqué dans le formulaire d’identifiants de Braze. Lorsque vous testez ou enregistrez des identifiants, Braze tente d’endosser votre rôle avec un ID externe différent. Si AWS autorise cette tentative, le test de connexion échoue. C’est le cas lorsque le rôle n’exige pas d’ID externe, ou lorsqu’il accepte un modèle tel que braze-cdi-*.
Copier l’ID de compte Braze et l’ID externe
- Dans le tableau de bord de Braze, accédez à Paramètres des données > Ingestion de données cloud > Sources.
- Sélectionnez Ajouter une source de données, puis Amazon Redshift.
- Pour la méthode d’authentification, sélectionnez Rôle IAM.
- À l’étape Configuration AWS, copiez l’ID de compte Braze et l’ID externe. Laissez le formulaire ouvert, car vous y reviendrez à l’étape Saisir les valeurs dans Braze.
Créer le rôle IAM
- Dans la console AWS, accédez à IAM > Roles, puis sélectionnez Create role.
- Sélectionnez AWS account comme type d’entité de confiance, puis Another AWS account.
- Collez l’ID de compte Braze. Sélectionnez Require external ID, puis collez l’ID externe.
- Ignorez l’étape des autorisations. Saisissez un nom de rôle, puis sélectionnez Create role. Vous ajouterez la politique d’autorisations à l’étape Ajouter la politique d’autorisations.
- Copiez l’Amazon Resource Name (ARN) du rôle. Vous le saisirez dans Braze à l’étape Saisir les valeurs dans Braze.
La politique d’approbation du rôle ressemble à l’exemple suivant. Remplacez BRAZE_ACCOUNT_ID et EXTERNAL_ID par les valeurs du formulaire d’identifiants.
{
"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"
}
}
}
]
}
Ajouter la politique d’autorisations
Ajoutez une politique d’autorisations intégrée au rôle. Dans l’onglet Permissions du rôle, sélectionnez Add permissions > Create inline policy, puis collez le JSON correspondant à votre type de cluster à partir des onglets suivants.
Pour Redshift Serverless, la politique doit autoriser redshift-serverless:GetCredentials sur votre groupe de travail. Dans la valeur Resource, utilisez l’ID du groupe de travail, qui est différent de son nom. Pour trouver cet ID, ouvrez votre groupe de travail dans la console Redshift et copiez l’ID à partir de l’ARN du groupe de travail.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": "arn:aws:redshift-serverless:REGION:AWS_ACCOUNT_ID:workgroup/WORKGROUP_ID"
}
]
}
Remplacez REGION, AWS_ACCOUNT_ID et WORKGROUP_ID par les valeurs de votre groupe de travail.
Pour un cluster provisionné, la politique doit autoriser redshift:GetClusterCredentialsWithIAM sur la base de données à partir de laquelle vous effectuez la synchronisation.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift:GetClusterCredentialsWithIAM",
"Resource": "arn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME"
}
]
}
Remplacez REGION, AWS_ACCOUNT_ID, CLUSTER_IDENTIFIER et DATABASE_NAME par les valeurs de votre cluster.
Créer l’utilisateur de base de données et accorder l’accès
Braze se connecte à Redshift en tant qu’utilisateur de base de données nommé IAMR:ROLE_NAME, où ROLE_NAME correspond au nom du rôle IAM que vous avez créé. Cet utilisateur est différent de braze_user : les autorisations que vous avez accordées à d’autres utilisateurs de base de données ne s’appliquent donc pas à lui.
Avant de tester la connexion dans Braze, exécutez l’instruction suivante dans votre base de données Redshift pour créer l’utilisateur. Vous pouvez l’exécuter sans risque avant la première connexion de Braze :
CREATE USER "IAMR:ROLE_NAME" PASSWORD DISABLE;
Accordez ensuite à cet utilisateur l’accès à votre table source. Utilisez les mêmes instructions GRANT qu’à l’étape 3 : Accorder des autorisations à l’utilisateur, en remplaçant braze_user par "IAMR:ROLE_NAME". Conservez les guillemets doubles, car le nom d’utilisateur contient un deux-points.
Si vous utilisez également Redshift comme source connectée, accordez à cet utilisateur les mêmes autorisations que celles indiquées dans cette section.
Saisir les valeurs dans Braze
Revenez au formulaire d’identifiants de Braze. À l’étape Configuration Braze, saisissez les valeurs suivantes :
| Champ Braze | Valeur à saisir |
|---|---|
| Type de cluster | Serverless (par défaut) ou Provisioned. |
| ARN du rôle | L’ARN du rôle que vous avez créé, au format arn:aws:iam::123456789012:role/ROLE_NAME. |
| Région | La région AWS dans laquelle s’exécute votre cluster ou groupe de travail Redshift, par exemple us-east-1. Elle peut être différente de la région de votre instance Braze. |
| Nom du groupe de travail ou Identifiant du cluster | Pour Serverless, le nom de votre groupe de travail. Pour un cluster provisionné, l’identifiant de votre cluster. |
| Hôte | L’endpoint de votre cluster ou groupe de travail. Pour Serverless, Braze remplit ce champ à partir de l’ARN du rôle, de la Région et du Nom du groupe de travail, et vous pouvez le modifier. Pour un cluster provisionné, saisissez l’endpoint. |
| Port | Le port de votre cluster ou groupe de travail. La valeur par défaut est 5439. Saisissez une valeur comprise entre 1024 et 65535. |

Vous ne pouvez pas modifier ces informations de connexion après avoir enregistré les identifiants. Pour modifier l’une d’entre elles, créez de nouveaux identifiants. Vous pourrez ensuite déplacer votre source vers ces nouveaux identifiants.
L’authentification par rôle IAM fonctionne avec ou sans tunnel SSH. Pour configurer le tunnel et la liste d’adresses IP autorisées, suivez l’étape 4 : Autoriser l’accès aux IP de Braze, comme pour les autres méthodes. Après avoir enregistré les identifiants, vous pouvez les renommer. Si vous utilisez un tunnel, vous pouvez également effectuer la rotation de la clé du tunnel.
Comment Braze teste la connexion
Lorsque vous testez la connexion, et à chaque connexion de Braze, Braze tente d’abord d’endosser votre rôle à l’aide d’un ID externe de test qui n’appartient à aucun espace de travail : braze-cdi-000000000000000000000000. Votre rôle doit refuser cette tentative avec une erreur AccessDenied. Si AWS l’autorise, le test de connexion échoue. Pour obtenir de l’aide, consultez Votre rôle IAM n’exige pas son ID externe.
AWS CloudTrail affiche ces tentatives sous forme d’appels AssumeRole avec le nom de session Braze-CDI-Redshift. La tentative refusée est normale et ne donne pas à Braze l’accès à vos données. N’ajoutez pas de condition qui rejette uniquement cet ID externe : votre rôle ferait alors toujours confiance à d’autres espaces de travail Braze.
Supprimer l’accès de Braze
Pour empêcher Braze d’accéder à vos données, supprimez le rôle, ou retirez la déclaration d’approbation du compte Braze de la politique d’approbation du rôle. Vous pouvez également supprimer l’utilisateur de base de données IAMR:ROLE_NAME.
Configurer avec l’AWS CLI
Vous pouvez aussi utiliser l’interface de ligne de commande AWS (CLI) pour créer le rôle et y associer la politique d’autorisations. Cet exemple utilise un groupe de travail Serverless. Pour un cluster provisionné, remplacez le document de politique par celui de l’onglet Provisioned de la section Ajouter la politique d’autorisations.
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"
}]
}'
Remplacez les marques substitutives suivantes :
BRAZE_ACCOUNT_IDetEXTERNAL_ID: les valeurs du formulaire d’identifiantsREGION,AWS_ACCOUNT_IDetWORKGROUP_ID: les valeurs de votre groupe de travail
La commande create-role renvoie l’ARN du rôle dans sa sortie. Pour plus de détails, consultez create-role dans la référence des commandes de l’AWS CLI. Copiez l’ARN, puis passez à l’étape Créer l’utilisateur de base de données et accorder l’accès.
Username and password
Braze se connecte à Redshift en tant qu’utilisateur de la base de données, avec un mot de passe. Créez un utilisateur pour Braze :
CREATE USER braze_user PASSWORD '{password}';
Conservez le nom d’utilisateur et le mot de passe en lieu sûr. Vous devrez les saisir dans le tableau de bord de Braze lors de la création de la source.
Étape 3 : Accorder des autorisations à l’utilisateur
Accordez à l’utilisateur de la base de données utilisé par Braze pour se connecter l’accès à votre table source. L’exemple suivant utilise braze_user. Si vous utilisez l’authentification par rôle IAM, remplacez braze_user par "IAMR:ROLE_NAME". Pour plus de détails, consultez Créer l’utilisateur de la base de données et accorder l’accès.
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;
Il s’agit des autorisations minimales requises pour cet utilisateur. Si vous créez plusieurs intégrations CDI, vous pouvez accorder des autorisations au niveau d’un schéma ou gérer les autorisations à l’aide d’un groupe.
Étape 4 : Autoriser l’accès aux IP de Braze
Si vous disposez d’un pare-feu ou d’autres politiques réseau, vous devez accorder à Braze un accès réseau à votre instance Redshift. Voici un exemple d’endpoint URL Redshift : « example-cluster.ap-northeast-2.redshift.amazonaws.com ».
Quelques points importants à connaître :
- Vous devrez peut-être également modifier vos groupes de sécurité pour permettre à Braze d’accéder à vos données dans Redshift.
- Veillez à autoriser explicitement le trafic entrant provenant des IP du tableau et sur le port utilisé pour interroger votre cluster Redshift (5439 par défaut). Autorisez explicitement la connectivité TCP de Redshift sur ce port, même si les règles entrantes sont définies sur « tout autoriser ».
- L’endpoint du cluster Redshift doit être accessible publiquement pour que Braze puisse se connecter à votre cluster.
- Si vous ne souhaitez pas que votre cluster Redshift soit accessible publiquement, vous pouvez configurer un VPC et une instance EC2 afin d’utiliser un tunnel SSH pour accéder aux données Redshift. Pour plus d’informations, consultez cet article du Knowledge Center d’AWS.
Autorisez l’accès depuis les IP suivantes, qui correspondent à la région de votre tableau de bord de Braze.
Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :
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
Pour l’instance US-08, voici les adresses IP correspondantes :
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
Pour l’instance US-10, voici les adresses IP correspondantes :
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :
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
Pour l’instance AU-01, voici les adresses IP correspondantes :
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Pour l’instance ID-01, voici les adresses IP correspondantes :
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Pour l’instance JP-01, voici les adresses IP correspondantes :
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Pour l’instance KR-01, voici les adresses IP correspondantes :
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Étape 5 : Créer une nouvelle source dans le tableau de bord de Braze
Dans le tableau de bord de Braze, allez dans Paramètres des données > Ingestion de données cloud > Sources, sélectionnez Ajouter une source de données, puis sélectionnez Amazon Redshift.
Étape 5.1 : Ajouter les informations de connexion Redshift et la table source
Choisissez un nom pour votre source et saisissez vos identifiants et votre configuration Redshift. Sélectionnez la méthode d’authentification que vous avez configurée à l’étape 2, puis saisissez ses identifiants :
- IAM role : Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier
- Username and password : Username and Password
Si vous utilisez un tunnel de réseau privé, activez le curseur et saisissez les informations du tunnel. Passez ensuite à l’étape suivante.

Dans le tableau de bord de Braze, le champ Nom de la base de données n’accepte que des lettres (A–Z, a–z), des chiffres (0–9) et des traits de soulignement (_), même si Amazon Redshift prend en charge d’autres caractères dans les identifiants de base de données.
Étape 5.2 : Tester la connexion et se connecter à la source
Ensuite, sélectionnez Tester la connexion. Une fois le test réussi, finalisez les paramètres restants et cliquez sur Se connecter à la source. Si la connexion échoue, un message d’erreur s’affiche pour vous aider à résoudre le problème.
Étape 6 : Créer une nouvelle synchronisation dans le tableau de bord de Braze
Accédez à Paramètres des données > Ingestion de données cloud > Synchronisations, puis sélectionnez Créer une synchronisation de données.
Configurer les détails de la synchronisation et définir vos données
Saisissez un nom pour votre synchronisation. Sélectionnez ensuite une source active et un type de données de synchronisation. Choisissez ensuite un mode de synchronisation et définissez vos données. Sélectionnez enfin Prévisualiser et valider.
Une fois la validation réussie, un aperçu des données s’affiche. Sélectionnez Suivant : Notifications pour continuer. Si la validation échoue, un message d’erreur s’affiche pour vous aider à résoudre le problème.

Vous devez valider une synchronisation avant de passer aux étapes suivantes. Si vous devez fermer la page de création de synchronisation, sélectionnez Enregistrer comme brouillon pour conserver votre travail en cours.
Ajouter des préférences de notification
Saisissez une ou plusieurs adresses e-mail de contact pour recevoir les notifications d’erreurs de synchronisation. Braze utilise ces coordonnées pour vous informer des erreurs d’intégration, comme une perte inattendue de l’accès à une table.
Les adresses e-mail de contact reçoivent uniquement les notifications d’erreurs globales ou au niveau de la synchronisation, par exemple des tables manquantes ou des problèmes d’autorisations. Elles ne sont pas notifiées des problèmes au niveau des lignes. Les erreurs globales signalent des problèmes critiques de connexion qui empêchent l’exécution des synchronisations.
Il peut notamment s’agir des problèmes suivants :
- Problèmes de connectivité
- Manque de ressources
- Problèmes d’autorisations
- Espace insuffisant pour le niveau de catalogue (synchronisations de catalogues uniquement)
Définir la planification
Enfin, configurez votre synchronisation comme ponctuelle ou récurrente.
Les synchronisations ponctuelles s’exécutent uniquement lorsque vous sélectionnez Synchroniser maintenant dans le tableau de bord ou que vous appelez l’endpoint Déclencher une synchronisation.
Les synchronisations récurrentes peuvent s’exécuter aussi souvent que toutes les 5 minutes ou aussi rarement qu’une fois par mois. Par défaut, l’intervalle le plus court que vous pouvez définir dans le tableau de bord est de 15 minutes, ce qui vous aide à maîtriser les coûts de calcul de votre entrepôt de données et le volume de requêtes. Pour synchroniser jusqu’à toutes les 5 minutes, contactez le support Braze ou votre gestionnaire de la satisfaction client. Braze planifie les synchronisations récurrentes en UTC.

Vous devez valider une intégration avant qu’elle puisse passer de l’état Brouillon à l’état Actif. Si vous fermez la page de création, votre intégration est enregistrée et vous pouvez revenir sur la page de détails pour apporter des modifications et la valider.
Exécuter la synchronisation
Une fois activée, votre synchronisation s’exécute selon la planification définie lors de la configuration. Pour lancer la synchronisation en dehors de cette planification ou récupérer les données les plus récentes, sélectionnez Synchroniser maintenant. Cette exécution n’a aucun impact sur les synchronisations planifiées à venir. Pour démarrer automatiquement une synchronisation dès que vos données sont mises à jour, appelez l’endpoint Déclencher une synchronisation depuis votre pipeline.
Configurer des intégrations ou des utilisateurs supplémentaires (facultatif)
Vous pouvez configurer plusieurs intégrations avec Braze. Lorsque vous créez des synchronisations supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte Redshift.
Si vous réutilisez le même utilisateur pour plusieurs intégrations, vous ne pourrez pas le supprimer dans le tableau de bord de Braze tant qu’il n’aura pas été retiré de toutes les synchronisations actives.
Utiliser Redshift comme source connectée
Une source connectée est une alternative sans copie à la synchronisation des données dans Braze. Braze interroge directement votre instance Redshift pour créer des segments CDI, sans copier les données sous-jacentes. Pour en savoir plus sur les concepts, les limites et l’impact sur les coûts, consultez Sources connectées.
Étape 1 : Créer l’utilisateur et accorder les autorisations
Choisissez l’une des méthodes décrites à l’étape 2 : Configurer l’authentification pour Braze. Accordez ensuite les autorisations suivantes à l’utilisateur de base de données Braze. L’exemple utilise braze_user. Si vous utilisez l’authentification par rôle IAM, remplacez braze_user par "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;
Créez un utilisateur dédié à votre source connectée. Cet utilisateur sert à générer la liste des tables disponibles dans vos extensions de segments CDI et à interroger les tables sources pour créer de nouveaux segments. Une fois la source connectée créée, Braze découvre le nom et la description de toutes les tables accessibles à l’utilisateur dans le schéma source. Si vous créez plusieurs intégrations CDI, vous pouvez accorder les autorisations au niveau d’un schéma ou les gérer à l’aide d’un groupe.
Vous pouvez accorder l’accès à toutes les tables d’un schéma, ou uniquement à certaines tables. Toutes les tables auxquelles le rôle Braze a accès peuvent être interrogées dans l’extension de segment CDI. Pensez à accorder à l’utilisateur l’accès aux nouvelles tables dès leur création, ou définissez des autorisations par défaut pour cet utilisateur.
L’autorisation create table est requise pour que Braze puisse créer une table contenant les résultats de la requête de votre extension de segment CDI avant de mettre à jour le segment dans Braze. Braze crée une table temporaire par segment, qui n’existe que pendant la mise à jour du segment.
La configuration de l’accès réseau est identique à celle de l’étape 4.
Étape 2 : Créer la source connectée dans Braze
Accédez à Paramètres des données > Ingestion de données cloud > Sources connectées, sélectionnez Ajouter une source de données, puis sélectionnez Amazon Redshift.
Dans Configurer la source, saisissez les informations suivantes :
- Identifiants : URL de l’hôte Redshift, Port et les champs correspondant à votre méthode d’authentification. Pour IAM role, saisissez Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier. Pour Username and password, saisissez Username and Password.
- Configuration : Base de données et Schéma
Si nécessaire, activez Se connecter avec un tunnel SSH et renseignez Hôte du tunnel, Port du tunnel et Nom d’utilisateur du tunnel.
Choisissez un nom pour la source connectée. Ce nom apparaît dans la liste des sources disponibles lorsque vous créez une nouvelle extension de segment CDI.
Configurez une durée d’exécution maximale pour cette source. Braze interrompt automatiquement toute requête qui dépasse cette durée. La durée d’exécution maximale autorisée est de 60 minutes ; une durée plus courte réduit les coûts engagés sur votre compte Redshift. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.
Étape 3 : Finaliser la configuration de Redshift
Si Se connecter avec un tunnel SSH est sélectionné dans vos identifiants, notez la clé publique RSA affichée à l’étape Tester la connexion et ajoutez-la à l’utilisateur du tunnel SSH.
Après avoir ajouté la clé à l’utilisateur, sélectionnez Tester la connexion dans Braze, puis Terminé. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.
Vous pouvez configurer plusieurs sources connectées avec Braze, mais chaque source doit se connecter à un schéma différent. Lorsque vous créez des sources supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte Redshift.
Formater un payload à partir de colonnes existantes
Si vous préférez stocker chaque attribut dans sa propre colonne en interne, vous devez convertir ces colonnes en chaîne de caractères JSON pour alimenter la synchronisation avec Braze. Utilisez cette requête dans Redshift pour formater les colonnes sources en champs 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";
Pour plus de conseils d’optimisation, consultez les bonnes pratiques de l’ingestion de données cloud.
Résolution des problèmes
Le test de connexion est lent
Le test de connexion s’exécute sur votre entrepôt de données : augmenter la capacité de l’entrepôt peut donc améliorer sa vitesse. Une instance SQL serverless réduit le temps de démarrage et améliore le débit des requêtes, mais peut légèrement augmenter les coûts d’intégration.
Autorisation refusée pour la relation {table_name}
Si vous recevez cette erreur :
- Accordez l’autorisation
usagesur le schéma à cet utilisateur. - Accordez l’autorisation
selectsur la table à cet utilisateur.
Votre rôle IAM n’exige pas son ID externe
Si vous utilisez l’authentification par rôle IAM, le test de connexion peut échouer avec l’erreur suivante :
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.
Cette erreur signifie qu’AWS a accepté l’ID externe de test décrit dans Comment Braze teste la connexion. Pour corriger le problème, mettez à jour la politique d’approbation de votre rôle :
- Dans la console AWS, ouvrez le rôle et sélectionnez l’onglet Relations d’approbation.
- Pour chaque déclaration qui autorise le compte Braze à assumer le rôle, ajoutez une condition
StringEqualssursts:ExternalIdqui utilise l’ID externe exact indiqué dans le formulaire d’identifiants. Supprimez toute condition basée sur un modèle, commebraze-cdi-*. - Dans Braze, testez à nouveau la connexion.
Braze n’a pas pu confirmer que votre rôle exige son ID externe
Si vous utilisez l’authentification par rôle IAM, le test de connexion peut échouer avec l’erreur suivante :
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 n’a pas pu terminer la vérification : cette erreur ne signifie donc pas que votre rôle est trop permissif. Testez à nouveau la connexion. Si l’erreur persiste, contactez l’assistance Braze.
Impossible d’assumer le rôle IAM
Si vous utilisez l’authentification par rôle IAM et que le test de connexion échoue avec une erreur commençant par « Unable to assume IAM role », vérifiez les points suivants :
- La politique d’approbation du rôle indique l’ID de compte Braze du formulaire d’identifiants comme principal approuvé.
- La politique d’approbation du rôle exige l’ID externe exact du formulaire d’identifiants.
- L’ARN du rôle que vous avez saisi dans Braze correspond à l’ARN du rôle que vous avez créé.
- Si votre instance Braze se trouve dans une région AWS qui n’est pas activée par défaut, comme Jakarta (ID-01), cette région est activée dans votre compte AWS.
AWS renvoie la même erreur AccessDenied pour toutes ces causes : vérifiez donc chacune d’entre elles.
Impossible d’obtenir les identifiants de la base de données Redshift
Si vous utilisez l’authentification par rôle IAM et que le test de connexion échoue avec une erreur commençant par « Unable to get Redshift database credentials as IAM role », vérifiez les points suivants :
- La politique d’autorisations du rôle autorise
redshift-serverless:GetCredentialspour Serverless, ouredshift:GetClusterCredentialsWithIAMpour un cluster provisionné. - Pour Serverless, la valeur
Resourcede la politique utilise l’ID du groupe de travail, qui est différent du nom du groupe de travail. - Pour un cluster provisionné, la valeur
Resourcede la politique est l’ARNdbnamede votre cluster et de votre base de données, au formatarn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME. - La valeur saisie dans Braze pour Région, Nom du groupe de travail ou Identifiant du cluster correspond à votre cluster ou à votre groupe de travail.
Autorisation refusée après un test de connexion réussi
Si le test de connexion réussit mais qu’une synchronisation ou une validation renvoie une erreur d’autorisation refusée, vous avez probablement accordé l’accès à un autre utilisateur, comme braze_user. Avec l’authentification par rôle IAM, Braze se connecte en tant que "IAMR:ROLE_NAME". Accordez les autorisations sur le schéma et les tables à cet utilisateur. Pour plus de détails, consultez Créer l’utilisateur de la base de données et accorder l’accès.
Erreur de création de connexion
Si vous recevez cette erreur, vérifiez que l’endpoint et le port Redshift sont corrects.
Erreur de création du tunnel SSH
Si vous recevez cette erreur :
- Vérifiez que la clé publique affichée dans votre tableau de bord de Braze se trouve bien sur l’hôte EC2 utilisé pour le tunnel SSH.
- Vérifiez que votre nom d’utilisateur est correct.
- Vérifiez que le tunnel SSH est correctement configuré.
Identifiant de snapshot non valide
Si Braze renvoie une erreur Invalid snapshot identifier pendant le Test de connexion ou la configuration de la synchronisation, cela signifie que Redshift ne parvient pas à résoudre la référence de snapshot utilisée lors de l’interrogation de votre objet source.
Dans Redshift, un snapshot est une sauvegarde d’un cluster à un instant donné. Chaque snapshot possède un identifiant unique que Redshift utilise pour référencer cet état de sauvegarde. Pour plus d’informations, consultez Snapshots et sauvegardes Amazon Redshift.
Cette erreur peut survenir lorsque des métadonnées changent pendant que Braze valide l’objet source, par exemple lors d’une copie, d’une restauration ou d’opérations liées à la réplication de snapshots. Pour plus d’informations, consultez la copie de snapshots vers une autre région AWS et la restauration d’un cluster à partir d’un snapshot.
Pour résoudre le problème :
- Vérifiez les paramètres de la source dans Braze, notamment l’endpoint du cluster, la base de données, le schéma et le nom de l’objet.
- Exécutez la même requête directement dans Redshift pour confirmer que la table ou la vue est lisible et stable.
- Réessayez une fois les opérations de snapshot, de restauration, de redimensionnement ou de réplication en cours terminées.
- Si le problème persiste, interrogez une vue matérialisée plutôt qu’une table de base qui change fréquemment.
Une vue matérialisée stocke des résultats de requête précalculés que vous pouvez actualiser selon une planification, ce qui peut rendre les lectures plus stables pour les synchronisations CDI. Pour plus d’informations, consultez les vues matérialisées dans Amazon Redshift.
Exemple :
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;
Après avoir créé la vue matérialisée, utilisez son nom comme objet source dans votre synchronisation CDI Braze, à la place de la table de base.
Où exécuter les vérifications SQL
Exécutez les vérifications de validation directement dans l’éditeur SQL de Redshift, sur la même table ou vue que celle utilisée par votre intégration CDI. Utilisez Query Editor v2. Pour plus d’informations, consultez Utiliser Amazon Redshift Query Editor v2.
Pages connexes
- Configuration de la table pour connaître les colonnes requises et le formatage du payload
- Bonnes pratiques pour la planification des synchronisations et l’utilisation efficace des points de données
- Journaux de synchronisation et observabilité pour surveiller les exécutions de synchronisation
- FAQ pour les questions fréquentes communes à toutes les sources