Trabajo con Simple Oracle Document Access (SODA) en una base de datos de IA autónoma
Simple Oracle Document Access (SODA) es un juego de API de estilo NoSQL que le permite utilizar recopilaciones de documentos JSON en Autonomous AI Database, recuperarlos y consultarles, sin necesidad de conocer la lenguaje de consulta estructurado (SQL) o cómo se almacenan los documentos en la base de datos.
Autonomous AI Database permite 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:
Nota: Si utiliza Always Free Autonomous AI Database con Oracle AI Database 26ai, para evitar problemas de compatibilidad de los controladores de SODA, Oracle recomienda utilizar las versiones de controlador necesarias para trabajar con el tipo JSON según se especifica en los controladores de SODA. Consulte Controladores SODA para obtener más información.
Nota
Para los proyectos que se han iniciado utilizando 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, simplemente 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 utilizar SODA para Java, con la versión más reciente. La versión mínima admitida es: 1.1.4. Utilice SODA para Java junto con La base de datos de IA autónoma no admite 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 la base de datos de IA autónoma para obtener más información. |
SODA para Java |
| SODA para REST | Acceso a servicios RESTful y SODA para REST | Uso del SODA para REST con Autonomous AI Database |
| SODA para C | Descargas de Oracle Instant Client Versiones: para SODA para C, las bibliotecas del cliente de Oracle deben ser 19.6 y superiores. Puede obtener Oracle Instant Client de Oracle Instant Client Downloads. |
SODA para C |
| SODA para PL/SQL | No es necesario descargar. Esto se incluye con Autonomous AI Database. | SODA para PL/SQL |
| SODA para Node.js | Varias descargas descritas en las instrucciones de instalación: Instalación de node-oracledb de inicio rápido Versiones: La compatibilidad con 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. |
Requisitos de SODA de Node-oracledb |
| SODA para Python | Varias descargas descritas en las instrucciones de instalación: Versiones: La compatibilidad con 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. |
Introducción a cx_Oracle |
Notas de SODA
Al utilizar SODA con Autonomous AI 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.