Cloud Data Ingestion für Amazon Redshift
Auf dieser Seite finden Sie alles, was Sie benötigen, um Daten mit Cloud Data Ingestion (CDI) von Amazon Redshift mit Braze zu synchronisieren: die in Redshift zu erstellenden Ressourcen, wie Sie die Quelle verbinden und eine Synchronisierung in Braze erstellen, die Quelltabelle für jeden Datentyp sowie Redshift-spezifische Fehlerbehebung.
Übersicht über die Einrichtung
- Richten Sie in Ihrer Redshift-Instanz die Tabellen oder Ansichten ein, die Sie mit Braze synchronisieren möchten.
- Wählen Sie eine der unterstützten Authentifizierungsmethoden für Braze aus und gewähren Sie dem Braze-Datenbanknutzer Zugriff auf Ihre Tabellen.
- Stellen Sie sicher, dass der Zugriff von Braze auf die Redshift-Tabellen, die Sie synchronisieren möchten, zulässig ist. Braze verbindet sich über das Internet mit Redshift.
- Erstellen Sie im Braze-Dashboard eine neue Quelle und Synchronisierung.
- Überprüfen Sie die Integration und starten Sie die Synchronisierung.

Wie viele Zeilen pro Synchronisierung verarbeitet werden, hängt von der Performance Ihres Data Warehouse, der Netzwerklatenz und der Menge neuer Daten ab, die der Synchronisierungsabfrage entsprechen. Im Synchronisierungsverlauf der Integration im Dashboard sehen Sie die Dauer und die Zeilenanzahl der letzten Durchläufe.
Schritt 1: Richten Sie Ihre Quelltabelle ein
Mit den Schritten in diesem Abschnitt erstellen Sie eine Tabelle mit einer PAYLOAD-Spalte. Wenn Sie Ihre Daten stattdessen im Schritt Datendefinition aufbereiten möchten, können Sie eine bestehende Tabelle oder View verwenden. Überspringen Sie in diesem Fall die Tabellenerstellung und gewähren Sie Braze Lesezugriff auf die Tabellen oder Views, die Sie synchronisieren möchten. Einen Vergleich der Optionen finden Sie unter Datendefinitionsoption auswählen.
Sie können die Datenbank, das Schema und die Tabelle beliebig benennen, die Spaltennamen sollten jedoch den Definitionen in den folgenden Tabs entsprechen. Anstelle einer Tabelle können Sie auch eine View oder eine materialisierte View verwenden.
Optional können Sie eine neue Datenbank und ein neues Schema für Ihre Quelltabelle einrichten:
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Wenn Sie eine PAYLOAD-Spalte verwenden, kann Ihre Quelltabelle oder View Spalten enthalten, die in den folgenden Tabs nicht aufgeführt sind (zum Beispiel für Auditing oder Hashing). Braze liest nur die in diesen Tabs beschriebenen Spalten; andere Spalten werden bei Synchronisierungen über Cloud Data Ingestion nicht verwendet.
Wählen Sie den Tab für den Datentyp aus, den Sie synchronisieren möchten.
Nutzerattribute, angepasste Events und Kauf-Events verwenden alle dieselbe Struktur für die Quelltabelle. Nur der Inhalt von PAYLOAD unterscheidet sich.
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– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder ihr hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenz-Zeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.- Spalten für Nutzer-Bezeichner – Ihre Tabelle kann eine oder mehrere Spalten für Nutzer-Bezeichner enthalten. Jede Zeile sollte nur einen Bezeichner enthalten (entweder
external_id, die Kombination ausalias_nameundalias_label,braze_id,emailoderphone). Eine Quelltabelle kann Spalten für einen, zwei, drei, vier oder alle fünf Bezeichnertypen enthalten.EXTERNAL_ID– Hiermit wird die Nutzer:in identifiziert, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendetenexternal_id-Wert übereinstimmen.ALIAS_NAMEundALIAS_LABEL– Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt.alias_namesollte ein eindeutiger Bezeichner sein, undalias_labelgibt den Typ des Alias an. Nutzer:innen können mehrere Aliasse mit unterschiedlichen Labels haben, aber nur einenalias_nameproalias_label.BRAZE_ID– Der Braze-Nutzer-Bezeichner. Er wird vom Braze SDK generiert. Über Cloud Data Ingestion können keine neuen Nutzer:innen mit einer Braze-ID erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.EMAIL– Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird bei Updates das zuletzt aktualisierte Profil priorisiert. Wenn Sie sowohl E-Mail-Adresse als auch Telefonnummer angeben, wird die E-Mail-Adresse als primärer Bezeichner verwendet.PHONE– Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird bei Updates das zuletzt aktualisierte Profil priorisiert.
PAYLOAD– Dies ist ein JSON-String mit den Feldern, die Sie mit dem Nutzerprofil in Braze synchronisieren möchten.
Bei Attribut-Synchronisierungen folgt PAYLOAD dem Format des Nutzerattribut-Objekts. Sie können verschachtelte angepasste Attribute, Arrays von Objekten und Abo-Gruppenstatus einbeziehen. Payload-Beispiele finden Sie unter Tabelleneinrichtung.
Angepasste Events verwenden dieselbe Quelltabelle wie Nutzerattribute. Erstellen Sie die im Tab Nutzerattribute gezeigte Tabelle und befüllen Sie PAYLOAD anschließend mit einem Event-Objekt.
Zum Synchronisieren von Events ist ein Event-Name erforderlich. Formatieren Sie das Feld time als ISO-8601-String oder im Format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Ist das Feld time nicht vorhanden, verwendet Braze den Wert der Spalte UPDATED_AT als Event-Zeitpunkt. Andere Felder, darunter app_id und properties, sind optional.
Sie können ein Event pro Zeile synchronisieren.
{
"app_id" : "your-app-id",
"name" : "rented_movie",
"time" : "2013-07-16T19:20:45+01:00",
"properties": {
"movie": "The Sad Egg",
"director": "Alex Smith"
}
}
Kauf-Events verwenden dieselbe Quelltabelle wie Nutzerattribute. Erstellen Sie die im Tab Nutzerattribute gezeigte Tabelle und befüllen Sie PAYLOAD anschließend mit einem Kauf-Objekt.
Zum Synchronisieren von Kauf-Events sind product_id, currency und price erforderlich. Formatieren Sie das optionale Feld time als ISO-8601-String oder im Format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Ist das Feld time nicht vorhanden, verwendet Braze den Wert der Spalte UPDATED_AT als Event-Zeitpunkt. Andere Felder, darunter app_id, quantity und properties, sind optional.
Sie können ein Kauf-Event pro Zeile synchronisieren.
{
"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 }
]
}
}
Bevor Sie eine Katalog-Synchronisierung erstellen, legen Sie den Zielkatalog in Braze an. Den vollständigen Katalog-Workflow finden Sie unter Katalogdaten synchronisieren und löschen.
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
)
Gewähren Sie dem Braze-Nutzer zusammen mit Ihren anderen Quelltabellen Zugriff auf diese Tabelle:
GRANT SELECT ON TABLE CATALOGS_SYNC TO braze_user;
Der Name der Integration muss exakt mit dem Namen des Katalogs übereinstimmen, den Sie in Braze erstellt haben.
Braze empfiehlt, eine View aus Ihren Katalogdaten zu erstellen, damit die Quelltabelle bei jeder Synchronisierung vollständig aktualisiert wird. Wenn Sie beispielsweise eine Tabelle mit Produktdaten (product_catalog_1) mit product_id und drei weiteren Attributen haben, könnten Sie Folgendes synchronisieren:
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";
Bevor Sie eine Datenobjekt-Synchronisierung erstellen, legen Sie den Datenobjekttyp und seine Felder in Braze an. Den vollständigen Workflow finden Sie unter Datenobjekte synchronisieren.
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
)
| Feldname | Typ | Modus |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | REQUIRED |
DELETED |
boolean | NULLABLE |
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.OBJECT_ID– Der Bezeichner des Datenobjekt-Datensatzes. Dieser muss mit demobject_id-Wert übereinstimmen, der in Braze für diesen Datenobjekttyp verwendet wird.PAYLOAD– Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist.DELETED– Beitruelöscht Braze den Datensatz, anstatt ihn zu aktualisieren. Lassen Sie diesen Wert für Zeilen, die Sie erstellen oder aktualisieren möchten, leer (null) oder setzen Sie ihn auffalse.
Bei Feldnamen innerhalb von PAYLOAD wird zwischen Groß- und Kleinschreibung unterschieden. Ein Schlüssel namens NAME entspricht nicht einem Feld namens name. Wenn die Schreibweise nicht übereinstimmt, meldet die Validierung den Schlüssel als undefiniertes Feld und das Feld, das damit befüllt werden sollte, als fehlend. Benennen Sie Ihre Schlüssel genau so, wie die Felder unter Dateneinstellungen > Datenobjekte angezeigt werden.
Braze erstellt oder ändert während einer Synchronisierung keine Datenobjekttypen. Definieren Sie den Typ und alle seine Felder in Braze, bevor Sie die Synchronisierung erstellen. Wenn Sie später ein Feld hinzufügen möchten, fügen Sie es zuerst dem Typ hinzu und aktualisieren Sie anschließend Ihre Quelltabelle oder Abfrage.
Ein PAYLOAD-Wert für einen Account mit den Feldern name und team_id sieht beispielsweise so aus:
{"name": "Acme Corp", "team_id": 42}
Gewähren Sie dem Braze-Nutzer Zugriff auf diese Tabelle:
GRANT SELECT ON TABLE ACCOUNTS_SYNC TO braze_user;
Wählen Sie im Schritt Datendefinition den Datentyp Datenobjekte aus und wählen Sie dann Ihren Datenobjekttyp. Datenobjekt-Synchronisierungen unterstützen Tabelle und SQL.
Mit dieser Synchronisierung verknüpfen Sie Nutzer:innen mit Datenobjekt-Datensätzen, zum Beispiel mit den Accounts, zu denen sie gehören. Erstellen Sie die Beziehung in Braze, bevor Sie sie synchronisieren.
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
)
| Feldname | Typ | Modus |
|---|---|---|
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 |
Jede Zeile benötigt OBJECT_ID sowie mindestens einen Nutzer-Bezeichner: EXTERNAL_ID, die Kombination aus ALIAS_NAME und ALIAS_LABEL, EMAIL oder PHONE. Verwenden Sie PAYLOAD für alle Felder, die für die Beziehung selbst definiert sind.

