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.
- Instalar e configurar drivers de Teradata
- Configurar o Teradata conta externa no Campaign
- 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.
-
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)
-
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
-
-
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)
Conta externa Teradata teradata-external
A conta externa Teradata permite conectar a instância do Campaign ao banco de dados externo do Teradata.
-
Na Campanha Explorer, clique em Administration / Platform / External accounts.
-
Clique em New e selecione External database como Type.
-
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:
Para obter mais informações, consulte esta página.
Para obter mais informações, consulte esta página
Adicionar contas externas ODBC adicionais add-external
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.
Para configurar faixas de Query, siga as etapas abaixo:
-
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.
-
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.
-
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:
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:
-
Descompacte o arquivo md5_20080530.zip.
-
Vá para o diretório md5/src.
-
Conecte-se ao banco de dados Teradata usando bteq.
-
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:
-
Descompacte o arquivo teradata-udf-sha2-1.0.zip.
-
Vá para o diretório teradata-udf-sha2-1.0/src.
-
Conecte-se ao banco de dados Teradata usando bteq.
-
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:
-
Descompacte o arquivo utk_release1.7.0.0.zip.
-
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/.
-
Conecte-se ao banco de dados Teradata usando bteq.
-
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:
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:
-
Extraia o arquivo tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.
-
Vá para o diretório tdodbc1620.
-
Talvez seja necessário corrigir o script de configuração:
code language-none "sed -i s/16.10/16.20/ setup_wrapper.sh". -
Execute setup_wrapper.sh.
Instalação de ferramentas e utilitários de teradata teradata-tools-installation
Para instalar ferramentas:
-
Extraia o arquivo TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.
-
Vá para o diretório TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu.
-
Execute setup_wrapper.sh.
-
Vá para o diretório TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2.
-
Execute setup_wrapper.sh.
-
Vá para o diretório TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.
-
Execute setup_wrapper.sh.
-
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';