Connexion à Autonomous Database avec Node.js et d'autres langages de script

Vous pouvez utiliser des programmes dans différents langages, y compris Node.js, PHP, Ruby, R, Go et Perl, pour vous connecter à Autonomous Database on Dedicated Exadata Infrastructure. La sécurité est appliquée à l'aide des informations d'identification client.

Ces langages de script comportent des pilotes ou des API d'accès à la base de données qui utilisent les bibliothèques Oracle Call Interface. Les bibliothèques Oracle Call Interface peuvent provenir du client Oracle complet ou d'Oracle Instant Client.

Installation du pilote de langage et des bibliothèques client

Pour se connecter à Autonomous Database on Dedicated Exadata Infrastructure à partir de votre langage de script, commencez par installer le pilote de langage et les bibliothèques client comme suit :

  1. Installez Instant Client ou le client complet. La version minimale prise en charge pour le client complet est la version 11.2.0.4. Pour Oracle Instant Client, utilisez la version 12.1.0.2 ou supérieure :

    Instant Client fonctionne bien pour la plupart des applications. Pour installer Instant Client, procédez comme suit :

    1. Sélectionnez l'architecture souhaitée sur la page Instant Client - Téléchargements et téléchargez le package Basic (disponible sur la page de téléchargement) : Oracle Instant Client

      Vous pouvez également télécharger le package Basic Light à partir de la page de téléchargement pour l'architecture souhaitée si les limites de globalisation Basic Light vous conviennent.

    2. Si vous créez un pilote ou une API de langage à partir du code source, vous devrez peut-être également télécharger le kit SDK Instant Client : Oracle Instant Client

    3. Décompressez le package de base sélectionné. Par exemple, décompressez-le dans C:\instantclient_12_2 ou /home/myuser/instantclient_18_5. Si vous téléchargez également le kit SDK, décompressez-le dans le même répertoire.

    4. Sous Windows, ajoutez le chemin de la variable PATH dans la section Variables système du panneau Variables d'environnement (par exemple, ajoutez C:\instantclient_12_2). Sous Windows 8, accédez à la zone de paramètre de variable PATH via Panneau de configuration > Système > Paramètres système avancés > Variables d'environnement. Si plusieurs versions des bibliothèques Oracle sont installées, assurez-vous que le nouveau répertoire apparaît en premier dans le chemin.

    5. Sur les plates-formes autres que Windows, créez un lien symbolique s'il n'existe pas. Exemple :

      cd /home/myuser/instantclient_18_5
      ln -s libclntsh.so.18.1 libclntsh.so

      Si aucun autre logiciel Oracle n'est affecté sur votre système, ajoutez Instant Client au chemin du lien d'exécution. Exemple :

      sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf"
      sudo ldconfig
      

      Vous pouvez également définir le chemin de bibliothèque dans chaque shell qui exécute votre application. Exemple :

      export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH

      Remarques :

      Les fichiers de téléchargement Linux Instant Client sont disponibles sous forme de fichiers .zip ou .rpm. Vous pouvez utiliser n'importe quelle version.
  2. Installez le pilote de langage approprié pour Oracle Database :

    • Node.js : afin d'installer noeud-oracledb pour Node.js, suivez les instructions de la page suivante : Installation de noeud-oracledb.

    • ROracle : afin d'installer ROracle pour R, utilisez les instructions de la page suivante : ROracle.

    • PHP : afin d'installer PHP OCI8 pour PHP, utilisez les instructions de la page suivante : Configuration de PHP avec OCI8.

      Les DLL Windows sont disponibles sur les pages http://php.net/downloads.php et PECL oci8.

    • PHP PDO_OCI : afin d'installer PHP PDO_OCI pour PHP, utilisez les instructions de la page suivante : Oracle Functions (PDO_OCI).

      Les DLL Windows sont disponibles sur la page http://php.net/downloads.php incluse dans PHP.

    • Ruby : afin d'installer ruby-oci8 pour Ruby, utilisez les instructions de la page suivante : Installation pour Oracle Instant Client.

    • DBD pour Perl : afin d'installer DBD : :Oracle pour Perl, définissez ORACLE_HOME et le chemin de recherche de bibliothèque, tel que LD_LIBRARY_PATH ou PATH, sur le répertoire Instant Client, et utilisez les instructions de la page suivante : DBD : :Oracle.

Activation de la connectivité réseau Oracle et obtention des informations d'identification de sécurité (Oracle Wallet)

  1. Obtenez les informations d'identification de sécurité client pour vous connecter à une instance Autonomous Database. Vous disposez alors d'un fichier ZIP contenant les informations d'identification de sécurité client et les paramètres de configuration réseau requis pour accéder à la base de données autonome. Vous devez protéger ce fichier et son contenu pour éviter tout accès non autorisé à la base de données. Procurez-vous le fichier d'informations d'identification de sécurité client comme suit :

  2. Extrayez les fichiers d'informations d'identification client (portefeuille) :

    1. Décompressez le fichier ZIP d'informations d'identification client.

    2. Si vous utilisez Instant Client, créez une hiérarchie de sous-répertoires network/admin sous le répertoire Instant Client, si nécessaire. Déplacez ensuite les fichiers vers ce sous-répertoire. Par exemple, en fonction de l'architecture ou du système client, et de l'emplacement d'installation d'Instant Client, les fichiers doivent se trouver dans l'un des répertoires suivants :

      C:\instantclient_12_2\network\admin

      ou

      /home/myuser/instantclient_18_5/network/admin

      ou

      /usr/lib/oracle/18.5/client64/lib/network/admin
      • Si vous utilisez le client Oracle complet, déplacez le fichier vers $ORACLE_HOME/network/admin.

    3. Vous pouvez également placer les fichiers de portefeuille décompressés dans un répertoire sécurisé et définir la variable d'environnement TNS_ADMIN sur le nom de ce répertoire.

    Remarques :

    A partir du fichier ZIP, seuls les fichiers suivants sont requis : tnsnames.ora, sqlnet.ora, cwallet.sso et ewallet.p12.

Exécution de l'application

  1. Mettez à jour l'application pour vous connecter à l'aide de votre nom utilisateur de base de données, de votre mot de passe et du nom de connexion Oracle Net indiqué dans le fichier tnsnames.ora décompressé. Par exemple : utilisateur atpc_user, mot de passe et atpc_low en tant que chaîne de connexion.

  2. Vous pouvez également modifier la chaîne de connexion dans tnsnames.ora afin qu'elle corresponde à la chaîne utilisée par l'application.

  3. Exécutez l'application.