Configurar o acesso ao Google BigQuery

Use a opção Adobe Campaign Classic Federated Data Access (FDA) para processar informações armazenadas em um banco de dados externo. Siga as etapas abaixo para configurar o acesso a Google BigQuery.

1. Configurar Google BigQuery em Windows ou Linux
2. Configure a Google BigQuery conta externa no Adobe Campaign Classic
3. Configure Google BigQuery o carregamento em massa do conector no Windows ou Linux

Google BigQuery no Windows

Driver configurado no Windows

1. Instale o driver ODBC para Windows.

2. Configure o driver ODBC no Windows. Para obter mais informações, consulte esta página.

3. Para que o conector Google BigQuery funcione, o Adobe Campaign Classic exige os seguintes parâmetros para se conectar:

   • Project: criar ou usar um projeto existente.

     Para obter mais informações, consulte esta página.

   • Service account: crie uma conta de serviço.

     Para obter mais informações, consulte esta página.

   • Key File Path: o Service account requer um Key File para uma Google BigQuery conexão por meio do ODBC.

     Para obter mais informações, consulte esta página.

   • Dataset: Dataset é opcional para uma conexão ODBC. Como cada query precisa fornecer o conjunto de dados em que a tabela está localizada, especificar um Dataset é obrigatório para Google BigQuery Conector FDA no Adobe Campaign Classic.

     Para obter mais informações, consulte esta página.

4. No Adobe Campaign Classic, você pode configurar a conta externa Google BigQuery. Para obter mais informações sobre como configurar a conta externa, consulte esta seção.

Carregamento em massa configurado no Windows

O utilitário Carregamento em massa permite transferência mais rápida, que é realizada por meio do SDK da Google Cloud.

1. Baixe o arquivo do Windows de 64 bits (x86_64) a partir deste page e extraia-o no diretório correspondente.

2. Execute o script google-cloud-sdk\install.sh. É necessário aceitar a configuração da variável de caminho.

3. Após a instalação, verifique se a variável de caminho ...\google-cloud-sdk\bin está definida. Caso contrário, adicione-o manualmente.

4. No arquivo ..\google-cloud-sdk\bin\bq.cmd, adicione a variável local CLOUDSDK_PYTHON, que redirecionará para o local da instalação do Python.

   Por exemplo:

   

5. Reinicie o Adobe Campaign Classic para que as alterações sejam consideradas.

Google BigQuery no Linux

Driver configurado no Linux

1. Antes de instalar o driver ODBC, é necessário atualizar seu sistema. No Linux ou CentOS, execute o seguinte comando:

   yum update
   # install unixODBC driver manager
   yum install unixODBC
   

2. Em seguida, é necessário instalar o gerenciador de driver unixODBC com o seguinte comando:

   # switch to root user
   sudo su
   

   No Debian:

   apt-get update
   apt-get upgrade
   # install unixODBC driver manager
   apt-get install unixODBC
   

3. Baixe o driver Magnitude Simba Linux ODBC (.tar.gz). Em seguida, transfira o arquivo de tarball para uma pasta temporária em sua máquina ou use o comando wget:

   # in this example driver version is 2.3.1.1001
   wget https://storage.googleapis.com/simba-bq-release/odbc/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux.tar.gz
   

4. Extraia o arquivo de tarball principal da seguinte maneira, onde TarballName é o nome do pacote de tarball que contém o driver:

   tar --directory=/tmp -zxvf [TarballName]
   

5. Acesse a pasta extraída e extraia o arquivo de tarball interno correspondente à versão do driver. Instale-o em outra pasta temporária, no seguinte exemplo BigQueryDriver:

   mkdir /tmp/BigQueryDriver/
   cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
   tar --directory=/tmp/BigQueryDriver/ -zxvf SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version].tar.gz
   

6. Acesse o local temporário onde o arquivo de tarball principal foi extraído e copie os arquivos GoogleBigQueryODBC.did e setup/simba.googlebigqueryodbc.ini para a nova pasta criada na etapa anterior:

   cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
   cp GoogleBigQueryODBC.did /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
   cp setup/simba.googlebigqueryodbc.ini /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
   

7. Crie o diretório de instalação da seguinte maneira:

   mkdir -p /opt/simba/googlebigqueryodbc/
   

