Configuração do 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
OBSERVAÇÃO

Google BigQuery O conector está disponível para implantações híbridas e locais. Para obter mais informações, consulte esta página.

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

OBSERVAÇÃO

Você precisa do Python instalado para que o SDK da Google Cloud funcione.

Recomendamos usar Python3, veja esta página.

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

OBSERVAÇÃO

Você precisa do Python instalado para que o SDK da Google Cloud funcione.

Recomendamos usar Python3, veja esta página.

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.

Nesta página