Trabalhar com SODA (Simple Oracle Document Access) no Autonomous Database
SODA (Simple Oracle Document Access) é um conjunto de APIs ao estilo NoSQL que permite usar coleções de documentos JSON no Autonomous Database, recuperá-los e consultá-los, sem precisar de conhecimentos em SQL (Structured Query Language) ou em como os documentos são armazenados no banco de dados.
O Autonomous Database suporta o armazenamento e a 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:
Se você estiver usando o Autonomous Database Always Free com o Oracle Database 23ai, para evitar problemas de compatibilidade dos drivers SODA, a Oracle recomenda o seguinte:
-
Use 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. -
Para projetos que foram iniciados usando uma release do banco de dados anterior ao Oracle Database 21c, especifique explicitamente os metadados para a coleta padrão, conforme especificado no exemplo em Drivers SODA. Para projetos que começaram a usar a release 21c ou posterior do Oracle Database, 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 SODA para Java em conjunto com O Autonomous 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 Database para obter mais informações. |
|
|
REST SODA |
||
|
SODA para C |
Downloads do Oracle Instant Client Versões: Para SODA para C, as bibliotecas do Cliente Oracle devem ser da versão 19.6 e posteriores. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client. |
|
|
SODA para PL/SQL |
Não é necessário fazer download. Isso é incluído no Autonomous Database. |
|
|
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 ao 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 deverão ser da versão 19.6 e posterior. 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. O uso da versão mais recente é recomendado, a versão mínima recomendada é 7.1. As bibliotecas do Cliente da Oracle deverão ser da versão 19.6 e posterior. Você pode obter o Oracle Instant Client em Downloads do Oracle Instant Client. |
- Observações do SODA
Quando você usa o SODA com o Autonomous Database, as seguintes restrições se aplicam:
Tópico principal: Usando Documentos JSON com Autonomous Database
Observações do SODA
Quando você usa o SODA com o 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