BRAZE_ID wird im Gegensatz zu Synchronisierungen von Nutzerattributen bei Synchronisierungen von Nutzerbeziehungen nicht unterstützt. Verwenden Sie einen der zuvor aufgeführten Bezeichner.
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.OBJECT_ID– Der Bezeichner des Datenobjekt-Datensatzes. Dieser muss mit demobject_id-Wert übereinstimmen, der in Braze für diesen Datenobjekttyp verwendet wird.PAYLOAD– Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist.DELETED– Beitruelöscht Braze den Datensatz, anstatt ihn zu aktualisieren. Lassen Sie diesen Wert für Zeilen, die Sie erstellen oder aktualisieren möchten, leer (null) oder setzen Sie ihn auffalse.
Bei Feldnamen innerhalb von PAYLOAD wird zwischen Groß- und Kleinschreibung unterschieden. Ein Schlüssel namens NAME entspricht nicht einem Feld namens name. Wenn die Schreibweise nicht übereinstimmt, meldet die Validierung den Schlüssel als undefiniertes Feld und das Feld, das damit befüllt werden sollte, als fehlend. Benennen Sie Ihre Schlüssel genau so, wie die Felder unter Dateneinstellungen > Datenobjekte angezeigt werden.
Braze erstellt oder ändert während einer Synchronisierung keine Datenobjekttypen. Definieren Sie den Typ und alle seine Felder in Braze, bevor Sie die Synchronisierung erstellen. Wenn Sie später ein Feld hinzufügen möchten, fügen Sie es zuerst dem Typ hinzu und aktualisieren Sie anschließend Ihre Quelltabelle oder Abfrage.
Wählen Sie im Schritt Datendefinition den Datentyp Nutzerbeziehungen von Datenobjekten aus und wählen Sie dann einen Beziehungsnamen, zum Beispiel User (Account-User).
Mit dieser Synchronisierung verknüpfen Sie Datenobjekt-Datensätze miteinander, zum Beispiel Accounts mit ihren übergeordneten Accounts. Erstellen Sie die Beziehung in Braze, bevor Sie sie synchronisieren.
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
)
| Feldname | Typ | Modus |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
RELATED_OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | NULLABLE |
DELETED |
boolean | NULLABLE |
OBJECT_ID ist der Datensatz, von dem die Beziehung ausgeht, und RELATED_OBJECT_ID ist der Datensatz, auf den sie verweist. Beide sind in jeder Zeile erforderlich. Verwenden Sie PAYLOAD für alle Felder, die für die Beziehung selbst definiert sind.
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.OBJECT_ID– Der Bezeichner des Datenobjekt-Datensatzes. Dieser muss mit demobject_id-Wert übereinstimmen, der in Braze für diesen Datenobjekttyp verwendet wird.PAYLOAD– Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist.DELETED– Beitruelöscht Braze den Datensatz, anstatt ihn zu aktualisieren. Lassen Sie diesen Wert für Zeilen, die Sie erstellen oder aktualisieren möchten, leer (null) oder setzen Sie ihn auffalse.
Bei Feldnamen innerhalb von PAYLOAD wird zwischen Groß- und Kleinschreibung unterschieden. Ein Schlüssel namens NAME entspricht nicht einem Feld namens name. Wenn die Schreibweise nicht übereinstimmt, meldet die Validierung den Schlüssel als undefiniertes Feld und das Feld, das damit befüllt werden sollte, als fehlend. Benennen Sie Ihre Schlüssel genau so, wie die Felder unter Dateneinstellungen > Datenobjekte angezeigt werden.
Braze erstellt oder ändert während einer Synchronisierung keine Datenobjekttypen. Definieren Sie den Typ und alle seine Felder in Braze, bevor Sie die Synchronisierung erstellen. Wenn Sie später ein Feld hinzufügen möchten, fügen Sie es zuerst dem Typ hinzu und aktualisieren Sie anschließend Ihre Quelltabelle oder Abfrage.
Wählen Sie im Schritt Datendefinition den Datentyp Datenobjekt-Beziehungen aus und wählen Sie dann einen Beziehungsnamen, zum Beispiel Subaccount (Account-Account).
Canvas-Trigger ermöglichen Zero-Copy-Personalisierung. Informationen zur Einrichtung des Ziel-Canvas und zu wichtigen Hinweisen finden Sie unter Zero-Copy-Personalisierung.
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)
);
Canvas-Trigger-Synchronisierungen unterscheiden sich in drei Punkten von anderen Synchronisierungen von Nutzerdaten:
- Es werden nur externe IDs oder Nutzer-Aliase als Bezeichner unterstützt. E-Mail-Adressen und Telefonnummern werden als Bezeichner nicht unterstützt.
- Es können nur bestehende Braze-Nutzer:innen synchronisiert werden. Neue Nutzer:innen können nicht angelegt werden.
PROPERTIESersetzt die SpaltePAYLOAD. Dabei handelt es sich um einen JSON-String mit den Feldern, die Sie als Canvas-Entry-Eigenschaften für die Personalisierung verwenden möchten.
Ihre Canvas-Trigger-Tabelle benötigt die folgenden Spalten:
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile aktualisiert oder der Tabelle hinzugefügt wurde. Braze synchronisiert Zeilen, derenUPDATED_ATspäter als der zuletzt synchronisierte Wert liegt. Zeilen mit genau dem Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel haben.- Entweder
EXTERNAL_IDoderALIAS_NAMEundALIAS_LABELals Spalte für den Nutzer-Bezeichner. Diese identifizieren die Nutzer:innen, für die Sie Canvas-Messaging triggern möchten.EXTERNAL_ID– Identifiziert die Nutzer:innen, die in das Canvas eintreten sollen. Dieser Wert sollte mit dem in Braze verwendeten Wertexternal_idübereinstimmen.ALIAS_NAMEundALIAS_LABEL– Diese Spalten erstellen ein Nutzer-Alias-Objekt.alias_namesollte ein eindeutiger Bezeichner sein, undalias_labelgibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einenalias_nameproalias_label.
PROPERTIES– Ein JSON-String mit Feldern, die in Ihrem Canvas als Eigenschaften für die Personalisierung verfügbar sein sollen. Er sollte nutzerspezifische Informationen enthalten.

