[Ultimate]{class="badge positive"}

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:

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.

TIP
Le origini che non dispongono di un account autenticato nel catalogo delle origini visualizzano l'opzione Configura. Quando esiste un account autenticato, questa opzione diventa Aggiungi dati.

Catalogo origini nellinterfaccia utente di Experience Platform, con la scheda origine Streaming di Snowflake selezionata.

Viene visualizzata la pagina Connetti account Streaming di Snowflake. In questa pagina è possibile utilizzare credenziali nuove o esistenti.

Crea un nuovo account

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.

Nuova interfaccia di creazione account del flusso di lavoro di origine.

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.
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.

Usa un account esistente

Per utilizzare un account esistente, selezionare Account esistente, quindi selezionare l'account desiderato dal catalogo degli account esistente.

Seleziona Avanti per procedere.

Pagina di selezione account esistente del catalogo delle origini.

Selezionare i dati select-data

IMPORTANT
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.

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.

Interfaccia di selezione dei dati con una tabella di database selezionata.

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.

Passaggi di configurazione timestamp, fuso orario e backfill.

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.

Anteprima dei dati di esempio di origine.

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.

Utilizza un nuovo set di dati

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.

Nuova interfaccia di selezione del 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.
Utilizza un set di dati esistente

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.

Interfaccia di selezione del set di dati esistente.

Seleziona per i passaggi per abilitare l’acquisizione del profilo, la diagnostica degli errori e l’acquisizione parziale.

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.

Passaggio di configurazione dei dettagli del flusso di dati.

Configurazioni del flusso di dati
Descrizione
Nome flusso di dati
Nome del flusso di dati. Per impostazione predefinita, viene utilizzato il nome del file che si sta importando.
Descrizione
(Facoltativo) Breve descrizione del flusso di dati.
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.

Interfaccia di mappatura del flusso di lavoro di origine.

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.

Passaggio di revisione del flusso di lavoro origini.

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.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089