# Oracle Cette section explique comment configurer la connectivité à une cible Oracle via le connecteur cible Oracle. Oracle peut être utilisé comme cible dans une tâche Replicate uniquement. Avant de pouvoir vous connecter à une cible Oracle, vous devez configurer les [Autorisations requises](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Permissi) sur la base de données. Si vous vous connectez à Oracle via Passerelle de déplacement des données, vous devez également installer le pilote, comme décrit à la section [Configuration du pilote](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Driver). Pour des informations sur les limitations et les considérations à prendre en compte lors de l'utilisation du connecteur Oracle, voir [Limitations et considérations générales](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Limitati). ## Définition des propriétés de connexion Pour configurer le connecteur, procédez comme suit : 1. Dans Connexions, cliquez sur Créer une connexion. 2. Sélectionnez le connecteur cible Oracle et fournissez les paramètres suivants : ### Cible de données * Passerelle de données : Lorsque vous travaillez avec Passerelle de déplacement des données, sélectionnez la passerelle de données qui sera utilisée pour tester la connexion à la cible Oracle. Il doit s'agir de la même passerelle que celle utilisée pour accéder à la source de données. Note Informations * Ce champ n'est pas disponible avec l'abonnement Démarreur Qlik Talend Cloud, car Passerelle de déplacement des données n'est pas supporté avec ce niveau d'abonnement. * Vous devez également installer le pilote approprié sur le poste Passerelle de déplacement des données. Pour des informations détaillées, voir la section [Configuration du pilote](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Driver) ci-dessous. * Chaîne de connexion : chaîne de connexion Oracle de la base de données Oracle à utiliser. Note Informations * Lors de la réplication vers Oracle Autonomous Data Warehouse, vous devez commencer par appliquer la procédure décrite à la section [Connexion à Oracle Autonomous Data Warehouse](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Connecti). * Ces informations sont sensibles à la casse. ### Propriétés de compte Nom d'utilisateur et Mot de passe : nom d'utilisateur et mot de passe d'un utilisateur autorisé à accéder à la base de données Oracle Server. ### Propriétés internes Les propriétés internes s'adressent à des cas d'utilisation spéciaux et ne sont par conséquent pas exposées dans la boîte de dialogue. Utilisez-les uniquement si Qlik Support vous le demande. Utilisez les boutons the Créer nouveau icon et the Annuler icon à droite des champs pour ajouter ou supprimer des propriétés, suivant les besoins. ### Nom Nom d'affichage de la connexion. ## Conditions préalables requises ### Autorisations requises L'utilisateur spécifié dans la chaîne de connexion doit avoir les privilèges suivants dans la base de données Oracle : * CREATE ANY TABLE * CREATE ANY INDEXES * ALTER ANY TABLE * DROP ANY TABLE * INSERT ANY TABLE * UPDATE ANY TABLE * DELETE ANY TABLE * SELECT ANY TABLE * SELECT all\_indexes * SELECT all\_ind\_columns * SELECT all\_constraints * SELECT all\_cons\_columns * LOCK ANY TABLE ### 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 oracle 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 oracle. Sinon, le CLUF du driver apparaîtra. 3. Effectuez l'une des opérations suivantes : * Appuyez à plusieurs reprises sur [Entrée] pour parcourir lentement le CLUF. * Appuyez à plusieurs reprises sur la barre d'espace 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. Effectuez l'une des opérations 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 oracle 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 oracle. Sinon, le CLUF du driver apparaîtra. 3. Effectuez l'une des opérations suivantes : * Appuyez à plusieurs reprises sur [Entrée] pour parcourir lentement le CLUF. * Appuyez à plusieurs reprises sur la barre d'espace 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. Effectuez l'une des opérations 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 oracle 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 Passerelle de déplacement des données installée, téléchargez le pilote oracle-instantclient-basiclite-<version>.x86\_64.rpm. Vous trouverez un lien de téléchargement direct vers la version supportée sous binary-artifacts dans /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. Une fois le téléchargement terminé, copiez le RPM sur le poste Passerelle de déplacement des données. Ensuite, 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. En outre, s'il n'est pas déjà fourni dans votre système, créez un lien symbolique dans le répertoire `$Oracle_Home\lib`. Attribuez un nom au lien `libclntsh.so`, puis faites-le pointer vers une version donnée de ce fichier. Exemple : lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1 5. Remplacez le répertoire de travail par <Data Movement gateway-Install-Dir>/bin et ajoutez la variable d'environnement `LD_LIBRARY_PATH` au répertoire Oracle Instant Client et au répertoire Data Movement gatewaylib en copiant l'emplacement du pilote dans le fichier `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. 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 ### Connexion à Oracle Autonomous Data Warehouse La procédure suivante doit être effectuée lors de la réplication dans Oracle Autonomous Data Warehouse. Pour configurer la connectivité à Oracle Autonomous Data Warehouse (ADW), vous avez besoin du fichier ZIP (Wallet) Client Credentials que vous avez téléchargé lors de la configuration de votre environnement Oracle Autonomous Data Warehouse. Pour que Qlik Talend Data Integration puisse se connecter à Oracle Autonomous Data Warehouse : 1. Extrayez le contenu du fichier ZIP Client Credentials dans un dossier de votre choix. Il peut s'agir de n'importe quel dossier, mais, aux fins de cette procédure, /home/adw\_credentials sera le dossier Linux contenant les fichiers extraits. 2. Dans le dossier contenant les fichiers extraits, éditez le fichier sqlnet.ora en remplaçant ?/network/admin par le chemin d'accès au dossier contenant les fichiers extraits : `WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="/home/adw_credentials")))` `SSL_SERVER_DN_MATCH=yes` 3. Créez la variable d'environnement TNS\_ADMIN et définissez-la sur l'emplacement du fichier credentials. Exécutez les commandes suivantes : `export TNS_ADMIN=/home/adw_credentials` `export PATH=$TNS_ADMIN:$PATH` 4. Dans le champ Chaîne de connexion du connecteur Cible Oracle, saisissez un des noms du fichier tnsnames.ora. Pour plus d'informations sur la configuration de la connectivité à Oracle ADW, voir : [Connexion à un traitement autonome des transactions via une application cliente](https://docs.oracle.com/en/cloud/paas/atp-cloud/atpug/connect-preparing.html#GUID-EFAFA00E-54CC-47C7-8C71-E7868279EF3B) ## Limitations et considérations générales Lors de l'utilisation d'Oracle comme cible de réplication, les limitations suivantes s'appliquent : * Il n'est pas possible de créer de nouveaux schémas dans la base de données Oracle. Pour effectuer une réplication dans un nouveau schéma, il faut que le nom du nouveau schéma existe déjà dans la base de données cible. Vous devez ensuite spécifier le nom du nouveau schéma dans l'onglet [Metadata](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/replicating-settings-metadata.htm) des paramètres de tâche. * En cas d'activation du mode [Application avec optimisation par lots](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/replicating-settings-replication.htm), il se peut que les colonnes de LOB vides soient répliquées sous forme de valeurs NULL. * Une fois l'opération Chargement complet terminée, si l'option Limiter la taille de LOB à est activée et si une table contient des données NCLOB, la taille de NCLOB dans la cible sera tronquée à la moitié de la taille spécifiée dans le champ [Limiter la taille de LOB à](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/replicating-settings-metadata.htm). L'opération CDC continuera à la tronquer conformément à la limite. ## Types de données Les informations de type de données natif sont préservées et affichées dans la colonne Type de données natif des vues d'ensemble de données. Si la colonne n'est pas visible, vous devez ouvrir le sélecteur de colonnes de la vue d'ensemble de données et sélectionner la colonne Type de données natif. Types de données | Types de données Qlik Cloud | Types de données Oracle | | --- | --- | | BOOLEAN | NUMBER (1) | | BYTES | RAW (length) | | DATE | DATETIME | | TIME | TIMESTAMP (0) | | DATETIME | Si scale <= 9, alors TIMESTAMP (scale)

