Conditions préalables requises
Avant de pouvoir déposer temporairement ou répliquer des données, vérifiez que vous remplissez bien les conditions préalables requises suivantes :
-
Installez le driver requis sur le serveur Data Movement gateway.
Note InformationsCela est nécessaire uniquement si vous avez décidé d'utiliser Data Movement gateway. Pour des informations sur les avantages de Data Movement gateway et quand il convient de l'utiliser, consultez Qlik Data Gateway - Data Movement.
-
Accordez les autorisations requises sur la source de données.
-
Configuration du connecteur de source de données
Configuration du pilote
Vous pouvez installer le driver via l'utilitaire d'installation de pilote (recommandé) ou manuellement. Tentez une installation manuelle uniquement dans le cas improbable où vous rencontriez un problème avec l'utilitaire d'installation de pilote.
Utilisation de l'utilitaire d'installation de pilote pour installer le pilote
Cette section explique comment installer le driver requis. Le processus implique le téléchargement du driver, sa copie dans le dossier requis (voir ci-dessous) et l'exécution d'un script qui l'installera et le configurera automatiquement. Vous pouvez également exécuter des scripts permettant de mettre à jour et de désinstaller le driver, si nécessaire.
Préparation de l'installation
-
Assurez-vous que Python 3.6 ou une version ultérieure est installé sur le serveur de passerelle Data Movement.
Python est préinstallé sur la plupart des distributions Linux. Vous pouvez vérifier la version de Python installée sur votre système en exécutant la commande suivante :
python3 --version
-
Téléchargez le pilote 64 bits ODBC SAP HANA 2.0.19 à 2.12 depuis le SAP Software Download Center et copiez les fichiers IMDB_CLIENT_<numéro de version>.SAR et SAPCAR_<numéro de version>.EXE dans :
/opt/qlik/gateway/movement/drivers/saphana
Installation de driver
Pour installer le driver :
-
Arrêtez le service Data Movement gateway :
sudo systemctl stop repagent
-
Confirmez éventuellement l'arrêt du service :
sudo systemctl status repagent
Le statut doit être comme suit :
Active: inactive (dead) since <timestamp> ago
-
Sur le poste de passerelle Data Movement, remplacez le répertoire de travail par :
opt/qlik/gateway/movement/drivers/bin
-
Exécutez la commande suivante :
Syntaxe :
./install saphana
-
Attendez la fin de l'installation (indiquée par « Complete! »), puis démarrez le service Data Movement gateway :
sudo systemctl start repagent
-
Confirmez éventuellement le lancement du service :
sudo systemctl status repagent
Le statut doit être comme suit :
Active: active (running) since <timestamp> ago
Le driver sera installé.
Mise à jour du driver
Exécutez la commande update si vous souhaitez désinstaller des versions précédentes du driver avant d'installer le driver fourni.
Pour mettre à jour le driver :
-
Arrêtez le service Data Movement gateway :
sudo systemctl stop repagent
-
Confirmez éventuellement l'arrêt du service :
sudo systemctl status repagent
Le statut doit être comme suit :
Active: inactive (dead) since <timestamp> ago
-
Sur le poste de passerelle Data Movement, remplacez le répertoire de travail par :
opt/qlik/gateway/movement/drivers/bin
-
Exécutez la commande suivante :
Syntaxe :
./update saphana
-
Attendez la fin de l'installation (indiquée par « Complete! »), puis démarrez le service Data Movement gateway :
sudo systemctl start repagent
-
Confirmez éventuellement le lancement du service :
sudo systemctl status repagent
Le statut doit être comme suit :
Active: active (running) since <timestamp> ago
L'ancien driver sera désinstallé et le nouveau driver sera installé.
Désinstallation du driver
Exécutez la commande uninstall si vous souhaitez désinstaller le driver.
Pour désinstaller le driver :
-
Arrêtez toutes les tâches configurées pour utiliser ce connecteur.
-
Sur le poste de passerelle Data Movement, remplacez le répertoire de travail par :
opt/qlik/gateway/movement/drivers/bin
-
Exécutez la commande suivante :
Syntaxe :
./uninstall saphana
le driver sera désinstallé.
Installation manuelle du pilote
Vous devez tenter d'installer manuellement le driver uniquement si l'installation de pilote automatisée n'a pas fonctionné.
Téléchargez le pilote 64 bits ODBC SAP HANA 2.0.19-2.12 depuis le Centre de téléchargement de logiciels SAP. Vous devez disposer d'un compte SAP pour télécharger le logiciel.
Le pilote ODBC SAP HANA versions 2.13 et supérieures n'est pas pris en charge.
Exemple de nom de pilote : HDBODBC
Ensuite, sur le poste Data Movement gateway, ouvrez une invite shell et procédez comme suit :
-
Arrêtez le service Data Movement gateway :
sudo systemctl stop repagent
-
Confirmez éventuellement l'arrêt du service :
sudo systemctl status repagent
Le statut doit être comme suit :
Active: inactive (dead) since <timestamp> ago
-
Installez le pilote sur le poste Data Movement gateway.
-
Ajoutez la section suivante au fichier odbcinst.ini situé dans le répertoire /etc :
[HDBODBC]
Description=64-bit HANA ODBC Driver
Driver=/opt/sap/hdbclient/libodbcHDB.so
fileUsage=1
-
Démarrez le service Data Movement gateway :
sudo systemctl start repagent
-
Confirmez éventuellement le lancement du service :
sudo systemctl status repagent
Le statut doit être comme suit :
Active: active (running) since <timestamp> ago
Connexion à l'aide de SSL
Pour se connecter à SAP HANA via SSL, le client doit être configuré pour authentifier le certificat du serveur SSL.
-
Pour l'authentification du serveur, suivez les instructions indiquées dans Authentification du certificat de serveur.
-
Pour l'authentification mutuelle, suivez les instructions indiquées dans Implémenter l'authentification mutuelle. Lorsque vous utilisez OpenSSL comme votre fournisseur de chiffrement, vous devez terminer la configuration en suivant les étapes supplémentaires d'OpenSSL sous Fournisseur de chiffrement.
Port
Sur le poste Data Movement gateway, ouvrez le numéro de port entrant 3xx15 vers le serveur SAP HANA, où xx est le numéro d'instance de la base de données SAP HANA contenant les tables source.
Par exemple, le port de l'instance 90 serait 39015.
Capture des modifications des données
Lorsque des données de dépôt temporaire utilisent le connecteur SAP Hana (base de données), les artefacts suivants sont automatiquement créés dans la base de données source :
- Trois déclencheurs pour chacune des tables sources en cours de dépôt temporaire : les déclencheurs capturent les modifications apportées aux tables sources (opérations INSERT, UPDATE et DELETE) et les écrivent dans la table attrep_cdc_changes_cts (décrite ci-dessous). Un déclencheur distinct est créé pour chaque opération DML. Les déclencheurs sont créés dans le schéma de la table source.
- attrep_cdc_changes_cts : Cette table contient les modifications capturées par les déclencheurs. La table sera créée dans le schéma spécifié dans le champ Créer table CDC dans schéma du connecteur SAP HANA (base de données).
Voir aussi : Autorisations