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 de la passerelle Déplacement de données.

• 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 l'exécution d'un script qui téléchargera, installera et configurera automatiquement le driver requis. 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 Déplacement des données.

  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

Installation de driver

Pour télécharger et installer le driver :

1. Sur le poste de passerelle Déplacement des données, remplacez le répertoire de travail par :

   opt/qlik/gateway/movement/drivers/bin

2. Exécutez la commande suivante :

   Syntaxe :

   ./install sqlserver

   Si le driver ne peut pas être téléchargé (en raison de restrictions d'accès ou de problèmes techniques), un message s'affichera, vous indiquant où télécharger et copier le driver sur le poste de passerelle Déplacement des données. Une fois que c'est fait, exécutez de nouveau la commande install sqlserver.

   Sinon, le CLUF du driver apparaîtra.

3. Procédez de l'une des manières suivantes :

   • Appuyez à plusieurs reprises sur [Entrée] pour parcourir lentement le CLUF.
   • Appuyez à plusieurs reprises sur la barre d'espacement pour parcourir rapidement le CLUF.
   • Appuyez sur q pour quitter le texte de licence et faire apparaître les options d'acceptation du CLUF.

4. Procédez de l'une des manières suivantes :

   • Saisissez « y » et appuyez sur [Entrée] pour accepter le CLUF et démarrer l'installation.
   • Saisissez « n » et appuyez sur [Entrée] pour rejeter le CLUF et quitter l'installation.

   • Saisissez « v » et appuyez sur [Entrée] pour afficher de nouveau le CLUF.

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 télécharger et mettre à jour le driver :

1. Sur le poste de passerelle Déplacement des données, remplacez le répertoire de travail par :

   opt/qlik/gateway/movement/drivers/bin

2. Exécutez la commande suivante :

   Syntaxe :

   ./update sqlserver

   Si le driver ne peut pas être téléchargé (en raison de restrictions d'accès ou de problèmes techniques), un message s'affichera, vous indiquant où télécharger et copier le driversur le poste de passerelle Déplacement des données. Une fois que c'est fait, exécutez de nouveau la commande update sqlserver.

   Sinon, le CLUF du driver apparaîtra.

3. Procédez de l'une des manières suivantes :

   • Appuyez à plusieurs reprises sur [Entrée] pour parcourir lentement le CLUF.
   • Appuyez à plusieurs reprises sur la barre d'espacement pour parcourir rapidement le CLUF.
   • Appuyez sur q pour quitter le texte de licence et faire apparaître les options d'acceptation du CLUF.

4. Procédez de l'une des manières suivantes :

   • Saisissez « y » et appuyez sur [Entrée] pour accepter le CLUF et démarrer l'installation.
   • Saisissez « n » et appuyez sur [Entrée] pour rejeter le CLUF et quitter l'installation.
   • Saisissez « v » et appuyez sur [Entrée] pour passer le CLUF en revue depuis le début.

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 :

1. Arrêtez toutes les tâches configurées pour utiliser ce connecteur.

2. Sur le poste de passerelle Déplacement des données, remplacez le répertoire de travail par :

   opt/qlik/gateway/movement/drivers/bin

3. Exécutez la commande suivante :

   Syntaxe :

   ./uninstall sqlserver

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

Une fois la Data Movement gateway installée, téléchargez le pilote msodbcsql<version>.x86_64.rpm. Vous trouverez un lien de téléchargement direct vers la version prise en charge sous binary-artifacts dans /opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml. Une fois le téléchargement terminé, copiez le RPM sur le poste Data Movement gateway.

Sur le serveur Data Movement gateway, ouvrez une invite shell et procédez comme suit :

1. Arrêtez le service Data Movement gateway :

   sudo systemctl stop repagent

2. Confirmez éventuellement l'arrêt du service :

   sudo systemctl status repagent

Le statut doit être comme suit :

Active: inactive (dead) since <timestamp> ago

3. Installez le pilote (RPM).

4. Modifiez le répertoire de travail par <product_dir>/bin.

5. Copiez l'emplacement du pilote dans le fichier site_arep_login.sh comme suit :

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql<version>/lib64/" >> site_arep_login.sh

   Cette opération ajoute le pilote à "LD_LIBRARY_PATH" et met à jour l'emplacement du pilote dans le fichier site_arep_login.sh .

6. Confirmez éventuellement que l'emplacement du pilote a été copié :

   cat site_arep_login.sh

7. Démarrez le service Data Movement gateway :

   sudo systemctl start repagent

8. Confirmez éventuellement le lancement du service :

   sudo systemctl status repagent

   Le statut doit être comme suit :

   Active: active (running) since <timestamp> ago

9. Data Movement gateway requiert la bibliothèque ODBC suivante : msodbcsql-18.1.so.1.1.

   Pour vérifier la version de la bibliothèque actuellement installée, exécutez la commande suivante :

   ls /opt/microsoft/msodbcsql<version>/lib64/

   Si la bibliothèque existante a un numéro de version différent (par exemple, libmsodbcsql-18.0.so.1.1), vous devez créer un lien symbolique entre la bibliothèque existante et la bibliothèque obligatoire.

   Pour ce faire exécutez les commandes suivantes :

   cd /opt/microsoft/msodbcsql<version>/lib64/
   ln -s existing_library_name msodbcsql-18.1.so.1.1

   où existing_library_name correspond au nom de la bibliothèque actuellement installée (par exemple, libmsodbcsql-18.0.so.1.1).

Sélection de base de données

Pour pouvoir sélectionner une base de données (en cliquant sur Charger des bases de données dans la boîte de dialogue du connecteur), l'utilisateur spécifié dans les paramètres du connecteur doit être créé dans la base de données principale.

Port

Par défaut, le port 1434 doit être ouvert pour la communication sortante sur le serveur Data Movement gateway. Vous pouvez le modifier dans les paramètres de connexion.

Préparer la base de données pour CDC

La section suivante explique comment configurer la base de données pour le CDC.

Pour configurer la base de données pour le CDC :

1. Exécutez les opérations qui suivent pour configurer la base de données pour MS-CDC :

   exec source_db_name.dbo.sp_cdc_enable_db

   où source_db_name correspond au nom de la base de données source.

2. La tâche landing active automatiquement MS-CDC pour toutes les tables source. Cependant, si vous préférez activer MS-CDC manuellement, exécutez le script suivant (pour chacune des tables source prévues) :

   exec sys.sp_cdc_enable_table

   @source_schema = N'schema_name',

   @source_name = N'table_name',

   @role_name = NULL

   où schema_name et table_name correspondent aux noms du schéma source et de la table source, respectivement.

   Note Informations

   • Les noms de la table CT doivent utiliser le format d'attribution de nom par défaut : <SchemaName>_<TableName>_CT

   • La table CT doit inclure les colonnes suivantes : [__$start_lsn], [__$end_lsn], [__$seqval], [__$operation], [__$update_mask], <all the data columns>, [__$command_id]

3. Assurez-vous que les tâches de nettoyage et de capture MS-CDC sont en cours d'exécution.

   Note Informations

   • sys.sp_cdc_change_job ne vous permet pas de contrôler les tâches. Pour en savoir plus, voir l'aide Microsoft.
   • Afin de diminuer la latence, vous pouvez définir le paramètre @pollinginterval sur une petite valeur.