Použití Oracle Database 23ai jako úložiště dokumentů

create table j_purchaseorder (
   id          varchar2(32) not null constraint pk_purchaseorder primary key,
   date_loaded timestamp(6) with time zone,
   po_document json
);

Stůl je přesně „jako každý jiný stůl“. Opravdu nemusíte dělat nic zvláštního. Obsah můžete ověřit pomocí schématu JSON a jakéhokoli dalšího zpracování, které chcete provádět. JavaScript, jak jej poskytuje Multilingual Engine (MLE), je skvělou možností pro práci s JSON.

create or replace json relational duality view emp_dept as
hr.departments {
    _id:    department_id
    name:   department_name
    employees: hr.employees @insert @update @delete [
        {
            id:         employee_id
            firstname:  first_name
            lastname:   last_name
            email
        }
    ]
};

Dualitní pohled JSON relační je přímo aktualizovatelný, což znamená, že můžete přímo vkládat, aktualizovat a odstraňovat dokumenty a dotazovat se na ně (výše uvedený příklad vyžaduje, aby bylo možné zapisovat určité anotace). Dokumenty podporované dualitním zobrazením mají vždy pole identifikátoru dokumentu, _id. Musíte jej zadat při vytváření Duálního zobrazení. Podkladové tabulky lze samozřejmě také aktualizovat – změny v obou směrech se okamžitě projeví ve všech klientech, relačních nebo NoSQL.

SQL> ddl emp_dept

  CREATE OR REPLACE FORCE EDITIONABLE JSON RELATIONAL DUALITY VIEW "EMILY"."EMP_DEPT"  AS 
  hr.departments {
    _id:    department_id
    name:   department_name
    employees: hr.employees @insert @update @delete [
        {
            id:         employee_id
            firstName:  first_name
            lastName:   last_name
            email
        }
    ]
};
SQL> desc emp_dept

Name    Null?    Type    
_______ ________ _______ 
DATA             JSON

K dokumentům JSON v zobrazení přistupujete stejně jako k jakémukoli jinému JSON v Oracle. Používejte funkce SQL/JSON, jednoduchou tečkovou notaci nebo NoSQL API – cokoli, co nejlépe vyhovuje vašim potřebám. Zde je příklad obsahující SQL:

select
   -- pretty print the output using json_serialize( ... pretty)
   json_serialize(dv.data pretty) data
from
    emp_dept dv 
where
    dv.data."_id" = 10;

DATA                                                
___________________________________________________ 
{
  "_id" : 10,
  "_metadata" :
  {
    "etag" : "6DF460935D50048D6DE64A71D015EBFD",
    "asof" : "00000000003324C8"
  },
  "name" : "Administration",
  "employees" :
  [
    {
      "id" : 200,
      "firstName" : "Jennifer",
      "lastName" : "Whalen",
      "email" : "JWHALEN"
    }
  ]
}

Další podrobnosti o JSON Relational Duality View můžete získat ze slovníku:

select
  collection_name,
  collection_type
from
  user_json_collections;

COLLECTION_NAME    COLLECTION_TYPE    
__________________ __________________   
EMP_DEPT           DUALITY VIEW

Mezi další zobrazení slovníku patří:

import { MongoClient } from "mongodb";

/**
 * simple function using the MongoDB API under the covers to create a new
 * collection and insert a document into it.
 */
export async function demo() {

   // use the Mongo DB URI, as per the ADB-S "Tool Configuration",
   // or the output of `ords serve...`. Store the DB_URI in an .env
   // file, and pass this to node using --env-file. Make sure _not_
   // to store the .env file in git!
   const client = new MongoClient(
      process.env.DB_URI, {
         tlsAllowInvalidCertificates: true,
      },
   );
   await client.connect();

   console.log('successfully connected');

   // define which Mongo Database to use
   const db = client.db("EMILY");

   // open/create the (new) collection
   const collection = db.collection("myCollection");

   // this document is based on the Administration department
   // retrieved earlier from the Duality View
   const adminDepartment = {
      name: "Administration",
      employees: [
         {
            id: 200,
            firstName: "Jennifer",
            lastName: "Whalen",
            email: "JWHALEN",
         },
      ],
   };

   // insert the new document
   await collection.insertOne(adminDepartment);

   // close the connection
   await client.close();
}

Pokud bylo nakonfigurováno MongoDB API a vaše schéma je povoleno ORDS (Oracle REST Data Services), můžete tento úryvek JavaScriptu spustit proti Oracle beze změn (kromě URI databáze v případě, že jste použili jiné úložiště dokumentů). Na konci provádění funkce se vytvoří tabulka kolekce JSON:

select
  collection_name,
  collection_type
from
  user_json_collections;

COLLECTION_NAME    COLLECTION_TYPE    
__________________ __________________ 
myCollection       TABLE              
EMP_DEPT           DUALITY VIEW

Skutečnost, že tabulka je základem, myCollectionje z pohledu Mongo DB API irelevantní. Dokument API se zabývá dokumenty, nikoli tabulkami; JSON Collection stůl je pouhé vozidlo.

create json collection view empview as
select
   json {
      '_id'         : employee_id,
      last_name,             
      'contactinfo' : {email, phone_number},
      hire_date,
      salary
   }
from
   hr.employees;

V aktuálním schématu skončíte s neduálním zobrazením kolekce JSON:

COLLECTION_NAME    COLLECTION_TYPE    
__________________ __________________ 
myCollection       TABLE              
EMP_DEPT           DUALITY VIEW       
EMPVIEW            VIEW

Takové zobrazení může být užitečné, pokud chcete externalizovat konkrétní data ze schématu nebo podmnožinu polí z kolekce bez udělení přístupu pro čtení a zápis.