Streamen von Daten aus Ihrer Snowflake-Datenbank mithilfe der Benutzeroberfläche an das Experience Platform
In diesem Handbuch erfahren Sie, wie Sie mit der Benutzeroberfläche Daten von Ihrer Snowflake -Datenbank an Adobe Experience Platform streamen können.
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
Informationen zu den Schritten, die Sie ausführen müssen, bevor Sie Streaming-Daten von Snowflake auf Experience Platform erfassen können, finden Sie im Handbuch unter Voraussetzungen für die Einrichtung von Snowflake Streaming-Daten .
Snowflake Streaming-Quelle verwenden, um Snowflake-Daten an Experience Platform zu streamen
Wählen Sie in der Platform-Benutzeroberfläche in der linken Navigationsleiste die Option Quellen, 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 der Kategorie Datenbanken die Option Snowflake Streaming und dann Daten hinzufügen aus.
Die Seite Snowflake-Streaming-Konto verbinden wird angezeigt. Auf dieser Seite können Sie entweder neue oder vorhandene Anmeldedaten verwenden.
Um ein neues Konto zu erstellen, wählen Sie Neues Konto aus und geben Sie einen Namen, eine optionale Beschreibung und Ihre Anmeldeinformationen ein.
Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Anmeldedaten | Beschreibung |
| Konto | Der Name Ihres Snowflake-Kontos. Konventionen zu Kontonamen finden Sie im Snowflake Streaming Authentifizierungshandbuch. |
| Warehouse | Der Name Ihres Snowflake Warehouse. Warehouse verwaltet die Ausführung von Abfragen in Snowflake. Jedes Snowflake-Warehouse ist unabhängig voneinander und muss einzeln aufgerufen werden, um Daten an Experience Platform zu bringen. |
| Datenbank | Der Name Ihrer Snowflake -Datenbank. Die Datenbank enthält die Daten, die Sie zum Experience Platform mitbringen möchten. |
| Schema | (Optional) Das Datenbankschema, das mit Ihrem Snowflake-Konto verknüpft ist. |
| Benutzername | Der Benutzername Ihres Snowflake-Kontos. |
| Kennwort | Das Kennwort für Ihr Snowflake-Konto. |
| Rolle | (Optional) Eine benutzerdefinierte Rolle, die einem Benutzer für eine bestimmte Verbindung bereitgestellt werden kann. Wenn dieser Wert nicht angegeben wird, wird standardmäßig public verwendet. |
Weiterführende Informationen zur Kontoerstellung finden Sie im Abschnitt Konfigurieren von Rolleneinstellungen in der Snowflake Streaming -Übersicht.
Um ein vorhandenes Konto zu verwenden, wählen Sie Vorhandenes Konto und dann das gewünschte Konto aus dem vorhandenen Kontokatalog aus.
Klicken Sie auf Weiter, um fortzufahren.
Daten auswählen select-data
-
In der Quelltabelle muss eine Spalte mit Zeitstempel vorhanden sein, damit ein Streaming-Datenfluss erstellt werden kann. Der Zeitstempel ist erforderlich, damit Experience Platform weiß, wann Daten erfasst und wann inkrementelle Daten gestreamt werden. Sie können rückwirkend 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 den Anweisungen von Snowflake zur Fallauflösung für Kennungen entspricht. Weitere Informationen finden Sie im Dokument Snowflake zur Identifizierungsweise .
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 Zeitstempelspaltentyp 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. Ihre Spalten sollten eine Nicht-Null-Einschränkung aufweisen. Weitere Informationen finden Sie im Abschnitt zu [Einschränkungen und häufig gestellten Fragen] .
Sie können während dieses Schritts auch die Einstellungen für die Aufstockung konfigurieren. Die Aufstockung bestimmt, welche Daten ursprünglich erfasst werden. Wenn die Aufstockung aktiviert ist, werden alle aktuellen Dateien im angegebenen Pfad während der ersten geplanten Erfassung erfasst. Andernfalls werden nur die Dateien erfasst, die zwischen der ersten Ausführung der Aufnahme und der Startzeit geladen wurden. Dateien, die vor der Startzeit geladen wurden, werden nicht erfasst.
Wählen Sie den Umschalter Aufstockung aus, um die Aufstockung zu aktivieren.
Wählen Sie abschließend Datei auswählen aus, um eine Beispiel-Quelldaten hochzuladen und so den Zuordnungssatz zu erstellen. Dieser wird in einem späteren Schritt verwendet, um Ihre ursprünglichen Daten dem Experience-Datenmodell (XDM) zuzuordnen.
Wenn Sie fertig sind, wählen Sie Weiter aus, um fortzufahren.
Bereitstellen von Datensatz- und Datenflussdetails 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 Datenspeicherung und -verwaltung, in dem Daten (in der Regel) in einer Tabelle erfasst werden, die ein Schema (Spalten) und Felder (Zeilen) beinhaltet. Daten, die erfolgreich in Experience Platform aufgenommen wurden, werden im Data Lake als Datensätze persistiert. In diesem Schritt können Sie einen neuen Datensatz erstellen oder einen vorhandenen Datensatz verwenden.
Um einen neuen Datensatz zu verwenden, wählen Sie Neuer Datensatz aus und geben Sie dann einen Namen und eine optionale Beschreibung für Ihren Datensatz an. Sie müssen auch ein Experience-Datenmodell (XDM)-Schema auswählen, dem Ihr Datensatz entspricht.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Neue Datensatzdetails | Beschreibung |
| Name des Ausgabe-Datensatzes | Der Name Ihres neuen Datensatzes. |
| Beschreibung | (Optional) Eine kurze Übersicht über den neuen Datensatz. |
| Schema | Eine Dropdown-Liste mit Schemas, die in Ihrer Organisation vorhanden sind. Sie können auch ein eigenes Schema vor dem Quellkonfigurationsprozess erstellen. Weitere Informationen finden Sie im Handbuch zum Erstellen eines XDM-Schemas in der Benutzeroberfläche 🔗. |
Wenn Sie bereits über einen vorhandenen Datensatz verfügen, wählen Sie Vorhandenen Datensatz und verwenden Sie dann die Option Erweiterte Suche , um ein Fenster mit allen Datensätzen in Ihrer Organisation anzuzeigen, einschließlich der entsprechenden Details, z. B. ob sie für die Aufnahme in das Echtzeit-Kundenprofil aktiviert sind.
Wenn Ihr Datensatz für das Echtzeit-Kundenprofil aktiviert ist, können Sie während dieses Schritts Profildatensatz umschalten, um Ihre Daten für die Profilaufnahme zu aktivieren. Sie können diesen Schritt auch verwenden, um die Fehlerdiagnose und die partielle Erfassung zu aktivieren.
- Fehlerdiagnose: Wählen Sie Fehlerdiagnose aus, um die Quelle anzuweisen, Fehlerdiagnosen zu erstellen, die Sie später bei der Überwachung der Datensatzaktivität und des Datenflussstatus referenzieren können.
- Partielle Erfassung: Partielle Batch-Erfassung ist die Möglichkeit, Daten mit Fehlern bis zu einem bestimmten konfigurierbaren Schwellenwert zu erfassen. Mit dieser Funktion können Sie alle Ihre präzisen Daten erfolgreich in Experience Platform erfassen, während all Ihre falschen Daten separat mit Informationen darüber gestapelt werden, warum sie ungültig sind.
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 Benutzer abonnieren können. Diese Optionen erfordern einen laufenden Datenfluss, um sie Trigger. Weitere Informationen finden Sie in der Warnhinweise - Übersicht
- Start des Datenflusses für Quellen: Wählen Sie diesen Warnhinweis aus, um eine Benachrichtigung zu erhalten, wenn der Datenfluss beginnt.
- Erfolg des Datenfluss-Workflows für Quellen: Wählen Sie diesen Warnhinweis aus, um eine Benachrichtigung zu erhalten, wenn Ihr Datenfluss ohne Fehler beendet wird.
- Quellen für Fehler beim Ausführen des Datenflusses: 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.
Felder einem XDM-Schema zuordnen 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 aus. Eine ausführliche Anleitung zur Verwendung der Zuordnungsschnittstelle finden Sie im UI-Handbuch zur Datenvorbereitung .
Überprüfen des Datenflusses review
Der letzte Schritt im Erstellungsprozess des Datenflusses besteht darin, Ihren Datenfluss zu überprüfen, bevor er ausgeführt wird. Verwenden Sie den Schritt Überprüfen , um die Details Ihres neuen Datenflusses zu überprüfen, bevor er ausgeführt wird. Details werden in die folgenden Kategorien eingeteilt:
- Verbindung: Zeigt den Quelltyp, den relevanten Pfad der ausgewählten Quelldatei und die Anzahl der Spalten in 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 -Daten erstellt. Weitere Ressourcen finden Sie in der folgenden Dokumentation.
Überwachen Ihres Datenflusses
Nachdem Ihr Datenfluss erstellt wurde, können Sie die erfassten Daten überwachen, um Informationen zu Erfassungsraten, Erfolg und Fehlern anzuzeigen. Weitere Informationen zum Überwachen von Streaming-Datenflüssen finden Sie im Tutorial zum Ü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 zum Aktualisieren der Datenflüsse für Quellen 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 zum Löschen von Datenflüssen in der Benutzeroberfläche 🔗.