Skip to content

Commit 5e31ebb

Browse files
authored
WMS ID: 11382, link-check, console image change & minor updates (#914)
* WMS ID: 11382, Links updated, clarification & minor updates. Signed-off-by: [email protected] * WMS ID: 11382, Added my name & date to last updated. Signed-off-by: [email protected] --------- Signed-off-by: [email protected]
1 parent f0780cc commit 5e31ebb

File tree

5 files changed

+32
-30
lines changed

5 files changed

+32
-30
lines changed

json-mongo-duality-general/duality-views/duality-views.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
Estimated Lab Time: 15 minutes
88

9-
**JSON Duality**
9+
### About JSON Duality
1010

1111
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.
1212

@@ -20,12 +20,16 @@ Key benefits of JSON Relational Duality:
2020

2121
* 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.
2222

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.
2424

2525

2626
### Objectives
2727

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.
2933

3034
### Prerequisites
3135

@@ -502,4 +506,4 @@ You might have noticed that any JSON document in a Duality View carried addition
502506
## Acknowledgements
503507
* **Author** - Hermann Baer
504508
* **Contributors** - Beda Hammerschmidt
505-
* **Last Updated By/Date** - Hermann Baer, April 2025
509+
* **Last Updated By/Date** - Eileen Beck, November 2025

json-mongo-duality-general/introduction/introduction.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,9 @@
22

33
## About this Workshop
44

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.
66

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.
108

119
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!
1210

@@ -69,11 +67,11 @@ In this workshop, you will:
6967
* Work with JSON Collections, a native MongoDB-compatible document storage
7068
* Experience the groundbreaking new functionality of JSON Relational Duality Views, marrying the benefits of relational and JSON
7169
* 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
7371

7472
### Prerequisites
7573

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
7775

7876
**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.
7977

@@ -91,4 +89,4 @@ You may now proceed to the next lab.
9189

9290
* **Author** - Hermann Baer
9391
* **Contributors** - Beda Hammerschmidt
94-
* **Last Updated By/Date** - Hermann Baer, April 2025
92+
* **Last Updated By/Date** - Eileen Beck, November 2025
82.2 KB
Loading

json-mongo-duality-general/json-collections/json-collections.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,11 +43,11 @@ In this lab, you will:
4343

4444
![JSON Create Collection](./images/json-create-collection.png)
4545

46-
5. In the field **Collection Name**, provide the name **movies**. Then click **Create**.
46+
5. In the field **Collection Name**, provide the name **movies**. Leave MongoDB Compatible radio button checked. Then click **Create**.
4747

4848
Note that the collection name is case-sensitive. You must enter products in all lower-case, don't use MOVIES or Movies.
4949

50-
![New Collection: movies](./images/collection-name.png)
50+
![New Collection: movies](./images/collection-name-mongodb-checked.png)
5151

5252
6. A notification pops up that displays **movies** collections has been created.
5353

@@ -352,4 +352,4 @@ You may now proceed to the next lab.
352352
353353
* **Author** - Hermann Baer
354354
* **Contributors** - Beda Hammerschmidt
355-
* **Last Updated By/Date** - Hermann Baer, April 2025
355+
* **Last Updated By/Date** - Eileen Beck, November 2025

json-mongo-duality-general/mongodb-api/mongodb-api.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
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.
66

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.
88

99
Estimated Time: 15 minutes
1010

@@ -99,15 +99,15 @@ Copy **ONE** of the following *curl* commands and paste it to the command or ter
9999
100100
```bash
101101
<copy>
102-
curl https://downloads.mongodb.com/compass/mongosh-2.3.0-darwin-x64.zip -o mongosh.zip
102+
curl https://downloads.mongodb.com/compass/mongosh-2.5.9-darwin-x64.zip -o mongosh.zip
103103
</copy>
104104
```
105105
106106
Download Command Line Database Tools:
107107
108108
```bash
109109
<copy>
110-
curl https://fastdl.mongodb.org/tools/db/mongodb-database-tools-macos-x86_64-100.10.0.zip -o mongodbtools.zip
110+
curl https://fastdl.mongodb.org/tools/db/mongodb-database-tools-macos-x86_64-100.13.0.zip -o mongodbtools.zip
111111
</copy>
112112
```
113113
@@ -117,15 +117,15 @@ Copy **ONE** of the following *curl* commands and paste it to the command or ter
117117
118118
```bash
119119
<copy>
120-
curl https://downloads.mongodb.com/compass/mongosh-2.3.0-darwin-arm64.zip -o mongosh.zip
120+
curl https://downloads.mongodb.com/compass/mongosh-2.5.9-darwin-arm64.zip -o mongosh.zip
121121
</copy>
122122
```
123123
124124
Download Command Line Database Tools:
125125
126126
```bash
127127
<copy>
128-
curl https://fastdl.mongodb.org/tools/db/mongodb-database-tools-macos-arm64-100.10.0.zip -o mongodbtools.zip
128+
curl https://fastdl.mongodb.org/tools/db/mongodb-database-tools-macos-arm64-100.13.0.zip -o mongodbtools.zip
129129
</copy>
130130
```
131131
@@ -135,15 +135,15 @@ Copy **ONE** of the following *curl* commands and paste it to the command or ter
135135
136136
```bash
137137
<copy>
138-
curl https://downloads.mongodb.com/compass/mongosh-2.3.0-win32-x64.zip -o mongosh.zip
138+
curl https://downloads.mongodb.com/compass/mongosh-2.5.9-win32-x64.zip -o mongosh.zip
139139
</copy>
140140
```
141141
142142
Download Command Line Database Tools:
143143
144144
```bash
145145
<copy>
146-
curl https://fastdl.mongodb.org/tools/db/mongodb-database-tools-windows-x86_64-100.10.0.zip -o mongodbtools.zip
146+
curl https://fastdl.mongodb.org/tools/db/mongodb-database-tools-windows-x86_64-100.13.0.zip -o mongodbtools.zip
147147
</copy>
148148
```
149149
@@ -159,7 +159,7 @@ Copy **ONE** of the following *curl* commands and paste it to the command or ter
159159
160160
```bash
161161
<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
163163
</copy>
164164
```
165165
@@ -191,7 +191,7 @@ Mongo Shell is now set up on your PC or Mac.
191191
192192
### 5: Alternatively, you can install MongoDB Compass, the GUI for MongoDB
193193
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.
195195
196196
This step is optional, so it is not described in more detail here, although the installation itself is intuitive and self-describing.
197197
@@ -213,7 +213,7 @@ In this section, you will:
213213
214214
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.
215215
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**:
217217
218218
```
219219
<copy>
@@ -328,7 +328,7 @@ In this section, you will:
328328
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.
329329
330330
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.
332332
333333
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.
334334
@@ -379,15 +379,15 @@ In this section, you will:
379379
```
380380
![Query result for count](./images/mongo-count.png " ")
381381
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."
383383
384384
```
385385
admin> <copy>db.movies.find( {"title": "Zootopia"} )
386386
</copy>
387387
```
388388
![Query result for Zootopia](./images/mongo-zootopia.png " ")
389389
390-
6. Now query for all movies made after 2020.
390+
7. Now query for all movies made after 2020.
391391
392392
```
393393
admin> <copy>db.movies.find ( { "year": {"$gt": 2020} } )
@@ -397,7 +397,7 @@ In this section, you will:
397397
398398
There's only one movie in our library that was released after 2020.
399399
400-
7. You can do the same for your JSON Collection Views, both the read-only View and our Duality Views
400+
8. You can do the same for your JSON Collection Views, both the read-only View and our Duality Views
401401
402402
```
403403
admin> <copy>db.MYVERSION.findOne()
@@ -411,7 +411,7 @@ In this section, you will:
411411
```
412412
![JSON Collection View](./images/mongo-schedulev.png " ")
413413
414-
8. If you happen to have installed Mongo Compass, this is how the Duality View would look like in MongoDB's GUI:
414+
9. If you happen to have installed Mongo Compass, this is how the Duality View would look like in MongoDB's GUI:
415415
416416
![JSON Duality View in Compass](./images/mongo-compass.png " ")
417417
@@ -528,4 +528,4 @@ That was a quick run-through of using JSON Collections with the MongoDB compatib
528528
529529
* **Authors** - Hermann Baer
530530
* **Contributors** - Beda Hammerschmidt
531-
- **Last Updated By/Date** - Hermann Baer, April 2025
531+
- **Last Updated By/Date** - Eileen Beck, November 2025

0 commit comments

Comments
 (0)