Sinon, VARCHAR2 (37) | | INT1 | NUMBER (3) | | INT2 | NUMBER (5) | | INT4 | NUMBER (10) | | INT8 | NUMBER (19) | | NUMERIC | NUMBER (p,s) | | REAL4 | BINARY\_FLOAT | | REAL8 | BINARY\_DOUBLE | | STRING | Avec indication de la date : DATE

Avec indication de l'heure : TIMESTAMP

Avec indication de l'horodatage : TIMESTAMP

Avec indication timestamp\_with\_timezone : TIMESTAMP WITH TIMEZONE

Avec indication timestamp\_with\_timezone : TIMESTAMP WITH LOCAL TIMEZONE

Avec indication interval\_year\_to\_month : INTERVAL YEAR TO MONTH

Avec indication interval\_day\_to\_second : INTERVAL DAY TO SECOND

Si Length > 4000: CLOB

Dans tous les autres cas : VARCHAR2 (Length) | | UINT1 | NUMBER (3) | | UINT2 | NUMBER (5) | | UINT4 | NUMBER (10) | | UINT8 | NUMBER (19) | | WSTRING | NVARCHAR2 (length)

Notez que lorsque la longueur est supérieure à 2 000, le type de données de la colonne est NCLOB. | | BLOB | BLOB

Note Informations

| | CLOB | CLOB

Note Informations

| | NCLOB | NCLOB

Note Informations

| | Le type de données cible XMLTYPE est pertinent uniquement dans des tâches de réplication d'Oracle à Oracle. Voir la remarque ci-dessous. | XMLTYPE |