Configuração do acesso ao Teradata

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

  1. Instale e configure drivers de Teradata
  2. Configure o Teradata external account no Campaign
  3. Configurar configuração adicional para Teradata e servidor do Campaign

Configuração de teradata

É necessário instalar drivers para o Teradata para que a conexão com o Campaign seja implementada.

  1. Instale o driver ODBC para Teradata.

    É composto de três pacotes que podem ser instalados no Red Hat (ou no CentOS)/Suse na seguinte ordem:

    • TeraGSS
    • tdicu1510 (instale-o usando setup_wrapper.sh)
    • tdodbc1510 (instale-o usando setup_wrapper.sh)
  2. Configure o driver ODBC. A configuração pode ser realizada nos arquivos padrão: /etc/odbc.ini para parâmetros gerais e /etc/odbcinst.ini para declaração de drivers:

    • /etc/odbc.ini

      [ODBC]
      InstallDir=/etc/
      

      "InstallDir" corresponde ao local do arquivo odbcinst.ini.

    • /etc/odbcinst.ini

      [ODBC DRIVERS]
      teradata=Installed
      
      [teradata]
      Driver=/opt/teradata/client/15.10/lib64/tdata.so
      APILevel=CORE
      ConnectFunctions=YYY
      DriverODBCVer=3.51
      SQLLevel=1
      
  3. Especifique as variáveis de ambiente do servidor do Adobe Campaign:

    • LD_LIBRARY_PATH: opt/teradata/client/15.10/lib64 e /opt/teradata/client/15.10/odbc_64/lib.
    • ODBCINI: local do arquivo odbc.ini (por exemplo /etc/odbc.ini).
    • NLSPATH: local do arquivo opermsgs.cat (/opt/teradata/client/15.10/msg/opermsgs.cat?lang=pt-BR)
OBSERVAÇÃO

A conexão com um banco de dados externo de Teradata no FDA requer etapas de configurações adicionais no servidor do Adobe Campaign. Saiba mais.

Conta externa Teradata

A conta externa do Teradata permite conectar sua instância do Campaign ao banco de dados externo do Teradata.

  1. Em Campanha Explorer, clique em Administration / Platform / External accounts.

  2. Clique em New e selecione External database como Type.

  3. Para configurar a conta externa do Teradata, você deve especificar:

    • Type: Escolha o Teradata tipo .

    • Server: URL ou nome do seu servidor Teradata

    • Account: Nome da conta utilizada para acessar o banco de dados Teradata

    • Password: Senha utilizada para conectar ao banco de dados Teradata

    • Database: Nome do banco de dados (opcional)

    • Options: Opções a serem passadas pelo Teradata. Use o seguinte formato: 'parameter=value'. Use uma semicoluna como separador entre valores.

    • Timezone: Fuso horário definido no Teradata. Saiba mais

Faixas de query

Quando vários usuários do Adobe Campaign se conectam à mesma conta externa FDA do Teradata, a guia Query banding permite definir uma faixa de query, ou seja, um conjunto de pares de chave-valor em uma sessão.

Quando essa opção é configurada, cada vez que um usuário do Campaign realiza um query no banco de dados de Teradatas, o Adobe Campaign enviará metadados, que consistem em uma lista de chaves, associadas a esse usuário. Esses dados podem ser usados pelos administradores do Teradata para fins de auditoria ou para gerenciar direitos de acesso.

OBSERVAÇÃO

Para obter mais informações sobre a Query banding, consulte a documentação do Teradata.

Para configurar a Faixa de query, siga as etapas abaixo:

  1. Use o Default para inserir uma faixa de query padrão que será usada se um usuário não tiver nenhuma faixa de query associada. Se este campo estiver vazio, os usuários sem faixa de query não poderão utilizar o Teradata.

  2. Use o campo Users para especificar uma faixa de query para cada usuário. Você pode adicionar quantos pares chave/valor forem necessários, por exemplo, priority=1;workload=high. Se o usuário não tiver nenhuma faixa de query atribuída, o campo Default será aplicado.

  3. Marque a caixa Active para ativar esse recurso

