Trasmetti dati dal database Snowflake ad Experience Platform utilizzando l'interfaccia utente
Leggi questa guida per scoprire come inviare dati dal database Snowflake ad Experience Platform utilizzando l'area di lavoro origini nell'interfaccia utente.
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 ad Experience Platform.
Utilizza l'origine Snowflake Streaming per inviare dati Snowflake ad Experience Platform
Nell'interfaccia utente di Experience 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 Configurazione.
Viene visualizzata la pagina Connetti account Snowflake Streaming. In questa pagina è possibile utilizzare credenziali nuove o esistenti.
Crea un nuovo account
Per creare un nuovo account, seleziona Nuovo account e fornisci un nome e una descrizione facoltativa per il tuo account.
Per utilizzare l'autenticazione di base, selezionare Autenticazione di base per Snowflake e fornire le credenziali per l'account Snowflake. Al termine, selezionare Connetti all'origine e attendere alcuni istanti prima di stabilire la connessione.
Per ulteriori informazioni su Snowflake Streamingraccolta delle credenziali richieste, leggere la panoramica di .
Per utilizzare l'autenticazione coppia di chiavi, selezionare Autenticazione coppia di chiavi per Snowflake e fornire le credenziali per l'account Snowflake. Al termine, selezionare Connetti all'origine e attendere alcuni istanti prima di stabilire la connessione.
Per ulteriori informazioni su Snowflake Streamingraccolta delle credenziali richieste, leggere la panoramica di .
Per utilizzare un account esistente, scegli Account esistente, seleziona il tuo account dall'elenco e seleziona Avanti.
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 per Experience Platform per sapere quando verranno acquisiti i dati e quando verranno trasmessi 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 di origine di esempio per l’acquisizione di dati non elaborati.
Utilizza la directory del database a sinistra dello schermo e seleziona la tabella da 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.
Se disponi di un set di dati esistente, 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.
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.
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.