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

Vous pouvez utiliser des programmes dans différents langages, notamment Node.js, PHP, Ruby, R, Go et Perl pour vous connecter à Autonomous Database sur une infrastructure Exadata dédiée. La sécurité est mise en oeuvre à l'aide de données d'identification de client.

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

Installer le pilote de langage et les bibliothèques du client

Pour vous connecter à Autonomous Database sur une infrastructure Exadata dédiée à partir de votre langage de script, commencez par installer le pilote de langage et les bibliothèques du client, comme suit :

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

    Oracle Instant Client fonctionne bien pour la plupart des applications. Pour installer Oracle Instant Client, procédez de la façon suivante :

    1. Sélectionnez l'architecture souhaitée dans la page de téléchargement d'Oracle Instant Client et téléchargez un ensemble de base (disponible dans la page de téléchargement) : Oracle Instant Client

      Vous pouvez également télécharger l'ensemble Basic Light à partir de la page de téléchargement pour l'architecture souhaitée, si ses limites en matière de globalisation sont compatibles avec votre utilisation.

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

    3. Décompressez l'ensemble de base que vous avez sélectionné. Par exemple, décompressez les données dans C:\instantclient_12_2 ou /home/myuser/instantclient_18_5. Si vous téléchargez également la trousse SDK, décompressez-la dans le même répertoire.

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

    5. Sur les plates-formes non Windows, créez un lien symbolique s'il n'existe pas. Par exemple :

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

      Si aucun autre logiciel Oracle sur votre système n'est concerné, ajoutez Oracle Instant Client au chemin du lien d'exécution. Par 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 la bibliothèque dans chaque interpréteur de commandes qui exécute votre application. Par exemple :

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

      Note :

      Les fichiers de téléchargement de Linux Instant Client sont disponibles en tant que fichiers .zip ou .rpm. Vous pouvez utiliser l'une ou l'autre version.

  2. Installez le pilote de langage approprié pour Oracle Database :

Activer la connectivité réseau Oracle et obtenir les données d'identification de sécurité (Oracle Wallet)

  1. Obtenez les données d'identification de sécurité du client pour la connexion à une instance de base de données autonome. Vous obtenez un fichier zip contenant les données d'identification de sécurité du client et les paramètres de configuration du réseau requis pour accéder à la base de données autonome. Vous devez protéger ce fichier et son contenu pour empêcher l'accès non autorisé à la base de données. Obtenez le fichier de données d'identification de sécurité du client comme suit :

    • Utilisateur ADMIN : Cliquez sur Connexion à la base de données. Voir Télécharger les données d'identification du client.

    • Autre utilisateur (non administrateur) : Obtenez le portefeuille Oracle Wallet pour la base de données autonome auprès de l'administrateur.

  2. Extrayez les fichiers de données d'identification du client (portefeuille) :

    1. Décompressez le fichier zip de données d'identification du client.

    2. Si vous utilisez Instant Client, créez un sous-répertoire network/admin sous le répertoire Instant Client, si nécessaire. Déplacez ensuite les fichiers vers ce sous-répertoire. Par exemple, selon l'architecture ou le système client et l'endroit où vous avez installé Instant Client, les fichiers doivent se trouver dans le répertoire : 

      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 un 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 régler la variable d'environnement TNS_ADMIN à ce nom de répertoire.

    Note :

    Dans le fichier zip, seuls ces fichiers sont requis : tnsnames.ora, sqlnet.ora, cwallet.sso et ewallet.p12.

Exécuter votre application

  1. Mettez à jour votre application pour vous connecter à l'aide de votre nom d'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 comme chaîne de connexion.

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

  3. Exécutez votre application

Rubriques connexes