DocumentazioneCampaignDocumentazione di Campaign Classic v7

Configurare l’accesso a Google BigQuery configure-fda-google-big-query

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Utilizzare l'opzione Federated Data Access (FDA) di Adobe Campaign Classic per elaborare le informazioni archiviate in un database esterno. Per configurare l'accesso a Google BigQuery, eseguire la procedura seguente.

  1. Configura Google BigQuery in Windows o Linux
  2. Configura l'Google BigQuery account esterno in Adobe Campaign Classic
  3. Configura il caricamento bulk del connettore Google BigQuery su Windows o Linux
NOTE
Il connettore Google BigQuery è disponibile per le distribuzioni in hosting, ibride e on-premise. Per ulteriori informazioni, consulta questa pagina.

BigQuery Google su Windows google-windows

Configurazione del driver su Windows driver-window

  1. Scarica il driver ODBC per Windows.

  2. Configurare il driver ODBC in Windows. Per ulteriori informazioni, consulta questa pagina.

  3. Affinché il connettore Google BigQuery funzioni, Adobe Campaign Classic richiede i seguenti parametri per connettersi:

    • Project: creare o utilizzare un progetto esistente.

      Per ulteriori informazioni, consulta questa pagina.

    • Service account: creare un account di servizio.

      Per ulteriori informazioni, consulta questa pagina.

    • Key File Path: Service account richiede Key File per una connessione Google BigQuery tramite ODBC.

      Per ulteriori informazioni, consulta questa pagina.

    • Dataset: Dataset è facoltativo per una connessione ODBC. Poiché ogni query deve fornire il set di dati in cui si trova la tabella, specificare un Dataset è obbligatorio per il connettore FDA Google BigQuery in Adobe Campaign Classic.

      Per ulteriori informazioni, consulta questa pagina.

  4. In Adobe Campaign Classic è quindi possibile configurare l'account esterno Google BigQuery. Per ulteriori informazioni su come configurare l'account esterno, consulta questa sezione.

Caricamento di massa configurato su Windows bulk-load-window

NOTE
Per il corretto funzionamento di Google Cloud SDK è necessario che sia installato Python.
Si consiglia di utilizzare Python3, vedere questa pagina.

L’utility Bulk Load consente un trasferimento più rapido, grazie all’SDK di Google Cloud.

  1. Scarica l'archivio di Windows a 64 bit (x86_64) da questa pagina ed estrailo nella directory corrispondente.

  2. Eseguire lo script google-cloud-sdk\install.sh. È necessario accettare l'impostazione della variabile di percorso.

  3. Dopo l'installazione, verificare che la variabile percorso ...\google-cloud-sdk\bin sia impostata. In caso contrario, aggiungerlo manualmente.

  4. Nel file ..\google-cloud-sdk\bin\bq.cmd, aggiungere la variabile locale CLOUDSDK_PYTHON, che verrà reindirizzata al percorso dell'installazione Python.

    Ad esempio:

  5. Riavvia Adobe Campaign Classic per tenere conto delle modifiche.

Google BigQuery su Linux google-linux

Configurazione del driver su Linux driver-linux

Prima di configurare il driver, si noti che gli script e i comandi devono essere eseguiti dall'utente root. Durante l’esecuzione dello script, si consiglia inoltre di utilizzare il DNS Google 8.8.8.8.

Per configurare Google BigQuery su Linux, eseguire la procedura seguente:

  1. Prima dell'installazione di ODBC, verificare che i seguenti pacchetti siano installati nella distribuzione Linux:

    • Per Red Hat/CentOS:

      code language-none 
      yum update
yum upgrade
yum install -y grep sed tar wget perl curl

    • Per Debian:

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y grep sed tar wget perl curl

  2. Aggiornare il sistema prima dell'installazione:

    • Per Red Hat/CentOS:

      code language-none 
      # install unixODBC driver manager
yum install -y unixODBC

    • Per Debian:

      code language-none 
      # install unixODBC driver manager
apt-get install -y odbcinst1debian2 libodbc1 odbcinst unixodbc

  3. Prima di eseguire lo script, è possibile ottenere ulteriori informazioni specificando l'argomento —help:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh --help

  4. Accedere alla directory in cui si trova lo script ed eseguire lo script seguente come utente root:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh

Caricamento di massa configurato su Linux bulk-load-linux

NOTE
Per il corretto funzionamento di Google Cloud SDK è necessario che sia installato Python.
Si consiglia di utilizzare Python3, vedere questa pagina.

L’utility Bulk Load consente un trasferimento più rapido, grazie all’SDK di Google Cloud.

  1. Prima dell'installazione di ODBC, verificare che i seguenti pacchetti siano installati nella distribuzione Linux:

    • Per Red Hat/CentOS:

      code language-none 
      yum update
yum upgrade
yum install -y python3

    • Per Debian:

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y python3

  2. Accedere alla directory in cui si trova lo script ed eseguire lo script seguente:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_sdk-setup.sh

Account esterno Google BigQuery google-external

È necessario creare un account esterno Google BigQuery per connettere l'istanza di Adobe Campaign Classic al database esterno Google BigQuery.

  1. Da Adobe Campaign Classic Explorer, fare clic su Administration '>' Platform '>' External accounts.

  2. Fai clic su New.

  3. Seleziona External database come Type del tuo account esterno.

  4. Configurare l'account esterno Google BigQuery. È necessario specificare:

    • Type: Google BigQuery

    • Service account: e-mail di Service account. Per ulteriori informazioni, consulta Documentazione di Google Cloud.

    • Project: nome di Project. Per ulteriori informazioni, consulta Documentazione di Google Cloud.

    • Key file Path:

      • Upload key file to the server: seleziona Click here to upload se scegli di caricare la chiave tramite Adobe Campaign Classic.

      • Enter manually the key file path: copia/incolla il percorso assoluto in questo campo se scegli di utilizzare una chiave preesistente.

    • Dataset: nome di Dataset. Per ulteriori informazioni, consulta Documentazione di Google Cloud.

Il connettore supporta le seguenti opzioni:

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, è possibile specificare con questa opzione il percorso esatto della directory bin dell'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 massa (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 massa (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 può essere modificato se necessario.
GCloudRecreateConfig
Tieni presente che questo è applicabile a partire dalla versione 7.3.4 e solo per lo strumento di caricamento in massa (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 massa 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 bulk predefinito per Inserisci array ODBC.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1