Usar Documentos JSON com o Autonomous Database on Dedicated Exadata Infrastructure

O Autonomous Database on Dedicated Exadata Infrastructure oferece suporte a dados JSON (JavaScript Object Notation) nativamente com recursos de banco de dados relacional, incluindo transações, indexação, consulta declarativa e views. Em Autonomous Databases, documentos JSON podem coexistir com dados relacionais.

Diferentemente dos dados relacionais, os dados JSON podem ser armazenados no banco de dados, indexados e consultados sem a necessidade de um esquema que defina os dados. Em geral, você poderá executar as seguintes tarefas ao trabalhar com dados JSON no Autonomous Database:
  1. Criar uma coluna JSON com uma restrição de verificação is json format oson
  2. Inserir dados JSON na coluna e
  3. Consultar os dados JSON
Consulte Trabalhar com Documentos JSON no Autonomous Database no Oracle Database 19c JSON Developer's Guide ou Oracle Database 23ai JSON Developer's Guide para obter instruções detalhadas com exemplos de código.

Observação:

Se você usa o SODA para acessar coleções no Oracle Database 19c, a Oracle recomenda que você use o cliente instantâneo para o Oracle Database 21c ou mais recente, a fim de facilitar a migração para o uso do tipo de dados JSON quando seu banco de dados for atualizado para a release 21 ou mais recente.

APIs SQL e PL/SQL

Ao usar um Autonomous Database para armazenar dados JSON, você pode aproveitar todos os recursos disponíveis no seu Autonomous Database. Você pode combinar seus dados JSON com dados não JSON. Você pode acessar dados JSON armazenados no banco de dados da mesma forma que acessa outros dados do banco de dados, incluindo o uso do Oracle Call Interface (OCI), Microsoft .Framework NET e Conectividade de Banco de Dados Java (JDBC). Consulte JSON no Oracle Database 19c ou Oracle Database 23ai para saber como usar APIs SQL e PL/SQL para trabalhar com documentos JSON.

Suporte à API da Oracle para MongoDB

A API do Oracle Database para MongoDB converte o protocolo de conexão MongoDB em instruções SQL executadas pelo Oracle Database. Ele permite que os desenvolvedores que têm conjuntos de habilidades MongoDB gravem aplicativos de armazenamento de documentos JSON para o Oracle Database que usam drivers e ferramentas que entendem o protocolo MongoDB. Consulte Visão Geral da API do Oracle Database para MongoDB no Oracle Database API for MongoDB para obter uma visão geral detalhada dessa API.

Consulte Usar API MongoDB com o Oracle Autonomous Database para obter instruções sobre como ativar e usar a API MongoDB com o Autonomous Database.

Simple Oracle Document Access (SODA)

A Oracle também fornece uma família de APIs SOADA (Simple Oracle Document Access) para acesso aos dados JSON armazenados no banco de dados. O SODA é projetado para desenvolvimento de aplicativos sem esquema, sem conhecimento de recursos ou linguagens de banco de dados relacional, como SQL e PL/SQL. Ele permite criar e armazenar coleções de documentos no Oracle Database, recuperá-los e consultá-los, sem a necessidade de saber como os documentos são armazenados no banco de dados. Para obter mais informações sobre o SODA, consulte Oracle as a Document Store e Visão Geral do SODA.

Há várias implementações do SODA:
  • SODA para REST: As solicitações de transferência de estado representacional (REST) executam operações de coleta e documento, usando qualquer linguagem capaz de fazer chamadas HTTP.
  • SODA para Java: As classes e interfaces Java representam bancos de dados, coleções e documentos.
  • SODA para PL/SQL: Os tipos de objeto PL/SQL representam coleções e documentos.
  • SODA para C: Os identificadores do Oracle Call Interface (OCI) representam coleções e documentos.
  • SODA para Node.js: As APIs SODA de estilo NoSQL são usadas para inserir, consultar e recuperar documentos SODA. Objetos como SodaDatabase, SodaCollection, SodaDocument, SodaDocumentCursor e SodaOperation representam os bancos de dados, coleções, documentos, cursor de documento e operações de leitura e gravação, respectivamente.
  • SODA para Python: Os métodos cx_Oracle de estilo NoSQL são usados para inserir, consultar e recuperar documentos SODA. Objetos como SodaDatabase, SodaCollection, SodaDocument, SodaDocumentCursor e SodaOperation representam os bancos de dados, coleções, documentos, cursor de documento e operações de leitura e gravação, respectivamente.
Você pode fazer download dos drivers SODA na página Detalhes de um Autonomous Database.
  • Vá para a página Detalhes do Autonomous Database. Consulte Exibir Detalhes de um Autonomous Database Dedicado.
  • Abra a guia Ferramentas.
  • Localize o mosaico Drivers SODA e clique em Download de Drivers SODA.
  • Faça download dos drivers SODA de sua escolha na lista de drivers exibida.

Metadados de Coleta SODA

Uma coleção SODA é um conjunto de documentos com o apoio de uma tabela ou view do Autonomous Database. Por padrão, a criação de uma coleção de documentos SODA cria o seguinte no Oracle Database:
  • metadados de coleta padrão persistente.
  • Uma tabela para armazenar a coleção no esquema de banco de dados ao qual o seu cliente SODA está conectado.
Você pode personalizar metadados de coleta para obter um comportamento diferente dos fornecidos por padrão. Os únicos metadados que você pode personalizar no Autonomous Database são o método de geração de chave de documento e o tipo de mídia de conteúdo. Especificamente, você não pode alterar o tipo de dados SQL da coluna usada para armazenar conteúdo JSON (a coluna de conteúdo). Consulte Metadados de Coleta SOA no Autonomous Database para saber como usar os metadados de coleta padrão e personalizados.

Limitações no Uso de SODA e JSON

O Autonomous Database suporta SODA e JSON, com as seguintes restrições:
  • 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 SQL/JSON JSON_EXISTS no Oracle Database 19c ou no Oracle Database 23ai para obter mais informações.
  • A indexação automática não é compatível com consulta por exemplo (QBE) SODA