Configuração do acesso ao Teradata configure-access-to-teradata

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

  1. Instalar e configurar drivers de Teradata
  2. Configurar o Teradata conta externa no Campaign
  3. Definir configuração adicional para o servidor do Teradata e do Campaign

Configuração de teradata teradata-config

É necessário instalar drivers para que o Teradata tenha a conexão com o Campaign 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

      code language-none
      [ODBC]
      InstallDir=/etc/
      

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

    • /etc/odbcinst.ini

      code language-none
      [ODBC DRIVERS]
      teradata=Installed
      
      [teradata]
      Driver=/opt/teradata/client/17.10/lib64/tdataodbc_sb64.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 (https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=pt-BR)
NOTE
A conexão com um banco de dados externo de Teradata no FDA exige etapas de configurações adicionais no servidor do Adobe Campaign. Saiba mais.

Conta externa Teradata teradata-external

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

  1. Na 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 tipo Teradata.

    • Server: URL ou nome do seu servidor do Teradata

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

    • Password: Senha usada para conectar ao banco de dados do Teradata

    • Database: Nome do banco de dados (opcional)

    • Options: Opções a serem passadas pelo Teradata. Use o seguinte formato: 'parameter=value'. Use ponto e vírgula como separador entre valores.

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

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

Opção
Descrição
TD_MAX_SESSIONS
Especifica o número máximo de sessões de logon que o Transportador Paralelo de Teradata pode adquirir para um trabalho de operador.
TimeZoneName
Nome do fuso horário do servidor.
ConjuntoDeCaracteres
Usado para configurar o conjunto de caracteres de Teradata.
Para obter mais informações, consulte esta página.
PáginaDeCódigoAppIANA
Página de código do aplicativo ODBC.
Para obter mais informações, consulte esta página

Adicionar contas externas ODBC adicionais add-external

NOTE
Essa opção não está disponível para builds anteriores à versão 7.3.1.

O driver de Teradata fornece sua própria biblioteca ODBC, mas essa biblioteca pode não ser compatível com outras contas externas ODBC.

Se você quiser configurar outra conta externa que também use ODBC, por exemplo, Snowflake, será necessário adicionar uma opção ODBCLib definida para o caminho da biblioteca ODBC padrão (/usr/lib/x86_64-linux-gnu/libodbc.so no Debian e /usr/lib64/libodbc.so no RHEL/CentOS).

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 executa um query no banco de dados do Teradata, 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.

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

Para configurar faixas 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 consulta 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 external-account-troubleshooting

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 nomeado como '{teradata}' em odbcinst.ini.

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

Configurações adicionais teradata-additional-configurations

Configuração do usuário user-configuration

Os seguintes direitos são necessários no banco de dados externo: create/drop/execute custom procedures, create/drop/insert/select tables. 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:

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

Instalação MD5 md5-installation

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:

    code language-none
    .run file = hash_md5.btq
    

Instalação do SHA2 sha2-installation

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:

    code language-none
    .run file = hash_sha256.sql
    .run file = hash_sha512.sql
    

Instalação UDF_UTF16TO8 UDF-UTF16TO8-installation

Se você quiser usar funções udf_utf16to8 na sua instância do Adobe Campaign, instale a função user mode no banco de dados do Teradata por meio do kit de ferramentas Teradata unicode.

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:

    code language-none
    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 campaign-server-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 odbc-installation

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:

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

Instalação de ferramentas e utilitários de teradata teradata-tools-installation

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 campaign-server-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 timezone

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';
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1