Connessione Azure Data Lake Storage Gen2
Panoramica overview
Leggi questa pagina per scoprire come creare una connessione in uscita al data lake Azure Data Lake Storage Gen2 (ADLS Gen2) per esportare periodicamente i file di dati da Experience Platform.
Connettersi all'archiviazione ADLS Gen2 tramite API o interfaccia utente connect-api-or-ui
- Per connettersi al percorso di archiviazione ADLS Gen2 tramite l'interfaccia utente di Platform, leggere le sezioni Connetti alla destinazione e Attiva i tipi di pubblico a questa destinazione di seguito.
- Per connettersi al percorso di archiviazione ADLS Gen2 a livello di programmazione, leggere l'esercitazione Attiva tipi di pubblico in destinazioni basate su file.
Tipi di pubblico supportati supported-audiences
Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.
Tipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
Esporta set di dati export-datasets
Questa destinazione supporta le esportazioni di set di dati. Per informazioni complete su come impostare le esportazioni dei set di dati, consulta le esercitazioni:
Formato file dei dati esportati file-format
Durante l'esportazione di dati sul pubblico, Platform crea un file .csv, parquet o .json nel percorso di archiviazione fornito. Per ulteriori informazioni sui file, consulta la sezione formati di file supportati per l'esportazione nell'esercitazione di Audience Activation.
Durante l'esportazione di set di dati, Platform crea un file .parquet o .json nel percorso di archiviazione fornito. Per ulteriori informazioni sui file, consulta la sezione Verifica dell'esportazione dei set di dati nell'esercitazione sull'esportazione dei set di dati.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.
Autenticarsi nella destinazione authenticate
Per eseguire l'autenticazione nella destinazione, compilare i campi obbligatori e selezionare Connetti alla destinazione.
-
URL: endpoint per Azure Data Lake Storage Gen2. Schema endpoint:
abfss://<container>@<accountname>.dfs.core.windows.net. -
Tenant: le informazioni del tenant che contengono l'applicazione.
-
ID entità servizio: ID client dell'applicazione.
-
Chiave principale servizio: chiave dell'applicazione.
-
Chiave di crittografia: facoltativamente, è possibile allegare la chiave pubblica in formato RSA per aggiungere la crittografia ai file esportati. Visualizza un esempio di chiave di crittografia formattata correttamente nell’immagine seguente.
Inserire i dettagli della destinazione destination-details
Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
-
Nome: immettere il nome preferito per la destinazione.
-
Descrizione: facoltativo. Ad esempio, puoi indicare per quale campagna stai utilizzando questa destinazione.
-
Percorso cartella: immettere il percorso della cartella di destinazione che ospiterà i file esportati.
-
Tipo di file: selezionare il formato da utilizzare per i file esportati dall'Experience Platform. Quando selezioni l'opzione CSV, puoi anche configurare le opzioni di formattazione del file.
-
Formato di compressione: selezionare il tipo di compressione che Experience Platform deve utilizzare per i file esportati.
-
Includi file manifesto: attivare questa opzione se si desidera che le esportazioni includano un file JSON manifesto contenente informazioni sul percorso di esportazione, sulle dimensioni dell'esportazione e altro ancora. Il manifesto è denominato nel formato
manifest-<<destinationId>>-<<dataflowRunId>>.json. Visualizza un file manifesto di esempio. Il file manifesto include i campi seguenti:flowRunId: esecuzione del flusso di dati che ha generato il file esportato.scheduledTime: ora in UTC in cui è stato esportato il file.exportResults.sinkPath: il percorso nel percorso di archiviazione in cui è depositato il file esportato.exportResults.name: nome del file esportato.size: dimensione del file esportato, in byte.
Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
- Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
- Per esportare identità, è necessario disporre dell'autorizzazione Visualizza grafo identità Controllo di accesso.
Per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione, consulta Attiva dati pubblico nelle destinazioni di esportazione profilo batch.
Pianificazione scheduling
Nel passaggio Pianificazione, puoi impostare la pianificazione dell'esportazione per la destinazione Azure Data Lake Storage Gen2 e configurare il nome dei file esportati.
Mappare attributi e identità map
Nel passaggio Mappatura, puoi selezionare l'attributo e i campi di identità da esportare per i profili. Puoi anche scegliere di modificare le intestazioni nel file esportato con qualsiasi nome descrittivo. Per ulteriori informazioni, vedi il passaggio di mappatura nell'esercitazione dell'interfaccia utente per l'attivazione di destinazioni batch.
Convalidare l’esportazione dei dati exported-data
Per verificare se i dati sono stati esportati correttamente, controllare l'archivio Azure Data Lake Storage Gen2 e assicurarsi che i file esportati contengano le popolazioni di profilo previste.