Configuração do acesso ao Google BigQuery

Usar 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 ao Google BigQuery.

  1. Configurar Google BigQuery on Windows ou Linux
  2. Configure o Google BigQuery conta externa no Adobe Campaign Classic
  3. Configurar Google BigQuery carga em massa do conector em Windows ou Linux
OBSERVAÇÃO

Google BigQuery O conector está disponível para implantações locais, híbridas e hospedadas. 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 o Google BigQuery para funcionar, o Adobe Campaign Classic requer 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 exige um Key File para um Google BigQuery conexão via 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 onde a tabela está localizada, especificando 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 Google BigQuery conta externa. 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 isso página.

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

  1. Faça o download do arquivo de 64 bits do Windows (x86_64) a partir desta página e extraia-a no diretório correspondente.

  2. Execute o google-cloud-sdk\install.sh script. É 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 ..\google-cloud-sdk\bin\bq.cmd , adicione o CLOUDSDK_PYTHON variável local, 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

Antes de configurar o driver, observe que o script e os comandos devem ser executados pelo usuário raiz. Também é recomendável usar o Google DNS 8.8.8.8 ao executar o script.

Para configurar Google BigQuery no Linux, siga as etapas abaixo:

  1. Antes de instalar o ODBC, verifique se os seguintes pacotes estão instalados em sua distribuição Linux:

    • Para Red Hat/CentOS:

      yum update
      yum upgrade
      yum install -y grep sed tar wget perl curl
      
    • Para Debian:

      apt-get update
      apt-get upgrade
      apt-get install -y grep sed tar wget perl curl
      
  2. Atualizar sistema antes da instalação:

    • Para Red Hat/CentOS:

      # install unixODBC driver manager
      yum install -y unixODBC
      
    • Para Debian:

      # install unixODBC driver manager
      apt-get install -y odbcinst1debian2 libodbc1 odbcinst unixodbc
      
  3. Acesse o diretório onde o script está localizado e execute o seguinte script:

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

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 isso página.

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

  1. Antes de instalar o ODBC, verifique se os seguintes pacotes estão instalados em sua distribuição Linux:

    • Para Red Hat/CentOS:

      yum update
      yum upgrade
      yum install -y python3
      
    • Para Debian:

      apt-get update
      apt-get upgrade
      apt-get install -y python3
      
  2. Acesse o diretório onde o script está localizado e execute o seguinte script:

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

Conta externa do Google BigQuery

Você precisa criar um Google BigQuery conta externa para conectar sua instância do Adobe Campaign Classic à sua Google BigQuery banco de dados externo.

  1. Do 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: Email do seu Service account. Para obter mais informações, consulte Documentação da Google Cloud.

    • Project: Nome da sua Project. Para obter mais informações, consulte Documentação da Google Cloud.

    • Key file Path:

      • Upload key file to the server: select 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 da sua Dataset. Para obter mais informações, consulte Documentação da Google Cloud.

O conector é compatível com as seguintes opções:

Opção Valor Descrição
ProxyType string Tipo de proxy usado para se conectar ao BigQuery por meio de conectores ODBC e SDK.
HTTP (padrão), http_no_túnel, socks4 e socks5 são suportados atualmente.
ProxyHost string Nome do host ou endereço IP onde o proxy pode ser atingido.
ProxyPort número Número da porta em que o proxy está sendo executado, por exemplo, 8080
ProxyUid string Nome de usuário usado para o proxy autenticado
ProxyPwd string Senha ProxyUid
bqpath string Observe que isso se aplica somente à ferramenta de carregamento em massa (Cloud SDK).
Para evitar o uso da variável PATH ou se o diretório google-cloud-sdk tiver que ser movido para outro local, você pode especificar com essa opção o caminho exato para o diretório do compartimento do sdk da nuvem no servidor.

Nesta página