Eigenschaften sind nicht für jede Zeile oder jede:n Nutzer:in erforderlich. Die Werte der Eigenschaften müssen jedoch ein gültiger JSON-String sein. Geben Sie einen leeren String {} ein, wenn es für die Zeile keine Eigenschaften gibt.
Gewähren Sie dem Braze-Nutzer Zugriff auf diese Tabelle:
GRANT SELECT ON TABLE CANVAS_TRIGGERS_SYNC TO braze_user;
Wählen Sie zum Einstieg beim Erstellen einer neuen Synchronisierung den Datentyp Canvas-Trigger aus.
Quelltabellen für das Löschen von Nutzer:innen sollten einen oder mehrere Nutzer-Bezeichnertypen und einen UPDATED_AT-Zeitstempel enthalten. Payload-Spalten werden für Daten zum Löschen von Nutzer:innen nicht unterstützt.
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile aktualisiert oder der Tabelle hinzugefügt wurde. Braze synchronisiert Zeilen, derenUPDATED_ATnach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.- Spalten für Nutzer-Bezeichner – Jede Zeile sollte nur einen Bezeichner enthalten: entweder
external_id, die Kombination ausalias_nameundalias_labeloderbraze_id. Eine Quelltabelle kann Spalten für einen, zwei oder alle drei Bezeichnertypen enthalten.EXTERNAL_ID– Dieser Wert identifiziert die Nutzer:in, die Sie aktualisieren möchten. Er sollte dem in Braze verwendetenexternal_id-Wert entsprechen.ALIAS_NAMEundALIAS_LABEL– Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt.alias_namesollte ein eindeutiger Bezeichner sein, undalias_labelgibt den Typ des Alias an. Nutzer:innen können mehrere Aliasse mit unterschiedlichen Labels haben, aber nur einenalias_nameproalias_label.BRAZE_ID– Der Braze-Nutzer-Bezeichner. Er wird vom Braze SDK generiert. Über Cloud Data Ingestion können keine neuen Nutzer:innen mit einer Braze-ID erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.

Fügen Sie Ihrer Tabelle zum Entfernen von Nutzer:innen keine PAYLOAD-Spalte hinzu. Um ein versehentliches, dauerhaftes Entfernen von Nutzer:innen zu verhindern, schlägt eine Synchronisierung fehl, wenn die Quelltabelle eine Payload-Spalte enthält. Alle anderen Spalten sind zulässig, werden von Braze jedoch ignoriert.
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
);
Setzen Sie auf der Seite Import-Synchronisierung erstellen den Datentyp auf Nutzer:innen löschen, damit während der Ausführung der Integration die richtigen Aktionen durchgeführt werden. Weitere Informationen finden Sie unter Nutzer:innen mit Cloud Data Ingestion löschen.

