Trasmetti dati dal database Snowflake all'Experience Platform utilizzando l'interfaccia utente
Scopri come utilizzare l'interfaccia utente per inviare dati dal database Snowflake a Adobe Experience Platform seguendo questa guida.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:
-
Experience Data Model (XDM) Sistema: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente.
- Nozioni di base sulla composizione dello schema: scopri i blocchi predefiniti di base degli schemi XDM, inclusi i principi chiave e le best practice nella composizione dello schema.
- Esercitazione sull'editor di schemi: scopri come creare schemi personalizzati utilizzando l'interfaccia utente dell'editor di schemi.
-
Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Autenticazione
Leggi la guida sulla configurazione dei prerequisiti per Snowflake dati in streaming per informazioni sui passaggi da completare prima di acquisire i dati in streaming da Snowflake a Experience Platform.
Utilizza l'origine Snowflake Streaming per eseguire lo streaming dei dati di Snowflake per l'Experience Platform
Nell'interfaccia utente di Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini. Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.
Nella categoria Database selezionare Snowflake Streaming, quindi Aggiungi dati.
Viene visualizzata la pagina Connetti account Streaming di Snowflake. In questa pagina è possibile utilizzare credenziali nuove o esistenti.
Per creare un nuovo account, selezionare Nuovo account e fornire un nome, una descrizione facoltativa e le credenziali.
Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
| 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 | |
|---|---|
| Credenziali | Descrizione |
| Account | Il nome dell'account Snowflake. Per le convenzioni sui nomi degli account, leggere la Snowflake Streaming guida all'autenticazione. |
| Data warehouse | Nome del data warehouse Snowflake. I warehouse gestiscono l'esecuzione delle query in Snowflake. Ogni data warehouse Snowflake è indipendente l'uno dall'altro e deve essere accessibile singolarmente per portare i dati all'Experience Platform. |
| Database | Nome del database Snowflake. Il database contiene i dati da portare all'Experience Platform. |
| Schema | (Facoltativo) Lo schema di database associato al tuo account Snowflake. |
| Nome utente | Il nome utente dell'account Snowflake. |
| Password | La password per il tuo account Snowflake. |
| Ruolo | (Facoltativo) Ruolo personalizzato che può essere fornito a un utente per una determinata connessione. Se non specificato, il valore predefinito è public. |
Per ulteriori informazioni sulla creazione dell'account, leggere la sezione sulla configurazione delle impostazioni dei ruoli nella panoramica di Snowflake Streaming.
Per utilizzare un account esistente, selezionare Account esistente, quindi selezionare l'account desiderato dal catalogo degli account esistente.
Seleziona Avanti per procedere.
Selezionare i dati select-data
-
Per poter creare un flusso di dati in streaming, nella tabella sorgente deve esistere una colonna di marca temporale. La marca temporale è necessaria ad Experience Platform per sapere quando verranno acquisiti i dati e quando verranno inviati in streaming i dati incrementali. Puoi aggiungere retroattivamente una colonna timestamp per una connessione esistente e creare un nuovo flusso di dati.
-
Verificare che il caso dei campi dati nel file di dati di origine di esempio sia conforme alle indicazioni di Snowflake sulla risoluzione dei casi per gli identificatori. Per ulteriori informazioni, leggere il documento Snowflake sul case dell'identificatore.
Viene visualizzato il passaggio Seleziona dati. In questo passaggio, devi selezionare i dati da importare in Experience Platform, configurare marche temporali e fusi orari e fornire un file di dati sorgente di esempio per l’acquisizione di dati non elaborati.
Utilizzare la directory del database a sinistra dello schermo e selezionare la tabella che si desidera importare in Experience Platform.
Quindi, seleziona il tipo di colonna timestamp della tabella. È possibile selezionare due tipi di colonne di marca temporale: TIMESTAMP_NTZ o TIMESTAMP_LTZ. Se si seleziona un tipo di colonna TIMESTAMP_NTZ, è necessario specificare anche un fuso orario. Le colonne devono avere un vincolo non null. Per ulteriori informazioni, leggere la sezione sulle [limitazioni e domande frequenti]
In questo passaggio puoi anche configurare le impostazioni di retrocompilazione. La retrocompilazione determina quali dati vengono inizialmente acquisiti. Se la retrocompilazione è abilitata, tutti i file correnti nel percorso specificato verranno acquisiti durante la prima acquisizione pianificata. In caso contrario, verranno acquisiti solo i file caricati tra la prima esecuzione dell’acquisizione e l’ora di inizio. I file caricati prima dell’ora di inizio non verranno acquisiti.
Seleziona l'interruttore Backfill per abilitare la retrocompilazione.
Infine, seleziona Scegli il file per caricare un esempio di dati di origine per creare il set di mappatura, che verrà utilizzato in un passaggio successivo per mappare i dati originali su Experience Data Model (XDM).
Al termine, selezionare Avanti per continuare.
Fornisci i dettagli del set di dati e del flusso di dati provide-dataset-and-dataflow-details
Quindi, devi fornire informazioni sul set di dati e sul flusso di dati.
Dettagli del set di dati dataset-details
Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati, in genere una tabella, che contiene uno schema (colonne) e dei campi (righe). I dati acquisiti correttamente in Experience Platform vengono memorizzati nel data lake come set di dati. Durante questo passaggio, puoi creare un nuovo set di dati o utilizzare un set di dati esistente.
Per utilizzare un nuovo set di dati, seleziona Nuovo set di dati, quindi fornisci un nome e una descrizione facoltativa per il set di dati. Devi anche selezionare uno schema Experience Data Model (XDM) a cui aderisce il set di dati.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Dettagli nuovo set di dati | Descrizione |
| Nome set di dati di output | Nome del nuovo set di dati. |
| Descrizione | (Facoltativo) Breve panoramica del nuovo set di dati. |
| Schema | Elenco a discesa degli schemi esistenti nell’organizzazione. Puoi anche creare uno schema personalizzato prima del processo di configurazione sorgente. Per ulteriori informazioni, consulta la guida su creazione di uno schema XDM nell'interfaccia utente. |
Se disponi già di un set di dati, seleziona Set di dati esistente e quindi utilizza l'opzione Ricerca avanzata per visualizzare una finestra di tutti i set di dati dell'organizzazione, inclusi i rispettivi dettagli, ad esempio se sono abilitati per l'acquisizione in Real-Time Customer Profile.
Se il set di dati è abilitato per Real-Time Customer Profile, durante questo passaggio puoi attivare/disattivare il set di dati profilo per abilitare i dati per l'acquisizione del profilo. È inoltre possibile utilizzare questo passaggio per abilitare Diagnostica errori e Acquisizione parziale.
- Diagnostica errori: selezionare Diagnostica errori per indicare all'origine di produrre diagnostica errori a cui fare successivamente riferimento durante il monitoraggio dell'attività del set di dati e dello stato del flusso di dati.
- Acquisizione parziale: l'acquisizione parziale in batch consente di acquisire dati contenenti errori, fino a una determinata soglia configurabile. Questa funzione consente di acquisire correttamente in Experience Platform tutti i dati accurati, mentre tutti i dati errati vengono raggruppati separatamente con informazioni sul motivo della validità.
Dettagli del flusso di dati dataflow-details
Una volta configurato il set di dati, devi quindi fornire dettagli sul flusso di dati, tra cui un nome, una descrizione facoltativa e le configurazioni degli avvisi.
Experience Platform può generare avvisi basati su eventi a cui gli utenti possono abbonarsi. Queste opzioni richiedono un flusso di dati in esecuzione per attivarle. Per ulteriori informazioni, leggere la panoramica degli avvisi
- Inizio esecuzione flusso di dati origini: selezionare questo avviso per ricevere una notifica all'inizio dell'esecuzione del flusso di dati.
- Esecuzione del flusso di dati origini completata: selezionare questo avviso per ricevere una notifica se il flusso di dati termina senza errori.
- Errore di esecuzione del flusso di dati di origini: selezionare questo avviso per ricevere una notifica se l'esecuzione del flusso di dati termina con errori.
Al termine, selezionare Avanti per continuare.
Mappare i campi su uno schema XDM mapping
Viene visualizzato il passaggio Mapping. Utilizza l'interfaccia di mappatura per mappare i dati di origine ai campi dello schema appropriati prima di acquisire tali dati in Experience Platform, quindi seleziona Avanti. Per una guida dettagliata sull'utilizzo dell'interfaccia di mappatura, leggere la Guida dell'interfaccia utente della preparazione dati per ulteriori informazioni.
Verifica il flusso di dati review
Il passaggio finale nel processo di creazione del flusso di dati consiste nell’esaminare il flusso di dati prima di eseguirlo. Utilizza il passaggio Rivedi per rivedere i dettagli del nuovo flusso di dati prima che venga eseguito. I dettagli sono raggruppati nelle seguenti categorie:
- Connessione: mostra il tipo di origine, il percorso pertinente del file di origine scelto e il numero di colonne all'interno di tale file di origine.
- Assegna set di dati e mappa i campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui il set di dati aderisce.
Dopo aver rivisto il flusso di dati, seleziona Fine e attendi che venga creato un po' di tempo.
Passaggi successivi
Seguendo questa esercitazione, hai creato un flusso di dati in streaming per Snowflake dati. Per ulteriori risorse, consulta la documentazione di seguito.
Monitorare il flusso di dati
Una volta creato il flusso di dati, puoi monitorare i dati che vengono acquisiti tramite di esso per visualizzare informazioni su tassi di acquisizione, successo ed errori. Per ulteriori informazioni su come monitorare i flussi di dati in streaming, consulta l'esercitazione sul monitoraggio dei flussi di dati in streaming nell'interfaccia utente.
Aggiornare il flusso di dati
Per aggiornare le configurazioni per la pianificazione, la mappatura e le informazioni generali dei flussi di dati, visita il tutorial su aggiornamento dei flussi di dati di origine nell'interfaccia utente.
Eliminare il flusso di dati
È possibile eliminare i flussi di dati non più necessari o creati in modo errato utilizzando la funzione Elimina disponibile nell'area di lavoro Flussi di dati. Per ulteriori informazioni su come eliminare i flussi di dati, consulta l'esercitazione su eliminazione dei flussi di dati nell'interfaccia utente.