8. Copie o conteúdo do diretório no novo diretório de instalação:

   cp -r /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/* /opt/simba/googlebigqueryodbc/
   

9. Substitua <INSTALLDIR> por /opt/simba/googlebigqueryodbc em simba.googlebigqueryodbc.ini no diretório de instalação:

   cd /opt/simba/googlebigqueryodbc/lib/
   sed -i 's/<INSTALLDIR>/\/opt\/simba\/googlebigqueryodbc/g' simba.googlebigqueryodbc.ini
   

10. Altere DriverManagerEncoding para UTF-16 e SwapFilePath em simba.googlebigqueryodbc.ini. Se necessário, também é possível alterar as configurações de registro.

    Este é um exemplo de um arquivo de configuração atualizado de todo o driver:

    # /opt/simba/googlebigqueryodbc/lib/simba.googlebigqueryodbc.ini
    [Driver]
    DriverManagerEncoding=UTF-16
    ErrorMessagesPath=opt/simba/googlebigqueryodbc/ErrorMessages
    LogLevel=6
    LogPath=/tmp
    SwapFilePath=/tmp
    

11. Se estiver usando um arquivo de drivers de sistema ou qualquer arquivo odbcinst.ini atual, configure /etc/odbcinst.ini para apontar para o local do driver Google BigQuery /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb[Bitness].so.

    Por exemplo:

    # /etc/odbcinst.ini
    # Make sure to use Simba ODBC Driver for Google BigQuery as a driver name.
    
    [ODBC Drivers]
    Simba ODBC Driver for Google BigQuery=Installed
    
    [Simba ODBC Driver for Google BigQuery]
    Description=Simba ODBC Driver for Google BigQuery(64-bit)
    Driver=/opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    

12. Localize as bibliotecas do gerenciador de driver unixODBC e adicione os caminhos de biblioteca unixODBC e googlebigqueryodbc à variável LD_LIBRARY_PATH environment.

    find / -name 'lib*odbc*.so*' -print
    #output:
    /usr/lib/x86_64-linux-gnu/libodbccr.so.2
    /usr/lib/x86_64-linux-gnu/libodbcinst.so.2.0.0
    /usr/lib/x86_64-linux-gnu/libodbccr.so.1
    .
    .
    /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    
    #the command would look like this
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/simba/googlebigqueryodbc:/usr/lib
    

13. No Adobe Campaign Classic, você pode configurar a conta externa Google BigQuery. Para obter mais informações sobre como configurar a conta externa, consulte esta seção.

Carregamento em massa configurado no Linux

O utilitário Carregamento em massa permite transferência mais rápida, que é realizada por meio do SDK da Google Cloud.

1. Baixe o arquivo Linux de 64 bits (x86_64) neste page e extraia no diretório correspondente.

2. Execute o script google-cloud-sdk\install.sh. É necessário aceitar a configuração da variável de caminho.

3. Após a instalação, verifique se a variável de caminho ...\google-cloud-sdk\bin está definida. Caso contrário, adicione-o manualmente.

4. Se quiser evitar o uso da variável PATH ou se quiser mover o diretório google-cloud-sdk para outro local, use o valor da opção bqpath ao configurar o External account para especificar o caminho exato para o diretório bin em seu sistema.

5. Reinicie o Adobe Campaign Classic para que as alterações sejam consideradas.

Conta externa do Google BigQuery

Você precisa criar uma conta externa Google BigQuery para conectar a instância do Adobe Campaign Classic ao banco de dados externo Google BigQuery.

1. Em Adobe Campaign Classic Explorer, clique em Administration '>' Platform '>' External accounts.

2. Clique em New.

3. Selecione External database como sua conta externa Type.

4. Para configurar a conta externa do Google BigQuery, você deve especificar:

   • Type: Google BigQuery

   • Service account: E-mail da sua Service account. Para obter mais informações, consulte a documentação do Google Cloud.

   • Project: Nome do seu Project. Para obter mais informações, consulte a documentação do Google Cloud.

   • Key file Path:

     • Upload key file to the server: selecione Click here to upload se você optar por fazer upload da chave por meio do Adobe Campaign Classic.

     • Enter manually the key file path: copie/cole o caminho absoluto nesse campo se optar por usar uma chave pré-existente.

   • Dataset: Nome do seu Dataset. Para obter mais informações, consulte a documentação do Google Cloud.