DocumentaçãoCampaignDocumentação do Campaign Classic v7

Configuração do acesso ao Google BigQuery configure-fda-google-big-query

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 em Windows ou Linux
  2. Configure o Google BigQuery conta externa no Adobe Campaign Classic
  3. Configurar Google BigQuery carregamento em massa do conector em Windows ou Linux
NOTE
Google BigQuery O conector de está disponível para implantações hospedadas, híbridas e no local. Para obter mais informações, consulte esta página.

Google BigQuery no Windows google-windows

Driver configurado no Windows driver-window

  1. Baixe 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 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: a variável Service account exige um Key File para um 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 consulta precisa fornecer o conjunto de dados em que 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 as Google BigQuery conta externa. Para obter mais informações sobre como configurar a conta externa, consulte nesta seção.

Configuração de carregamento em massa no Windows bulk-load-window

NOTE
É necessário ter o Python instalado para que o SDK da Google Cloud funcione.
Recomendamos o uso do Python3. Consulte esta página.

O utilitário de Carregamento em massa permite uma transferência mais rápida, alcançada pelo SDK da Google Cloud.

  1. Baixar arquivo do Windows de 64 bits (x86_64) deste página e extraia-o 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á definido. Caso contrário, adicione-o manualmente.

  4. No ..\google-cloud-sdk\bin\bq.cmd arquivo, adicione o CLOUDSDK_PYTHON variável local, que será redirecionada 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 google-linux

Driver configurado no Linux driver-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 da instalação do ODBC, verifique se os seguintes pacotes estão instalados na distribuição Linux:

    • Para Red Hat/CentOS:

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

    • Para Debian:

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

  2. Atualize o sistema antes da instalação:

    • Para Red Hat/CentOS:

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

    • Para Debian:

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

  3. Antes de executar o script, você pode obter mais informações especificando o argumento —help:

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

  4. Acesse o diretório onde o script está localizado e execute o script a seguir como usuário root:

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

Configuração de carregamento em massa no Linux bulk-load-linux

NOTE
É necessário ter o Python instalado para que o SDK da Google Cloud funcione.
Recomendamos o uso do Python3. Consulte esta página.

O utilitário de Carregamento em massa permite uma transferência mais rápida, alcançada pelo SDK da Google Cloud.

  1. Antes da instalação do ODBC, verifique se os seguintes pacotes estão instalados na distribuição Linux:

    • Para Red Hat/CentOS:

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

    • Para Debian:

      code language-none 
      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:

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

Conta externa do Google BigQuery google-external

É necessário criar um Google BigQuery conta externa para conectar a instância do Adobe Campaign Classic ao 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 Service account. Para obter mais informações, consulte Documentação da Google Cloud.

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

    • Key file Path:

      • Upload key file to the server: selecionar 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 neste campo se optar por usar uma chave pré-existente.

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

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

Opção
Descrição
ProxyType
Tipo de proxy usado para se conectar ao BigQuery por meio de conectores ODBC e SDK.
HTTP (padrão), http_no_tunnel, socks4 e socks5 são suportados no momento.
ProxyHost
Nome do host ou endereço IP onde o proxy pode ser acessado.
PortaProxy
Número da porta em que o proxy está sendo executado, por exemplo, 8080
ProxyUid
Nome de usuário usado para o proxy autenticado
ProxyPwd
Senha do ProxyUid
bqpath
Observe que isso é aplicável somente para a ferramenta de carregamento em massa (SDK da nuvem).
Para evitar o uso da variável PATH ou se o diretório google-cloud-sdk tiver que ser movido para outro local, é possível especificar com essa opção o caminho exato para o diretório bin do sdk da nuvem no servidor.
GCloudConfigName
Observe que isso é aplicável a partir da versão 7.3.4 e somente para a ferramenta de carregamento em massa (SDK da nuvem).
O SDK da Google Cloud usa configurações para carregar dados em tabelas do BigQuery. A configuração chamada accfda armazena os parâmetros para carregar os dados. No entanto, essa opção permite que os usuários especifiquem um nome diferente para a configuração.
GCloudDefaultConfigName
Observe que isso é aplicável a partir da versão 7.3.4 e somente para a ferramenta de carregamento em massa (SDK da nuvem).
A configuração ativa do SDK da Google Cloud não pode ser excluída sem antes transferir a tag ativa para uma nova configuração. Essa configuração temporária é necessária para recriar a configuração principal para carregar dados. O nome padrão para a configuração temporária é default, isso poderá ser alterado, se necessário.
GCloudRecreateConfig
Observe que isso é aplicável a partir da versão 7.3.4 e somente para a ferramenta de carregamento em massa (SDK da nuvem).
Quando definido como false, o mecanismo de carregamento em massa evita tentar recriar, excluir ou modificar as configurações do SDK da Google Cloud. Em vez disso, ele continua com o carregamento de dados usando a configuração existente na máquina. Esse recurso é importante quando outras operações dependem das configurações do SDK da Google Cloud.
Se o usuário ativar essa opção de mecanismo sem uma configuração adequada, o mecanismo de carregamento em massa emitirá uma mensagem de aviso: No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option. Para evitar mais erros, ele será revertido para o usando o mecanismo de carregamento em massa de Inserção de matriz ODBC padrão.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1