# Pré-requisitos

A seção a seguir descreve os pré-requisitos para trabalhar com o Teradata como origem no Qlik Talend Cloud Data Integration.

## Replicate Server para Windows

Instale o Teradata Database ODBC Driver 17.20 ou 20.00 para Windows.

Baixe o driver do [Teradata Download Center](https://downloads.teradata.com/download/connectivity/odbc-driver/windows).

## Replicate Server para Linux

As etapas a seguir descrevem como trabalhar com o Teradata como origem em um gateway de movimentação de dados Linux. O Teradata Database Client requer o gerenciador de driver ODBC DataDirect fornecido com o cliente.

Nota informativa

Estas instruções pressupõem que o Teradata Database Client 20.00 esteja instalado em /opt/teradata/client/20.00. Se você instalar outra versão ou usar uma localização diferente, altere os caminhos de acordo.

1. Pare o serviço do Data Movement gateway e confirme que ele parou.

2. Instale o Teradata Database Client 20.00 ou anterior para Linux.

   Faça o download do driver em https://downloads.teradata.com/download/connectivity/odbc-driver/linux.

3. Copie o pacote do cliente baixado para /opt/qlik/gateway/movement/drivers/teradata e execute install teradata.

4. Defina as seguintes variáveis de ambiente:

   `TD_CLIENT=/opt/teradata/client/20.00/odbc_64/lib:/opt/teradata/client/17.20/lib64; export TD_CLIENT`

   `ODBCINI=/opt/teradata/client/20.00/odbc_64/odbc.ini; export ODBCINI`

   `ODBCINST=/opt/teradata/client/20.00/odbc_64/odbcinst.ini; export ODBCINST`

5. Defina o caminho da biblioteca:

   `LD_LIBRARY_PATH=$TD_CLIENT:/opt/qlik/gateway/lib:/lib64:/usr/lib64; export LD_LIBRARY_PATH`

6. Execute `echo $LD_LIBRARY_PATH` para verificar se o caminho foi atualizado.

7. Adicione os comandos de exportar ao script de login do serviço de gateway para que estejam disponíveis após as reinicializações do serviço.

8. Inicie o serviço do Data Movement gateway e confirme que ele foi iniciado.

Nota informativa

Uma tarefa não pode usar endpoints que exigem gerenciadores de driver ODBC diferentes. As origens Teradata usam o DataDirect ODBC Driver Manager, enquanto a maioria dos destinos Linux usa o unixODBC. Quando a tarefa combinar uma origem DataDirect com um destino que requer unixODBC, use o Qlik Replication File Channel.

Antes de configurar a origem do Teradata, adicione o mapeamento de host e banco de dados do Teradata Database ao arquivo hosts na máquina do gateway. Para o procedimento, consulte [Editando o arquivo hosts](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/Teradata/teradata-hosts-file.htm).

Esta seção descreve como instalar o driver necessário. O processo envolve o download do driver, sua cópia para a pasta necessária (veja abaixo) e a execução de um script que o instalará e configurará automaticamente. Você também pode executar scripts para atualizar e desinstalar o driver como necessário.

### Preparando a instalação

* Certifique-se de que o Python 3.6.x ou mais recente esteja instalado no servidor de gateway do Data Movement.

  O Python vem pré-instalado na maioria das distribuições do Linux. Você pode verificar qual versão do Python está instalada em seu sistema executando o seguinte comando:

  python3 --version

### Instalando o driver

Para o driver:

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Na máquina do gateway do Data Movement, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

4. Execute o seguinte comando:

   Sintaxe:

   ./install teradata

   Caso contrário, o EULA do driver será exibido.

5. Realize uma das seguintes ações:

   * Pressione [Enter] repetidamente para percorrer lentamente o EULA.
   * Pressione a barra de espaço repetidamente para rolar rapidamente pelo EULA.
   * Pressione q para sair do texto da licença e ser apresentado às opções de aceitação do EULA.

6. Realize uma das seguintes ações:

   * Digite "y" e pressione [Enter] para aceitar o EULA e iniciar a instalação.

   * Digite "n" e pressione [Enter] para rejeitar o EULA e sair da instalação.

   * Digite "v" e pressione [Enter] para visualizar o EULA novamente.

   O driver será instalado.

7. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

8. Opcionalmente, confirme se o serviço foi iniciado:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since &lt;timestamp&gt; ago

### Atualizando o driver

Execute o comando de atualização se quiser desinstalar versões anteriores do driver antes de instalar o driver fornecido.

Para atualizar o driver:

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Na máquina do gateway do Data Movement, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

4. Execute o seguinte comando:

   Sintaxe:

   ./update teradata

   Caso contrário, o EULA do driver será exibido.

5. Realize uma das seguintes ações:

   * Pressione [Enter] repetidamente para percorrer lentamente o EULA.
   * Pressione a barra de espaço repetidamente para rolar rapidamente pelo EULA.
   * Pressione q para sair do texto da licença e ser apresentado às opções de aceitação do EULA.

6. Realize uma das seguintes ações:

   * Digite "y" e pressione [Enter] para aceitar o EULA e iniciar a instalação.
   * Digite "n" e pressione [Enter] para rejeitar o EULA e sair da instalação.
   * Digite "v" e pressione [Enter] para revisar o EULA desde o início.

   O driver antigo será desinstalado, e o novo driver será instalado.

7. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

8. Opcionalmente, confirme se o serviço foi iniciado:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since &lt;timestamp&gt; ago

### Desinstalando o driver

Execute o comando de desinstalação se quiser desinstalar o driver.

Para desinstalar o driver:

1. Pare todas as tarefas configuradas para usar esse conector.

2. Na máquina do gateway do Data Movement, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

3. Execute o seguinte comando:

   Sintaxe:

   ./uninstall teradata

   O driver será desinstalado.

## Conceder acesso à conta

O usuário especificado na definição do conector deve ser um usuário válido do Teradata Database e ter os privilégios necessários para ler as tabelas de origem e executar as operações de processamento de alterações usadas pela tarefa.

Para obter mais informações sobre os requisitos de segurança e acesso do Teradata, consulte o guia do usuário do Qlik Replicate para origens Teradata.