Trabalhar com SODA (Simple Oracle Document Access) no Autonomous Database
SODA (Simple Oracle Document Access) é um conjunto de APIs no estilo NoSQL que permite usar coleções de documentos JSON no Autonomous Database, recuperá-los e consultá-los, sem precisar de conhecimento de SQL (Structured Query Language) ou de como os documentos são armazenados no banco de dados.
O Autonomous Database suporta armazenamento e consulta de documentos JSON nativamente. As coleções de documentos SODA são apoiadas por tabelas e views de banco de dados comuns; você pode aproveitar os recursos de 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 for REST. O SODA for REST mapeia operações SODA para padrões de URL, para que possa ser usado com a maioria das linguagens de programação.
Para começar a usar o SODA, consulte:
Dependendo da API do SODA com a qual você deseja trabalhar, consulte as seguintes informações:
Se você estiver usando o Autonomous Database Always Free com o Oracle Database 23ai, para evitar problemas de compatibilidade de drivers SODA, a Oracle recomenda o seguinte:
-
Use as versões de driver necessárias para trabalhar com o tipo
JSON, conforme especificado nos Drivers SODA. Consulte Drivers SODA para obter mais informações. -
Para projetos que foram iniciados usando uma release de banco de dados anterior ao Oracle Database 21c, especifique explicitamente os metadados da coleção padrão conforme especificado no exemplo, em Drivers SODA. Para projetos iniciados usando a release Oracle Database 21c ou mais recente, basta usar os metadados padrão. Consulte SODA Drivers para obter mais informações.
| SODA API | Download e Instalação | Mais Informações |
|---|---|---|
|
SODA para Java |
Fazer Download do SODA para Java Pré-requisitos do SODA para 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 Autonomous Database não suporta o Criador de metadados. Para personalizar metadados de coleção, especifique strings de metadados de coleção diretamente para o método createCollection. Consulte Metadados de Coleção do ODA no Autonomous Database para obter mais informações. |
|
|
SODA para REST |
||
|
SODA para C |
Downloads do Oracle Instant Client Versões: No SODA para C, a versão das bibliotecas do Oracle Cliente devem ser 19.6 e acima. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client. |
|
|
SODA para PL/SQL |
Não é necessário baixar. Ele está incluído no Autonomous Database. |
|
|
SODA para Node.js |
Vários downloads descritos nas instruções de instalação: Instalação do node-oracledb de Início Rápido Versões: O suporte ao SODA foi introduzido na versão 3.0. Recomenda-se o uso da versão mais recente; a versão mínima recomendada é a 4.0. As bibliotecas do Oracle Cliente devem ser a 19.6 e acima. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client. |
|
|
SODA para Python |
Vários downloads descritos nas instruções de instalação: Versões: O suporte ao SODA foi introduzido na versão 7.0. Recomenda-se o uso da versão mais recente; a versão mínima recomendada é a 7.1. As bibliotecas do Oracle Cliente devem ser a 19.6 e acima. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client. |
- Notas do SODA
Quando você usa o SODA com o Autonomous Database, as seguintes restrições se aplicam:
Tópico principal: Usando Documentos JSON com o Autonomous Database
Observações do SODA
Quando você usa SODA com Autonomous 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