Ir para conteúdo principal Pular para conteúdo complementar
Recursos da Qilk

Pré-requisitos

Antes de fazer a aterrissagem ou a replicação dos dados, certifique-se de atender aos seguintes pré-requisitos:

  • Instalar o driver necessário no servidor de gateway do Data Movement

  • Conceder as permissões necessárias na fonte de dados

  • Configurar o conector de fontes de dados

Configuração do driver

Você pode instalar o driver usando o utilitário de instalação do driver (recomendado) ou manualmente. A instalação manual só deve ser tentada no caso improvável de você encontrar um problema com o utilitário de instalação do driver.

Usando o utilitário de instalação de driver para instalar o driver

Esta seção descreve como instalar o driver necessário. O processo envolve a execução de um script que baixará, instalará e configurará automaticamente os driver necessários. 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 Movimentação de dados.

    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 baixar e instalar o driver:

  1. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

    opt/qlik/gateway/movement/drivers/bin

  2. Execute o seguinte comando:

    Sintaxe:

    ./install oracle

    Se o driver não puder ser baixado (devido a restrições de acesso ou problemas técnicos), uma mensagem será exibida informando onde baixar o driver e onde copiá-lo na máquina de gateway do Movimentação de dados. Depois de fazer isso, execute o comando install oracle novamente.

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

  3. 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.

  4. 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.

    5. O driver será instalado.

Atualizando o driver

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

Para baixar e atualizar o driver:

  1. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

    opt/qlik/gateway/movement/drivers/bin

  2. Execute o seguinte comando:

    Sintaxe:

    ./update oracle

    Se o driver não puder ser baixado (devido a restrições de acesso ou problemas técnicos), uma mensagem será exibida informando onde baixar o driver e onde copiá-lo na máquina de gateway do Movimentação de dados. Depois de fazer isso, execute o comando update oracle novamente.

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

  3. 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.

  4. 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.

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

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 Movimentação de dados, altere o diretório de trabalho para:

    opt/qlik/gateway/movement/drivers/bin

  3. Execute o seguinte comando:

    Sintaxe:

    ./uninstall oracle

    O driver será desinstalado.

Instalando o driver manualmente

Você só deve tentar instalar o driver manualmente se a instalação automática do driver não for concluída com êxito.

Após a instalação do Data Movement gateway, baixe o driver oracle-instantclient-basiclite-<version>.x86_64.rpm. Você pode encontrar um link de download direto para a versão compatível em binary-artifacts em /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. Assim que o download for concluído, copie o RPM para a máquina Data Movement gateway.

Em seguida, no servidor do Gateway Data Movement, abra um prompt de shell e faça o seguinte:

  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

    3. O status deverá ser o seguinte:

    Active: inactive (dead) since <timestamp> ago

  3. Instale o driver (RPM).

  4. Além disso, se ainda não estiver incluído em seu sistema, crie um link simbólico no diretório $Oracle_Home\lib. Nomeie o link como libclntsh.so e aponte-o para uma versão específica deste arquivo.

    Exemplo:

    lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1

  5. Altere o diretório de trabalho para <Gateway Data Movement-Install-Dir>/bin e anexe a variável de ambiente LD_LIBRARY_PATH ao diretório do Oracle Instant Client e ao diretório Gateway Data Movementlib, copiando o local do driver para o arquivo site_arep_login.sh:

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh

  6. Opcionalmente, confirme se a localização do driver foi copiada:

    cat site_arep_login.sh

  7. 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 <timestamp> ago

Forneça acesso à conta Oracle

Você deve fornecer acesso à conta Oracle ao usuário do Gateway Data Movement. Este usuário deve ter privilégios de leitura/gravação no banco de dados Oracle. Para obter informações sobre como configurar o acesso à conta Oracle, consulte Permissões necessárias.

Certifique-se de que o modo ARCHIVELOG esteja ativado

O Oracle pode ser executado em dois modos diferentes: o modo ARCHIVELOG e o modo NOARCHIVELOG. Para usar os logs Oracle com Gateway Data Movement, execute o banco de dados no modo ARCHIVELOG. Se o log não estiver definido para o modo ARCHIVELOG, execute a seguinte consulta:

ALTER database ARCHIVELOG

Observe que, se sua instância de banco de dados Oracle estiver no Amazon RDS, um comando diferente precisará ser executado. Para obter mais informações, consulte Habilitando backups automáticos e Configurando o arquivamento

Configurar o registro em log complementar

O registro em log complementar deve ser ativado para o banco de dados Oracle, tanto no nível do banco de dados quanto no nível da tabela.

Nota informativa

Quando aterrissagem de um ambiente de espera Oracle, o registro em log complementar deve ser configurado na instância Oracle primária (conforme descrito abaixo), não na instância em espera.

Verificando e habilitando o registro em log complementar no nível do banco de dados

  1. Execute a seguinte consulta:

    SELECT name, value, description FROM v$parameter WHERE name = 'compatible';

    O resultado retornado deve ser de GE to n.n.n em que n.n.n é a versão do banco de dados Oracle (por exemplo, 10.0.0).

    Nota de advertência

    O valor do parâmetro deve corresponder à versão real do banco de dados.

  2. Execute a seguinte consulta:

    SELECT supplemental_log_data_min FROM v$database;

    O resultado retornado deve ser YES ou IMPLICIT.

    Habilite o registro em log complementar executando a seguinte consulta:

    ALTER DATABASE ADD SUPPLEMENTAL LOG DATA

    Nota informativa

    Se sua instância de banco de dados Oracle estiver no Amazon RDS, um comando diferente precisará ser executado. Para obter mais informações, consulte Trabalhando com o Amazon RDS for Oracle.

Verificando e habilitando o registro em log complementar no nível da tabela

  1. Para verificar se o registro em log complementar está ativado no nível da tabela, execute a seguinte consulta:

    Sintaxe:

    select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE_NAME='TABLE-NAME';

    Exemplo:

    select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE_NAME='EMPLOYEES';

  2. Para habilitar o registro em log complementar no nível da tabela, execute a seguinte consulta:

    Sintaxe:

    ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

    Exemplo:

    ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

Veja também: Permissões necessárias

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui