Streamen von Daten aus Ihrer Snowflake-Datenbank an Experience Platform mithilfe der Benutzeroberfläche
Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Daten aus Ihrer Snowflake-Datenbank mithilfe des Arbeitsbereichs „Quellen“ in der Benutzeroberfläche an Experience Platform streamen.
Erste Schritte
Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Experience Platform voraus:
-
Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.
- Grundlagen der Schemakomposition: Machen Sie sich mit den grundlegenden Bausteinen von XDM-Schemata vertraut, einschließlich der wichtigsten Prinzipien und Best Practices bei der Schemaerstellung.
- Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemata mithilfe der Benutzeroberfläche des Schema-Editors erstellen können.
-
Real-Time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.
Authentifizierung
Lesen Sie das Handbuch unter Vorausgesetzte Einrichtung für Snowflake -Streaming, um Informationen zu den Schritten zu erhalten, die Sie durchführen müssen, bevor Sie Streaming-Daten von Snowflake in Experience Platform aufnehmen können.
Verwenden der Snowflake Streaming zum Streamen Snowflake Daten an Experience Platform
Wählen Sie in der Experience Platform-Benutzeroberfläche Quellen in der linken Navigationsleiste aus, um auf den Arbeitsbereich Quellen zuzugreifen. Sie können die gewünschte Kategorie aus dem Katalog auf der linken Bildschirmseite auswählen. Alternativ können Sie die gewünschte Quelle mithilfe der Suchoption finden.
Wählen Sie unter Kategorie die Option Snowflake Streaming und dann Einrichten aus.
Die Snowflake Streaming-Konto verbinden wird angezeigt. Auf dieser Seite können Sie entweder neue oder vorhandene Anmeldeinformationen verwenden.
Neues Konto erstellen
Um ein neues Konto zu erstellen, wählen Sie Neues Konto und geben Sie einen Namen und eine optionale Beschreibung für Ihr Konto an.
Um die Standardauthentifizierung zu verwenden, wählen Sie Standardauthentifizierung für Snowflake aus und geben Sie Anmeldeinformationen für Ihr Snowflake an. Wenn Sie fertig sind, wählen Mit Quelle verbinden und warten Sie einige Augenblicke, bis die Verbindung hergestellt ist.
Snowflake Streaming Weiterführende Informationen dazu, wie Sie die erforderlichen Anmeldeinformationen , finden Sie in der Übersicht zu .
Um die KeyPair-Authentifizierung zu verwenden, wählen Sie KeyPair-Authentifizierung für Snowflake aus und geben Sie Anmeldeinformationen für Ihr Snowflake an. Wenn Sie fertig sind, wählen Mit Quelle verbinden und warten Sie einige Augenblicke, bis die Verbindung hergestellt ist.
Snowflake Streaming Weiterführende Informationen dazu, wie Sie die erforderlichen Anmeldeinformationen , finden Sie in der Übersicht zu .
Um ein vorhandenes Konto zu verwenden, wählen Sie Vorhandenes Konto, wählen Sie Ihr Konto aus der Liste aus und klicken Sie auf Weiter.
Daten auswählen select-data
-
Eine Zeitstempelspalte muss in Ihrer Quelltabelle vorhanden sein, damit ein Streaming-Datenfluss erstellt werden kann. Der Zeitstempel ist erforderlich, damit Experience Platform weiß, wann Daten aufgenommen werden und wann inkrementelle Daten gestreamt werden. Sie können nachträglich eine Zeitstempelspalte für eine bestehende Verbindung hinzufügen und einen neuen Datenfluss erstellen.
-
Stellen Sie sicher, dass die Groß-/Kleinschreibung der Datenfelder in Ihrer Beispiel-Quelldatendatei mit der Anleitung von Snowflake zur Groß-/Kleinschreibung für Kennungen übereinstimmt. Weitere Informationen finden Snowflake im Dokument zur Groß und Kleinschreibung von Bezeichnern .
Der Schritt Daten auswählen wird angezeigt. In diesem Schritt müssen Sie die Daten auswählen, die Sie in Experience Platform importieren möchten, Zeitstempel und Zeitzonen konfigurieren und eine Beispieldatendatei für die Aufnahme von Rohdaten bereitstellen.
Verwenden Sie das Datenbankverzeichnis auf der linken Bildschirmseite und wählen Sie die Tabelle aus, die Sie in Experience Platform importieren möchten.
Wählen Sie als Nächstes den Zeitstempel-Spaltentyp Ihrer Tabelle aus. Sie können zwischen zwei Arten von Zeitstempelspalten wählen: TIMESTAMP_NTZ oder TIMESTAMP_LTZ. Wenn Sie den Spaltentyp TIMESTAMP_NTZ auswählen, müssen Sie auch eine Zeitzone angeben. Die Spalten sollten eine NOT NULL-Einschränkung aufweisen. Weitere Informationen finden Sie im Abschnitt zu Einschränkungen und häufig gestellte Fragen.
In diesem Schritt können Sie auch Aufstockungseinstellungen konfigurieren. Die Aufstockung bestimmt, welche Daten anfänglich aufgenommen werden. Wenn die Aufstockung aktiviert ist, werden alle aktuellen Dateien im angegebenen Pfad während der ersten geplanten Aufnahme aufgenommen. Andernfalls werden nur die Dateien aufgenommen, die zwischen dem ersten Aufnahmevorgang und der Startzeit geladen werden. Dateien, die vor der Startzeit geladen wurden, werden nicht aufgenommen.
Wählen Sie den Umschalter Aufstockung aus, um die Aufstockung zu aktivieren.
Wählen Sie abschließend Datei auswählen aus, um ein Beispiel für Quelldaten hochzuladen und so den Zuordnungssatz zu erstellen. Dieser wird in einem späteren Schritt verwendet, um Ihre Originaldaten dem Experience-Datenmodell (XDM) zuzuordnen.
Wenn Sie fertig sind, wählen Sie Weiter aus, um fortzufahren.
Datensatz- und Datenflussdetails angeben provide-dataset-and-dataflow-details
Als Nächstes müssen Sie Informationen zu Ihrem Datensatz und Ihrem Datenfluss angeben.
Datensatz-Details dataset-details
Ein Datensatz ist ein Konstrukt zur Speicherung und Verwaltung einer Sammlung von Daten, in der Regel eine Tabelle, die ein Schema (Spalten) und Felder (Zeilen) enthält. Daten, die erfolgreich in Experience Platform aufgenommen werden, bleiben als Datensätze im Data Lake erhalten. In diesem Schritt können Sie einen neuen Datensatz erstellen oder einen vorhandenen Datensatz verwenden.
Wenn Sie über einen vorhandenen Datensatz verfügen, wählen Sie Vorhandener Datensatz und verwenden Sie dann die Option Erweiterte Suche, um ein Fenster aller Datensätze in Ihrer Organisation anzuzeigen, einschließlich der entsprechenden Details, z. B. ob sie für die Aufnahme in das Echtzeit-Kundenprofil aktiviert sind.
Um einen neuen Datensatz zu verwenden, wählen Neuer Datensatz und geben Sie dann einen Namen und eine optionale Beschreibung für Ihren Datensatz an. Sie müssen auch ein Experience-Datenmodell-Schema (XDM) auswählen, dem Ihr Datensatz entspricht.
Datenflussdetails dataflow-details
Nachdem Ihr Datensatz konfiguriert wurde, müssen Sie Details zu Ihrem Datenfluss angeben, einschließlich eines Namens, einer optionalen Beschreibung und Warnhinweiskonfigurationen.
Experience Platform kann ereignisbasierte Warnhinweise erstellen, die Benutzende abonnieren können. Für diese Optionen ist ein laufender Datenfluss erforderlich, um sie im Trigger zu halten. Weitere Informationen finden Sie unter Warnhinweise - Übersicht
- Start der Ausführung des Quelldatenflusses: Wählen Sie diesen Warnhinweis aus, um eine Benachrichtigung zu erhalten, wenn die Ausführung des Datenflusses beginnt.
- Erfolgreiche Ausführung des Quelldatenflusses: Wählen Sie diesen Warnhinweis aus, um eine Benachrichtigung zu erhalten, wenn Ihr Datenfluss fehlerfrei endet.
- Fehler bei der Ausführung des Datenflusses an Quellen: Wählen Sie diesen Warnhinweis aus, um eine Benachrichtigung zu erhalten, wenn die Ausführung des Datenflusses mit Fehlern endet.
Wenn Sie fertig sind, wählen Sie Weiter aus, um fortzufahren.
Zuordnen von Feldern zu einem XDM-Schema mapping
Der Schritt Zuordnung wird angezeigt. Verwenden Sie die Zuordnungsschnittstelle, um Ihre Quelldaten den entsprechenden Schemafeldern zuzuordnen, bevor Sie diese Daten in Experience Platform aufnehmen, und wählen Sie dann Weiter. Eine ausführliche Anleitung zur Verwendung der Zuordnungsschnittstelle finden Sie im Handbuch zur Datenvorbereitungs-).
Überprüfen des Datenflusses review
Der letzte Schritt im Prozess zur Erstellung eines Datenflusses besteht darin, Ihren Datenfluss zu überprüfen, bevor er ausgeführt wird. Verwenden Sie den Überprüfen Schritt, um die Details Ihres neuen Datenflusses zu überprüfen, bevor er ausgeführt wird. Die Details sind in die folgenden Kategorien unterteilt:
- Verbindung: Zeigt den Quelltyp, den relevanten Pfad der ausgewählten Quelldatei und die Anzahl der Spalten innerhalb dieser Quelldatei an.
- Datensatz- und Zuordnungsfelder zuweisen: Zeigt an, in welchen Datensatz die Quelldaten aufgenommen werden, einschließlich des Schemas, dem der Datensatz entspricht.
Nachdem Sie Ihren Datenfluss überprüft haben, klicken Sie auf Beenden und gewähren Sie etwas Zeit für die Erstellung des Datenflusses.
Nächste Schritte
In diesem Tutorial haben Sie erfolgreich einen Streaming-Datenfluss für Snowflake erstellt. Weitere Ressourcen finden Sie in der Dokumentation unten.
Überwachen Ihres Datenflusses
Nachdem Ihr Datenfluss erstellt wurde, können Sie die Daten überwachen, die über ihn aufgenommen werden, um Informationen zu Aufnahmegeschwindigkeiten, Erfolg und Fehlern anzuzeigen. Weitere Informationen zum Überwachen von Streaming-Datenflüssen finden Sie im Tutorial Überwachen von Streaming-Datenflüssen in der Benutzeroberfläche.
Aktualisieren des Datenflusses
Um Konfigurationen für die Planung, Zuordnung und allgemeine Informationen Ihrer Datenflüsse zu aktualisieren, besuchen Sie das Tutorial Aktualisieren von Quelldatenflüssen in der Benutzeroberfläche.
Löschen des Datenflusses
Datenflüsse, die nicht mehr erforderlich sind oder nicht korrekt erstellt wurden, können Sie löschen, indem Sie dazu die Funktion Löschen im Arbeitsbereich Datenflüsse verwenden. Weitere Informationen zum Löschen von Datenflüssen finden Sie im Tutorial Löschen von Datenflüssen in der Benutzeroberfläche.