DocumentazioneComposizione di pubblico federato di Experience Platform

[Disponibilità limitata]{class="badge informative"}

Configurare i database federati federated-db

Last update: Tue Oct 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

La composizione di pubblico federato di Experience Platform consente di creare e arricchire i tipi di pubblico dai data warehouse di terze parti e di importarli in Adobe Experience Platform.

Scopri come creare, configurare, testare e salvare la connessione al database esterno in questa pagina. Di seguito è riportato l’elenco dei database supportati e le impostazioni dettagliate da configurare per ciascuno di essi.

Database supportati supported-db

Con la composizione di pubblico federato puoi connetterti ai seguenti database. La configurazione di ciascun database è descritta di seguito.

Amazon Redshift amazon-redshift

Utilizza i database federati per elaborare le informazioni archiviate in un database esterno. Segui i passaggi seguenti per configurare l’accesso ad Amazon Redshift.

  1. Nel menu Dati federati, seleziona Database federati.

  2. Fai clic su Aggiungi database federato.

  3. Immetti un Nome nel database federato.

  4. Dal menu a discesa Tipo, seleziona Amazon Redshift.

  5. Configura le impostazioni di autenticazione Amazon Redshift:

    • Server: aggiungi il nome del DNS.

    • Account: aggiungi il nome utente.

    • Password: aggiungi la password dell’account.

    • Database: nome del database se non specificato nel DSN. Se specificato nel DSN, questo campo può essere lasciato vuoto.

    • Schema di lavoro: nome dello schema del database da utilizzare per le tabelle di lavoro. Ulteriori informazioni sono disponibili nella sezione della documentazione di Amazon

      note note
      NOTE
      È possibile utilizzare qualsiasi schema del database, inclusi gli schemi utilizzati per l’elaborazione dati temporanea, purché si disponga dell’autorizzazione necessaria per connettersi a tale schema.
      È necessario utilizzare schemi di lavoro distinti per connettere più sandbox con lo stesso database.

  6. Seleziona l’opzione Verifica la connessione per verificare la configurazione.

  7. Fai clic sul pulsante Distribuisci funzioni per creare le funzioni.

  8. Al termine della configurazione, fai clic su Aggiungi per creare il database federato.

Azure Synapse Analytics azure-synapse

Utilizza i database federati per elaborare le informazioni archiviate in un database esterno. Segui i passaggi seguenti per configurare l’accesso ad Azure Synapse Analytics.

  1. Nel menu Dati federati, seleziona Database federati.

  2. Fai clic su Aggiungi database federato.

  3. Immetti un Nome nel database federato.

  4. Dal menu a discesa Tipo, seleziona Azure Synapse Analytics.

  5. Configura le impostazioni di autenticazione di Azure Synapse Analytics:

    • Server: immetti l’URL del server di Azure Synapse.

    • Account: immetti il nome utente.

    • Password: immetti la password dell’account.

    • Database (facoltativo): immetti il nome del database se non specificato nel DSN.

    • Opzioni: il connettore supporta le opzioni descritte nella tabella seguente.

  6. Seleziona l’opzione Verifica la connessione per verificare la configurazione.

  7. Fai clic sul pulsante Distribuisci funzioni per creare le funzioni.

  8. Al termine della configurazione, fai clic su Aggiungi per creare il database federato.

Opzione
Descrizione
Autenticazione
Tipo di autenticazione supportato dal connettore. Valore attualmente supportato: ActiveDirectoryMSI. Per ulteriori informazioni, fai riferimento alla documentazione SQL di Microsoft (esempio di stringhe di connessione n. 8)

Google BigQuery google-big-query

Utilizza i database federati per elaborare le informazioni archiviate in un database esterno. Segui i passaggi seguenti per configurare l’accesso a Google BigQuery.

  1. Nel menu Dati federati, seleziona Database federati.

  2. Fai clic su Aggiungi database federato.

  3. Immetti un Nome nel database federato.

  4. Dal menu a discesa Tipo, seleziona Google BigQuery.

  5. Configura le impostazioni di autenticazione di Google BigQuery:

    • Account di servizio: immetti l’indirizzo e-mail del tuo Account di servizio. Per ulteriori informazioni, consulta la documentazione di Google Cloud.

    • Progetto: immetti l’ID del Progetto. Per ulteriori informazioni, consulta la documentazione di Google Cloud.

    • Set di dati: immetti il nome del Set di dati. Per ulteriori informazioni, consulta la documentazione di Google Cloud.

    • Percorso file della chiave: carica il file della chiave nel server. Sono accettati solo i file .JSON.

    • Opzioni: il connettore supporta le opzioni descritte nella tabella seguente.

  6. Seleziona l’opzione Verifica la connessione per verificare la configurazione.

  7. Fai clic sul pulsante Distribuisci funzioni per creare le funzioni.

  8. Al termine della configurazione, fai clic su Aggiungi per creare il database federato.

