Configurare un flusso di dati per una connessione al database nell’interfaccia utente

Un flusso di dati è un’attività pianificata che recupera e acquisisce dati da un’origine a un set di dati della Platform. Questa esercitazione fornisce i passaggi per configurare un nuovo flusso di dati utilizzando l'account del database.

Introduzione

Questa esercitazione richiede una buona comprensione dei seguenti componenti di Adobe Experience Platform:

• Experience Data Model (XDM) Sistema: Il framework standardizzato in base al quale l’Experience Platform organizza i dati sulla customer experience.
  • Nozioni di base sulla composizione dello schema: Scopri i blocchi di base degli schemi XDM, inclusi i principi chiave e le best practice nella composizione dello schema.
  • Esercitazione dell’Editor di schema: Scopri come creare schemi personalizzati utilizzando l’interfaccia utente dell’Editor di schema.
• Real-time Customer Profile: Fornisce un profilo di consumatore unificato e in tempo reale basato su dati aggregati provenienti da più origini.

Inoltre, questa esercitazione richiede che tu abbia già creato un account di database. Un elenco di esercitazioni per la creazione di diversi connettori di database nell'interfaccia utente è disponibile nella panoramica dei connettori sorgente.

Seleziona dati

Dopo aver creato l'account di database, viene visualizzato il passaggio Select data che fornisce un'interfaccia interattiva per esplorare la gerarchia del database.

• La metà sinistra dell'interfaccia è un browser, che visualizza l'elenco dei database del tuo account.
• La metà destra dell’interfaccia consente di visualizzare in anteprima fino a 100 righe di dati.

Puoi utilizzare l’opzione Search nella parte superiore della pagina per identificare rapidamente i dati di origine che intendi utilizzare.

Una volta trovati i dati di origine, seleziona la directory, quindi fai clic su Next.

Mappatura di campi dati su uno schema XDM

Viene visualizzato il passaggio Mapping , che fornisce un’interfaccia interattiva per mappare i dati di origine a un set di dati della Platform.

Scegli un set di dati in entrata in cui acquisire i dati. Puoi utilizzare un set di dati esistente o crearne uno nuovo.

Utilizzare un set di dati esistente

Per acquisire dati in un set di dati esistente, seleziona Existing dataset, quindi fai clic sull’icona del set di dati.

Viene visualizzata la finestra di dialogo Select dataset. Trova il set di dati che desideri utilizzare, selezionalo, quindi fai clic su Continue.

Utilizzare un nuovo set di dati

Per acquisire dati in un nuovo set di dati, seleziona New dataset e immetti un nome e una descrizione per il set di dati nei campi forniti.

È possibile allegare un campo schema immettendo un nome schema nella barra di ricerca Select schema. Puoi anche selezionare l’icona a discesa per visualizzare un elenco degli schemi esistenti. In alternativa, puoi selezionare Advanced search per accedere alla schermata degli schemi esistenti, inclusi i rispettivi dettagli.

Durante questo passaggio, puoi abilitare il set di dati per Real-time Customer Profile e creare una visualizzazione olistica degli attributi e dei comportamenti di un’entità. I dati di tutti i set di dati abilitati verranno inclusi in Profile e le modifiche vengono applicate al salvataggio del flusso di dati.

Attiva il pulsante Profile dataset per abilitare il set di dati di destinazione per Profile.

Viene visualizzata la finestra di dialogo Select schema. Seleziona lo schema da applicare al nuovo set di dati, quindi fai clic su Done.

In base alle tue esigenze, puoi scegliere di mappare direttamente i campi oppure utilizzare funzioni di mappatura per trasformare i dati di origine in valori calcolati o calcolati. Per ulteriori informazioni sulla mappatura dei dati e sulle funzioni di mappatura, consulta l’esercitazione sulla mappatura dei dati CSV nei campi dello schema XDM.

Seleziona Preview data per visualizzare i risultati della mappatura di fino a 100 righe di dati di esempio dal set di dati selezionato.

Durante l’anteprima, la colonna Identity ha la priorità come primo campo, in quanto rappresenta le informazioni chiave necessarie per la convalida dei risultati della mappatura.

Una volta mappati i dati di origine, seleziona Close.

Pianifica esecuzioni di acquisizione

Viene visualizzato il passaggio Scheduling , che consente di configurare una pianificazione dell’acquisizione per acquisire automaticamente i dati di origine selezionati utilizzando le mappature configurate. La tabella seguente illustra i diversi campi configurabili per la pianificazione:

