Création d'une application Node.js

Pour créer une application Node.js qui accède à une base de données d'IA autonome, vous commencez par configurer votre système de développement afin qu'il prenne en charge l'accès à la base de données, qui peut tirer parti de la disponibilité continue et des fonctionnalités hautes performances d'Autonomous AI Database.

Après avoir configuré votre système de développement, codez les connexions de base de données et les instructions SQL dans votre application pour tirer parti des fonctionnalités de hautes performances et de disponibilité continue.

Conseil : pour commencer par tester les éléments abordés ensuite, vous pouvez suivre l'exercice 3 sur la création et la déploiement d'une application Node.js dans l'atelier Oracle Autonomous AI Database Dedicated pour le développement et les utilisateurs de base de donnée.

Configuration de votre système de développement Node.js

Pour configurer votre système de développement de sorte que votre application Node.js puisse tirer parti des fonctionnalités de disponibilité continue et de hautes performances d'une base de données d'IA autonome, procédez comme suit.

  1. Téléchargez et installez Node.js.

  2. Téléchargez et installez Oracle Instant Client.

  3. Téléchargez et installez node-oracledb.

  4. Téléchargez les informations d'identification client de la base de données et rendez-les disponibles pour Oracle Instant Client.

Avant de commencer

Votre système de développement doit répondre à certains critères pour sa configuration.

Téléchargement et installation de Node.js

Téléchargez et installez Node.js pour le système d'exploitation et l'architecture de votre système :

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y nodejs

Téléchargement et installation d'Oracle Instant Client

Vous avez besoin des bibliothèques Oracle Instant Client version 19.6 ou ultérieure.

Téléchargez et installez le package de base Oracle Instant Client pour le système d'exploitation et l'architecture de votre système :

sudo yum -y install oracle-release-el7
sudo yum -y install oracle-instantclient19.3-basic

(Pour afficher la liste de tous les packages Instant Client, accédez à la page http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

Téléchargement et installation de node-oracledb

Téléchargez et installez l'extension node-oracledb Node.js pour le système d'exploitation et l'architecture de votre système :

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y node-oracledb-node10

Téléchargement et installation des informations d'identification client pour la base de données

  1. Téléchargez le fichier ZIP contenant les informations d'identification client pour la base de données vers un répertoire sécurisé de l'ordinateur.

    Ce fichier ZIP peut être téléchargé à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous disposez d'un compte utilisateur Oracle Cloud vous permettant d'accéder à cette page, téléchargez les informations d'identification tel que décrit ci-dessous. Si vous ne disposez pas d'un tel compte, vous devez obtenir le fichier ZIP auprès de l'administrateur de la base des données, ainsi que le mot de passe qui protège le fichier ZIP.

    1. Dans votre navigateur Web, connectez-vous à Oracle Cloud et accédez à la page Détails de la base de données Autonomous AI.

    2. Cliquez sur Connexion de base de données.

    3. Sur la page Connexion à la base de donnée, cliquez sur Télécharger.

    4. Dans la boîte Télécharger un portefeuille, entrez un mot de passe de portefeuille dans le champ de mot de passe et confirmez le mot de passe dans le champ de confirmer le mot de passe.

      Le mot de passe doit comporter au minimum 8 caractères, dont au moins 1 lettre et 1 caractère numérique ou caractère spécial.

    5. Cliquez sur Télécharger pour enregistrer le fichier ZIP d'informations d'identification client dans un répertoire sécurisé.

  2. Après avoir téléchargé le fichier ZIP, procédez comme suit :

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

    2. Modifiez le fichier sqlnet.ora fourni dans les informations d'identification client en remplaçant "?/network/admin" par le chemin complet du répertoire dans lequel vous avez décompressé les informations d'identification client. Par exemple, remplacez :

       (DIRECTORY="?/network/admin")

      par :

       (DIRECTORY="/users/jdoe/adbcredentials")

    3. Créez la variable d'environnement TNS_ADMIN, en définissant sa valeur sur le chemin complet du répertoire dans lequel vous avez décompressé les informations d'identification client.

Codage des connexions de base de données et des instructions SQL

Après avoir configuré votre système de développement pour qu'il prenne en charge la connectivité des applications Node.js à une base de données Autonomous AI, procédez comme suit pour garantir des performances optimales de l'utilisation de la base de données par votre application :

  1. Ajoutez la dépendance à l'extension node-oracledb au fichier package.json de l'application.

  2. Codez les connexions pour les hautes performances et la disponibilité continue.

Ajoutez le fichier topackage.json de la dépendance node-oracledb

Modifiez l'objet dependencies dans le fichier package.json de l'application en ajoutant le package et la version oracledb. (Utilisez La commande npm init pour générer package.json s'il n'existe pas.) Exemple :

. . .
"dependencies": {
  . . .,
 "oracledb": "^4.0",
  . . .
},
. . .

Pour obtenir des informations détaillées sur l'objet dependencies, reportez-vous à la page npm-package.json. Pour afficher la version oracledb installée, vous pouvez utiliser la commande npm list, par exemple :

npm list -g --depth=0

Codage des connexions pour les hautes performances et la disponibilité continue

Afin d'obtenir des performances élevées et une disponibilité continue, suivez les instructions ci-dessous pour l'établissement de connexions à la base de données :

Exemple :

pool = await oracledb.createPool({
  events: true,
  user: "appuser",
  password: process.env.MY_PASSWORD_ENV_VAR,
  connectString: "tp_tls"
});

Cet exemple crée un pool pour les connexions au service de base de données tp_tls, et active la fonction FAN en définissant la propriété events sur true.

Contenu connexe