You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: json-mongo-duality-general/duality-views/duality-views.md
+8-4Lines changed: 8 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@
6
6
7
7
Estimated Lab Time: 15 minutes
8
8
9
-
**JSON Duality**
9
+
### About JSON Duality
10
10
11
11
JSON Relational Duality is a landmark capability in Oracle AI Database, providing game-changing flexibility and simplicity for Oracle AI Database developers. This feature overcomes the historical challenges developers have faced when building applications using the relational or document models.
12
12
@@ -20,12 +20,16 @@ Key benefits of JSON Relational Duality:
20
20
21
21
* Enable flexibility and simplicity in building multiple apps on the same set of data. You can use the power of Duality View to define multiple JSON Views across overlapping groups of tables. This flexible data modeling makes building multiple apps against the same data easy and efficient.
22
22
23
-
* Duality Views eliminate the inherent problem of data duplication and data inconsistency in document databases. Duality Views are fully ACID (atomicity, consistency, isolation, durability) transactions across multiple documents and tables. They eliminate data duplication across documents, whereas consistency is maintained automatically.
23
+
* Duality Views eliminate the inherent problem of data duplication and data inconsistency in document databases. Duality Views ensure fully ACID-compliant (atomic, consistent, isolated, and durable) transactions across multiple documents and tables, automatically maintaining data consistency and removing the need for duplicate data.
24
24
25
25
26
26
### Objectives
27
27
28
-
This lab aims to provide hands-on experience with JSON-relational Duality Views, demonstrating how to get the strengths of both JSON and relational data models. You will learn how to create, query, and update JSON-relational Duality Views using SQL and REST.
28
+
This lab aims to provide hands-on experience with JSON-relational Duality Views, demonstrating how to get the strengths of both JSON and relational data models.
29
+
In this lab, you will:
30
+
* Create tables with SQL and install a relational model
31
+
* Create a JSON Duality view on the previously created relational tables
32
+
* Realize benefits of JSON Duality Views through centralized storage, automatic data consistency, and schema flexibility.
29
33
30
34
### Prerequisites
31
35
@@ -502,4 +506,4 @@ You might have noticed that any JSON document in a Duality View carried addition
502
506
## Acknowledgements
503
507
* **Author** - Hermann Baer
504
508
* **Contributors** - Beda Hammerschmidt
505
-
* **Last Updated By/Date** - Hermann Baer, April 2025
509
+
* **Last Updated By/Date** - Eileen Beck, November 2025
Copy file name to clipboardExpand all lines: json-mongo-duality-general/introduction/introduction.md
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,9 @@
2
2
3
3
## About this Workshop
4
4
5
-
In this workshop, you will experience Oracle's JSON capabilities using both relational and document-store APIs. You will be learn all variants of how to leverage JSON in the Oracle AI Database, starting from the native JSON datatype over JSON Collections and JSON Duality Views - the latest groundbreaking JSON-related functionality, to the Oracle AI Database API for MongoDB that provides full MongoDB compatibility in a plug-and-play fashion
5
+
In this workshop, you will experience Oracle's JSON capabilities using both relational and document-store APIs. You will be learn all variants of how to leverage JSON in the Oracle AI Database, starting from the native JSON datatype over JSON Collections and JSON Duality Views - the latest groundbreaking JSON-related functionality, to the Oracle AI Database API for MongoDB that provides full MongoDB compatibility in a plug-and-play fashion.
6
6
7
-
This lab is organized into different topics, each topic consists of multiple steps. After completing this workshop a user has a very good understanding of what JSON features are available in Oracle AI Database and when to use them. You will work against the same data using both with SQL and using the MongoDB API and will experience yourself why Oracle AI Database is better suited for JSON Development than Mongo database.
8
-
9
-
### Objective
7
+
This lab is organized into different topics, each topic consists of multiple steps. This workshop highlights available JSON features in the Oracle AI Database and when to use them. You will work against the same data using both SQL and the MongoDB API and will experience why Oracle AI Database is better suited for JSON Development than Mongo database.
10
8
11
9
This workshop is not a 'cookbook' or 'design guideline' on how to work with JSON data - the purpose is to illustrate various JSON features that the Oracle AI Database offers. That said, you likely find that many examples are applicable to your business needs!
12
10
@@ -69,11 +67,11 @@ In this workshop, you will:
69
67
* Work with JSON Collections, a native MongoDB-compatible document storage
70
68
* Experience the groundbreaking new functionality of JSON Relational Duality Views, marrying the benefits of relational and JSON
71
69
* Use the MongoDB API to query or manipulate JSON Collections and Duality Views in the Oracle AI Database
72
-
* Use SQL interchangeably to MongoDB API to query, generate and process JSON data
70
+
* Use SQL interchangeably with MongoDB API to query, generate and process JSON data
73
71
74
72
### Prerequisites
75
73
76
-
- Autonomous AI Database, free or paid
74
+
- Autonomous AI Database, within your free or paid tenancy, or Autonomous AI Database created within LiveLab Sandbox
77
75
78
76
**Please Note:**: While this workshop is using Autonomous AI Database, all commands and features related to JSON enhancement are also available on any other Oracle AI Database (Version 23.4 or higher) release. This includes the Oracle AI Database Free release as well as 26ai running on Oracle AI Database Base Service or Oracle Engineered Systems.
79
77
@@ -91,4 +89,4 @@ You may now proceed to the next lab.
91
89
92
90
***Author** - Hermann Baer
93
91
***Contributors** - Beda Hammerschmidt
94
-
***Last Updated By/Date** - Hermann Baer, April 2025
92
+
***Last Updated By/Date** - Eileen Beck, November 2025
Copy file name to clipboardExpand all lines: json-mongo-duality-general/mongodb-api/mongodb-api.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
5
5
JSON collections - JSON Collection Tables and JSON Collection Views like Duality Views - store JSON documents alongside some metadata , making them fully MongoDB compatible out-of-the box. Through the MongoDB API, part of Oracle REST Data Services (ORDS), you can use any MongoDB tool, utility, or SDK to work with these collections.
6
6
7
-
We'll then install MongoDB Shell and Command Line Database Tools to enable Mongo APIs. These will interact with our JSON collection.
7
+
This lab walks you through the steps to install MongoDB Shell and Command Line Database Tools to interaction with our JSON collection through the MongoDB API.
8
8
9
9
Estimated Time: 15 minutes
10
10
@@ -99,15 +99,15 @@ Copy **ONE** of the following *curl* commands and paste it to the command or ter
@@ -159,7 +159,7 @@ Copy **ONE** of the following *curl* commands and paste it to the command or ter
159
159
160
160
```bash
161
161
<copy>
162
-
mkdir -p mongodbtools | tar -xvf mongodbtools.zip -C mongosh --strip-components=1
162
+
mkdir -p mongodbtools | tar -xvf mongodbtools.zip -C mongodbtools --strip-components=1
163
163
</copy>
164
164
```
165
165
@@ -191,7 +191,7 @@ Mongo Shell is now set up on your PC or Mac.
191
191
192
192
### 5: Alternatively, you can install MongoDB Compass, the GUI for MongoDB
193
193
194
-
1. Identify the appropriate MongoDB Compass download for your local machine on https://www.mongodb.com/try/download/compass, download and install it. MongoDB Compass offers you both a graphical user interface, as well as a built-in MongoDB shell.
194
+
1. Identify the appropriate MongoDB Compass download for your local machine on https://www.mongodb.com/docs/compass/install/?operating-system=linux&package-type=.deb#std-label-download-install, download and install it. MongoDB Compass offers you both a graphical user interface, as well as a built-in MongoDB shell.
195
195
196
196
This step is optional, so it is not described in more detail here, although the installation itself is intuitive and self-describing.
197
197
@@ -213,7 +213,7 @@ In this section, you will:
213
213
214
214
Oracle allows you to define read-only JSON Collection Views. JSON Collection Views can become arbitrarily complex, and the only requirement is to have a single-column SELECT list, returning a JSON Object. The common use case is to expose some relational reference data to the MongoDB tool that is a shared enterprise-wide.
215
215
216
-
We are quickly creating such a JSON Collection View on a V$ View using **SQL worksheet in Database Actions or your preferred SQL client tool**:
216
+
We can quickly create such a JSON Collection View on a V$ View using **SQL worksheet in Database Actions or your preferred SQL client tool**:
217
217
218
218
```
219
219
<copy>
@@ -328,7 +328,7 @@ In this section, you will:
328
328
Please check [this link](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/mongo-using-oracle-database-api-mongodb.html#GUID-44088366-81BF-4090-A5CF-09E56BB2ACAB) to learn more about Using MongoDB API in the Oracle AI Database.
329
329
330
330
331
-
2. Let's use the first MongoDB utility - mongoimport - to populate our database with data exported from a MongoDB in ndjson format. You will use a document from Object Storage to seed the data in your **movie** collection.
331
+
2. Let's use the first MongoDB utility - mongoimport - to populate our database with data exported from a MongoDB in ndjson (newline delimited JSON) format. You will use a document from Object Storage to seed the data in your **movie** collection.
332
332
333
333
On Linux and Mac systems, issue the following command in your shell to use mongoimport and your URI the environment variable. If you closed the shell, you need to set the URI variable again or specify the connect string directly in the command.
334
334
@@ -379,15 +379,15 @@ In this section, you will:
379
379
```
380
380

381
381
382
-
5. You can also query for specific documents. Run this query to find the document with title "Zootopia."
382
+
6. You can also query for specific documents. Run this query to find the document with title "Zootopia."
0 commit comments