Das Löschen von Nutzerprofilen kann nicht rückgängig gemacht werden. Die Löschaktion entfernt Nutzer:innen dauerhaft, was zu Abweichungen in Ihren Daten führen kann. Weitere Informationen finden Sie unter Auswirkungen des Löschens von Nutzerprofilen.
Schritt 2: Authentifizierung einrichten
Braze verbindet sich als Datenbank-Nutzer:in mit Redshift. Wählen Sie eine der folgenden Authentifizierungsmethoden, um diese:n Nutzer:in einzurichten:
| Methode | So authentifiziert Braze | Was Sie in Braze eingeben |
|---|---|---|
| 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 übernimmt eine AWS Identity and Access Management (IAM)-Rolle in Ihrem AWS-Konto und fordert temporäre Zugangsdaten für die Datenbank an. Braze speichert kein Datenbank-Passwort. Braze übernimmt die Rolle aus demselben AWS-Konto, das es auch für Amazon S3-Quellen verwendet.
Braze generiert eine externe ID für Ihren Workspace. Ihre Rolle verwendet diese ID, um zu bestätigen, dass eine Anfrage zur Übernahme der Rolle von Ihrem Braze-Workspace stammt.
Ihre bestehenden Zugangsdaten mit Nutzername und Passwort funktionieren weiterhin, sodass Sie sie nicht migrieren müssen.
Voraussetzungen
Sie benötigen die Berechtigung, IAM-Rollen und -Richtlinien in Ihrem AWS-Konto zu erstellen. Außerdem benötigen Sie die Berechtigung, CREATE USER- und GRANT-Anweisungen in Ihrer Redshift-Datenbank auszuführen.

Die Vertrauensrichtlinie Ihrer Rolle muss genau die externe ID aus dem Braze-Formular für Zugangsdaten verlangen. Wenn Sie Zugangsdaten testen oder speichern, versucht Braze, Ihre Rolle mit einer anderen externen ID zu übernehmen. Wenn AWS diesen Versuch zulässt, schlägt der Verbindungstest fehl. Das passiert, wenn die Rolle keine externe ID verlangt oder wenn sie ein Muster wie braze-cdi-* akzeptiert.
Braze-Konto-ID und externe ID kopieren
- Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud-Datenaufnahme > Quellen.
- Wählen Sie Datenquelle hinzufügen und dann Amazon Redshift aus.
- Wählen Sie als Authentifizierungsmethode IAM-Rolle aus.
- Kopieren Sie im Schritt AWS-Einrichtung die Braze-Konto-ID und die Externe ID. Lassen Sie das Formular geöffnet, da Sie im Abschnitt Werte in Braze eingeben dorthin zurückkehren.
IAM-Rolle erstellen
- Gehen Sie in der AWS-Konsole zu IAM > Roles und wählen Sie dann Create role aus.
- Wählen Sie AWS account als Typ der vertrauenswürdigen Entität und dann Another AWS account aus.
- Fügen Sie die Braze-Konto-ID ein. Wählen Sie Require external ID aus und fügen Sie dann die Externe ID ein.
- Überspringen Sie den Schritt für Berechtigungen. Geben Sie einen Rollennamen ein und wählen Sie dann Create role aus. Die Berechtigungsrichtlinie fügen Sie im Abschnitt Berechtigungsrichtlinie hinzufügen hinzu.
- Kopieren Sie den Amazon Resource Name (ARN) der Rolle. Sie geben ihn im Abschnitt Werte in Braze eingeben in Braze ein.
Die Vertrauensrichtlinie für die Rolle sieht wie im folgenden Beispiel aus. Ersetzen Sie BRAZE_ACCOUNT_ID und EXTERNAL_ID durch die Werte aus dem Formular für Zugangsdaten.
{
"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"
}
}
}
]
}
Berechtigungsrichtlinie hinzufügen
Fügen Sie der Rolle eine Inline-Berechtigungsrichtlinie hinzu. Wählen Sie auf dem Tab Permissions der Rolle Add permissions > Create inline policy aus und fügen Sie dann das JSON für Ihren Cluster-Typ aus den folgenden Tabs ein.
Für Redshift Serverless muss die Richtlinie redshift-serverless:GetCredentials für Ihre Workgroup erlauben. Verwenden Sie im Resource-Wert die Workgroup-ID, die sich vom Workgroup-Namen unterscheidet. Um die ID zu finden, öffnen Sie Ihre Workgroup in der Redshift-Konsole und kopieren Sie die ID aus dem Workgroup-ARN.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": "arn:aws:redshift-serverless:REGION:AWS_ACCOUNT_ID:workgroup/WORKGROUP_ID"
}
]
}
Ersetzen Sie REGION, AWS_ACCOUNT_ID und WORKGROUP_ID durch die Werte für Ihre Workgroup.
Für einen bereitgestellten Cluster muss die Richtlinie redshift:GetClusterCredentialsWithIAM für die Datenbank erlauben, aus der Sie synchronisieren.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift:GetClusterCredentialsWithIAM",
"Resource": "arn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME"
}
]
}
Ersetzen Sie REGION, AWS_ACCOUNT_ID, CLUSTER_IDENTIFIER und DATABASE_NAME durch die Werte für Ihren Cluster.
Datenbanknutzer erstellen und Zugriff gewähren
Braze meldet sich bei Redshift als Datenbanknutzer mit dem Namen IAMR:ROLE_NAME an, wobei ROLE_NAME der Name der von Ihnen erstellten IAM-Rolle ist. Dieser Nutzer unterscheidet sich von braze_user, daher gelten Berechtigungen, die Sie anderen Datenbanknutzern erteilt haben, nicht für ihn.
Bevor Sie die Verbindung in Braze testen, führen Sie die folgende Anweisung in Ihrer Redshift-Datenbank aus, um den Nutzer zu erstellen. Sie können die Anweisung bedenkenlos ausführen, bevor Braze zum ersten Mal eine Verbindung herstellt:
CREATE USER "IAMR:ROLE_NAME" PASSWORD DISABLE;
Gewähren Sie diesem Nutzer anschließend Zugriff auf Ihre Quelltabelle. Verwenden Sie dieselben GRANT-Anweisungen wie in Schritt 3: Berechtigungen für den Nutzer erteilen und ersetzen Sie braze_user durch "IAMR:ROLE_NAME". Behalten Sie die doppelten Anführungszeichen bei, da der Nutzername einen Doppelpunkt enthält.
Wenn Sie Redshift auch als verbundene Quelle verwenden, erteilen Sie diesem Nutzer dieselben Berechtigungen, die in diesem Abschnitt aufgeführt sind.
Werte in Braze eingeben
Kehren Sie zum Braze-Formular für Zugangsdaten zurück. Geben Sie im Schritt Braze-Einrichtung die folgenden Werte ein:
| Braze-Feld | Einzugebender Wert |
|---|---|
| Cluster-Typ | Serverless (Standard) oder Provisioned. |
| Rollen-ARN | Der ARN der von Ihnen erstellten Rolle im Format arn:aws:iam::123456789012:role/ROLE_NAME. |
| Region | Die AWS-Region, in der Ihr Redshift-Cluster oder Ihre Workgroup läuft, z. B. us-east-1. Sie kann sich von der Region Ihrer Braze-Instanz unterscheiden. |
| Workgroup-Name oder Cluster-Bezeichner | Für Serverless der Name Ihrer Workgroup. Für einen bereitgestellten Cluster der Bezeichner Ihres Clusters. |
| Host | Der Endpunkt Ihres Clusters oder Ihrer Workgroup. Für Serverless füllt Braze dieses Feld anhand von Rollen-ARN, Region und Workgroup-Name aus, und Sie können es bearbeiten. Für einen bereitgestellten Cluster geben Sie den Endpunkt ein. |
| Port | Der Port Ihres Clusters oder Ihrer Workgroup. Der Standardwert ist 5439. Geben Sie einen Wert von 1024 bis 65535 ein. |

