Desarrollo de servicios RESTful en Autonomous Database

Puede desarrollar y desplegar servicios RESTful con soporte nativo para Oracle REST Data Services (ORDS) en una instancia de Autonomous Database.

Acerca de Oracle REST Data Services en Autonomous Database

Oracle REST Data Services (ORDS) facilita el desarrollo de interfaces REST para datos relacionales en una Autonomous Database. ORDS es una aplicación Java de nivel medio que asigna verbos HTTP(S), como GET, POST, PUT, DELETE, etc., a transacciones de base de datos y devuelve todos los resultado como datos JSON.

Note:

La aplicación Oracle REST Data Services (ORDS) en Autonomous Database está preconfigurada y totalmente gestionada. ORDS se conecta a la base de datos mediante el servicio de base de datos predefinido low con un número máximo fijo de conexiones (el número de conexiones para ORDS no cambia según el número de CPU). No se puede cambiar la configuración de ORDS por defecto.

Consulte Oracle REST Data Services para obtener información sobre el uso de Oracle REST Data Services.

Consulte la Nombres de servicio de base de datos predefinidos para instancias de Autonomous Database para obtener información sobre el servicio de base de datos low.

Desarrollo con Oracle REST Data Services en Autonomous Database

Autonomous Database soporta Oracle REST Data Services (ORDS).

El desarrollo de servicios RESTful es sencillo con cualquiera de las siguientes interfaces de desarrollo:

  • SQL Developer (escritorio): con SQL Developer en el escritorio, puede conectarse a Autonomous Database y activar el acceso de los servicios REST a tablas y vistas, o desarrollar servicios RESTful personalizados basados en su código SQL y PL/SQL. Consulte Conexión con Oracle SQL Developer versión 18.2 o posterior para obtener más información.

  • Oracle Application Express (APEX): con APEX puede utilizar las páginas de desarrollo de servicios RESTful para crear y mantener los servicios y los objetos activados para REST. Puede utilizar el Taller de SQL de APEX para acceder a los servicios de Oracle RESTful y los objetos activados para REST. Consulte la sección sobre cómo acceder a los servicios RESTful para obtener más información.

La cuenta ADMIN de Autonomous Database está activada para REST. Esto permite que los servicios REST se publiquen en los esquemas de ADMIN y le permite acceder a Database Actions mediante la cuenta de usuario de base de datos ADMIN. Oracle recomienda crear una cuenta de esquema de aplicación para los servicios RESTful y los objetos activados para REST. Los servicios se protegen mediante la autenticación de base de datos y el esquema activado para REST.

El usuario de base de datos autenticado solo tiene permiso de acceso si el esquema está activado para REST y la asignación de URL para la solicitud apunta a su propio esquema. Un usuario no se autentica cuando una solicitud apunta a cualquier otro esquema de base de datos. Por ejemplo, se puede acceder a la siguiente solicitud autenticada como el esquema activado para REST HR: 

GET /ords/hr/module/service/

Sin embargo, cuando se autentica como el esquema activado para REST SCOTT, la misma solicitud: 

GET /ords/hr/module/service/

genera un error:

401 HTTP Unauthorized response/error

Cualquier usuario de base de datos cuyas credenciales son correctas y cumplen estas reglas se autentica y se le otorga el rol ORDS, de nivel medio: SQL Developer. El rol SQL Developer permite al usuario acceder a cualquier punto final que necesite el rol SQL Developer.

Consulte la sección sobre la activación para REST de una tabla de base de datos en la Guía de inicio rápido para obtener información sobre cómo activar una tabla para el acceso de REST.