Créer une application Node.js

Pour créer une application Node.js qui accède à une base de données autonome d'IA, vous commencez par configurer votre système de développement pour prendre en charge l'accès à la base de données, qui peut tirer parti de la disponibilité continue et des fonctions haute performance de la base de données autonome d'IA.

Après avoir configuré votre système de développement, vous codez les connexions à la base de données et les énoncés SQL dans votre application afin de tirer parti des fonctions de disponibilité continue et de haute performance.

Conseil : Pour une autre option que la lecture des rubriques suivantes, vous pouvez consulter Laboratoire 3 : Créer et déployer une application Node.js dans l'atelier sur Oracle Autonomous AI Database Dedicated for Developers and Database Users.

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

Pour configurer votre système de développement afin que votre application Node.js puisse tirer parti de la disponibilité continue et des fonctions haute performance d'une base de données autonome d'IA, procédez de la façon suivante.

  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 données d'identification du client pour la base de données et mettez-les à la disposition d'Oracle Instant Client.

Avant de commencer

Pour pouvoir être configuré, votre système de développement doit répondre à certains critères.

Télécharger et installer 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écharger et installer Oracle Instant Client

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

Téléchargez et installez l'ensemble 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 voir la liste de tous les ensembles Instant Client, allez à http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

Télécharger et installer node-oracledb

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

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

Télécharger et installer les données d'identification du client pour la base de données

  1. Téléchargez le fichier zip contenant les données d'identification du client pour votre base de données dans un répertoire sécurisé sur votre ordinateur.

    Ce fichier zip est disponible pour téléchargement à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous disposez d'un compte d'utilisateur Oracle Cloud qui vous permet d'accéder à cette page, téléchargez les données d'identification comme suit. Si vous ne disposez pas d'un tel compte, vous devez obtenir le fichier zip auprès de l'administrateur de la base de données, ainsi que le mot de passe utilisé pour protéger le fichier zip.

    1. Dans votre navigateur Web, connectez-vous à Oracle Cloud et naviguez jusqu'à la page Détails de la base de données d'IA autonome.

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

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

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

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

    5. Cliquez sur Télécharger pour enregistrer le fichier zip des données d'identification du client dans un répertoire sécurisé.

  2. Après avoir téléchargé le fichier zip, procédez de la façon suivante :

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

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

       (DIRECTORY="?/network/admin")

      en :

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

    3. Créez la variable d'environnement TNS_ADMIN et réglez sa valeur au chemin complet du répertoire où vous avez décompressé les données d'identification du client.

Coder les connexions aux bases de données et les énoncés SQL

Après avoir configuré votre système de développement pour prendre en charge la connectivité d'application Node.js à une base de données autonome d'IA, suivez ces étapes pour assurer une performance optimale de l'utilisation de la base de données par votre application :

  1. Ajoutez la dépendance au module complémentaire node-oracledb dans le fichier package.json de votre application.

  2. Codez les connexions pour la haute performance et la disponibilité continue.

Ajouter le fichier topackage.json node-oracledb Dependency

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

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

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

npm list -g --depth=0

Coder les connexions pour la haute performance et la disponibilité continue

Pour obtenir une performance élevée et une disponibilité continue, suivez ces directives lors de l'établissement de connexion à la base de données :

Par exemple :

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

Cet exemple crée une réserve de connexions au service de base de données tp_tls et active l'avis rapide des applications en réglant la propriété events à true.

Contenu connexe