Sie können diese Verbindungsdetails nach dem Speichern der Zugangsdaten nicht mehr ändern. Um eines davon zu ändern, erstellen Sie neue Zugangsdaten. Anschließend können Sie Ihre Quelle auf die neuen Zugangsdaten umstellen.
Die Authentifizierung per IAM-Rolle funktioniert mit oder ohne SSH-Tunnel. Für die Einrichtung von Tunnel und IP-Allowlist folgen Sie Schritt 4: Zugriff auf Braze-IPs erlauben, genau wie bei anderen Methoden. Nach dem Speichern können Sie die Zugangsdaten umbenennen. Wenn Sie einen Tunnel verwenden, können Sie außerdem den Tunnel-Schlüssel rotieren.
So testet Braze die Verbindung
Wenn Sie die Verbindung testen und jedes Mal, wenn Braze eine Verbindung herstellt, versucht Braze zunächst, Ihre Rolle mit einer externen Test-ID zu übernehmen, die zu keinem Workspace gehört: braze-cdi-000000000000000000000000. Ihre Rolle muss diesen Versuch mit einem AccessDenied-Fehler ablehnen. Wenn AWS ihn zulässt, schlägt der Verbindungstest fehl. Hilfe finden Sie unter Ihre IAM-Rolle verlangt ihre externe ID nicht.
AWS CloudTrail zeigt diese Versuche als AssumeRole-Aufrufe mit dem Sitzungsnamen Braze-CDI-Redshift an. Der abgelehnte Versuch ist zu erwarten und gewährt Braze keinen Zugriff auf Ihre Daten. Fügen Sie keine Bedingung hinzu, die nur diese externe ID ablehnt, da Ihre Rolle sonst weiterhin anderen Braze-Workspaces vertrauen würde.
Braze-Zugriff entfernen
Um Braze den Zugriff auf Ihre Daten zu entziehen, löschen Sie die Rolle oder entfernen Sie die Vertrauensanweisung für das Braze-Konto aus der Vertrauensrichtlinie der Rolle. Sie können auch den Datenbanknutzer IAMR:ROLE_NAME löschen.
Einrichtung mit der AWS CLI
Alternativ können Sie die AWS Command Line Interface (CLI) verwenden, um die Rolle zu erstellen und die Berechtigungsrichtlinie anzuhängen. Dieses Beispiel verwendet eine Serverless-Workgroup. Für einen bereitgestellten Cluster ersetzen Sie das Richtliniendokument durch die Richtlinie aus dem Tab Provisioned im Abschnitt Berechtigungsrichtlinie hinzufügen.
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"
}]
}'
Ersetzen Sie die folgenden Platzhalter:
BRAZE_ACCOUNT_IDundEXTERNAL_ID: Die Werte aus dem Formular für ZugangsdatenREGION,AWS_ACCOUNT_IDundWORKGROUP_ID: Die Werte für Ihre Workgroup
Der Befehl create-role gibt den Rollen-ARN in seiner Ausgabe zurück. Details finden Sie unter create-role in der AWS CLI Command Reference. Kopieren Sie den ARN und fahren Sie dann mit Datenbanknutzer erstellen und Zugriff gewähren fort.
Username and password
Braze verbindet sich mit Redshift als Datenbanknutzer:in mit Passwort. Erstellen Sie eine:n Nutzer:in für Braze:
CREATE USER braze_user PASSWORD '{password}';
Bewahren Sie Nutzernamen und Passwort an einem sicheren Ort auf, bis Sie diese beim Erstellen der Quelle im Braze-Dashboard eingeben müssen.
Schritt 3: Berechtigungen für den Nutzer erteilen
Erteilen Sie dem Datenbanknutzer, mit dem sich Braze verbindet, Zugriff auf Ihre Quelltabelle. Im folgenden Beispiel wird braze_user verwendet. Wenn Sie die Authentifizierung über eine IAM-Rolle verwenden, ersetzen Sie braze_user durch "IAMR:ROLE_NAME". Weitere Informationen finden Sie unter Datenbanknutzer erstellen und Zugriff erteilen.
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;
Dies sind die minimal erforderlichen Berechtigungen für diesen Nutzer. Wenn Sie mehrere CDI-Integrationen erstellen, sollten Sie Berechtigungen für ein Schema erteilen oder Berechtigungen über eine Gruppe verwalten.
Schritt 4: Zugriff für Braze-IPs zulassen
Wenn Sie eine Firewall oder andere Netzwerkrichtlinien einsetzen, müssen Sie Braze Netzwerkzugriff auf Ihre Redshift-Instanz gewähren. Ein Beispiel für den Redshift-URL-Endpunkt ist „example-cluster.ap-northeast-2.redshift.amazonaws.com“.
Einige wichtige Hinweise:
- Möglicherweise müssen Sie auch Ihre Sicherheitsgruppen anpassen, damit Braze auf Ihre Daten in Redshift zugreifen kann.
- Erlauben Sie eingehenden Datenverkehr explizit für die IPs in der Tabelle und für den Port, über den Ihr Redshift-Cluster abgefragt wird (standardmäßig 5439). Sie sollten die Redshift-TCP-Konnektivität auf diesem Port explizit zulassen, auch wenn die eingehenden Regeln auf „alle zulassen“ gesetzt sind.
- Der Endpunkt des Redshift-Clusters muss öffentlich zugänglich sein, damit Braze sich mit Ihrem Cluster verbinden kann.
- Wenn Ihr Redshift-Cluster nicht öffentlich zugänglich sein soll, können Sie eine VPC und eine EC2-Instanz einrichten, um über einen SSH-Tunnel auf die Redshift-Daten zuzugreifen. Weitere Informationen finden Sie im Beitrag im AWS Knowledge Center.
Erlauben Sie den Zugriff von den folgenden IPs, die der Region Ihres Braze-Dashboards entsprechen.
Für die Instanzen US-01, US-02, US-03, US-04, US-05, US-06, US-07 sind dies die relevanten IP-Adressen:
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
Für die Instanz US-08 sind dies die relevanten IP-Adressen:
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
Für die Instanz US-10 sind dies die relevanten IP-Adressen:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Für die Instanzen EU-01 und EU-02 sind dies die relevanten IP-Adressen:
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
Für die Instanz AU-01 sind dies die relevanten IP-Adressen:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Für die Instanz ID-01 sind dies die relevanten IP-Adressen:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Für die Instanz JP-01 sind dies die relevanten IP-Adressen:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Für die Instanz KR-01 sind dies die relevanten IP-Adressen:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Schritt 5: Neue Quelle im Braze-Dashboard erstellen
Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud-Datenaufnahme > Quellen, wählen Sie Datenquelle hinzufügen und dann Amazon Redshift aus.
Schritt 5.1: Redshift-Verbindungsinformationen und Quelltabelle hinzufügen
Wählen Sie einen Namen für Ihre Quelle und geben Sie Ihre Redshift-Zugangsdaten und -Konfiguration ein. Wählen Sie die Authentifizierungsmethode aus, die Sie in Schritt 2 eingerichtet haben, und geben Sie die zugehörigen Zugangsdaten ein:
- IAM role: Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier
- Username and password: Username and Password
Wenn Sie einen privaten Netzwerktunnel verwenden, aktivieren Sie den Schieberegler und geben Sie die Tunnelinformationen ein. Fahren Sie dann mit dem nächsten Schritt fort.

Im Braze-Dashboard akzeptiert das Feld Datenbankname nur Buchstaben (A–Z, a–z), Ziffern (0–9) und Unterstriche (_), obwohl Amazon Redshift weitere Zeichen in Datenbank-Bezeichnern unterstützt.
Schritt 5.2: Verbindung testen und mit der Quelle verbinden
Wählen Sie als Nächstes Verbindung testen aus. Wenn der Test erfolgreich ist, schließen Sie die übrigen Einstellungen ab und klicken Sie auf Mit Quelle verbinden. Schlägt die Verbindung fehl, wird eine Fehlermeldung angezeigt, die Ihnen bei der Fehlerbehebung hilft.
Schritt 6: Neue Synchronisierung im Braze-Dashboard erstellen
Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Synchronisierungen und wählen Sie Datensynchronisierung erstellen.
Synchronisierungsdetails konfigurieren und Daten definieren
Geben Sie einen Namen für Ihre Synchronisierung ein. Wählen Sie dann eine aktive Quelle und einen Datentyp für die Synchronisierung aus. Wählen Sie anschließend einen Synchronisierungsmodus und definieren Sie Ihre Daten. Wählen Sie dann Vorschau und validieren.
Nach erfolgreicher Validierung erscheint eine Vorschau der Daten. Wählen Sie Weiter: Benachrichtigungen, um fortzufahren. Wenn die Validierung fehlschlägt, erscheint eine Fehlermeldung, die Ihnen bei der Fehlerbehebung hilft.

Sie müssen eine Synchronisierung erfolgreich validieren, bevor Sie mit den nächsten Schritten fortfahren können. Wenn Sie die Seite zur Erstellung der Synchronisierung schließen müssen, wählen Sie Als Entwurf speichern, damit Ihr aktueller Arbeitsstand erhalten bleibt.
Benachrichtigungseinstellungen hinzufügen
Geben Sie eine oder mehrere Kontakt-E-Mail-Adressen für Benachrichtigungen über Synchronisierungsfehler ein. Braze verwendet diese Kontaktinformationen, um Benachrichtigungen über Integrationsfehler zu versenden, etwa bei einem unerwarteten Verlust des Tabellenzugriffs.
Kontakt-E-Mail-Adressen erhalten nur Benachrichtigungen über globale Fehler oder Fehler auf Synchronisierungsebene, etwa fehlende Tabellen, fehlende Berechtigungen und Ähnliches. Probleme auf Zeilenebene werden nicht gemeldet. Globale Fehler weisen auf kritische Probleme mit der Verbindung hin, die die Ausführung von Synchronisierungen verhindern.
Zu solchen Problemen gehören unter anderem:
- Verbindungsprobleme
- Fehlende Ressourcen
- Probleme mit Berechtigungen
- Kein freier Speicherplatz in der Katalogstufe (nur Katalog-Synchronisierungen)
Zeitplan festlegen
Konfigurieren Sie Ihre Synchronisierung abschließend als einmalig oder wiederkehrend.
Einmalige Synchronisierungen werden nur ausgeführt, wenn Sie im Dashboard Jetzt synchronisieren auswählen oder den Endpunkt Synchronisierung triggern aufrufen.
Wiederkehrende Synchronisierungen lassen sich in Intervallen von 5 Minuten bis zu einem Monat ausführen. Standardmäßig beträgt das kürzeste Intervall, das Sie im Dashboard festlegen können, 15 Minuten. So lassen sich die Rechenkosten Ihres Data Warehouse und das Anfragevolumen besser steuern. Wenn Sie in Abständen von nur 5 Minuten synchronisieren möchten, wenden Sie sich an den Braze-Support oder Ihren Customer-Success-Manager. Braze plant wiederkehrende Synchronisierungen in UTC.