I flussi di dati sono progettati per acquisire automaticamente i dati su base pianificata. Inizia selezionando la frequenza di acquisizione. Quindi, impostare l'intervallo per indicare il periodo tra due esecuzioni di flusso. Il valore dell'intervallo deve essere un numero intero diverso da zero e deve essere impostato su maggiore o uguale a 15.

Per impostare l’ora di inizio per l’acquisizione, regola la data e l’ora visualizzate nella casella dell’ora di inizio. In alternativa, puoi selezionare l’icona del calendario per modificare il valore dell’ora di inizio. L’ora di inizio deve essere maggiore o uguale all’ora UTC corrente.

Seleziona Load incremental data by per assegnare la colonna delta. Questo campo distingue tra dati nuovi ed esistenti.

Configurare un flusso di dati di acquisizione una tantum

Per impostare l’acquisizione una tantum, seleziona la freccia a discesa della frequenza e seleziona Once.

Dopo aver fornito i valori appropriati alla pianificazione, seleziona Next.

Fornire i dettagli del flusso di dati

Viene visualizzato il passaggio Dataflow detail , che consente di assegnare un nome e una breve descrizione del nuovo flusso di dati.

Durante questo processo, puoi anche abilitare Partial ingestion e Error diagnostics. L’abilitazione di Partial ingestion consente di acquisire dati contenenti errori fino a una determinata soglia. Una volta abilitato Partial ingestion, trascina il comando Error threshold % per regolare la soglia di errore del batch. In alternativa, è possibile regolare manualmente la soglia selezionando la casella di input. Per ulteriori informazioni, consulta la panoramica sull’acquisizione parziale dei batch.
Immetti i valori per il flusso di dati e seleziona Next.

Controlla il tuo flusso di dati

Viene visualizzato il passaggio Review , che consente di rivedere il nuovo flusso di dati prima della creazione. I dettagli sono raggruppati nelle seguenti categorie:

• Connection: Mostra il tipo di origine, il percorso pertinente del file di origine scelto e la quantità di colonne all'interno del file di origine.
• Assign dataset & map fields: Mostra il set di dati in cui vengono acquisiti i dati di origine, incluso lo schema a cui il set di dati aderisce.
• Scheduling: Mostra il periodo, la frequenza e l’intervallo attivi della pianificazione dell’acquisizione.

Dopo aver esaminato il flusso di dati, fai clic su Finish e consenti la creazione del flusso di dati.

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 sui tassi di acquisizione, sul successo e sugli errori. Per ulteriori informazioni su come monitorare il flusso di dati, consulta l’esercitazione su monitoraggio di account e flussi di dati nell’interfaccia utente.

Elimina il flusso di dati

È possibile eliminare i flussi di dati che non sono più necessari o che sono stati creati in modo errato utilizzando la funzione Delete disponibile nell'area di lavoro Dataflows. Per ulteriori informazioni su come eliminare i flussi di dati, consulta l’esercitazione sull’ eliminazione dei flussi di dati nell’interfaccia utente.

Passaggi successivi

Seguendo questa esercitazione, hai creato correttamente un flusso di dati per inserire dati da un database esterno e hai acquisito informazioni sul monitoraggio dei set di dati. I dati in entrata possono ora essere utilizzati dai servizi a valle Platform come Real-time Customer Profile e Data Science Workspace. Per ulteriori informazioni, consulta i seguenti documenti:

• Real-time Customer Profile panoramica
• Data Science Workspace panoramica

Appendice

Le sezioni seguenti forniscono informazioni aggiuntive per l’utilizzo dei connettori sorgente.

Disattiva un flusso di dati

Quando un flusso di dati viene creato, diventa immediatamente attivo e acquisisce i dati in base alla pianificazione specificata. Puoi disattivare un flusso di dati attivo in qualsiasi momento seguendo le istruzioni riportate di seguito.

Nell’area di lavoro Sources, seleziona la scheda Dataflows . Quindi, seleziona il flusso di dati da disattivare.

La colonna Properties viene visualizzata sul lato destro dello schermo, incluso un pulsante di attivazione/disattivazione Enabled. Seleziona l’interruttore per disattivare il flusso di dati. La stessa opzione può essere utilizzata per riattivare un flusso di dati dopo che è stato disabilitato.

Attivare i dati in entrata per la popolazione Profile

I dati in entrata provenienti dal connettore di origine possono essere utilizzati per arricchire e popolare i dati Real-time Customer Profile. Per ulteriori informazioni sulla compilazione dei dati Real-time Customer Profile, consulta l’esercitazione su Popolazione di profili.