Trabalhar com SODA (Simple Oracle Document Access) no Autonomous AI Database

O SODA (Simple Oracle Document Access) é um conjunto de APIs no estilo NoSQL que permite usar coleções de documentos JSON no Autonomous AI Database, recuperá-las e consultá-las, sem precisar conhecer a SQL (Structured Query Language) ou como os documentos são armazenados no banco de dados.

O Autonomous AI Database oferece suporte ao armazenamento e consulta de documentos JSON de forma nativa. As coleções de documentos SODA são apoiadas por tabelas e visualizações comuns do banco de dados; você pode aproveitar os recursos do banco de dados para uso com o conteúdo dos documentos SODA.

Os drivers SODA estão disponíveis para várias linguagens e frameworks, incluindo: Java, Node.js, Python, C (usando o Oracle Call Interface), PL/SQL e SODA para REST. O SODA para REST mapeia operações SODA para padrões de URL (Uniform Resource Locator), de modo que possa ser usado com a maioria das linguagens de programação.

Para começar a usar o SODA, consulte o seguinte:

Dependendo da API SODA com a qual você deseja trabalhar, consulte o seguinte:

Observação: Se você estiver usando o Always Free Autonomous AI Database com o Oracle AI Database 26ai, para evitar problemas de compatibilidade de drivers SODA, a Oracle recomenda usar as versões do driver necessárias para trabalhar com o tipo JSON, conforme especificado nos Drivers SODA. Consulte Drivers de SODA para obter mais informações.

Observação

Para projetos que foram iniciados usando uma release de banco de dados anterior ao Oracle Database 21c, especifique explicitamente os metadados da coleta padrão conforme especificado no exemplo em Drivers SODA. Para projetos que começaram a usar a release Oracle Database 21c ou posterior, basta usar os metadados padrão. Consulte Drivers de SODA para obter mais informações.

SODA API Download e Instalação Mais Informações
SODA para Java

Fazer Download do SODA para Java

SODA para Pré-requisitos do Java

Versões: SODA para Java, é recomendável usar a versão mais recente. A versão mínima suportada é: 1.1.4.

Use o SODA para Java em conjunto com o ojdbc8.jar (disponível em Downloads do Oracle AI Database JDBC driver e Jars Companion ou no Maven Central).

O Autonomous AI Database não suporta o Construtor de metadados. Para personalizar metadados de coleta, passe strings de metadados de coleta diretamente para o método createCollection.

Consulte Metadados de Coleta do SOA no Autonomous AI Database para obter mais informações.

SODA para Java
REST SODA Acessar Serviços RESTful e SODA para REST Usar SODA para REST com Autonomous AI Database
SODA para C

Downloads do Oracle Instant Client

Versões: Para SODA para C, as bibliotecas do Oracle Client devem ser da versão 19.6 e posteriores. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client.

SODA para C
SODA para PL/SQL Não é necessário fazer download. Isso está incluído no Autonomous AI Database. SODA para PL/SQL
SODA para Node.js

Vários downloads descritos nas instruções de instalação:

Instalação rápida de node-oracledb

Versões: O suporte SODA foi introduzido na versão 3.0. O uso da versão mais recente é recomendado, a versão mínima recomendada é 4.0.

As bibliotecas do Cliente da Oracle devem ser da versão 19.6 e posterior. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client.

Requisitos SODA do Node-oracledb
SODA para Python

Vários downloads descritos nas instruções de instalação:

Instalação do cx_Oracle 7

Versões: O suporte SODA foi introduzido na versão 7.0. O uso da versão mais recente é recomendado, a versão mínima recomendada é 7.1.

As bibliotecas do Cliente da Oracle devem ser da versão 19.6 e posterior. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client.

Introdução ao cx_Oracle

Observações do SODA

Quando você usa o SODA com o Autonomous AI Database, as seguintes restrições se aplicam:

  • A indexação automática não é compatível com códigos SQL e PL/SQL que usam a função SQL/JSON json_exists. Consulte Condição JSON/SQL JSON_EXISTS para obter mais informações.

  • A indexação automática não é compatível com consulta por exemplo (QBE) SODA