Se connecter à Autonomous AI 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 à une base de données autonome 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 à une base de données sur une infrastructure Exadata dédiée à partir de votre langage de script, installez d'abord le pilote de langue et les bibliothèques client comme suit :
-
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 :
-
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.
-
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
-
Décompressez l'ensemble de base que vous avez sélectionné. Par exemple, décompressez les données dans
C:\instantclient_12_2ou/home/myuser/instantclient_18_5.Si vous téléchargez également la trousse SDK, décompressez-la dans le même répertoire. -
Sous Windows, ajoutez le chemin à la variable
PATHdans la section "Variables système" du volet Variables d'environnement (par exemple, ajoutezC:\instantclient_12_2). Sous Windows 8, accédez à la zone de paramètres de la variablePATHen 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. -
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.soSi 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 ldconfigVous 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_PATHNote :
Les fichiers de téléchargement de Linux Instant Client sont disponibles en tant que fichiers.zipou.rpm. Vous pouvez utiliser l'une ou l'autre version.
-
-
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_HOMEet le chemin de recherche de bibliothèque, par exempleLD_LIBRARY_PATHouPATH, au répertoire Instant Client et utilisez les instructions de la page suivante : DBD : :Oracle.
-
Activer la connectivité réseau Oracle et obtenir les données d'identification de sécurité (Oracle Wallet)
-
Obtenez les données d'identification de sécurité du client pour vous connecter à une instance 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 à votre base de données Autonomous AI Database. 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 Oracle Wallet auprès de l'administrateur pour votre base de données autonome d'IA.
-
-
Extrayez les fichiers de données d'identification du client (portefeuille) :
-
Décompressez le fichier zip de données d'identification du client.
-
Si vous utilisez Instant Client, créez un sous-répertoire
network/adminsous 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\adminou
/home/myuser/instantclient_18_5/network/adminou
/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.
-
-
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.ssoetewallet.p12. -
Exécuter votre application
-
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.oradécompressé. Par exemple, utilisateuratpc_user, mot de passe etatpc_lowcomme chaîne de connexion. -
Vous pouvez également modifier la chaîne de connexion dans
tnsnames.orapour qu'elle corresponde à la chaîne utilisée par votre application. -
Exécutez votre application