Conexión a Autonomous Database con Node.js y otros idiomas de creación de scripts

Puede utilizar programas en diferentes idiomas, incluidos Node.js, PHP, Ruby, R, Go y Perl para conectarse a Autonomous Database on Dedicated Exadata Infrastructure. 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. Las bibliotecas de Oracle Call Interface pueden ser del cliente de Oracle completo o de Oracle Instant Client.

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

Para conectarse a Autonomous Database on Dedicated Exadata Infrastructure desde el lenguaje de creación de scripts, primero instale el controlador de lenguaje y las bibliotecas de cliente de la siguiente manera:

  1. Instale Instant Client o el cliente completo. La versión mínima admitida para el cliente completo es la versión 11.2.0.4; para Oracle Instant Client, utilice la versión 12.1.0.2 o superior:

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

    1. Seleccione la arquitectura deseada en la página Descargas de Oracle Instant Client y descargue un paquete Basic (disponible en la página de descarga): 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

      Note:

      Los archivos de descarga de Linux Instant Client están disponibles como archivos .zip o archivos .rpm. Puede utilizar cualquiera de las versiones.
  2. Instale el controlador de lenguaje correspondiente para Oracle Database:

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

  1. Obtenga credenciales de seguridad de cliente para conectarse a una instancia de Autonomous Database. Debe obtener un archivo zip que contiene las credenciales de seguridad del cliente y los valores de configuración de red necesarios para acceder a su instancia de Autonomous Database. 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.

    • Otro usuario (no administrador): obtenga Oracle Wallet del administrador para su instancia de Autonomous Database.

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

    1. Descomprima el archivo zip de credenciales de cliente.

    2. Si va a utilizar Instant Client, cree la 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 bien,

      /home/myuser/instantclient_18_5/network/admin

      o bien,

      /usr/lib/oracle/18.5/client64/lib/network/admin
      • Si va a utilizar Oracle Client completo, mueva el archivo a $ORACLE_HOME/network/admin.

    3. 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.

    Note:

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

Ejecución de la aplicación

  1. Actualice la aplicación para conectarse mediante el nombre de usuario de la base de datos, la contraseña y el nombre de conexión de red de Oracle proporcionado en el archivo tnsnames.ora descomprimido. Por ejemplo, usuario, atpc_user, contraseña y atpc_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 que utiliza la aplicación.

  3. Ejecute la aplicación.