Creación de una aplicación Node.js

Para crear una aplicación Node.js que acceda a una base de Datos de IA autónoma, debe empezar por configurar el sistema del desarrollo para que pueda beneficiarse de las funciones del servicio de disponibilidad continua y alto rendimiento de Autonomous AI Database.

Después de configurar el sistema de desarrollo, codifique las conexiones de base de datos y las sentencias SQL en la aplicación para utilizar las funciones de disponibilidad continua y alto rendimiento.

Consejo: si desea una alternativa de "prueba" a la lectura de los siguientes temas, puede realizar el laboratorio 3 sobre creación y despliegue de aplicaciones Node.js en el taller de Oracle Autonomous AI Database Dedicated for Developers and Database Users.

Configuración del sistema de desarrollo Node.js

Para configurar el sistema para que su aplicación Node.js pueda usar las funciones de disponibilidad continua y alto rendimiento de una base de datos de IA autónoma, realice estos pasos.

  1. Descargue e instale Node.js.

  2. Descargue e instale Oracle Instant Client.

  3. Descargue e instale node-oracledb.

  4. Descargue las credenciales de cliente para la base de datos y haga que estén disponibles para Oracle Instant Client.

Antes de empezar

El sistema de desarrollo debe cumplir determinados criterios para configurarlo correctamente.

Descarga e instalación de Node.js.

Descargue e instale Node.js para el sistema operativo y la arquitectura de su sistema:

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

Descarga e instalación de Oracle Instant Client

Necesita las bibliotecas de Oracle Instant Client versión 19.6 o posterior.

Descargue e instale el paquete básico de Oracle Instant Client para el sistema operativo y la arquitectura del sistema:

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

(Si desea ver una lista de todos los paquetes Instant Client, vaya a http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html).

Descarga e instalación de node-oracledb

Descargue e instale el complemento node-oracledb para Node.js para el sistema operativo y la arquitectura de su sistema:

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

Descarga e instalación de las credenciales de cliente para la base de datos

  1. Descargue el archivo zip que contiene las credenciales de cliente para la base de datos en un directorio seguro de la computadora.

    Este archivo zip está disponible para su descarga en la página Detalles de la base de datos en la consola de Oracle Cloud. If you have an Oracle Cloud user account that permits you to access this page, download the credentials as follows. Si no tiene una cuenta de este tipo, deberá obtener el archivo zip del administrador de la base de datos, junto con la contraseña que se ha utilizado para proteger el archivo zip.

    1. En su explorador web, conéctese a Oracle Cloud y desplácese a la página Detalles de la base de datos de IA autónoma.

    2. Haga clic en Conexión de base de datos.

    3. En la página Conexión a base de datos, haga clic en Descargar.

    4. En el cuadro Descargar cartera, introduzca una contraseña para una cartera en el campo de Contraseña y confirme la contraseña en el campo de Confirmar Contraseña.

      La contraseña debe tener al menos 8 caracteres e incluir al menos 1 letra y 1 carácter numérico o 1 carácter especial.

    5. Haga clic en Descargar para guardar el archivo ZIP de credenciales del cliente en un directorio seguro.

  2. Después de descargar el archivo zip, siga estos pasos:

    1. Descomprima el archivo zip de credenciales de cliente.

    2. Edite el archivo sqlnet.ora que se proporciona en las credenciales de cliente, sustituyendo "?/network/admin" por la ruta completa del directorio en el que ha descomprimido las credenciales de cliente; por ejemplo, cambie:

       (DIRECTORY="?/network/admin")

      a:

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

    3. Cree la variable de entorno TNS_ADMIN definiendo su valor en la ruta de acceso completa del directorio donde ha descomprimido las credenciales de cliente.

Codificación de conexiones de base de datos y sentencias SQL

Después de configurar el sistema de desarrollo para admitir la conectividad de las aplicaciones Node.js a una base de Datos de IA autónoma, siga estos pasos para garantizar un rendimiento óptimo del uso de la base de Datos por parte de la aplicación:

  1. Agregue la dependencia en el complemento node-oracledb al archivo package.json de la aplicación.

  2. Codifique conexiones de alto rendimiento y disponibilidad continua.

Agregar el nodo-oracledb Dependency topackage.json

Edite el objeto dependencies en el archivo package.json de la aplicación, agregando el paquete y la versión oracledb. (Utilice la orden npm init para generar package.json si no existe). Por ejemplo:

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

Para obtener información detallada sobre el objeto dependencies, consulte la página npm-package.json. Para mostrar la versión de oracledb instalada, puede utilizar el comando npm list; por ejemplo:

npm list -g --depth=0

Codificación de conexiones de alto rendimiento y disponibilidad continua

Para lograr un alto rendimiento y una disponibilidad continua, siga estas directrices al realizar conexiones a la base de datos:

Por ejemplo:

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

En este ejemplo se crea un pool para las conexiones al servicio de base de datos tp_tls y se activa FAN definiendo la propiedad events en true.

Contenido relacionado