Solução de problemas de conta externa

Se o seguinte erro for exibido durante o teste da conexão TIM-030008 Data '2': missing character(s) (iRc=-53) verifique se o driver ODBC está instalado corretamente e se LD_LIBRARY_PATH (Linux) / PATH (Windows) está definido para o servidor do Campaign.

Erro ODB-240000 ODBC: [Nome da fonte de dados Microsoft][ODBC Driver Manager] não encontrado e nenhum driver padrão especificado. ocorre com o Windows se você usar um driver 16.X. O Adobe Campaign espera que o teradata seja nomeados como '{teradata}' em odbcinst.ini.

  • A partir do Campaign 18.10, é possível adicionar ODBCDriverName="Teradata Database ODBC Driver 16.10" nas opções da conta externa. O número da versão pode mudar; o nome exato pode ser encontrado executando o odbcad32.exe e acessando a guia Drivers.

  • Se estiver usando uma versão mais antiga do Campaign, será necessário copiar a seção Teradata de odbcinst.ini criada pela instalação do driver para uma nova seção chamada Teradata. O Regedit pode ser usado nesse caso. Se sua base estiver em latin1, você terá que adicionar APICharSize=1 nas opções.

Configurações adicionais

Configuração do usuário

Os seguintes direitos são necessários no banco de dados externo: crie/solte/execute procedimentos personalizados, crie/solte/insira/selecione tabelas. Você também pode precisar criar funções de modo de usuário se quiser usar as funções md5 e sha2 na instância do Adobe Campaign.

Configure o fuso horário correto. Ele deve corresponder ao que será definido na conta externa criada na instância do Adobe Campaign.

O Adobe Campaign não definirá um modo de proteção (fallback) nos objetos que ele criará no banco de dados. Talvez seja necessário definir um padrão no usuário que o Adobe Campaign usará para se conectar ao banco de dados Teradata usando o seguinte query:

desativar fallback padrão
MODIFY USER $login$ AS NO FALLBACK;

Instalação MD5

Se você quiser usar funções md5 na instância do Adobe Campaign, será necessário instalar a função user mode no banco de dados do Teradata nessa página (md5_20080530.zip).

O sha1 do arquivo baixado é o seguinte: 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.

Para instalar o md5:

  1. Descompacte o arquivo md5_20080530.zip.

  2. Vá para o diretório md5/src.

  3. Conecte-se ao banco de dados Teradata usando bteq.

  4. Execute o seguinte comando bteq:

    .run file = hash_md5.btq
    

Instalação do SHA2

Se você quiser usar funções sha2 na instância do Adobe Campaign, será necessário instalar a função user mode no banco de dados do Teradata nessa página (teradata-udf-sha2-1.0.zip).

O sha1 do arquivo baixado é o seguinte: e87438d37424836358bd3902cf1adeb629349780.

Para instalar o sha2:

  1. Descompacte o arquivo teradata-udf-sha2-1.0.zip.

  2. Vá para o diretório teradata-udf-sha2-1.0/src.

  3. Conecte-se ao banco de dados Teradata usando bteq.

  4. Execute os dois comandos bteq a seguir:

    .run file = hash_sha256.sql
    .run file = hash_sha512.sql
    

Instalação UDF_UTF16TO8

Se você quiser usar funções udf_utf16to8 na sua instância do Adobe Campaign, será necessário instalar a função user mode no banco de dados do Teradata com o kit de ferramentas Teradata unicode dessapágina (utk_release1.7.0.0.zip).

O sha1 do arquivo baixado é o seguinte: e58235f434f52c71316a577cb48e20b97d24f470.