Opzione
Descrizione
ProxyType
Tipo di proxy utilizzato per connettersi a BigQuery tramite connettori ODBC e SDK. Sono attualmente supportati
HTTP (impostazione predefinita), http_no_tunnel, socks4 e socks5.
ProxyHost
Nome host o indirizzo IP in cui è possibile raggiungere il proxy.
ProxyPort
Numero di porta su cui è in esecuzione il proxy, ad esempio 8080
ProxyUid
Nome utente utilizzato per il proxy autenticato
ProxyPwd
Password ProxyUid
bqpath
Tieni presente che questo è applicabile solo per lo strumento di caricamento in blocco (SDK per cloud).
Per evitare di utilizzare la variabile PATH o se la directory google-cloud-sdk deve essere spostata in un’altra posizione, con questa opzione è possibile specificare il percorso esatto della directory bin SDK cloud sul server.
GCloudConfigName
Tieni presente che questo è applicabile a partire dalla versione 7.3.4 e solo per lo strumento di caricamento in blocco (Cloud SDK).
L’SDK di Google Cloud utilizza le configurazioni per caricare i dati nelle tabelle BigQuery. La configurazione denominata accfda memorizza i parametri per il caricamento dei dati. Tuttavia, questa opzione consente agli utenti di specificare un nome diverso per la configurazione.
GCloudDefaultConfigName
Tieni presente che questo è applicabile a partire dalla versione 7.3.4 e solo per lo strumento di caricamento in blocco (Cloud SDK).
Impossibile eliminare la configurazione SDK di Google Cloud attiva senza prima trasferire il tag attivo in una nuova configurazione. Questa configurazione temporanea è necessaria per ricreare la configurazione principale per il caricamento dei dati. Il nome predefinito per la configurazione temporanea è default, che, in base alle necessità, può essere modificato.
GCloudRecreateConfig
Tieni presente che questo è applicabile a partire dalla versione 7.3.4 e solo per lo strumento di caricamento in blocco (Cloud SDK).
Se è impostato su false, il meccanismo di caricamento in blocco non tenta di ricreare, eliminare o modificare le configurazioni dell’SDK di Google Cloud. Procede invece con il caricamento dei dati utilizzando la configurazione esistente sul computer. Questa funzione è utile quando altre operazioni dipendono dalle configurazioni dell’SDK di Google Cloud.
Se l’utente abilita questa opzione del motore senza una configurazione corretta, il meccanismo di caricamento in blocco invierà un messaggio di avviso: No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option. Per evitare ulteriori errori, verrà utilizzato il meccanismo di caricamento in blocco predefinito per Inserisci array ODBC.

Snowflake snowflake

NOTE
È supportato l'accesso sicuro al data warehouse di Snowflake esterno tramite collegamento privato. Il tuo account di Snowflake deve essere ospitato su Amazon Web Services (AWS) e si trova nella stessa area dell’ambiente Federated Audience Composition. Contatta il tuo rappresentante Adobe per assistenza nella configurazione dell’accesso sicuro al tuo account di Snowflake.

Utilizza i database federati per elaborare le informazioni archiviate in un database esterno. Segui i passaggi seguenti per configurare l’accesso a Snowflake.

  1. Nel menu Dati federati, seleziona Database federati.

  2. Fai clic su Aggiungi database federato.

  3. Immetti un Nome nel database federato.

  4. Dal menu a discesa Tipo, seleziona Snowflake.

  5. Configura le impostazioni dell’autenticazione di Snowflake:

    • Server: immetti il nome del server.

    • Utente: inserisci il tuo nome utente.

    • Password: immetti la password del tuo account.

    • Database (facoltativo): immetti il nome del database se non specificato nel DSN.

    • Schema di lavoro (facoltativo): immettere il nome dello schema del database da utilizzare per le tabelle di lavoro.

      note note
      NOTE
      È possibile utilizzare qualsiasi schema del database, inclusi gli schemi utilizzati per l’elaborazione dati temporanea, purché si disponga dell’autorizzazione necessaria per connettersi a tale schema.
      È necessario utilizzare utilizzare schemi di lavoro distinti per connettere più sandbox con lo stesso database.

    • Chiave privata: fai clic sul campo Chiave privata per selezionare i file con estensione .pem dalla cartella locale.

    • Opzioni: il connettore supporta le opzioni descritte nella tabella seguente.

  6. Seleziona l’opzione Verifica la connessione per verificare la configurazione.

  7. Fai clic sul pulsante Distribuisci funzioni per creare le funzioni.

  8. Al termine della configurazione, fai clic su Aggiungi per creare il database federato.

Il connettore supporta le seguenti opzioni:

Opzione
Descrizione
schema di lavoro
Schema di database da utilizzare per le tabelle di lavoro
data warehouse
Nome del data warehouse predefinito da utilizzare. Sostituirà l’impostazione predefinita dell’utente.
TimeZoneName
Per impostazione predefinita, questo significa che viene utilizzato il fuso orario del server dell’app. L’opzione può essere utilizzata per forzare il parametro di sessione TIMEZONE.
Per ulteriori informazioni, consulta questa pagina.
WeekStart
Parametro di sessione WEEK_START. Per impostazione predefinita, è impostato su 0.
Per ulteriori informazioni, consulta questa pagina.
UseCachedResult
Parametro di sessione USE_CACHED_RESULTS. Per impostazione predefinita, è impostato su TRUE. Questa opzione può essere utilizzata per disabilitare i risultati di Snowflake memorizzati nella cache.
Per ulteriori informazioni, consulta questa pagina.
bulkThreads
Numero di thread da utilizzare per il caricamento in blocco di Snowflake; un numero maggiore di thread indica prestazioni migliori per caricamenti in blocco di maggiori dimensioni. Per impostazione predefinita, è impostato su 1. Il numero può essere regolato, a seconda del conteggio di thread automatico.
chunkSize
Determina la dimensione del file di un blocco del caricamento in blocco. Per impostazione predefinita, è impostata su 128 MB. Può essere modificata per ottenere prestazioni migliori se utilizzata con bulkThreads. Un numero maggiore di thread attivi contemporaneamente garantisce prestazioni migliori.
Per ulteriori informazioni, consulta la documentazione Snowflake.
StageName
Nome della fase interna di pre-provisioning. Verrà utilizzato nel caricamento in blocco anziché creare una nuova fase temporanea.

Vertica Analytics vertica-analytics

Utilizza i database federati per elaborare le informazioni archiviate in un database esterno. Per configurare l’accesso a Vertica Analytics, segui la procedura riportata di seguito.

  1. Nel menu Dati federati, seleziona Database federati.

  2. Fai clic su Aggiungi database federato.

  3. Immetti un Nome nel database federato.

  4. Seleziona Vertica Analytics dal menu a discesa Tipo.

  5. Configura le impostazioni di autenticazione Vertica Analytics:

    • Server: aggiungi l’URL del server Vertica Analytics.

    • Account: aggiungi il nome utente.

    • Password: aggiungi la password dell’account.

    • Database (facoltativo): immetti il nome del database se non specificato nel DSN.

    • Schema di lavoro (facoltativo): immettere il nome dello schema del database da utilizzare per le tabelle di lavoro.

      note note
      NOTE
      È possibile utilizzare qualsiasi schema del database, inclusi gli schemi utilizzati per l’elaborazione dati temporanea, purché si disponga dell’autorizzazione necessaria per connettersi a tale schema.
      È necessario utilizzare schemi di lavoro distinti per connettere più sandbox con lo stesso database.

    • Opzioni: il connettore supporta le opzioni descritte nella tabella seguente.

  6. Seleziona l’opzione Verifica la connessione per verificare la configurazione.

  7. Fai clic sul pulsante Distribuisci funzioni per creare le funzioni.

  8. Al termine della configurazione, fai clic su Aggiungi per creare il database federato.

Il connettore supporta la seguente opzione:

Opzione
Descrizione
TimeZoneName
Per impostazione predefinita, questo significa che viene utilizzato il fuso orario del server dell’app. L’opzione può essere utilizzata per forzare il parametro di sessione TIMEZONE.

Database databricks

Utilizza i database federati per elaborare le informazioni archiviate in un database esterno. Per configurare l’accesso alle banche dati, segui la procedura riportata di seguito.

  1. Nel menu Dati federati, seleziona Database federati.

  2. Fai clic su Aggiungi database federato.

  3. Immetti un Nome nel database federato.

  4. Selezionare Database dal menu a discesa Tipo.

  5. Configurare le impostazioni di autenticazione dei database:

    • Server: aggiungere il nome del server di database.

    • Percorso HTTP: aggiungere il percorso al cluster o al data warehouse. Ulteriori informazioni

    • Password: aggiungi il token di accesso dell'account. Ulteriori informazioni

    • Catalogo: aggiungere il campo per il catalogo dei database.

    • Schema di lavoro: nome dello schema di database da utilizzare per le tabelle di lavoro.

      note note
      NOTE
      È possibile utilizzare qualsiasi schema del database, inclusi gli schemi utilizzati per l’elaborazione dati temporanea, purché si disponga dell’autorizzazione necessaria per connettersi a tale schema.
      È necessario utilizzare schemi di lavoro distinti per connettere più sandbox con lo stesso database.

    • Opzioni: il connettore supporta le opzioni descritte nella tabella seguente.

  6. Seleziona l’opzione Verifica la connessione per verificare la configurazione.

  7. Fai clic sul pulsante Distribuisci funzioni per creare le funzioni.

  8. Al termine della configurazione, fai clic su Aggiungi per creare il database federato.

Il connettore supporta le seguenti opzioni:

Opzione
Descrizione
TimeZoneName
Per impostazione predefinita, questo significa che viene utilizzato il fuso orario del server dell’app. L’opzione può essere utilizzata per forzare il parametro di sessione TIMEZONE.
recommendation-more-help
fadff0d9-29d0-4d44-99a6-2499b0b7778b