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:
-
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:
-
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.
-
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
-
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. -
En Windows, agregue la ruta a la variable
PATH
en la sección "Variables del sistema" del panel Variables de entorno (por ejemplo, agregueC:\instantclient_12_2
). En Windows 8, acceda al área de configuración de la variablePATH
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. -
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.
-
-
Instale el controlador de lenguaje correspondiente para Oracle Database:
-
Node.js: para instalar node-oracledb para Node.js, siga las instrucciones de la página: Instalación de node-oracledb.
-
ROracle: para instalar ROracle para R, utilice las instrucciones de la página ROracle
-
PHP: para instalar PHP OCI8 para PHP, utilice las instrucciones de la página sobre la 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: 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 de instalación para Oracle Instant Client
-
DBD para Perl: para instalar DBD::Oracle para Perl, defina
ORACLE_HOME
y la ruta de búsqueda en biblioteca, comoLD_LIBRARY_PATH
oPATH
, en el directorio de Instant Client y utilice las instrucciones de la siguiente página: DBD::Oracle.
-
Activación de la conectividad de la red de Oracle y obtención de las credenciales de seguridad (Oracle Wallet)
-
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.
-
-
Extraiga los archivos de credenciales de cliente (cartera):
-
Descomprima el archivo zip de credenciales de cliente.
-
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
.
-
-
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
yewallet.p12
. -
Ejecución de la aplicación
-
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 yatpc_low
como cadena de conexión. -
También puede cambiar la cadena de conexión en
tnsnames.ora
para que coincida con la cadena que utiliza la aplicación. -
Ejecute la aplicación.
Temas relacionados