Teradata

Última atualização: 30/09/2026

O Teradata está disponível como destino apenas em projetos do Qlik Talend Cloud Replicate. A conexão usa a API do Teradata Parallel Transporter (TPT) para carregamento de dados e o ODBC para consultas de metadados, solicitações DDL e informações de tabelas de erros do Teradata.

Configurar a conexão

Antes de criar uma tarefa de replicação, crie e teste uma conexão com o destino Teradata.

1. Em Conexões, clique em Criar conexão.
2. Selecione o conector de destino Teradata.
3. Insira as propriedades de conexão descritas em Propriedades de conexão do Teradata.
4. Clique em Testar conexão e resolva quaisquer erros relatados.
5. Salve a conexão.

Propriedades de conexão do Teradata

Configure as seguintes propriedades para a conexão de destino do Teradata:

Pré-requisitos

Prepare o ambiente Teradata e o acesso exigido pela conexão antes de criar a conexão de destino.

• Certifique-se de que o servidor Teradata esteja instalado em sua rede e acessível a partir do computador que executa o gateway de dados selecionado.
• Instale e configure o driver ODBC do Teradata e os componentes de cliente necessários do Teradata no gateway de dados. Não presuma que um driver instalado em outro computador esteja disponível para o gateway.
• Solicite a um administrador de banco de dados Teradata que crie ou identifique um usuário do banco de dados e forneça a senha e a string de conta do usuário, quando necessário.

Se você estiver adaptando a capacidade de destino do Teradata ao seu ambiente, solicite a um administrador de banco de dados Teradata que verifique se os seguintes privilégios são necessários para a sua tarefa. As concessões se aplicam ao banco de dados de destino, a menos que indicado em contrário; elas não são necessariamente as permissões mínimas para cada tarefa do Qlik Talend Cloud:

• GRANT SELECT ON <database>
• GRANT INSERT ON <database>
• GRANT DELETE ON <database>
• GRANT UPDATE ON <database>
• GRANT EXECUTE ON <database>
• GRANT EXECUTE FUNCTION ON <database>
• GRANT EXECUTE PROCEDURE ON <database>
• GRANT CREATE TABLE ON <database>
• GRANT DROP TABLE ON <database>
• GRANT CREATE VIEW ON <database>
• GRANT DROP VIEW ON <database>
• GRANT NONTEMPORAL ON <database>
• GRANT CHECKPOINT ON <database>

Para uma origem que oferece suporte ao operador Stream, solicite também ao DBA que verifique a seguinte concessão quando o Operador TPT estiver definido como Stream:

• GRANT CREATE MACRO ON <database>

Solucionar erros de conexão

Se o teste de conexão falhar, analise o erro relatado e verifique os seguintes itens antes de testar a conexão novamente:

• Gateway ou rede: Confirme se o gateway de dados selecionado está em execução e pode acessar o servidor Teradata. Verifique o nome do servidor ou o endereço IP e quaisquer regras de rede entre o gateway e o servidor.
• Driver ou cliente: Confirme se o driver ODBC do Teradata e os componentes de cliente necessários estão instalados e configurados no gateway selecionado. Um driver instalado no computador local não é utilizado por um gateway remoto.
• Credenciais ou permissões: Confirme o Usuário e a Senha com distinção entre maiúsculas e minúsculas, a String de conta opcional e as concessões de banco de dados necessárias com um DBA.
• Descoberta de bancos de dados: Se Carregar bancos de dados não retornar nenhum banco de dados ou apresentar um erro, primeiro teste a conectividade e, em seguida, confirme se o usuário pode descobrir e acessar os bancos de dados. Você pode inserir um banco de dados conhecido com Inserir nome do banco de dados manualmente, se apropriado.
• Propriedades ODBC: Verifique cada par de Nome e Valor quanto à ortografia, valores com suporte e conflitos com a configuração do driver. Remova uma propriedade opcional que faça com que o teste de conexão falhe ou solicite a um administrador ODBC para verificá-la.

Configurar as configurações da tarefa

Configure essas configurações em uma tarefa do Replicate em Carregamento de dados.

Configurações básicas

• Operador TPT: Selecione Load ou Stream. O padrão é Stream.
• Formato JSON: Selecione Texto, BSON ou UBJSON. O padrão é Texto.

Modos do operador TPT

O Operador TPT determina como os dados são gravados no Teradata.

• Stream (padrão): usa o protocolo Teradata TPump para transações DML de alta velocidade em tempo quase real. As tabelas podem ser consultadas enquanto ocorrem operações DML. Este modo é menos restritivo para o processamento de alterações contínuas. Quando a origem oferece suporte a este operador, o usuário do banco de dados também pode precisar do privilégio CREATE MACRO.

• Carregar: usa o protocolo Teradata FastLoad para carregar um grande volume de dados em uma tabela vazia. A tabela de destino deve estar vazia e não pode ter índices secundários. Use este modo apenas quando essas restrições atenderem aos requisitos de processamento da tarefa.

Opção de formato JSON

Especifique como as colunas JSON são armazenadas no Teradata:

• Texto (padrão): Armazena dados JSON como texto.
• BSON: Armazena dados JSON no formato BSON.
• UBJSON: Armazena dados JSON no formato UBJSON.

Atributos avançados do TPT

Em Atributos avançados do TPT, configure as seguintes opções:

• Tamanho do buffer (KB): Defina o tamanho do buffer de saída usado para enviar pacotes de carga para o Teradata. Digite um valor de 1 a 64.
• Buffers: Defina o número de buffers de requisição usados. Insira um valor de 2 ou superior.
• Intervalo explícito de sessões: Defina o número mínimo e máximo de sessões para que se efetue o logon no Teradata. Insira valores de 1 a 65.535.
• Empacotamento dinâmico de instruções: Selecione esta opção para permitir que o driver do fluxo determine o empacotamento máximo possível para o trabalho de fluxo atual.
• Empacotamento de instruções: Defina o número de instruções empacotadas em uma solicitação de várias instruções para o modo Stream. Insira um valor de 2 a 600. Esta opção está disponível quando o Empacotamento dinâmico de instruções não estiver selecionado.

Limitações e considerações

• Os modos de replicação disponíveis são Carga total, Aplicar alterações e Armazenar alterações.
• Para tarefas que usam Aplicar alterações ou Armazenar alterações, operações DDL e evolução automática de esquema não são suportadas. Esta limitação não se aplica a uma tarefa apenas de carga total.
• Para o modo Carregamento, a tabela de destino deve estar vazia e não deve ter índices secundários. Selecione Stream quando a tarefa exigir processamento contínuo de DML ou consultas simultâneas à tabela.

Informações relacionadas

• Criando um projeto de replicação