Trabajar con Simple Oracle Document Access (SODA) en Autonomous Database
El acceso simple a documentos de Oracle (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 el almacenamiento y la consulta de documentos de JSON de forma nativa. Las recopilaciones de documentos de SODA están respaldadas por tablas y vistas de base de datos comunes; puede aprovechar las funciones de base de datos para utilizarlas con el contenido de los documentos de SODA.
Los controladores SODA están disponibles para varios lenguajes y marcos: Java, Node.js, Python, C (con Oracle Call Interface), PL/SQL y SODA para REST. SODA para REST asigna operaciones SODA a patrones de localizador uniforme de recursos (URL), por lo que se puede utilizar con la mayoría de lenguajes de programación.
Para empezar a usar 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 21c, para evitar problemas de compatibilidad con los controladores SODA, Oracle recomienda lo siguiente:
-
Utilice las versiones del controlador necesarias para trabajar con el tipo
JSONcomo se especifica en los controladores SODA. Consulte Controladores de SOA para obtener más información. -
Para los proyectos que se hayan iniciado con 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 Controladores de SODA. Para los proyectos iniciados con la versión Oracle Database 21c o posterior, simplemente utilice los metadatos por defecto. Consulte Controladores de SOA para obtener más información.
| SODA API | Descarga e Instalación | Más información |
|---|---|---|
|
SODA para Java |
Versiones: se recomienda el uso de la última versión de SODA para Java. La versión mínima soportada es: 1.1.4. Utilice SODA para Java junto con Autonomous Database no soporta el Creador 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 de la versión 19.6 o superior. Puede obtener Oracle Instant Client en Descargas de Oracle Instant Client. |
|
|
SODA para PL/SQL |
No es necesario descargarlo. 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 incluyó en la versión 3.0. Con la última versión recomendada, la versión mínima recomendada es 4.0. Las bibliotecas de Oracle Client deben ser de la versión 19.6 o superior. Puede obtener Oracle Instant Client en Descargas de Oracle Instant Client. |
|
|
SODA para Python |
Varias descargas descritas en las instrucciones de instalación: Versiones: el soporte de SODA se incluyó en la versión 7.0. Con la última versión recomendada, la versión mínima recomendada es 7.1. Las bibliotecas de Oracle Client deben ser de la versión 19.6 o superior. Puede obtener Oracle Instant Client en Descargas de Oracle Instant Client. |
- Notas de SODA
Al utilizar SODA con Autonomous Database, se aplican las siguientes restricciones:
Tema principal: Uso de documentos JSON con Autonomous Database
Notas sobre 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.