Desarrollo de servicios RESTful en una base de datos de IA autónoma

Puede desarrollar y desplegar servicios RESTful con soporte nativo Oracle REST Data Services (ORDS) en una base de datos de IA autónoma.

Acerca de Oracle REST Data Services en la base de datos de IA autónoma

Oracle REST Data Services (ORDS) facilita el desarrollo en una base de datos de IA autónoma de interfaces REST para datos relacionales. 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 la base de datos de IA autónoma está preconfigurada y totalmente gestionada. ORDS es un servicio predefinido low de bases de datos 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 Nombres de servicio de base de datos predefinidos para base de datos de IA autónoma para obtener información sobre el servicio de base de datos low.

Desarrollo con Oracle REST Data Services en Autonomous AI Database

La base de datos de IA autónoma 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 la instancia de AI Database y activar el acceso de la 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 AI 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.