DocumentazioneCampaignDocumentazione di Campaign Classic v7

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

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Usa Adobe Campaign Classic Federated Data Access (FDA) per elaborare le informazioni memorizzate in un database esterno. Segui i passaggi seguenti per configurare l’accesso a Google BigQuery.

  1. Configura Google BigQuery il Windows o Linux
  2. Configurare Google BigQuery account esterno in Adobe Campaign Classic
  3. Configurazione Google BigQuery carico di massa del connettore attivato Windows o Linux
NOTE
Google BigQuery il connettore è 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 file Driver ODBC per Windows.

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

  3. Per Google BigQuery per il funzionamento del connettore, Adobe Campaign Classic richiede i seguenti parametri per la connessione:

    • Project: crea o utilizza un progetto esistente.

      Per ulteriori informazioni, consulta questa pagina.

    • Service account: crea un account di servizio.

      Per ulteriori informazioni, consulta questa pagina.

    • Key File Path: il Service account richiede un Key File per un 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, specificando un Dataset è obbligatorio per Google BigQuery Connettore FDA in Adobe Campaign Classic.

      Per ulteriori informazioni, consulta questa pagina.

  4. In Adobe Campaign Classic, puoi quindi configurare Google BigQuery account esterno. 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 pagina.

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

  1. Scarica l'archivio Windows a 64 bit (x86_64) da questo pagina ed estrarlo nella directory corrispondente.

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

  3. Dopo l’installazione, verifica che la variabile del percorso ...\google-cloud-sdk\bin è impostato. In caso contrario, aggiungerlo manualmente.

  4. In ..\google-cloud-sdk\bin\bq.cmd file, aggiungi CLOUDSDK_PYTHON variabile locale, che verrà reindirizzata alla posizione 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, segui i passaggi seguenti:

  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 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

Devi creare un Google BigQuery account esterno per collegare l’istanza Adobe Campaign Classic al tuo Google BigQuery database esterno.

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

  2. Fai clic su New.

  3. Seleziona External database come dell’account esterno Type.

  4. Configurare Google BigQuery account esterno, è necessario specificare:

    • Type: Google BigQuery

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

    • Project: nome del 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 del 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.
Attualmente sono 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 puoi specificare 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).
La configurazione SDK di Google Cloud attiva non può essere eliminata 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, questo valore 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 evita di tentare 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 emetterà 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