Admin-Benutzerhandbuch für Snowflake-Connector

Kontext der Funktion

Was ist Snowflake?

Snowflake ist eine leistungsstarke, cloudbasierte Datenplattform, die Unternehmen hilft, den Wert ihrer Daten in vollem Umfang zu erschließen. Mit Snowflake können Sie alle Ihre Daten an einem Ort speichern, darauf zugreifen und sie analysieren – ohne die Komplexität herkömmlicher Systeme.

Ganz gleich, ob Sie Einblicke in Echtzeit gewähren, ein besseres Kundenerlebnis schaffen oder Abläufe rationalisieren möchten, Snowflake ermöglicht es Ihrem Team, datengestützte Entscheidungen schneller und effizienter zu treffen. Snowflake wurde für die Cloud entwickelt und wird von führenden Marken eingesetzt, um Daten in einen echten Wettbewerbsvorteil zu verwandeln.

Der Selligent by Zeta Snowflake-Connector ermöglicht es unseren Snowflake-Kunden, ihre Plattformdaten in ihre Marketing-Kommunikation zu integrieren, um ihren Kontakten differenziertere und gezieltere Nachrichten zu senden. Umgekehrt können sie die Daten an die Snowflake-Datenplattform weiterleiten.

Funktionsweise des Connectors

Mit dem nativen Snowflake-Connector können Selligent-Benutzer über eine bidirektionale, Batch-basierte Integration Kundenprofile und Aktivitätsdaten zwischen Selligent und Snowflake synchronisieren. Die Synchronisierung unterstützt geplante Datenflüsse unter Verwendung der zentralisierten Platform-Connector-Dienste.

Die Benutzer können:

• Zielgruppen- und Profildaten aus Snowflake in Selligent importieren
• Exportieren Sie Daten einfach aus Selligent in die Snowflake-Umgebung
• den Synchronisierungsstatus überwachen und das Mapping direkt in der Benutzeroberfläche konfigurieren
• auf diese Integration über die Selligent-Benutzeroberfläche zugreifen

Aktivierung und Konfiguration

Voraussetzungen

Einrichten des Connectors (Kundentechnik)

Dies ist eine einmalige Einrichtung.

1. Gehen Sie zu Admin-Konfiguration/Datenintegration/Connectors und fügen Sie einen neuen Connector hinzu:

Auf der rechten Seite wird ein Eigenschaften-Bereich angezeigt:

2. Legen Sie die folgenden Eigenschaften fest:

• Connector* — Wählen Sie Snowflake als Typ des Connectors aus der Dropdown-Liste aus.
• Server* — Dies ist der Name des Servers, auf dem Selligent installiert ist. Wählen Sie einen aus der Dropdown-Liste aus. Nur Server, auf denen der Connector installiert ist, sind aufgelistet.
• Konto — Konto der Snowflake-Domäne
• Datenbank — Die verwendete Snowflake-Datenbank
• Benutzer — Das Snowflake-Login.
• Privater Schlüssel — Die Datei mit Ihrem privaten Schlüssel von Snowflake
• Passwort des privaten Schlüssels
• Rolle — Die Snowflake-Rolle, die für die Durchführung von Aktionen verwendet wird (erforderlich bei der Arbeit mit einem privaten Schlüssel)
• Schema — Das Schema in der Datenbank
• Warehouse — Das virtuelle Lager, das für die Datenverarbeitung und analytische Abfragen verwendet wird
• Geänderte Felder — Geben Sie eine Liste von durch Komma (,) getrennten Feldern ein, die verwendet werden, um festzustellen, ob ein Datensatz aktualisiert wurde oder nicht. Standardmäßig werden die Felder „modified“, „modified_dt“, „updated“, „updated_dt“ und „timespan“ verwendet, um zu bestimmen, ob ein Datensatz aktualisiert wurde und eine Synchronisierung erfordert. Wenn dieses Feld in der Quelle jedoch nicht verfügbar ist, können Sie ein oder mehrere andere Felder auswählen.

3. Speichern Sie den Connector.

Wichtiger Hinweis: Für die Synchronisierung muss jede Quellentabelle ein Schlüsselfeld (eindeutige ID) haben. Wenn kein Schlüssel definiert ist, wird die Tabelle nicht im Synchronisierungs-Flow angezeigt. Fügen Sie einen Schlüssel hinzu, um dies verfügbar zu machen.

 

Verbinden des Connectors mit Ihrem Geschäftsbereich (Kundentechnik)

Dies ist eine einmalige Einrichtung.

Sobald der Connector erstellt wurde, muss er mit den Geschäftsbereichs verknüpft werden, in denen Sie den Connector verwenden möchten.

Weitere Informationen zu diesem Thema finden Sie in diesem Artikel.

