Oracle Ords Descargar 21
Mozell Gentges
Oracle ORDS Download 21: Cómo instalar y usar la última versión
Si está buscando una manera de acceder y manipular datos en su base de datos Oracle utilizando servicios web RESTful, es posible que desee considerar el uso de Oracle REST Data Services (ORDS). ORDS es una aplicación Java que une HTTPS y su base de datos Oracle, proporcionando una API REST de administración de bases de datos, SQL Developer Web, una puerta de enlace PL/SQL, SODA para REST, y la capacidad de publicar servicios web RESTful para interactuar con los datos y procedimientos almacenados en su base de datos Oracle.
En este artículo, le mostraremos cómo descargar, instalar, configurar y usar la última versión de ORDS, que es 21.1.1 a partir de mayo de 2021. También discutiremos algunos de los beneficios, características y alternativas de ORDS, así como algunas de las mejores prácticas y consejos para su uso eficaz.
Qué es Oracle ORDS?
Oracle REST Data Services (ORDS) es una API REST estándar de OASIS que fue desarrollada originalmente por Microsoft en 2007. Permite la creación y el consumo de APIs RESTful consultables e interoperables de una manera simple y estándar. ORDS admite bases de datos relacionales y NoSQL, como Oracle Database, Times Ten y NoSQL.
ORDS se entrega como una aplicación Java (archivo de guerra) que puede ejecutarse de forma independiente o dentro de un contenedor J2EE (como Apache Tomcat, GlassFish o WebLogic). No requiere un hogar de Oracle ni ninguna instalación de software adicional. Utiliza un controlador JDBC integrado para conectarse a la tecnología de base de datos y pool de conexiones universales (UCP) para gestionar los grupos de conexiones.
Beneficios de Oracle ORDS
Algunos de los beneficios de usar ORDS son:
- Proporciona un acceso HTTPS seguro y eficiente para su base de datos Oracle, ya sea en las instalaciones o en la nube.
- Simplifica el desarrollo y consumo de servicios web RESTful para sus objetos de base de datos, como tablas, vistas, paquetes, procedimientos, etc.
- Soporta SODA para REST, una forma simple y flexible de almacenar y recuperar documentos JSON en su base de datos usando REST.
- Admite la habilitación automática de REST de tablas y vistas, lo que significa que puede exponerlas como servicios web RESTful sin escribir ningún código.
- Admite la autenticación y autorización OAuth2 para proteger sus servicios web.
- Soporta varios formatos para la representación de datos, como JSON, XML, CSV, etc.
- Admite varias opciones de consulta para filtrado, clasificación, paginación, expansión, etc.
- Admite varias operaciones para crear, leer, actualizar, eliminar datos (CRUD) utilizando métodos HTTP como POST, GET, PUT/PATCH, DELETE.
- Soporta varias características para mejorar la funcionalidad y el rendimiento de sus servicios web, como solicitudes por lotes, almacenamiento en caché, etags, etc.
Características de Oracle ORDS
Algunas de las características de ORDS son:
- Database Management REST API: Este es un conjunto de servicios web predefinidos que le permiten realizar varias tareas administrativas en su base de datos utilizando REST. Por ejemplo, puede crear usuarios y roles, conceder privilegios, administrar tablesp
spaces, supervisar sesiones, hacer copias de seguridad y restaurar datos, etc. También puede crear sus propios servicios web personalizados utilizando la API REST de Database Management.
- PL/SQL Gateway: Esta es una característica que le permite publicar sus procedimientos y funciones almacenados en PL/SQL como servicios web RESTful. Puede usar anotaciones o un archivo de configuración para definir los metadatos del servicio web, como la asignación de URL, parámetros, tipo de retorno, etc. También puede usar la API ORDS PL/SQL para manipular las definiciones del servicio web mediante programación.
- SQL Developer Web: Esta es una versión web de Oracle SQL Developer que le permite acceder y administrar su base de datos mediante un navegador. Puede usar SQL Developer Web para ejecutar consultas y scripts, crear y alterar objetos de base de datos, crear modelos de datos, acceder a Performance Hub y ver la actividad de la base de datos. También puede usar SQL Developer Web para habilitar y deshabilitar Auto REST para sus tablas y vistas, así como para probar y depurar sus servicios web.
- SODA for REST: Esta es una característica que le permite almacenar y recuperar documentos JSON en su base de datos utilizando REST. Puede usar SODA for REST para crear colecciones de documentos JSON, insertar, actualizar, eliminar y consultar documentos utilizando métodos HTTP y cargas útiles JSON, y realizar varias operaciones en colecciones y documentos utilizando parámetros de consulta. También puede usar SODA for REST para acceder a las funciones de Oracle Database, como transacciones, control de concurrencia, indexación, etc.
Alternativas a Oracle ORDS
Algunas de las alternativas a ORDS son:
- Oracle Application Express (APEX): Esta es una plataforma de desarrollo de bajo código que le permite construir aplicaciones web basadas en datos utilizando un navegador. APEX incluye un módulo de servicios RESTful que le permite crear y consumir servicios web RESTful para sus objetos de base de datos. APEX también incluye un módulo SQL Workshop que le permite acceder y administrar su base de datos mediante un navegador.
- Oracle Database Gateway para OData: Esta es una función que le permite exponer sus tablas de bases de datos y vistas como servicios web OData (Open Data Protocol). OData es un protocolo estándar para crear y consumir APIs RESTful que soportan operaciones CRUD y opciones de consulta. Puede usar Database Gateway para OData para habilitar o deshabilitar OData para sus tablas y vistas, así como para personalizar los metadatos del servicio web.
Cómo descargar Oracle ORDS 21
Hay dos formas de descargar Oracle ORDS 21: desde el sitio web de Oracle o desde el repositorio yum.
Descarga desde el sitio web de Oracle
Para descargar ORDS desde el sitio web de Oracle, necesita tener una cuenta de Oracle. Si no lo tienes, puedes crear uno gratis siguiendo estos pasos:
- Haga clic en el botón Descargar bajo Oracle REST Data Services.
- Será redirigido a la página de Oracle Software Delivery Cloud.
- Inicie sesión con sus credenciales de cuenta de Oracle.
- Seleccione su plataforma (como Linux x86- 64) y haga clic en Continuar.
- Acepte el acuerdo de licencia y haga clic en Continuar.
- Haga clic en el botón Descargar junto a Oracle REST Data Services 21.1.1.
- Guarde el archivo (ords-21.1.1.zip) en la ubicación deseada.
Descarga de yum Repository
Si está utilizando Oracle Linux, puede descargar ORDS desde el repositorio yum siguiendo estos pasos:
- Habilite el repositorio de Oracle Software Collection Library ejecutando el siguiente comando como root:
yum-config-manager --enable ol7_oracle_software_collections yum install ords - Los archivos ORDS se instalarán en el directorio /usr/share/ords.
Cómo instalar y configurar Oracle ORDS 21
Después de descargar ORDS, necesita instalarlo y configurarlo antes de poder usarlo. El proceso de instalación y configuración depende de si está utilizando un modo de contenedor independiente o J2EE.
Requisitos del sistema
Antes de instalar ORDS, debe asegurarse de que su sistema cumple con los siguientes requisitos:
- Tiene una versión compatible de Oracle Database (11g o posterior) con una licencia válida.
- Tiene una versión Java compatible (8 o posterior) con una licencia válida.
- Tiene un servidor web o servidor de aplicaciones compatibles (como Apache Tomcat, GlassFish o WebLogic) si está utilizando un modo contenedor J2EE.
- Tiene suficiente espacio en disco, memoria y recursos de CPU para la carga de trabajo esperada.
Script de privilegios del instalador
Antes de instalar ORDS, necesita ejecutar un script que otorgue los privilegios necesarios al usuario instalador de ORDS. El script se llama ords_installer_privileges.sql y se encuentra en la carpeta docs del archivo zip ORDS. Puede ejecutar el script siguiendo estos pasos:
- Descomprimir el archivo zip ORDS a una ubicación temporal.
- Conéctese a su base de datos como SYSDBA usando SQL*Plus o SQL Developer.
- Ejecute el script ingresando el siguiente comando:
@ords_installer_privileges.sql - Introduzca un nombre de usuario y contraseña para el usuario del instalador ORDS cuando se le solicite. El nombre de usuario predeterminado es ORDS_PUBLIC_USER.
- El script creará el usuario del instalador ORDS y le otorgará los privilegios necesarios.
Instalación interactiva de interfaz de línea de comandos
Si desea instalar y configurar ORDS utilizando una interfaz de línea de comandos interactiva, puede seguir estos pasos:
- Navega a la carpeta ORDS usando un terminal o un símbolo del sistema.
- Ejecute el siguiente comando:
java -jar ords.war install - El instalador le pedirá varias informaciones, como:
- Los detalles de conexión de la base de datos (host, puerto, nombre de servicio, nombre de usuario, contraseña).
- El esquema de base de datos para almacenar metadatos ORDS (por defecto es ORDS_METADATA).
- El esquema de base de datos para almacenar servicios web RESTful (por defecto es ORDS_PUBLIC_USER).
- La ruta base para acceder a los servicios web RESTful (por defecto es /ords).
- El modo de instalación (autónomo o contenedor J2EE).
- El número de puerto para el modo independiente (por defecto es 8080).
- La ubicación de las imágenes APEX para el modo independiente (opcional).
- El instalador validará sus entradas e instalará y configurará ORDS en consecuencia.
Instalación de interfaz de línea de comandos no interactiva
Si desea instalar y configurar ORDS utilizando una interfaz de línea de comandos no interactiva, puede seguir estos pasos:
- Descomprima el archivo zip ORDS a la ubicación deseada.
- Navega a la carpeta ORDS usando un terminal o un símbolo del sistema.
- Cree un archivo de parámetros que contenga la información para instalar y configurar ORDS. El archivo de parámetros es un archivo de texto que tiene el siguiente formato:
db.hostname=host db.port=port db.servicename=service db.username=username db.password=password user.public.password=password user.tablespace.default=tablespace user.tablespace.temp=tablespace rest.services.ords.add=true rest.services.apex.add=false rest.services.soda.add=true schema.tablespace.default=tablespace schema.tablespace.temp=tablespace standalone.mode=true standalone.http.port=port standalone.static.images=/path/to/images - Guarde el archivo de parámetros como ords_params.properties en la carpeta ORDS.
- Ejecute el siguiente comando:
java -jar ords.war install --parameterFile ords_params.properties - El instalador usará la información del archivo de parámetros e instalará y configurará ORDS en consecuencia.
Cómo usar Oracle ORDS 21
Después de instalar y configurar ORDS, puede comenzar a usarlo para acceder y manipular datos en su base de datos utilizando servicios web RESTful. Estas son algunas de las formas en que puedes usar ORDS:
Implementación de Oracle REST Data Services
Si está utilizando un modo independiente, puede iniciar ORDS ejecutando el siguiente comando desde la carpeta ORDS:
java -jar ords.war Esto iniciará un servidor web Jetty en el número de puerto que especificó durante la instalación. A continuación, puede acceder a ORDS introduciendo la siguiente URL en su navegador:
http://host:port/ords/ Si está utilizando un modo contenedor J2EE, debe implementar el archivo ords.war en su servidor web o servidor de aplicaciones. Los pasos exactos pueden variar dependiendo del servidor que esté utilizando, pero generalmente, necesita copiar el archivo ords.war a la carpeta de aplicaciones web o implementaciones de su servidor y reiniciarlo. A continuación, puede acceder a ORDS introduciendo la siguiente URL en su navegador:
http://host:port/ords/ Creación de servicios web RESTful
Puede usar ORDS para construir servicios web RESTful para sus objetos de base de datos, como tablas, vistas, paquetes, procedimientos, etc. Hay dos maneras de hacer esto: usando Auto REST o usando PL/SQL Gateway.
Usando REST automático
BEGIN ORDS.enable_schema(p_enabled => TRUE); ORDS.enable_object(p_object => 'EMPLOYEES'); END; / Esto creará un servicio web para la tabla EMPLOYEES con la siguiente URL:
http://host:port/ords/schema/employees/ Puede usar métodos HTTP como GET, POST, PUT/PATCH, DELETE para realizar operaciones CRUD en la tabla. Por ejemplo, puede ejecutar el siguiente comando en una terminal o en un símbolo del sistema para recuperar todas las filas de la tabla EMPLOYEES:
curl -X GET http://host:port/ords/schema/employees/ También puede usar parámetros de consulta para filtrar, ordenar, página, expandir, etc. Por ejemplo, puede ejecutar el siguiente comando para recuperar solo el nombre y apellido de los empleados cuyo salario es mayor que 10000 y ordenarlos por apellido en orden descendente:
curl -X GET http://host:port/ords/schema/employees/? q=salary>10000&fields=first_name,last_name&orderby=last_name:desc Uso de PL/SQL Gateway
Esta es una forma más avanzada de crear servicios web para sus objetos de base de datos, como paquetes, procedimientos, funciones, etc. Necesita usar anotaciones o un archivo de configuración para definir los metadatos del servicio web, como la asignación de URL, parámetros, tipo de retorno, etc. También puede utilizar la API ORDS PL/SQL para manipular programáticamente las definiciones de servicios web.
Por ejemplo, puede crear un servicio web para un procedimiento llamado GET_EMPLOYEE que toma un ID de empleado como parámetro de entrada y devuelve los detalles del empleado como parámetro de salida. Puede usar la siguiente anotación en su definición de procedimiento:
-%rest --%description Obtener detalles de los empleados por ID --%endpoint /employees/id -%método GET -%source PROCEDURE get_employee ( p_emp_id IN employees.employee_id%TYPE, p_rec empleados%ROWTYPE ); http://host:port/ords/schema/employees/id Puede usar métodos HTTP como GET para invocar el procedimiento. Por ejemplo, puede ejecutar el siguiente comando en una terminal o en un símbolo del sistema para invocar el procedimiento con un ID de empleado de 100:
curl -X GET http://host:port/ords/schema/employees/100 Usando SQL Developer Web
Puede usar SQL Developer Web para acceder y administrar su base de datos mediante un navegador. Puede usar SQL Developer Web para ejecutar consultas y scripts, crear y alterar objetos de base de datos, crear modelos de datos, acceder a Performance Hub y ver la actividad de la base de datos. También puede usar SQL Developer Web para habilitar y deshabilitar Auto REST para sus tablas y vistas, así como para probar y depurar sus servicios web.
Para acceder a SQL Developer Web, necesita tener una cuenta de Oracle con los privilegios apropiados. Puede crear una cuenta de Oracle utilizando SQL Developer Web o SQL*Plus o SQL Developer. Por ejemplo, puede ejecutar el siguiente comando en SQL*Plus o SQL Developer para crear una cuenta de Oracle llamada scott con la contraseña tiger:
CREATE USER scott IDENTIFIED BY tiger; GRANT CONNECT, RESOURCE TO scott; Una vez que tenga una cuenta de Oracle, puede acceder a SQL Developer Web ingresando la siguiente URL en su navegador:
http://host:port/ords/sql-developer Se le pedirá que introduzca sus credenciales de cuenta de Oracle y luego verá la interfaz web de SQL Developer.
Usando SODA para REST
Para usar SODA for REST, necesita tener una cuenta de Oracle con los privilegios apropiados. Puede crear una cuenta de Oracle utilizando SQL Developer Web o SQL*Plus o SQL Developer. Por ejemplo, puede ejecutar el siguiente comando en SQL*Plus o SQL Developer para crear una cuenta de Oracle llamada soda con la contraseña soda:
CREATE USER soda IDENTIFIED BY soda; GRANT CREATE SESSION TO soda; GRANT SODA_APP TO soda; Una vez que tenga una cuenta de Oracle, puede usar SODA for REST ingresando la siguiente URL en su navegador:
http://host:port/ords/schema/soda/latest/ Se le pedirá que introduzca sus credenciales de cuenta de Oracle y luego verá la interfaz SODA para REST.
Conclusión
En este artículo, le hemos mostrado cómo descargar, instalar, configurar y usar Oracle ORDS 21, la última versión de Oracle REST Data Services. También hemos discutido algunos de los beneficios, características y alternativas de ORDS, así como algunas mejores prácticas y consejos para su uso eficaz.
ORDS es una poderosa herramienta que le permite acceder y manipular datos en su base de datos Oracle utilizando servicios web RESTful. Proporciona una API REST de administración de bases de datos, SQL Developer Web, una puerta de enlace PL/SQL, SODA para REST y la capacidad de publicar servicios web RESTful para interactuar con los datos y los procedimientos almacenados en su base de datos Oracle.
Esperamos que este artículo le haya ayudado a entender cómo usar ORDS y cómo puede mejorar su experiencia de desarrollo y administración de bases de datos. Si tiene alguna pregunta o comentario, no dude en ponerse en contacto con nosotros o dejar un comentario a continuación. Gracias por leer y feliz codificación!
Preguntas frecuentes
Aquí están algunas de las preguntas más frecuentes sobre Oracle ORDS 21:
- Cuáles son las diferencias entre ORDS 21 y versiones anteriores?
Algunas de las diferencias entre ORDS 21 y versiones anteriores son:
- ORDS 21 soporta Java 11 y versiones posteriores.
- ORDS 21 admite el tipo de concesión de credenciales de cliente OAuth2 para proteger los servicios web.
- ORDS 21 soporta JSON Merge Patch para actualizaciones parciales de documentos JSON.
- ORDS 21 admite la especificación OpenAPI 3.0 para documentar servicios web.
- Cómo puedo actualizar a ORDS 21 desde versiones anteriores?
Para actualizar a ORDS 21 de versiones anteriores, debe seguir estos pasos:
- Descargar ORDS 21 desde el sitio web de Oracle o el repositorio yum.
- Detenga su instancia ORDS existente.
- Copia de seguridad de sus archivos de configuración ORDS existentes y esquemas de base de datos.
- Descomprima el archivo zip ORDS 21 a la ubicación deseada.
- Copie sus archivos de configuración ORDS existentes a la carpeta ORDS 21.
- Ejecute el siguiente comando desde la carpeta ORDS 21:
java -jar ords.war validar - Esto validará sus archivos de configuración y esquemas de base de datos y los actualizará si es necesario.
- Inicie su nueva instancia ORDS ejecutando el siguiente comando desde la carpeta ORDS 21:
java -jar ords.war - Si está usando un modo contenedor J2EE, necesita redistribuir el archivo ords.war a su servidor web o servidor de aplicaciones.
- Cómo puedo solucionar problemas de ORDS?
Para solucionar problemas de ORDS, puede usar los siguientes recursos:
- Los archivos de registro ORDS, que se encuentran en la carpeta de registros del directorio de instalación ORDS. Los archivos de registro contienen información sobre las solicitudes, respuestas, errores, advertencias, etc. que ocurren durante la operación ORDS.
- La documentación de ORDS, que está disponible en https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/index.html. La documentación contiene información detallada sobre la instalación, configuración, uso, seguridad, rendimiento, etc. de ORDS.
- Cómo puedo aprender más sobre ORDS?
Para obtener más información sobre ORDS, puede utilizar los siguientes recursos:
- El blog ORDS, que está disponible en https://blogs.oracle.com/ords/. El blog contiene noticias, actualizaciones, consejos, trucos, mejores prácticas, etc. sobre ORDS.
- El canal de YouTube ORDS, que está disponible en https://www.youtube.com/channel/UCr6mzwq_gcdsefQWBI72T9g. El canal contiene vídeos, tutoriales, demos, webinars, etc. sobre ORDS.
- Los cursos de formación ORDS, que están disponibles en https://education.oracle.com/oracle-rest-data-services-ords/courP_00000000000000000000000000000000. Los cursos contienen lecciones en línea, cuestionarios, laboratorios, etc. que le enseñan cómo usar ORDS eficazmente.
- Cómo puedo proporcionar comentarios o sugerencias para ORDS?
Para proporcionar comentarios o sugerencias para ORDS, puede usar los siguientes métodos:
- La página de comentarios de Oracle REST Data Services, que está disponible en https://apex.oracle.com/pls/apex/f?p=55447:1:0::::. La página le permite enviar sus comentarios o sugerencias directamente al equipo de desarrollo de ORDS.
- La página de Oracle REST Data Services Idea Lab, que está disponible en https://community.oracle.com/tech/developers/idea-lab?Id=1128&sort=recent. La página le permite enviar sus ideas para nuevas características o mejoras para ORDS y votar sobre las ideas de otros usuarios.
17b9afdd22