New example JSON

SQL for JSON Collection and JSON Duality View. Updated README to include the JSON sql

Author: malcherm

sql/README.md

@@ -25,7 +25,7 @@ Try out these scripts to learn how to get started using Autonomous Database. Sim
 |[select-ai-nl2sql.sql](select-ai-nl2sql.sql)|Use natural language to query your data|
 |[select-ai-sql-function.sql](select-ai-sql-function.sql)|Use Select AI SQL functions to apply AI to your data. These examples summarize a support chat and make product recommendations based on info in your database|
 |[select-ai-rag.sql](select-ai-rag.sql)|Select AI makes it easy to create AI vector pipelines and then ask questions using AI and your organization's knowledge base|
-
+|[json-duality.sql](json-duality.sql)|Autonomous Database allows you to with JSON in many different ways. JSON Collections stored in the database, and JSON Duality Views are a couple of the examples here.|
 
 ### Configuration file
 Many of the SQL scripts rely on information found in your [config.sql](config.sql) file. Update the config file prior to running any of the scripts. 

sql/json-duality.sql

@@ -0,0 +1,88 @@
+-- Copyright (c) 2024 Oracle and/or its affiliates.
+-- Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+
+/* Apply AI SQL function to your data to summarize information, make recommendations and more */
+
+/* PREREQUISITES
+    Install the sample schema using script
+        @data-create-sample-schema.sql
+*/
+
+/* Working with JSON in Autonomous Database
+We can query relational data as JSON and also create JSON Collection tables. Different ways to work with JSON, 
+flexiblity to work with JSON, and leverage relational tables by using JSON Duality views providing the best of both worlds. 
+Let's look at a couple of ways of creating JSON collection tables, JSON Duality Views and querying JSON data.  
+*/
+-- JSON Collection 
+create JSON COLLECTION TABLE MOVIE_BUDGET;
+
+insert into movie_budget values ('{"movie_id": 1,"movie_title":"Avatar","movie_year": 2009, 
+"sku":"LYG56160","runtime": 162,"cast":["Sam Worthington","Zoe Saldana"],
+"studio":["20th Century Studios","Lightstorm Entertainment"]}' );
+insert into movie_budget values ('{"movie_id": 2,"movie_title":"Ghostbusters II","movie_year": 1989, 
+"sku":"FWT19789","runtime": 104,"cast":["Bill Murray","Sigourney Weaver"],
+"genre":["Fantasy","Sci-Fi","Thriller","Comedy"]}' );
+--see the JSON collection that has been created along with the ability to query it
+select * from movie_budget;
+--Let's add budget information to the movies
+update movie_budget set data= JSON_TRANSFORM(data, set '$.budgetUnit' = 'Million USD', set '$.budget'=1000000);
+select json_value(data, '$.movie_id') movie_id,json_value(data,'$.budget') budget from movie_budget;
+--Change the budget for one of the movies
+update movie_budget set data= JSON_TRANSFORM(data,  set '$.budget'=(json_value(data,'$.budget') * 2))
+where JSON_VALUE(data,'$.movie_id')=2;
+select json_value(data, '$.movie_id') movie_id,json_value(data,'$.budget') budget from movie_budget;
+
+--JSON Duality
+/* We can work with our relational tables as JSON Documents by creating a JSON Duality View. 
+Inserts, updates and deletes can be performed directly against the JSON Duality View and the changes happen on the underlying relational tables. 
+This means that the JSON documents for these views will be updated without having to maintain each document, and the data is stored relationally 
+avoiding duplication. 
+*/
+--Simple JSON view on one table
+
+--We need primary keys on the tables that are part of the views
+CREATE OR REPLACE JSON RELATIONAL DUALITY VIEW customer_dv AS
+customer @insert @update @delete
+{
+    _id             : cust_id,
+    FirstName       : first_name,
+    LastName        : last_name,
+    age             : age,
+    Email           : email,
+    street_address  : street_address,
+    city            : city,
+    postal_code     : postal_code
+    yrs_customer    : yrs_customer
+    pet             : pet
+}
+;
+select * from customer_dv;
+
+--JSON Duality View on a couple of tables. We do need primary keys on the tables being used in the views
+alter table streams add constraint constraint_name primary key(cust_id,day_id, movie_id);
+--JSON of the customers with the movies that they streamed
+CREATE OR REPLACE JSON RELATIONAL DUALITY VIEW customer_streams_dv AS
+customer @insert @update @delete
+{
+    _id             : cust_id,
+    FirstName       : first_name,
+    LastName        : last_name,
+    age             : age,
+    yrs_customer    : yrs_customer
+    streams : streams
+    [{
+        cust_id : cust_id
+        day_id : day_id
+        genre_id : genre_id
+        movie_id : movie_id
+    }]
+}
+;
+select * from customer_streams_dv;
+--Pull back the customers watching romance movies
+select * from customer_streams_dv
+where JSON_VALUE(data,'$.streams.genre_id')=19;
+
+/* With the JSON Collections and JSON Duality Views you can use API calls with GET and PUT to work
+with the JSON in the database. We have just shown here SQL access to the JSON. */
+