Konfigurieren der Datensynchronisierung (Experten-Benutzer)

Dies ist standardmäßig eine einmalige Einrichtung, es sei denn, zusätzliche Felder, die eine Synchronisierung erfordern, werden entweder auf der Snowflake-Seite oder auf der Selligent-Seite hinzugefügt.

Die Datensynchronisierung wird im Abschnitt Datenaustausch von Selligent eingerichtet. Weitere Informationen hierzu finden Sie unter den folgenden Themen:

• Der CRM-Übersichtsseite

• Einrichten der Datensynchronisierung

Wichtiger Hinweis: Bei der Definition der Feldzuordnung zwischen Snowflake und beachten Sie bitte, dass Snowflake zwischen Groß- und Kleinschreibung unterscheidet und die folgende Typzuordnung berücksichtigt werden sollte.

Selligent data type	SQL Server type	Snowflake type	Snowflake to selligent	Selligent to Snowflake	Remarks
BOOLEAN	BIT	BOOLEAN	Es funktioniert	Es funktioniert
NUMERIC	INT	None strict	Überlaufrisiko	Es funktioniert	Es gibt keine strikte Typzuordnung zwischen Snowflake und Selligent. Snowflake kann Werte außerhalb des numerischen Bereichs von Selligent speichern (-2 147 483 648 bis 2 147 483 647). Werte in Snowflake müssen auf diesen Bereich beschränkt werden, um eine sichere Synchronisierung von Snowflake zu Selligent zu gewährleisten.
LONG	BIGINT	None strict	Überlaufrisiko	Es funktioniert	Es gibt keine strikte Typzuordnung zwischen Snowflake und Selligent. Snowflake kann Werte außerhalb des Selligent-BIGINT-Bereichs (-9 223 372 036 854 775 808 bis 9 223 372 036 854 775 807) speichern. Werte in Snowflake müssen auf diesen Bereich beschränkt werden, um eine sichere Synchronisierung von Snowflake zu Selligent zu gewährleisten.
FLOAT	FLOAT	FLOAT/DOUBLE	Genauigkeitsrisiko	Genauigkeitsrisiko	Die FLOAT/DOUBLE-Typen in Snowflake und Selligent sind approximativ (IEEE 754). Die Genauigkeit kann variieren.
DATE	DATE	DATE	Es funktioniert	Es funktioniert
DAETIME	DATETIME	None strict, TIMESTAMP_NTZ empfohlen	Überlaufrisiko	Es funktioniert	Es gibt keine strikte Typzuordnung. Snowflake TIMESTAMP_NTZ unterstützt Jahre von 0001-01-01 bis 9999-12-31. Selligent datetime unterstützt Jahre von 1753-01-01 bis 9999-12-31. Werte in Snowflake müssen auf diesen Bereich beschränkt werden, um eine sichere Synchronisierung von Snowflake nach Selligent zu gewährleisten.
TEXT	NVARCHAR	NVARCHAR(4000)	Es funktioniert	Es funktioniert	In Snowflake sind maximal 4.000 Zeichen zulässig. Längere Texte müssen LONGTEXT verwenden. Bidirektional sicher bei ≤ 4.000 Zeichen.
LONGTEXT	NVARCHAR(MAX)	None strict, VARCHAR/LONGTEXT empfohlen	Es funktioniert	Überlaufrisiko	Snowflake unterstützt bis zu 16 MB pro Zelle. Selligent unterstützt bis zu 2 GB pro Feld. Selligent-Daten, die 16 MB überschreiten, schlagen beim Laden nach Snowflake fehl.
UNIQUEIDENTIFIER	UNIQUEIDENTIFIER	None strict, STRING(36)/CHAR(36) empfohlen	Es funktioniert	Es funktioniert	Das UUID-Format mit 36 Zeichen muss eingehalten werden. Snowflake verfügt über keinen nativen GUID-Typ; verwenden Sie UUID_STRING() für Inserts.

 

Einsehen des Status der Datensynchronisierung (Alle Benutzer)

Auf der Registerkarte Verlauf des Schritts „Datensynchronisierung“ finden Sie Details zu früheren Durchläufen.

Dazu gehören:

• die Quell- und Zieltabelle der Datensynchronisierung
• die Details pro Ausführung:
  • das Ausführungsdatum
  • die Richtung der Datensynchronisierung
  • die Gesamtzahl der einbezogenen Datensätze
  • die Anzahl der Datensätze, die erfolgreich synchronisiert wurden, und derjenigen, deren Synchronisierung fehlgeschlagen ist
  • die Startzeit der Synchronisierung
  • die Dauer der Synchronisierung

Weitere Einzelheiten hierzu finden Sie im Abschnitt Verlauf im Artikel zur Einrichtung der Datensynchronisierung.