Se connecter avec Node.js et d'autres langues de script (mTLS)

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.

Pour plus de détails, voir la vidéo suivante :

• Connecter des applications Node.js à une base de données Autonomous Transaction Processing

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

Pour vous connecter à Autonomous AI Database à partir de votre langage de script, installez d'abord le pilote de langage et les bibliothèques du client, comme suit :

1. Installez Oracle Instant Client/Oracle Database Client : 18.19 (ou version ultérieure), 19.2 (ou version ultérieure) ou 21 (version de base ou version 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 de votre choix dans la page Téléchargements de clients instantanés et téléchargez un ensemble de base (disponible dans la page de téléchargement) : Téléchargements d'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. 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. 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. 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 :

   • Node.js : Pour installer node-oracledb pour Node.js, utilisez les instructions de la page suivante : Installation de node-oracledb.

   • ROracle : Pour installer ROracle pour R, utilisez les instructions de la page suivante : ROracle

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

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

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

     Les DLL Windows sont disponibles sur http://php.net/downloads.php et incluses dans PHP.

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

   • DBD for Perl : Pour installer DBD::Oracle pour Perl, réglez ORACLE_HOME et le chemin de recherche de bibliothèque, par exemple LD_LIBRARY_PATH ou PATH, au répertoire d'Instant Client et utilisez les instructions de la page suivante : Installation de DBD-Oracle.

   • Python : Pour obtenir des instructions sur la connexion des applications Python, voir Connecter les applications Python avec un portefeuille (mTLS)

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 vous connecter à la base de données Autonomous AI Database. Vous obtenez un fichier zip contenant les données d'identification de sécurité du client et les paramètres de configuration de réseau requis pour accéder à la base de données. 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 des données d'identification de client (portefeuilles).

   • Autre utilisateur (non administrateur) : Obtenez Oracle Wallet auprès de l'administrateur de votre base de données Autonomous AI Database.

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.

3. Si vous êtes derrière un mandataire, suivez les étapes décrites dans "Connexions avec un mandataire HTTP", sous Préparer pour Oracle Call Interface, ODBC et les connexions OCI JDBC avec des portefeuilles (mTLS).

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, adb_user, mot de passe et db2022adb_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