Conexión a Node.js y otros lenguajes de creación de scripts (mTLS)

Puede utilizar programas en diferentes lenguajes, incluidos Python, Node.js, PHP, Ruby, R, Go y Perl para conectarse a una instancia de base de datos de IA autónoma mediante mTLS (con carteras). La seguridad se aplica mediante credenciales de cliente.

Estos lenguajes de creación de scripts tienen controladores o API de acceso a base de datos que utilizan las bibliotecas de Oracle Call Interface.

Para obtener más información, consulte el siguiente vídeo:

• Conexión de aplicaciones de Node.js a adb_tp

Instalación del controlador de lenguaje y las bibliotecas de cliente

Para conectarse a la base de datos de IA autónoma desde su lenguaje de scripts, primero instale el controlador de lenguaje y la biblioteca de cliente de esta manera:

1. Instale Oracle Instant Client/Oracle AI Database Client: 18.19 (o posterior), 19.2 (o posterior) o 21 (versión base o posterior).

   Instant Client funciona correctamente para la mayoría de las aplicaciones. Para instalar Instant Client, haga lo siguiente:

   1. Seleccione la arquitectura que desee en la página Instant Client Downloads y descargue un paquete básico (disponible en la página de descarga): Descargas de Oracle Instant Client.

      Como alternativa, descargue el paquete Basic Light de la página de descarga para la arquitectura deseada si las limitaciones de globalización de Basic Light se adecuan a su uso.

   2. Si va a crear una API o un controlador de lenguaje a partir del código fuente, puede que también necesite descargar el SDK de Instant Client: Oracle Instant Client

   3. Descomprima el paquete base que ha seleccionado. Por ejemplo, descomprímalo en C:\instantclient_12_2 o /home/myuser/instantclient_18_5. Si también descarga el SDK, descomprímalo en el mismo directorio.

   4. En Windows, agregue la ruta a la variable PATH en la sección "Variables del Sistema" del panel Variables de entorno (por ejemplo, agregue C:\instantclient_12_2). En Windows 8, acceda al área de configuración de la variable PATH desplazándose hasta Panel de control>Sistema>Configuración avanzada del sistema>Variables de entorno. Si tiene instaladas varias versiones de bibliotecas de Oracle, asegúrese de que el nuevo directorio aparezca en primer lugar en la ruta.

   5. En plataformas que no sean Windows, cree un enlace simbólico si no existe. Por ejemplo:

      cd /home/myuser/instantclient_18_5
      ln -s libclntsh.so.18.1 libclntsh.so

      Si no hay ningún otro software de Oracle en el sistema que se vea afectado, agregue Instant Client a la ruta del enlace de tiempo de ejecución. Por ejemplo:

      sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf"
      sudo ldconfig

      También puede definir la ruta de la biblioteca en cada shell que ejecute la aplicación. Por ejemplo:

      export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH

      Nota
      
      Nota: Los archivos de descarga de Linux Instant Client están disponibles como archivos de .zip o archivos .rpm. Puede utilizar cualquiera de las versiones.

2. Instale el controlador de lenguaje correspondiente para Oracle AI Database:

   • Node.js: para instalar node-oracledb para Node.js, utilice las instrucciones del página sobre la instalación de node-oracledb.

   • Oracle: para instalar ROracle para R, utilice las instrucciones de la página sobre ROracle

   • PHP: para instalar PHP OCI8 para PHP, utilice las instrucciones de la página siguiente: Configuración de PHP con OCI8.

     Las DLL de Windows están disponibles en http://php.net/downloads.php y también en PECL oci8.

   • PHP PDO_OCI: para instalar PHP PDO_OCI para PHP, utilice las instrucciones de la página sobre Oracle Functions (PDO_OCI).

     Las DLL de Windows están disponibles en http://php.net/downloads.php que se incluye en PHP.

   • Ruby: para instalar ruby-oci8 para Ruby, utilice las instrucciones de la página deinstalación para Oracle Instant Client

   • DBD para Perl: para instalar DBD::Oracle para Perl, defina ORACLE_HOME y las rutas de búsqueda de biblioteca, como LD_LIBRARY_PATH o PATH, en el directorio de Instant Client y utilice las instrucciones del siguiente página: instalación de DBD-Oracle.

   • Python: para obtener instrucciones sobre la conexión de aplicaciones Python, consulte Conexión de aplicaciones Python con una cartera (mTLS)

Activación de la conectividad de la red de Oracle y obtención de las credenciales de seguridad (Oracle Wallet)

1. Obtenga credenciales del cliente de seguridad para conectarse a la base de datos de IA autónoma. Debe obtener un archivo comprimido que contenga las credenciales de seguridad de cliente y los valores de configuración del red necesarios para acceder a su base de datos. Debe proteger este archivo y su contenido para evitar el acceso no autorizado a la base de datos. Obtenga el archivo de credenciales de seguridad del cliente de la siguiente manera:

   • Usuario ADMIN: haga clic en Conexión de base de datos. Consulte Descarga de credenciales de cliente (carteras).

   • Otro usuario (no administrador): obtenga Oracle Wallet del administrador para su base de datos de IA autónoma.

2. Extraiga los archivos de credenciales de cliente (cartera):

   • Descomprima el archivo comprimido de credenciales de cliente.

   • Si va a utilizar Instant Client, cree una jerarquía de subdirectorio network/admin en el directorio Instant Client si es necesario. A continuación, mueva los archivos a este subdirectorio. Por ejemplo, en función de la arquitectura o el sistema cliente y de dónde haya instalado Instant Client, los archivos deben estar en el directorio:

     C:\instantclient_12_2\network\admin

     o

     /home/myuser/instantclient_18_5/network/admin

     o

     /usr/lib/oracle/18.5/client64/lib/network/admin

     • Si va a utilizar Oracle Client completo, mueva el archivo a $ORACLE_HOME/network/admin.

   • También puede colocar los archivos de cartera descomprimidos en un directorio seguro y definir la variable de entorno TNS_ADMIN en ese nombre de directorio.

     Nota
     
     Nota: En el archivo comprimido, solo se necesitan estos archivos: tnsnames.ora, sqlnet.ora, cwallet.sso y ewallet.p12.

3. Si está detrás de un proxy, siga los pasos de "Conexiones con un proxy HTTP", en Preparación para conexiones OCI de Oracle Call Interface, ODBC y JDBC con carteras (mTLS).

Ejecución de la aplicación

1. Actualice la aplicación para conectarse utilizando el nombre del usuario de la base de Datos, la contraseña y el nombre en el que se conecta la Red de Oracle proporcionado en el archivo tnsnames.ora descomprimido. Por ejemplo, el usuario adb_user, password y db2022adb_low como cadena de conexión.

2. También puede cambiar la cadena de conexión en tnsnames.ora para que coincida con la cadena utilizada por la aplicación.

3. Ejecute la aplicación.