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 do Data Movement gateway
Nota informativaIsso apenas será necessário se você optar por trabalhar com o Data Movement gateway. Para obter informações sobre os benefícios do Data Movement gateway e quando ele é necessário, consulte Qlik Data Gateway - 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 os driver necessários. 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
-
Baixe o Driver 2.0.19 a 2.12 de 64 bits do SAP HANA ODBC do SAP Software Download Center e copie os arquivos IMDB_CLIENT_<número de versão>.SAR e SAPCAR_<número de versão>.EXE para:
/opt/qlik/gateway/movement/drivers/saphana
Instalando o driver
Para o driver:
-
Pare o serviço do Gateway Data Movement:
sudo systemctl stop repagent
-
Opcionalmente, confirme se o serviço foi interrompido:
sudo systemctl status repagent
O status deverá ser o seguinte:
Active: inactive (dead) since <timestamp> ago
-
Na máquina do gateway do Data Movement, altere o diretório de trabalho para:
opt/qlik/gateway/movement/drivers/bin
-
Execute o seguinte comando:
Sintaxe:
./install saphana
-
Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:
sudo systemctl start repagent
-
Opcionalmente, confirme se o serviço foi iniciado:
sudo systemctl status repagent
O status deverá ser o seguinte:
Active: active (running) since <timestamp> ago
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 atualizar o driver:
-
Pare o serviço do Gateway Data Movement:
sudo systemctl stop repagent
-
Opcionalmente, confirme se o serviço foi interrompido:
sudo systemctl status repagent
O status deverá ser o seguinte:
Active: inactive (dead) since <timestamp> ago
-
Na máquina do gateway do Data Movement, altere o diretório de trabalho para:
opt/qlik/gateway/movement/drivers/bin
-
Execute o seguinte comando:
Sintaxe:
./update saphana
-
Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:
sudo systemctl start repagent
-
Opcionalmente, confirme se o serviço foi iniciado:
sudo systemctl status repagent
O status deverá ser o seguinte:
Active: active (running) since <timestamp> ago
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:
-
Pare todas as tarefas configuradas para usar esse conector.
-
Na máquina do gateway do Data Movement, altere o diretório de trabalho para:
opt/qlik/gateway/movement/drivers/bin
-
Execute o seguinte comando:
Sintaxe:
./uninstall saphana
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.
Baixe o Driver 2.0.19-2.12 de 64 bits ODBC do SAP HANA do SAP Software Download Center. Você deve ter uma conta na SAP para baixar o software.
Não há suporte para o driver SAP HANA ODBC 2.13 e versões posteriores.
Exemplo de nome do driver: HDBODBC
Em seguida, na máquina do Gateway Data Movement, abra um prompt de shell e faça o seguinte:
-
Pare o serviço do Gateway Data Movement:
sudo systemctl stop repagent
-
Opcionalmente, confirme se o serviço foi interrompido:
sudo systemctl status repagent
O status deverá ser o seguinte:
Active: inactive (dead) since <timestamp> ago
-
Instale o driver na máquina do Gateway Data Movement.
-
Adicione a seguinte seção ao arquivo odbcinst.ini localizado no diretório /etc:
[HDBODBC]
Description=64-bit HANA ODBC Driver
Driver=/opt/sap/hdbclient/libodbcHDB.so
fileUsage=1
-
Inicie o serviço do Gateway Data Movement:
sudo systemctl start repagent
-
Opcionalmente, confirme se o serviço foi iniciado:
sudo systemctl status repagent
O status deverá ser o seguinte:
Active: active (running) since <timestamp> ago
Conectando-se usando o SSL
Para se conectar ao espaço SAP HANA usando SSL, o cliente deve ser configurado para autenticar o certificado do servidor SSL.
-
Para autenticação do servidor, siga as instruções em Autenticação do certificado do servidor.
-
Para autenticação mútua, siga as instruções em Implementar autenticação mútua. Ao usar o OpenSSL como seu provedor de criptografia, você deve realizar a configuração executando as etapas extras para OpenSSL em Provedor de criptografia.
Porta
Na máquina do Gateway Data Movement, abra o número da porta de entrada 3xx15 para o servidor do SAP HANA, em que xx pe o número da instância do banco de dados do SAP HANA que contém as tabelas de origem.
Por exemplo, a porta para a instância 90 seria 39015.
Capturar alterações de dados
Ao aterrisar dados usando o conector SAP Hana (banco de dados), os seguintes artefatos são criados automaticamente no banco de dados de origem:
- Três gatilhos para cada uma das tabelas de origem que estão sendo aterrisadas: os gatilhos capturam alterações nas tabelas de origem (INSERTs, UPDATEs e DELETEs) e as gravam na tabela attrep_cdc_changes_cts (descrita abaixo). Um gatilho separado é criado para cada operação DML. Os gatilhos são criados no esquema da tabela de origem.
- attrep_cdc_changes_cts: Esta tabela contém as alterações capturadas pelos gatilhos. A tabela será criada no esquema especificado no campo Criar tabela de CDC no esquema do conector SAP HANA (banco de dados).
Consulte também: Permissões