Sie müssen eine Integration erfolgreich validieren, bevor sie vom Status „Entwurf“ in den Status „Aktiv“ wechseln kann. Wenn Sie die Erstellungsseite schließen, wird Ihre Integration gespeichert. Sie können dann die Detailseite erneut aufrufen, um Änderungen vorzunehmen und die Integration zu validieren.
Synchronisierung ausführen
Nach der Aktivierung läuft Ihre Synchronisierung nach dem Zeitplan, den Sie bei der Einrichtung festgelegt haben. Wenn Sie die Synchronisierung außerhalb des Zeitplans ausführen oder die neuesten Daten abrufen möchten, wählen Sie Jetzt synchronisieren. Dieser Durchlauf hat keine Auswirkungen auf zukünftige, regulär geplante Synchronisierungen. Um eine Synchronisierung automatisch zu starten, sobald Ihre Daten aktualisiert werden, rufen Sie den Endpunkt Synchronisierung triggern aus Ihrer Pipeline auf.
Zusätzliche Integrationen oder Nutzer:innen einrichten (optional)
Sie können mehrere Integrationen mit Braze einrichten. Wenn Sie zusätzliche Synchronisierungen erstellen, können Sie vorhandene Zugangsdaten wiederverwenden, sofern Sie sich mit demselben Redshift-Konto verbinden.
Wenn Sie denselben Nutzer bzw. dieselbe Nutzerin für mehrere Integrationen verwenden, können Sie diese:n im Braze-Dashboard erst löschen, nachdem er bzw. sie aus allen aktiven Synchronisierungen entfernt wurde.
Redshift als verbundene Quelle verwenden
Eine verbundene Quelle ist eine Zero-Copy-Alternative zur Synchronisierung von Daten mit Braze. Braze fragt Ihre Redshift-Instanz direkt ab, um CDI-Segmente zu erstellen, ohne die zugrunde liegenden Daten zu kopieren. Konzepte, Einschränkungen und Kostenauswirkungen finden Sie unter Verbundene Quellen.
Schritt 1: Nutzer:in erstellen und Berechtigungen erteilen
Wählen Sie eine der Methoden aus Schritt 2: Authentifizierung einrichten für Braze. Erteilen Sie anschließend dem Braze-Datenbanknutzer die folgenden Berechtigungen. Im Beispiel wird braze_user verwendet. Wenn Sie die Authentifizierung über eine IAM-Rolle verwenden, ersetzen Sie braze_user durch "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;
Erstellen Sie einen Nutzer für Ihre verbundene Quelle. Mit diesem Nutzer wird die Liste der in Ihren CDI-Segmenterweiterungen verfügbaren Tabellen erstellt, und es werden Quelltabellen abgefragt, um neue Segmente zu erstellen. Nachdem die verbundene Quelle erstellt wurde, ermittelt Braze die Namen und Beschreibungen aller Tabellen, die dem Nutzer im Quellschema zur Verfügung stehen. Wenn Sie mehrere CDI-Integrationen erstellen, empfiehlt es sich, Berechtigungen für ein Schema zu erteilen oder Berechtigungen über eine Gruppe zu verwalten.
Sie können Zugriff auf alle Tabellen in einem Schema gewähren oder Berechtigungen nur für bestimmte Tabellen erteilen. Alle Tabellen, auf die die Braze-Rolle Zugriff hat, stehen in der CDI-Segmenterweiterung für Abfragen zur Verfügung. Achten Sie darauf, dem Nutzer Zugriff auf neue Tabellen zu gewähren, sobald diese erstellt werden, oder legen Sie Standardberechtigungen für den Nutzer fest.
Die Berechtigung create table ist erforderlich, damit Braze eine Tabelle mit den Abfrageergebnissen Ihrer CDI-Segmenterweiterung erstellen kann, bevor das Segment in Braze aktualisiert wird. Braze erstellt pro Segment eine temporäre Tabelle, die nur so lange bestehen bleibt, wie Braze das Segment aktualisiert.
Die Einrichtung des Netzwerkzugriffs entspricht Schritt 4.
Schritt 2: Verbundene Quelle in Braze erstellen
Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Verbundene Quellen, wählen Sie Datenquelle hinzufügen und dann Amazon Redshift aus.
Geben Sie unter Quelle einrichten Folgendes ein:
- Zugangsdaten: Redshift-Host-URL, Port und die Felder für Ihre Authentifizierungsmethode. Geben Sie für IAM role Folgendes ein: Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier. Geben Sie für Username and password Folgendes ein: Username and Password.
- Konfiguration: Datenbank und Schema
Aktivieren Sie bei Bedarf Mit SSH-Tunnel verbinden und geben Sie Tunnel-Host, Tunnel-Port und Tunnel-Nutzername ein.
Wählen Sie einen Namen für die verbundene Quelle. Dieser Name wird in der Liste der verfügbaren Quellen angezeigt, wenn Sie eine neue CDI-Segmenterweiterung erstellen.
Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht automatisch alle Abfragen ab, die die maximale Laufzeit überschreiten. Die maximal zulässige Laufzeit beträgt 60 Minuten. Eine kürzere Laufzeit senkt die Kosten, die in Ihrem Redshift-Konto anfallen. Diese Einstellung gilt für Abfragen, die über diese Quelle ausgeführt werden, einschließlich Synchronisierungen und CDI-Segmenterweiterungen, die diese Quelle verwenden.
Schritt 3: Redshift-Konfiguration abschließen
Wenn bei Ihren Zugangsdaten Mit SSH-Tunnel verbinden ausgewählt ist, notieren Sie sich den öffentlichen RSA-Schlüssel im Schritt Verbindung testen und fügen Sie ihn dem SSH-Tunnel-Nutzer hinzu.
Nachdem Sie den Schlüssel dem Nutzer hinzugefügt haben, wählen Sie in Braze Verbindung testen und dann Fertig aus. Ihre verbundene Quelle ist jetzt erstellt und kann in CDI-Segmenterweiterungen verwendet werden.
Sie können mehrere verbundene Quellen mit Braze einrichten, aber jede Quelle sollte so konfiguriert werden, dass sie eine Verbindung zu einem anderen Schema herstellt. Wenn Sie weitere Quellen erstellen, können Sie vorhandene Zugangsdaten wiederverwenden, sofern Sie eine Verbindung zum selben Redshift-Konto herstellen.
Payload aus vorhandenen Spalten formatieren
Wenn Sie jedes Attribut intern lieber in einer eigenen Spalte speichern, müssen Sie diese Spalten in einen JSON-String umwandeln, um die Synchronisierung mit Braze zu befüllen. Verwenden Sie diese Abfrage in Redshift, um Quellspalten in CDI-Felder zu formatieren.
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";
Weitere Hinweise zur Optimierung finden Sie unter Best Practices für Cloud Data Ingestion.
Fehlerbehebung
Test Connection läuft langsam
Test Connection läuft in Ihrem Data Warehouse. Wenn Sie die Kapazität des Warehouse erhöhen, kann sich die Geschwindigkeit verbessern. Eine serverlose SQL-Instanz minimiert die Aufwärmzeit und verbessert den Abfragedurchsatz, kann aber zu etwas höheren Integrationskosten führen.
Permission denied for relation {table_name}
Wenn Sie diesen Fehler erhalten:
- Erteilen Sie dem betreffenden Nutzer die Berechtigung
usagefür das Schema. - Erteilen Sie dem betreffenden Nutzer die Berechtigung
selectfür die Tabelle.
Ihre IAM-Rolle erfordert ihre externe ID nicht
Wenn Sie die Authentifizierung über eine IAM-Rolle verwenden, kann der Verbindungstest mit folgendem Fehler fehlschlagen:
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.
Dieser Fehler bedeutet, dass AWS die externe Test-ID zugelassen hat, die unter So testet Braze die Verbindung beschrieben ist. Um das Problem zu beheben, aktualisieren Sie die Vertrauensrichtlinie Ihrer Rolle:
- Öffnen Sie in der AWS-Konsole die Rolle und wählen Sie den Tab Vertrauensstellungen aus.
- Fügen Sie jeder Anweisung, die dem Braze-Konto die Übernahme der Rolle erlaubt, eine
StringEquals-Bedingung fürsts:ExternalIdhinzu, die genau die externe ID aus dem Formular für die Zugangsdaten verwendet. Entfernen Sie alle Musterbedingungen wiebraze-cdi-*. - Testen Sie die Verbindung in Braze erneut.
Braze konnte nicht bestätigen, dass Ihre Rolle ihre externe ID erfordert
Wenn Sie die Authentifizierung über eine IAM-Rolle verwenden, kann der Verbindungstest mit folgendem Fehler fehlschlagen:
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 konnte die Prüfung nicht abschließen. Dieser Fehler bedeutet also nicht, dass Ihre Rolle zu weit gefasst ist. Testen Sie die Verbindung erneut. Wenn der Fehler weiterhin auftritt, wenden Sie sich an den Braze-Support.
IAM-Rolle kann nicht übernommen werden
Wenn Sie die Authentifizierung über eine IAM-Rolle verwenden und der Verbindungstest mit einem Fehler fehlschlägt, der mit „Unable to assume IAM role“ beginnt, überprüfen Sie Folgendes:
- Die Vertrauensrichtlinie der Rolle führt die Braze-Konto-ID aus dem Formular für die Zugangsdaten als vertrauenswürdigen Prinzipal auf.
- Die Vertrauensrichtlinie der Rolle erfordert genau die externe ID aus dem Formular für die Zugangsdaten.
- Der Rollen-ARN, den Sie in Braze eingegeben haben, stimmt mit dem ARN der von Ihnen erstellten Rolle überein.
- Wenn sich Ihre Braze-Instanz in einer AWS-Region befindet, die nicht standardmäßig aktiviert ist, z. B. Jakarta (ID-01), ist diese Region in Ihrem AWS-Konto aktiviert.
AWS gibt für alle diese Ursachen denselben AccessDenied-Fehler zurück. Überprüfen Sie daher jeden Punkt.
Redshift-Datenbank-Zugangsdaten können nicht abgerufen werden
Wenn Sie die Authentifizierung über eine IAM-Rolle verwenden und der Verbindungstest mit einem Fehler fehlschlägt, der mit „Unable to get Redshift database credentials as IAM role“ beginnt, überprüfen Sie Folgendes:
- Die Berechtigungsrichtlinie der Rolle erlaubt
redshift-serverless:GetCredentialsfür Serverless oderredshift:GetClusterCredentialsWithIAMfür einen bereitgestellten Cluster. - Bei Serverless verwendet der
Resource-Wert der Richtlinie die Workgroup-ID, die sich vom Workgroup-Namen unterscheidet. - Bei einem bereitgestellten Cluster ist der
Resource-Wert der Richtlinie derdbname-ARN für Ihren Cluster und Ihre Datenbank im Formatarn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME. - Die Werte für Region, Workgroup-Name oder Cluster-Bezeichner, die Sie in Braze eingegeben haben, stimmen mit Ihrem Cluster oder Ihrer Workgroup überein.
Berechtigung nach erfolgreichem Verbindungstest verweigert
Wenn der Verbindungstest erfolgreich ist, eine Synchronisierung oder Validierung aber einen Fehler wegen verweigerter Berechtigung zurückgibt, haben Sie den Zugriff wahrscheinlich einer anderen Nutzer:in gewährt, z. B. braze_user. Bei der Authentifizierung über eine IAM-Rolle meldet sich Braze als "IAMR:ROLE_NAME" an. Gewähren Sie dieser Nutzer:in die Berechtigungen für Schema und Tabellen. Weitere Informationen finden Sie unter Datenbanknutzer:in erstellen und Zugriff gewähren.
Create Connection Error
Wenn Sie diesen Fehler erhalten, überprüfen Sie, ob Redshift-Endpunkt und Port korrekt sind.
Create SSH Tunnel Error
Wenn Sie diesen Fehler erhalten:
- Überprüfen Sie, ob sich der Public Key aus Ihrem Braze-Dashboard auf dem EC2-Host befindet, den Sie für das SSH-Tunneling verwenden.
- Überprüfen Sie, ob Ihr Nutzername korrekt ist.
- Überprüfen Sie, ob der SSH-Tunnel korrekt ist.
Ungültiger Snapshot-Bezeichner
Wenn Braze während Test connection oder bei der Einrichtung der Synchronisierung den Fehler Invalid snapshot identifier zurückgibt, kann Redshift die Snapshot-Referenz nicht auflösen, die bei der Abfrage Ihres Quellobjekts verwendet wird.
In Redshift ist ein Snapshot eine zeitpunktbezogene Sicherung eines Clusters. Jeder Snapshot hat einen eindeutigen Bezeichner, über den Redshift auf diesen Sicherungsstand verweist. Weitere Informationen finden Sie unter Amazon Redshift-Snapshots und -Sicherungen.
Dieser Fehler kann auftreten, wenn sich Metadaten ändern, während Braze das Quellobjekt validiert, etwa beim Kopieren oder Wiederherstellen von Snapshots oder bei Replikationsvorgängen. Weitere Informationen finden Sie unter Kopieren von Snapshots in eine andere AWS-Region und Wiederherstellen eines Clusters aus einem Snapshot.
So beheben Sie den Fehler:
- Überprüfen Sie die Quelleinstellungen in Braze, einschließlich Cluster-Endpunkt, Datenbank, Schema und Objektname.
- Führen Sie dieselbe Abfrage direkt in Redshift aus, um sicherzustellen, dass die Tabelle oder View lesbar und stabil ist.
- Versuchen Sie es erneut, nachdem laufende Snapshot-, Wiederherstellungs-, Größenänderungs- oder Replikationsvorgänge abgeschlossen sind.
- Wenn das Problem weiterhin besteht, fragen Sie statt einer sich häufig ändernden Basistabelle eine Materialized View ab.
Eine Materialized View speichert vorberechnete Abfrageergebnisse, die Sie nach einem Zeitplan aktualisieren können. Dadurch werden Lesevorgänge für CDI-Synchronisierungen oft stabiler. Weitere Informationen finden Sie unter Materialized Views in Amazon Redshift.
Beispiel:
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;
Nachdem Sie die Materialized View erstellt haben, verwenden Sie deren Namen anstelle der Basistabelle als Quellobjekt in Ihrer Braze CDI-Synchronisierung.
Wo Sie SQL-Prüfungen ausführen
Führen Sie Validierungsprüfungen direkt im Redshift SQL-Editor aus, und zwar für dieselbe Tabelle oder View, die Ihre CDI-Integration verwendet. Verwenden Sie Query Editor v2. Weitere Informationen finden Sie unter Verwenden von Amazon Redshift Query Editor v2.
Verwandte Seiten
- Tabellen-Setup für erforderliche Spalten und die Formatierung von Payloads
- Best Practices für die Planung von Synchronisierungen und eine effiziente Nutzung von Datenpunkten
- Synchronisierungsprotokolle und Beobachtbarkeit für das Monitoring von Synchronisierungsläufen
- FAQ für häufige Fragen zu allen Quellen