Configurare un flusso di dati per un connettore di database nell'interfaccia utente

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

Introduzione

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

  • Experience Data Model (XDM) Sistema: Il framework standard con cui Experience Platform organizza i dati sull'esperienza dei clienti.
    • Nozioni di base sulla composizionedello schema: Scoprite i componenti di base degli schemi XDM, inclusi i principi chiave e le procedure ottimali nella composizione dello schema.
    • Esercitazionesull'Editor di schema: Scoprite come creare schemi personalizzati utilizzando l'interfaccia utente dell'Editor di schema.
  • Real-time Customer Profile: Fornisce un profilo di consumo unificato e in tempo reale basato su dati aggregati provenienti da più origini.

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

Seleziona dati

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

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

È possibile utilizzare l' Search opzione nella parte superiore della pagina per identificare rapidamente i dati di origine che si intende utilizzare.

Nota

L'opzione per i dati dell'origine di ricerca è disponibile per tutti i connettori sorgente basati su tabelle, ad eccezione dei connettori Analytics, Classifications, Event Hubs e Kinesis.

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

select-data

Mappatura dei 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 piattaforma.

Scegliere un set di dati in entrata in cui assimilare i dati. È possibile utilizzare un set di dati esistente o crearne uno nuovo.

Utilizzare un dataset esistente

Per assimilare i dati in un dataset esistente, selezionare Existing dataset, quindi fare clic sull'icona del dataset.

Viene visualizzata Select dataset la finestra di dialogo. Trovare il set di dati che si desidera utilizzare, selezionarlo, quindi fare clic Continue.

Utilizza un nuovo set di dati

Per assimilare i dati in un nuovo dataset, selezionare New dataset e immettere un nome e una descrizione per il dataset nei campi forniti.

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

Durante questo passaggio, potete abilitare il dataset 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 verranno applicate al salvataggio del flusso di dati.

Attivate il Profile dataset pulsante per attivare il set di dati di destinazione per Profile.

create-new-dataset

Viene visualizzata Select schema la finestra di dialogo. Selezionare lo schema che si desidera applicare al nuovo dataset, quindi fare clic su Done.

In base alle esigenze, è possibile scegliere di mappare direttamente i campi oppure utilizzare le funzioni di mappatura per trasformare i dati di origine in modo da derivare i valori calcolati o calcolati. Per ulteriori informazioni sulla mappatura dei dati e sulle funzioni di mappatura, consulta l’esercitazione sulla mappatura dei dati CSV ai campidello schema XDM.

SUGGERIMENTO

Platform fornisce raccomandazioni intelligenti per i campi mappati automaticamente in base allo schema di destinazione o al dataset selezionato. Puoi regolare manualmente le regole di mappatura in base ai tuoi casi di utilizzo.

Selezionate 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 dell'identità ha priorità come primo campo, in quanto rappresenta le informazioni chiave necessarie per convalidare i risultati della mappatura.

Una volta mappati i dati di origine, selezionare Close.

Pianificare le esecuzioni dell'assimilazione

Viene visualizzato il Scheduling passaggio che consente di configurare una pianificazione di assimilazione per l'acquisizione automatica dei dati di origine selezionati tramite le mappature configurate. Nella tabella seguente sono riportati i diversi campi configurabili per la pianificazione:

Campo Descrizione
Frequenza Le frequenze selezionabili includono Once, Minute, Hour, Daye Week.
Intervallo Un numero intero che imposta l'intervallo per la frequenza selezionata.
Ora di inizio Una marca temporale UTC che indica quando è impostata la prima assimilazione.
Backfill Un valore booleano che determina i dati inizialmente acquisiti. Se Backfill è abilitata, tutti i file correnti nel percorso specificato verranno acquisiti durante la prima assimilazione pianificata. Se Backfill è disattivato, verranno assimilati solo i file caricati tra la prima esecuzione dell'assimilazione e l'ora di inizio. I file caricati prima dell'ora di inizio non vengono assimilati.
Colonna Delta Opzione con un set filtrato di campi dello schema di origine di tipo, data o ora. Questo campo è utilizzato per distinguere tra dati nuovi ed esistenti. I dati incrementali verranno acquisiti in base alla marca temporale della colonna selezionata.

I flussi di dati sono progettati per l'acquisizione automatica dei dati su base programmata. Per iniziare, selezionate la frequenza di assimilazione. Quindi, impostare l'intervallo per specificare 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 dell’assimilazione, regolate la data e l’ora visualizzate nella casella Ora di inizio. In alternativa, potete 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.

Selezionare Load incremental data by per assegnare la colonna delta. Questo campo consente di distinguere tra dati nuovi ed esistenti.

Impostazione di un flusso di dati per l’assimilazione una tantum

Per impostare l’inserimento una tantum, selezionate la freccia a discesa di frequenza e selezionate Once.

SUGGERIMENTO

Interval e non Backfill sono visibili durante un'assimilazione una tantum.

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

Fornire i dettagli del flusso di dati

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

Durante questo processo, potete anche abilitare Partial ingestion e Error diagnostics. L'attivazione Partial ingestion consente di assimilare i dati contenenti errori fino a una determinata soglia. Una volta Partial ingestion attivato, trascinare il Error threshold % quadrante per regolare la soglia di errore del batch. In alternativa, è possibile regolare manualmente la soglia selezionando la casella di input. Per ulteriori informazioni, consultate la panoramica sull’assimilazione parziale deibatch.
Immettete i valori per il flusso di dati e selezionate Next.

Controllare il flusso di dati

Viene visualizzato il Review passaggio 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 di assimilazione.

Dopo aver rivisto 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 attraverso di esso per visualizzare informazioni su velocità di assimilazione, successo ed errori. Per ulteriori informazioni su come monitorare il flusso di dati, consulta l’esercitazione sul monitoraggio di account e flussi di dati nell’interfaccia utente.

Eliminare il flusso di dati

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

Passaggi successivi

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

Appendice

Le sezioni seguenti forniscono informazioni aggiuntive sull'utilizzo dei connettori di origine.

Disattivazione di un flusso di dati

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

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

La Properties colonna viene visualizzata sul lato destro dello schermo, con un pulsante di Enabled attivazione/disattivazione. Selezionate l’opzione 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 Profile popolazione

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

In questa pagina