Créer une application Node.js

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

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 mettre en pratique les instructions décrites dans les rubriques qui suivent, exécutez l'étape Exercice 3 : Créer et déployer une application Node.js dans l'atelier sur l'utilisation des bases de données autonomes Oracle dédiées pour développeurs et utilisateurs de base de données.

Rubriques connexes

Configurer 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 fonctions de disponibilité continue et de haute performance d'une base de données Autonomous Database, vous devez effectuer ces étapes.

  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.

Étapes préliminaires

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 :

  • Oracle Linux :

    Exécutez ces commandes pour télécharger et installer la dernière version de Node.js :

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

  • Autres architectures et OSes :

    Allez à la page de téléchargements de Node.js, sélectionnez la dernière version LTS (avec soutien à long terme) pour le système d'exploitation et l'architecture de votre système, puis installez-la.

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 :

  • Oracle Linux :

    Exécutez ces commandes pour télécharger et installer l'ensemble de base Oracle Instant Client :

    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, accédez à http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

  • Autres architectures et OSes :

    1. Accédez à la page de téléchargements d'Oracle Instant Client et sélectionnez le téléchargement correspondant au système d'exploitation et à l'architecture de votre système.

    2. Dans la page de téléchargement, acceptez le contrat de licence d'Oracle Technology Network, téléchargez la dernière version de l'ensemble de base, puis installez-le en suivant les instructions au bas de la page de téléchargement.

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 :

  • Oracle Linux :

    Exécutez ces commandes pour télécharger et installer la dernière version de node-oracledb :

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

  • Autres architectures et OSes :

    Allez à la page Ajout d'un noeud-oracledb, choisissez les instructions "Ma base de données se trouve sur un autre ordinateur" correspondant à votre système d'exploitation et votre architecture, puis suivez les instructions sous Installer le compagnon.

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 avez 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, avec 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 pour Autonomous Database.

    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 Download Wallet (Télécharger le portefeuille), entrez un mot de passe dans le champ Password (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é des applications Node.js à une base de données Autonomous Database, procédez comme suit 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.

Ajoutez la dépendance à node-oracledb dans package.json.

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 le fichier 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.

Ressources supplémentaires

Pour des informations détaillées sur node-oracledb, allez à la page de documentation sur node-oracledb, qui contient des informations de référence sur les API et un guide de l'utilisateur.

Pour des exemples de code qui illustrent de nombreuses fonctions de node-oracledb, allez au dossier node-oracledb/examples.