Creación de una aplicación Ruby

Para crear una aplicación Ruby que acceda a una base de Datos de IA autónoma, debe empezar por configurar el sistema a fin de que admita el acceso a bases de datos para que pueda beneficiarse de las funciones a disponibilidad continua y alto rendimiento de la base de Datos de IA autónoma.

Después de configurar el sistema de desarrollo para que soporte el acceso a la base de datos, puede codificar conexiones de base de datos y sentencias SQL en la aplicación para utilizar estas funciones.

Configuración del sistema de desarrollo Ruby

Para configurar el sistema a fin de que su aplicación Ruby pueda aprovechar las funciones de disponibilidad continua y alto rendimiento de una base de datos de IA autónoma, realice estos pasos.

1. Descargue e instale Ruby.

2. Descargue e instale Oracle Instant Client.

3. Descargue e instale ruby-oci8.

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.

• Debe tener acceso a Internet.

• Debe tener acceso de red a la base de datos de IA autónoma.

  Consulte Configuración de un sistema de desarrollo para acceder a la base de datos

Descarga e instalación de Ruby

Para descargar e instalar Ruby, vaya a la página Installing Ruby en ruby-lang.org y siga las instrucciones para el sistema operativo y la arquitectura de su sistema.

Descarga e instalación de Oracle Instant Client

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

• Oracle Linux:

  Ejecute estos comandos para descargar e instalar el paquete básico de Oracle Instant Client:

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

• Otros sistemas operativos y arquitecturas:

  1. Vaya a la página Oracle Instant Client Downloadst y seleccione la descarga para el sistema operativo y la arquitectura de su sistema.

  2. En la página De Descarga, acepte el Acuerdo de Licencia de Oracle Technology Network, descargue la versión más reciente del Paquete Básico y, a continuación, instálelo siguiendo las instrucciones que se muestran en la parte inferior de la página De Descarga.

Descarga e instalación de ruby-oci8

Para descargar e instalar la interfaz ruby-oci8 en Oracle Database, siga las instrucciones de la página de instalación para Oracle Instant Client.

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 de forma que soporte la conectividad de aplicación Ruby a una base del sistema de IA autónoma, siga estas directrices para lograr un alto rendimiento y la disponibilidad continua de los conectores de aplicación a la base:

• Utilice pools de conexiones.

• Active FAN (Fast Application Notification).

• Utilice el servicio de base de datos predefinido que mejor coincida con las operaciones que va a realizar. Para obtener información sobre los servicios a la base de datos predefinidos, consulte Nombres de servicio a la base de datos predefinidos para bases de datos de IA autónomas.

Por ejemplo:

require 'oci8'
OCI8.properties[:events_mode] = true
cpool = OCI8::ConnectionPool.new(1, 5, 2, username, password, 'tp_tls')
conn1 = OCI8.new(username, password, cpool)

En este ejemplo se activa FAN definiendo la propiedad events_mode en true, se crea un pool para las conexiones al servicio de base de datos tp_tls y se adquiere una conexión del pool.

Contenido relacionado

• Para obtener información detallada sobre ruby-oci8, vaya a la página Ruby-oci8.

• Conceptos básicos de la creación de una aplicación