Para instalar o udf_utf16to8:

  1. Descompacte o arquivo utk_release1.7.0.0.zip.

  2. Procure o arquivo udf_utf16to8.o nos arquivos extraídos e navegue até o diretório que contém o arquivo. Ele deve ser chamado utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01 Teradata UDFs/suselinux-x8664/udf_installation/.

  3. Conecte-se ao banco de dados Teradata usando bteq.

  4. Digite o seguinte comando bteq:

    REPLACE FUNCTION udf_utf16to8 (
    inputString VARCHAR(8000) CHARACTER SET UNICODE
    ) RETURNS VARCHAR(16000) CHARACTER SET LATIN
    LANGUAGE C
    NO SQL
    EXTERNAL NAME 'CO!i18n103!udf_utf16to8.o!F!udf_utf16to8'
    PARAMETER STYLE SQL;
    
    -- Test: should return 410042
    SELECT CAST(Char2HexInt(UDF_UTF16to8(_UNICODE'004100000042'XC)) AS VARCHAR(100));
    

Configuração do servidor do Campaign para Linux

Para a instalação do driver é necessário:

  • Driver Teradata ODBC, que pode ser encontrado nesta página

  • Ferramentas e utilitários Teradata (usados para o carregamento em massa), que podem ser encontrados nesta página

Nomes de arquivos e sha1:

  • tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f44fd

  • TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563

Se não houver nenhum pacote para sua distribuição Linux, você poderá instalar conforme explicado em CentOS 7 (por exemplo, usando docker) e em seguida, copiar o conteúdo de /opt/teradata no servidor do Adobe Campaign.

Instalação do driver ODBC

Para instalar o driver ODBC:

  1. Extraia o arquivo tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.

  2. Vá para o diretório tdodbc1620.

  3. Talvez seja necessário corrigir o script de configuração:

    "sed -i s/16.10/16.20/ setup_wrapper.sh".
    
  4. Execute setup_wrapper.sh.

Instalação de ferramentas e utilitários do Teradata

Para instalar ferramentas:

  1. Extraia o arquivo TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.

  2. Vá para o diretório TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu.

  3. Execute setup_wrapper.sh.

  4. Vá para o diretório TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2.

  5. Execute setup_wrapper.sh.

  6. Vá para o diretório TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.

  7. Execute setup_wrapper.sh.

  8. Um arquivo libtelapi.so deve estar disponível em /opt/teradata/client/16.20/lib64.

Configuração do servidor do Campaign para Windows

Primeiro, é necessário baixar as Ferramentas e utilitários do Teradata para Windows. Você pode baixá-los nesta página

Instale o driver ODBC e a Base de transporte paralelo do Teradata. Ele instalará o telapi.dll usado para fazer o carregamento em massa no banco de dados Teradata.

Verifique se o caminho do driver e dos utilitários está na variável PATH que o nlserver terá durante a execução. Por padrão, o caminho é C:\Program Files (x86)\Teradata\Client\15.10\bin em Windows 32 bits ou C:\Program Files\Teradata\Client\15.10\bin em 64 bit).

Fuso horário

O Teradata usa nomes de fusos horários que não são padrão. Você pode encontrar a lista no site do Teradata. O Adobe Campaign tentará converter o fuso horário fornecido na configuração externa em algo que o Teradata entenda. Se uma correspondência não for encontrada, o fuso horário ausente GMT+X (ou GMT-X) será encontrado para a sessão, com um aviso no log.

A conversão é feita ao ler um arquivo chamado teradata_timezone.txt que deve estar no seguinte diretório datakit: /usr/local/neolane/nl6/datakit em linux. Se você editar esse arquivo, entre em contato com a equipe do Adobe Campaign para fazer a alteração no código fonte; caso contrário, esse arquivo será substituído durante a próxima atualização do Campaign.

O fuso horário usado para conexão será indicado ao executar o nlserver com o switch -verbose, por exemplo:

15:04:04 >   ODB-240007 Teradata: will use 'Europe Central' as session time zone.

Se o fuso horário usado não for o correto, uma opção chamada "TimeZoneName" poderá ser adicionada à conta externa. Nesse caso, use o Valor do Teradata, por exemplo "TimeZoneName=Europe Central".

Ao usar carregamento em massa ou "carregamento rápido" em documentos Teradata, o Campaign não pode indicar o fuso horário. Portanto, é recomendável definir o fuso horário padrão do usuário que o Campaign usará para se conectar:

MODIFY USER $login$ AS TIME ZONE = 'Europe Central';

Nesta página