Trabajo con Simple Oracle Document Access (SODA) en Autonomous Database
Simple Oracle Document Access (SODA) es un juego de API de estilo NoSQL que le permite utilizar recopilaciones de documentos JSON en Autonomous Database, recuperarlos y consultarlos, sin necesidad de conocer el lenguaje de consulta estructurado (SQL) o cómo se almacenan los documentos en la base de datos.
Autonomous Database soporta almacenar y consultar documentos JSON de forma nativa. Las recopilaciones de documentos de SODA están respaldadas por tablas y vistas de base de datos ordinarias; puede aprovechar las funciones de la base de datos para utilizarlas con el contenido de los documentos de SODA.
Los controladores de SODA están disponibles para varios lenguajes y marcos, incluidos: Java, Node.js, Python, C (con Oracle Call Interface), PL/SQL y SODA para REST. SODA para REST asigna las operaciones de SODA a patrones Uniform Resource Locator (URL), por lo que se puede utilizar con la mayoría de los lenguajes de programación.
Para empezar a utilizar SODA, consulte lo siguiente:
Según la API de SODA con la que desee trabajar, consulte lo siguiente:
Si utiliza Autonomous Database siempre gratis con Oracle Database 23ai, para evitar problemas de compatibilidad de los controladores de SODA, Oracle recomienda lo siguiente:
-
Utilice las versiones de controlador necesarias para trabajar con el tipo
JSONcomo se especifica en los controladores de SODA. Consulte Controladores SODA para obtener más información. -
Para los proyectos que se han iniciado mediante una versión de base de datos anterior a Oracle Database 21c, especifique explícitamente los metadatos para la recopilación por defecto, como se especifica en el ejemplo de los controladores de SODA. Para los proyectos que han comenzado a utilizar la versión Oracle Database 21c o posterior, utilice los metadatos por defecto. Consulte Controladores SODA para obtener más información.
| SODA API | Descarga e Instalación | Más información |
|---|---|---|
|
SODA para Java |
Requisitos previos de SODA para Java Versiones: se recomienda el uso de SODA para Java con la última versión. La versión mínima admitida es: 1.1.4. Utilice SODA para Java junto con Autonomous Database no soporta el generador de metadatos. Para personalizar los metadatos de recopilación, transfiera las cadenas de metadatos de recopilación directamente al método createCollection. Consulte Metadatos de recopilación de SOA en Autonomous Database para obtener más información. |
|
|
SODA para REST |
||
|
SODA para C |
Descargas de Oracle Instant Client Versiones: para SODA para C, las bibliotecas del cliente de Oracle deben ser 19.6 y posteriores. Puede obtener Oracle Instant Client de Oracle Instant Client Downloads. |
|
|
SODA para PL/SQL |
No es necesario descargar. Esto se incluye con Autonomous Database. |
|
|
SODA para Node.js |
Varias descargas descritas en las instrucciones de instalación: Instalación de node-oracledb de inicio rápido Versiones: el soporte de SODA se introdujo en la versión 3.0. Se recomienda usar la última versión, la versión mínima recomendada es 4.0. Las bibliotecas del cliente Oracle deben ser 19.6 y superiores. Puede obtener Oracle Instant Client de Oracle Instant Client Downloads. |
|
|
SODA para Python |
Varias descargas descritas en las instrucciones de instalación: Versiones: el soporte de SODA se introdujo en la versión 7.0. Se recomienda usar la última versión, la versión mínima recomendada es 7.1. Las bibliotecas del cliente Oracle deben ser 19.6 y superiores. Puede obtener Oracle Instant Client de Oracle Instant Client Downloads. |
- Notas de SODA
Al utilizar SODA con Autonomous Database, se aplican las siguientes restricciones:
Tema principal: Uso de documentos de JSON con Autonomous Database
Notas de SODA
Al utilizar SODA con Autonomous Database, se aplican las siguientes restricciones:
-
La indexación automática no está soportada para el código SQL y PL/SQL que utiliza la función SQL/JSON
json_exists. Consulte la sección sobre la condición SQL/JSON JSON_EXISTS para obtener más información. -
La indexación automática no está soportada para la consulta mediante ejemplo (QBE) de SODA.