Klaviyo und Redshift verbinden
Advanced Klaviyo Data Platform ist nicht in der Standard-Marketing-Anwendung von Klaviyo enthalten, und für den Zugriff auf die zugehörigen Funktionen ist ein Abonnement erforderlich. In unserem Abrechnungsleitfaden erfährst du, wie du diesen Plan kaufen kannst.

Übersicht
Dieser Leitfaden führt Redshift-Administrator*innen durch die Vorbereitung von Amazon Redshift für Klaviyo, die Vergabe der minimal erforderlichen Zugriffsrechte und das Abschließen der Verbindung, sodass Profildaten nach Zeitplan importiert werden können. Du lernst, wie du:
- Die
KLAVIYO_TMP- undKLAVIYO_IMPORT_FROM_DWH-Schemas erstellen - Erstelle eine*n dedizierte*n Service-User*in für Klaviyo
- Least-Privilege-Berechtigungen vergeben
- (Optional) Überprüfe die Datenbankberechtigungen
- Verbinde Redshift mit Klaviyo und erstelle eine geplante Profil-Synchronisierung
Für Hintergrundinformationen dazu, wie der Data-Warehouse-Import funktioniert – einschließlich unterstützter Objekte und Best Practices für die Tabellenstruktur – siehe Data-Warehouse-Import in Klaviyo verstehen.
Erforderliche Schemas erstellen
Erstelle 2 Schemas in der Redshift-Datenbank, die du für Klaviyo verwenden wirst:
-- Run as a Redshift DB admin or a role with CREATE SCHEMA
CREATE SCHEMA IF NOT EXISTS klaviyo_import_from_dwh;
CREATE SCHEMA IF NOT EXISTS klaviyo_tmp;KLAVIYO_IMPORT_FROM_DWH– Platziere hier deine finalen, synchronisationsbereiten Tabellen oder Views. Während der Einrichtung listet Klaviyo Objekte in diesem Schema auf, aus denen du auswählen kannst. Nimm daher nur die Tabellen auf, die du importieren möchtest.KLAVIYO_TMP– Wird ausschließlich von Klaviyo für temporäre/Staging-Tabellen während Sync-Jobs verwendet. Ändere die Daten hier nicht – Klaviyo verwaltet und bereinigt dieses Schema automatisch.
Erstelle den Klaviyo Service-Benutzer
Erstelle für Klaviyo einen dedizierten Datenbankbenutzer mit einem starken Passwort, das du unabhängig rotieren kannst.
-- Replace with your own names and a strong password
CREATE USER klaviyo_data_transfer_user WITH PASSWORD 'REPLACE_WITH_STRONG_PASSWORD';Erstelle eine Rolle, um Berechtigungen für die Service-Nutzer*in zu verwalten:
CREATE ROLE klaviyo_data_transfer_role;
GRANT ROLE klaviyo_data_transfer_role TO klaviyo_data_transfer_user;Benutzername und Passwort sicher speichern – sie werden beim Verbinden von Klaviyo mit Redshift benötigt.
Erforderliche Berechtigungen erteilen (Least Privilege)
Führe diese Anweisungen als Redshift-Administrator in der Datenbank aus, die du vorbereitet hast. Diese Berechtigungen gelten für vorhandene Tabellen und Views. Gewähre Zugriff auf neue Quelltabellen oder Views, bevor du sie zu einer Synchronisierung hinzufügst.
-- 1) Permissions on the staging schema Klaviyo manages
GRANT USAGE ON SCHEMA klaviyo_tmp TO ROLE klaviyo_data_transfer_role;
GRANT CREATE ON SCHEMA klaviyo_tmp TO ROLE klaviyo_data_transfer_role;
-- 2) Read-only access to existing tables and views in your import schema
GRANT USAGE ON SCHEMA klaviyo_import_from_dwh TO ROLE klaviyo_data_transfer_role;
GRANT SELECT ON ALL TABLES IN SCHEMA klaviyo_import_from_dwh TO ROLE klaviyo_data_transfer_role;
-- Remember to grant access to new tables and views in the future
-- Alternatively, grant SELECT on each specific source table or view:
-- GRANT SELECT ON TABLE klaviyo_import_from_dwh.example_view_name TO ROLE klaviyo_data_transfer_role;(Optional) Einrichtung überprüfen
Stelle eine Verbindung mit der Datenbank her, die du als Klaviyo Service-Benutzer*in vorbereitet hast, und führe dann diese Prüfungen aus. Ersetze EXAMPLE_TABLE durch eine Quelltabelle oder Ansicht, die du synchronisieren möchtest. Diese Prüfungen ersetzen nicht den Schritt Verbindung testen in Klaviyo.
-- 1) Validate create/read access in KLAVIYO_TMP
-- Use a new test table name if klaviyo_permission_check already exists
CREATE TABLE klaviyo_tmp.klaviyo_permission_check (id INT);
INSERT INTO klaviyo_tmp.klaviyo_permission_check VALUES (1);
SELECT COUNT(*) FROM klaviyo_tmp.klaviyo_permission_check; -- expect 1
DROP TABLE klaviyo_tmp.klaviyo_permission_check;
-- 2) Confirm visibility of source tables and views
SELECT DISTINCT table_name FROM information_schema.columns
WHERE table_schema = 'klaviyo_import_from_dwh'
ORDER BY table_name
LIMIT 25;
-- 3) Confirm SELECT on a source table or view
SELECT * FROM klaviyo_import_from_dwh.EXAMPLE_TABLE LIMIT 1;Netzwerkzugriff
Klaviyo muss deinen Redshift-Endpunkt erreichen können.
- Öffentlicher Redshift-Endpunkt: Whitelist der allgemeingültigen IPs von Klaviyo in deiner Firewall oder Sicherheitsgruppe.
- Privater Endpunkt (z. B. PrivateLink): Konnektivität über deinen internen Netzwerkpfad und deine Sicherheitsrichtlinien sicherstellen.
Wenn Sicherheitsgruppen verwendet werden, eingehenden Zugriff auf den Redshift-Port (Standard: 5439) für Klaviyo’s IP-Bereiche zulassen:
184.72.183.187/32
52.206.71.52/32
3.227.146.32/32
44.198.39.11/32
35.172.58.121/32
3.228.37.244/32
54.88.219.8/32
3.214.211.176/32Bereite deine Importtabellen vor (Struktur und Performance)
Stelle sicher, dass alle Tabellen, die du importieren möchtest, diese Konventionen befolgen, um genaue, effiziente inkrementelle Synchronisierungen zu gewährleisten:
- Zeitstempelspalte: Füge einen Zeitstempel für die Erstellung oder das letzte Update pro Zeile hinzu (z. B.
inserted_at,updated_at,modified_at). Verwende eineTIMESTAMP- oderTIMESTAMPTZ-Spalte mit einem Wert für jede Zeile. Text- und DATE-Spalten stehen für die Änderungserkennung nicht zur Verfügung. - Monotone Updates: Der Zeitstempel sollte jedes Mal steigen, wenn sich eine Zeile ändert.
- Zeitzone: UTC verwenden oder Zeitzoneninformationen angeben. Wenn diese fehlen, geht Klaviyo von UTC aus.
- Konsistente Kennungen: Füge mindestens 1 Profilkennung (
email,phone,external_idusw.) hinzu. Verwende konsistente Kennungen in allen Importtabellen, um doppelte Profile zu vermeiden. - Einwilligungsformate: Befolge beim Synchronisieren von Einwilligungsdaten dieselben gültigen Werte/Formate wie bei Datei- oder SFTP-Uploads.
- Performance: Ziehe einen Sortierschlüssel für deine Timestamp-Spalte in Betracht, um effiziente inkrementelle Lesevorgänge zu ermöglichen.
- Views: Du kannst aus Tabellen oder Views importieren, solange eine einfache
SELECTfür die*den Klaviyo-Benutzer*in funktioniert.
Verbinde Redshift und erstelle eine Profilsynchronisierung
- Navigiere in Klaviyo zu Erweitert > Datenmanagement > Synchronisierung.
- Wenn du bereits eine Verbindung konfiguriert hast, klicke auf Sync erstellen. Wenn dies deine erste Verbindung ist, fahre mit dem nächsten Schritt fort.
- Wähle Daten aus deinem Data Warehouse importieren aus.
- Wähle Amazon Redshift.
- Klicke auf Mit Redshift verbinden und gib die folgenden Verbindungsdetails ein:
Feld | Beschreibung |
|---|---|
Name | Gib einen Namen ein, z. B. den Namen deiner Redshift-Datenbank. |
Host-URL | Dein Redshift-Endpunkt (z. B. |
Port | 5439 (oder dein benutzerdefinierter Port) |
Datenbank | Die Datenbank mit |
Benutzername/Passwort | Die Anmeldedaten für den Klaviyo Service-User |
- Klicke auf Weiter, um Verbindung testen zu öffnen, und klicke dann auf Testen. Klaviyo überprüft deine Verbindung, erforderliche Schemas und Staging-Berechtigungen und listet dann zugängliche Tabellen und Ansichten in
klaviyo_import_from_dwhauf. Mindestens 1 Quelle muss verfügbar sein, um fortzufahren. Nachdem der Test erfolgreich ist und eine Quelle verfügbar ist, klicke auf Weiter. - Gib in Name einen eindeutigen Synchronisierungsnamen ein, wähle unter Datenquelle deine Tabelle oder Ansicht aus und wähle unter Datenobjekttypen Profil aus.
- Wähle unter Taktung die Option Ausführung planen aus. Wähle das Intervall unter Alle aus, und lege dann Startdatum, Startzeit und Zeitzone fest. Klicke auf Weiter.
- Wähle unter Eigenschaften zuordnen deine Zeitstempelspalte unter Änderungserkennung > Erkennung neuer Zeilen aus. Ordne mindestens 1 Profilkennung und die Profileigenschaften zu, die du importieren möchtest. Entferne Zuordnungen für Spalten, die du nicht importieren möchtest. Du kannst die Spalte für die Änderungserkennung nicht gleichzeitig einer Profileigenschaft zuordnen.
- Klicke auf Fertig, um die Verbindung zu speichern und zu synchronisieren. Klaviyo bringt dich zurück zur Synchronisierung, und die Synchronisierung wird nach dem von dir ausgewählten Zeitplan ausgeführt.
Tipps zur Fehlerbehebung
Verbindungstest fehlgeschlagen
- Stelle sicher, dass Firewall- oder Sicherheitsgruppenregeln Klaviyos IPs erlauben, deinen Redshift-Endpunkt über den richtigen Port zu erreichen.
- Bestätige die SSL-Einstellungen und dass du den richtigen Endpunkt (Cluster vs. Workgroup), die Region und den Port verwendest.
Tabellen werden nicht angezeigt
- Stelle sicher, dass sich Tabellen in
klaviyo_import_from_dwhbefinden. - Bestätige, dass der Klaviyo-Benutzer
USAGEim Schema undSELECTin den Tabellen oder Views hat.
Keine neuen Zeilen werden synchronisiert
- Überprüfe, ob deine Zeitstempelspalte bei Zeilenänderungen aktualisiert wird und UTC verwendet oder Zeitzoneninformationen enthält.
Berechtigungsfehler zur Laufzeit
- Führe das Validierungs-SQL als Klaviyo-Nutzer*in erneut aus.
- Falls nötig, Berechtigungen oder Standardprivilegien erneut anwenden.
Sicherheit und Wartung
- Rotiere das Service-User-Passwort regelmäßig und nach Personalwechseln. Nachdem du das Passwort in Redshift geändert hast, aktualisiere es im Tab Konfiguration deiner Klaviyo-Verbindung und klicke auf Speichern.
- Beschränke die*n Klaviyo-Benutzer*in auf die 2 Schemas oben, und erteile
USAGEnur dort Berechtigungen, wo sie erforderlich sind. - Halte ein einfaches Runbook bereit, in dem deine genauen
GRANT-Anweisungen und die IP-Bereiche dokumentiert sind, die du auf die Allowlist gesetzt hast.
FAQ
Kann ich aus mehreren Redshift-Datenbanken importieren?
Ja. Erstelle die 2 Schemas und gewähre in jeder Datenbank Zugriff. Erstelle dann für jede Datenbank eine separate Redshift-Verbindung in Klaviyo. Füge innerhalb jeder Verbindung separate Synchronisierungen für die Quelltabellen oder Ansichten hinzu.
Kann ich materialisierte Views verwenden?
Ja. SELECT auf der materialisierten View für die*n Klaviyo-Benutzer*in gewähren.
Anhang: Beispiel-DDL für eine einfache Importtabelle
CREATE TABLE klaviyo_import_from_dwh.profile_base (
external_id VARCHAR(128),
email VARCHAR(320),
phone VARCHAR(32),
first_name VARCHAR(128),
last_name VARCHAR(128),
country VARCHAR(64),
inserted_at TIMESTAMP
);
-- ensure monotonically increasing timestamp on inserts/updates
-- (use your ETL/ELT to set inserted_at = GETDATE() at load time)