new Set up live data sharing between Oracle Databases using Database …

…Actions workshop (#343)

* Update create-share-recipients.md

* Update create-share-recipients.md

* Update create-share-recipients.md

* Update create-share-recipients.md

* Update create-share-recipients.md

* Update create-share-recipients.md

* updates

* Update manifest.json

* folder rename

* added content to data studio folder

* Delete user-bucket-credential-diagram.png

* updates self-qa

* Update introduction.md

* remove extra text files

* Update introduction.md

* Update setup-workshop-environment.md

* Data Studio Workshop Changes

* changes to data studio workshop

* Update setup-workshop-environment.md

* adb changes

* Update recipient-diagram.png

* diagram change

* Update user-bucket-credential-diagram.png

* SME feedback

* Update create-share.md

* Nilay changes

* changes

* Update consume-share.md

* Anoosha's feedback

* Update consume-share.md

* updated 2 screens and a sentence

* minor changes

* deleted extra images and added doc references

* new ECPU changes

* more changes to data sharing workshops

* more changes to fork (data studio)

* more changes

* Marty's feedback

* Marty's feedback to plsql workshop too

* Update setup-workshop-environment.md

* Delete 7381.png

* workshop # 3 ADB set up

and a couple of minor typos in workshops 1 and 2

* changes to adb-dcat workshop

* more changes

* minor typos in all 4 workshops

* quarterly qa build data lake

* new lab 11 in build DL with ADW

* minor changes database actions drop-down list

* final changes to build data lake workshop

* AI updates

AI workshop updates

* ai workshop updates

* Update query-using-select-ai.md

* Update query-using-select-ai.md

* updates

* more updates

* Update query-using-select-ai.md

* more new updates to ai workshop

* Update query-using-select-ai.md

* a new screen capture

* push Marty's feedback to fork

Final changes.

* updates sandbox manifest

* updates

* restored sandbox manifest

* Update setup-environment.md

* updates after CloudWorld

* final updates to ai workshop (also new labs 4 and 5)

* marty's feedback

* incorporated feedback

* minor PR edits by Sarah

* removed steps 7 & 8 Lab 2 > Task 3 per Alexey

The customer asked to remove this as it's not a requirement for the bucket to be public.

* more changes

* more changes per Alexey

* Update load-os-data-public.md

* Quarterly QA

I added a new step per the PM's request in the Data Sharing PL/SQL workshop. I also made a minor edit (removed space) in the Data Lake workshop.

* more updates

* Quarterly QA changes

* Update consume-share.md

* minor edit based on workshop user

* quarterly qa November 2023

* Added new videos to the workshop

Replaced 3 old silent videos with new ones. Added two new videos.

* Adding important notes to the two data sharing workshops

Per the PM's request.

* folder structure only  push to production

This push and the PR later is to make sure the folder structure is in the production repo before I start development. Only 1 .md file and the workshops folder.

* typos

* cloud links workshop

* UPDATES

* Update query-view.png

* update

* minor updates to chat ai workshop (Fork)

* test clones

* test pr

* Alexey's feedback

* Update data-sharing-diagram.png

* sarah's edits

* changes to Data Load UI

* removed script causing ML issue

* Update load-local-data.md

* updates: deprecated procedure and new code

* updates and test

* more updates

* minor update

* testing using a building block in a workshop

* updates

* building blocks debugging

* Update manifest.json

* fixing issues

* Update manifest.json

* delete cleanup.md from workshop folder (use common file)

* use common cleanup.md instead of local cleanup.md

* test common tasks

* update data sharing data studio workshop

* Update create-recipient.png

* PM's 1 feedback

* quarterly qa

* missing "Lab 2" from Manifest

* always free note addition

added a note

* always free change

* Update setup-environment.md

* update manage and monitor workshop

* Folder structure for new data share workshop (plus introduction.md)

* Updated Load and Analyze from clone

* Data Lake minor changes from clone

* manage and monitor workshop

* Remove the lab from the workshop per Marty's request

* mark-hornick-feedback

* used marty's setup file

* replaced notebook with a new one

* updates to lab 6 of manage and monitor

* Update adb-auto-scaling.md

* Nilay's feedback

* Update adb-auto-scaling.md

* updates to second ai workshop

* note change

* Changes to Load and Analyze workshop (other minor changes too)

* quarterly qa

* Update diagrams per Alexey (remove delta share icon)

* updated the 15-minutes workshop

* Update analyzing-movie-sales-data.md

* ords updates and misc

* updated data studio workshop

* ORDS and Misc updates

* updated freetier version

* updated livelabs version

* updating the manage and monitor workshop

* more updates

* lab 11 updates

* updated lab 14

* updated freetier

* more updates

* Update adw-connection-wallet.md

* update

* Create purge-scn.png

* livelabs updates

* Update adb-flashback.md

* final updates

* updated screens Ramona's review

* Update click-add-peer-database-second-time.png

* update the adb-dcat workshop

1. New ord 24.1.0 launchpad.
2. New navigation path to create dynamic groups
3. Updated OML UI

* Update see-clone-information-in-details-page-2.png

* Requested changes to the Data Lake workshop

* more updates

* updates to Data Lake workshop

* kscope24 workshop for Alexey

* new lab & other updates

* Update load-os-data-private.md

* Update load-os-data-private.md

* more updates, new lab

* minor update example 2

* Update load-os-data-private.md

* Chat AI workshop changes

* new notebook

* more updates

* minor updates

* New Iceberg Lab

added to the freetier and livelabs workshops

* Update manifest.json

* Update query-iceberg-tables.md

* new livelabs folder to request green button

* folder structure for two more data sharing workshops - green button

* 3rd workshop

* NEW LIVE DATA SHARE WORKSHOP

* Anne's feedback

* update

* Update introduction.md

---------

Co-authored-by: Michelle Malcher <[email protected]>
Co-authored-by: Sarah Hirschfeld <[email protected]>

shared/adw-data-lake/setup-live-data-sharing-db-actions/consume-share/consume-share.md

@@ -0,0 +1,125 @@
+# Consume the Data Share by the Recipient
+
+## Introduction
+
+In this lab you will learn how to consume the data in your available data share as a recipient.
+
+Estimated Time: 10 minutes
+
+### Objectives
+
+In this lab, you will:
+
+* Subscribe to the data share provider.
+* Access the data in your authorized data share.
+
+### Prerequisites
+
+* This lab assumes that you have successfully completed all of the preceding labs in the **Contents** menu on the left.
+
+Live data shared with you through data sharing is not automatically available for consumption. To consume data shares, you as a recipient need to subscribe to them and create views of the tables included in the live share. This enables the recipient to consume live data from the database.
+
+## Task 1: Log in as the share_consumer User
+
+1. Log in as the **`share_consumer`** user. On the **Sign-in** page, enter **`share_consumer`** as the username and **`TrainingADW`** as the password, and then click **Sign in**.
+
+2. On the **Database Actions Launchpad** page, click the **Data Studio** tab, and then click the **Data Share** tab.
+
+    ![click the data share tile.](images/click-data-share.png)
+
+    The **Provider and Consumer** Home page is displayed.
+
+    ![The Provider and Consumer page is displayed.](images/provider-consumer-page.png)
+
+## Task 2: Subscribe to Share Provider
+
+1. On the **Provider and Consumer** page, click the **CONSUME SHARE** tile to display the **Consume Share** page.
+
+    ![click the consume share tile.](images/click-consume-share.png)
+
+2. Click the **+ Subscribe to Share Provider** drop-down list, and then click the **Subscribe to Live Share Provider** option.
+
+    ![click Subscribe to Share Provider.](images/click-subscribe-provider.png)
+
+    The **Subscribe to Share Provider** wizard is displayed.
+
+    >**Note:** The **Available Live Share Providers in the last 7 Days** section displays the list of available Live Share Providers in the last 7 days. You can click the **+** sign to subscribe to a Live Share.
+
+3. On the **Provider Settings** page 1 of the wizard, provide the following information:
+
+    * **Share Source:** Accept the default **Select from Live Share Providers** option.
+    * **Share Provider:** Select the **`training-share`** from the drop-down list.
+
+        ![Complete share panel.](images/completed-share-panel.png)
+
+4. Click **Next**.
+
+5. On the **Add Shares** wizard page, click the **TRAINING_SHARE** in the **Available Shares** section, and then click the **Select** (>) icon.
+
+    ![Add shares page.](images/wizard-add-shares.png)
+
+    The share is added to the **Selected Shares** section. Click **Subscribe**.
+
+    ![Click subscribe to selected share.](images/click-subscribe.png)
+
+    A **`CUSTOMER_CONTACT_SHARE` share provider was created successfully**  informational message is displayed. You are directed to the **Link Data** page with the **Share** tab selected. The **`share_consumer`** user now has access to the **`training_share`** data share that was created by the **`share_provider`** user. Drill-down on **`training_share`** to see the **`CUSTOMER_CONTACT`** table in this share.
+
+    >**Note:** You might need to click the drop-down list and select the **`TRAINING_SHARE`**, if needed and/or click the **Refresh** icon to display the **`TRAINING_SHARE`** and the **`CUSTOMER_CONTACT`** shared table.
+
+    ![The Link Cloud Object page is displayed.](images/link-data-page.png)
+
+## Task 3: Create a View over the Shared Table
+
+In this task, you create a view based on the **`CUSTOMER_CONTACT`** table that was included in the live data share. A view is a logical table based on one or more tables or views. A view contains no data itself. The tables upon which a view is based are called base tables.
+
+1. Click the drop-down list and select the **`TRAINING_SHARE`**, if needed. You might need to click the **Refresh** icon to display the **`TRAINING_SHARE`**. Drill-down on the **`TRAINING_SHARE`** data share node to display the objects in it. Drag and drop the **`CUSTOMER_CONTACT`** shared table to add it to the data link job.
+
+    ![Drag and drop the shared table onto the canvas.](images/drag-and-drop-share.png)
+
+2. The shared table is added to the data link job. When you run this job, a new **`CUSTOMER_CONTACT`** view will be created on top of the **`CUSTOMER_CONTACT`** table that was shared with you. Before you create the view, change its name from **`CUSTOMER_CONTACT`** to **`CUSTOMER_CONTACT_SHARE`**. Click the **Settings** icon (pencil).
+
+    ![The Link Cloud Object page is displayed.](images/shared-table-added.png)
+
+3. In the **Link Data from Cloud Store Location SHARE_PROVIDER.CUSTOMER\_CONTACT** dialog box, change the name of the view that will be generated to **`CUSTOMER_CONTACT_SHARE`**, and then click **Close**.
+
+    ![Change the table name.](images/change-table-name.png)
+
+    The **Link Data** page is re-displayed.
+
+    ![The changed table name is displayed.](images/table-name-changed.png)
+
+4. Click **Start**. A **Start Link from Cloud Store** dialog box is displayed. Click **Run**. When the job completes successfully, a link icon is displayed. The **`CUSTOMER_CONTACT_SHARE`** view is created.
+
+    ![The link job is completed.](images/link-job-complete.png)
+
+5. Let's query the newly created view. Click **Query**. You can also use the SQL Worksheet. An informational box is displayed. Close it.
+
+6. Click **Run**. The query result is displayed in the **Query Result** tab.
+
+    ![Query table share.](images/query-customer-share.png)
+
+7. To return to the data load dashboard, in the navigator pane on the left, drill down on **Data Load**, and then click **Home**.
+
+You may now proceed to the next lab.
+
+## Learn More
+
+* [The Share Tool](https://docs.oracle.com/en/cloud/paas/autonomous-database/adbsa/adp-data-share-tool.html#GUID-7EECE78B-336D-4853-BFC3-E78A7B8398DB)
+* [Oracle Cloud Infrastructure Documentation](https://docs.cloud.oracle.com/en-us/iaas/Content/GSG/Concepts/baremetalintro.htm)
+* [Using Oracle Autonomous Database Serverless](https://docs.oracle.com/en/cloud/paas/autonomous-database/adbsa/index.html)
+
+## Acknowledgements
+
+* **Author:** Lauran K. Serhal, Consulting User Assistance Developer
+* **Contributor:** Alexey Filanovskiy, Senior Principal Product Manager
+* **Last Updated By/Date:** Lauran K. Serhal, July 2024
+
+Data about movies in this workshop were sourced from Wikipedia.
+
+Copyright (C) 2024, Oracle Corporation.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3
+or any later version published by the Free Software Foundation;
+with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+A copy of the license is included in the section entitled [GNU Free Documentation License](files/gnu-free-documentation-license.txt)

shared/adw-data-lake/setup-live-data-sharing-db-actions/create-share/create-share.md

@@ -0,0 +1,147 @@
+# Create, Populate, and Publish a Data Share
+
+## Introduction
+
+A data share is a named entity in the provider’s instance. It can be a group of datasets shared as a single entity. The share is the logical container that contains objects such as tables that you will share with recipients. An authorized data share recipient can  access the share and all the tables in it.
+
+In this lab, as a share provider user, you will create a data share and add a table to it. Next, you will create a new recipient that will have access to this data share.
+
+Estimated Time: 15 minutes
+
+### Objectives
+
+In this lab, you will:
+
+* Create a provider id that enables recipients to identify you.
+* Create a new data share as the **`share_provider`** user.
+* Add the **`customer_contact`** table from the previous lab to the data share.
+* Create a new data share recipient named **`training_recipient`**.
+* Publish the data share to make it available to authorized recipients.
+
+### Prerequisites
+
+* This lab assumes that you have successfully completed all of the preceding labs in the **Contents** menu on the left.
+
+## Task 1: Create a Provider ID
+
+In this task, you will create a Provider ID. This provides information to the recipient on how to identify you.
+
+The **Provider and Consumer** page is displayed. The **PROVIDE SHARE** and the **CONSUME SHARE** tools enable you to create a data share as a share provider and to subscribe and consume a data share as a recipient respectively. You can click the [Quick Start Guide](https://docs.oracle.com/en/database/oracle/sql-developer-web/sdwfd/index.html) button to view step by step instructions on how to use Oracle Autonomous Database as a data share provider and as a data share recipient. For the complete Data Share documentation, see [The Data Share Tool](https://docs.oracle.com/en/cloud/paas/autonomous-database/adbsa/adp-data-share-tool.html#GUID-7EECE78B-336D-4853-BFC3-E78A7B8398DB). You can also try one of the available Data Sharing LiveLabs workshops.
+
+1. Make sure you are still logged in as the **share_provider** user. In the navigation pane on the left, drill-down on **Data Share** if needed, and then click **Provide Share**.
+
+   ![Click Provide Share.](./images/click-provide-share.png " ")
+
+    _**Important:**_    
+    _If you are using an **Always Free** ADB instance, you must run the following script in your SQL Worksheet as the **`share_provider`** user <u>before</u> you proceed with **step 2** below:_
+
+    ```
+    <copy>
+    BEGIN
+        DBMS_SHARE.UPDATE_DEFAULT_SHARE_PROPERTY('job_type', 'DBMS_CLOUD');
+    END;
+    /
+    </copy>
+    ```
+
+2. As the **`share_provider`** user, create a new data share named **`training_share`**. On the **Provide Share** page, you must provide the details of the provider before you share the data. The share provider identification will be available to recipients with whom you grant the share. click **Provider Identification** to create a Provider ID to provide information to the recipient on how to identify you.
+
+    ![Click provider information.](./images/click-provider-identification.png " ")
+
+    The **Provider Identification** panel is displayed.
+
+3. In the **General** tab, specify the following:
+
+    * **Name:** Enter **`training_share`**.
+    * **Email:** Enter the email address for the provider such as **`[email protected]`**.
+    * **Description:** Enter a meaningful description of the provider (required).
+
+        ![The General tab.](./images/general-tab.png " ")
+
+4. Click **Save**. The **Provide Share** page is re-displayed. Initially, there are no data shares or recipients.
+
+    ![The Provide Share page is displayed.](./images/provide-share-page-redisplayed.png " ")
+
+## Task 2: Create and Publish a Data Share
+
+When you create the data share using the share live data using direct connection method, you'll need the **Sharing ID**. A Sharing ID is a unique provider for your Autonomous Database. The Data Share tool uses it to share data with you. You can find the Sharing ID on the **Consume Share** page.
+
+>**Note:** In this workshop, both the **`share_provider`** and **`share_consumer`** are using the same Autonomous Database instance.
+
+1. Let's get the Sharing ID. In the navigation panel on the left, click **Consume Share**.
+
+    ![Click Consume Share.](./images/click-consume-share.png " ")
+
+2. On the **Consume Share** page, click **My Sharing ID**.
+
+    ![Click My Sharing ID.](./images/click-my-sharing-id.png " ")
+
+3. In the **Sharing ID** dialog box, click **Copy to Clipboard**. Svae this sharing id value as you will need it when you create a data share next. Next, click **Close**.
+
+    ![Copy to clipboard.](./images/copy-to-clipboard.png " ")
+
+4. In the navigation panel on the left, click **Provide Share**, and then click **Create Share**. 
+
+    ![Click Create Share.](./images/click-create-share.png " ")
+
+    The **Create Share** wizard is displayed.
+
+5. On the **General** page, enter **`training_share`** as the name for the new share, an optional description, and then click **Next**.
+
+    ![The general page.](./images/wizard-general.png " ")
+
+6. On the **Publish Details** page, select the **SHARE LIVE DATA USING DIRECT CONNECTION** tile, and then click **Next**.
+
+    ![The publish details page.](./images/wizard-publish-details.png " ")
+
+7. On the **Select Tables** page, add the **`CUSTOMER_CONTACT`** table that you created in the previous lab to the **`training_share`** data share. In the **Available Tables** section, click the table name, and then click the **Select** (>) icon.
+
+    The **`CUSTOMER_CONTACT`** table is added to the **Shared Tables** section. Click **Next**.
+
+    ![The table is added.](images/table-added.png " ")
+
+8. On the **Recipients** page, there are no recipients available initially. Click the **Select Recipient** drop-down list, and then select **MY_TENANCIES** from the list. Next, create a new recipient that will consume this data share. Click **New Recipient**.
+
+    ![Click recipient.](images/click-recipient.png " ")
+
+9. In the **Create Share Recipient** panel, enter **`training_recipient`** as the name of the recipient, an optional description, and paste the sharing id that you copied to your clipboard in the **Sharing ID** field.
+
+    ![Create the new recipient.](images/create-new-recipient.png " ")
+
+10. Click **Create**. The **Recipients** wizard's page is re-displayed. The newly created **TRAINING_RECIPIENT** is displayed on the page.
+
+    ![Click Create.](images/recipient-wizard-page.png " ")
+
+11. **Create** to create the data share. The **Provide Share** page is displayed. The new data share is displayed in the entities section. An informational message is displayed about the publishing process of the data share has started.
+
+    ![Data share created.](images/data-share-created.png " ")
+
+12. You can click the Actions icon (ellipsis) to view the data share details.
+
+    ![Click Actions.](images/click-actions.png " ")
+
+13. Log out of the **`SHARE_PROVIDER`** user. On the **Oracle Database Actions | Data Share** banner, click the drop-down list next to the `SHARE_PROVIDER` user, and then select **Sign Out** from the drop-down menu. If you are prompted to leave, click **Leave**.
+
+You may now proceed to the next lab.
+
+## Learn More
+
+* [The Share Tool](https://docs.oracle.com/en/cloud/paas/autonomous-database/adbsa/adp-data-share-tool.html#GUID-7EECE78B-336D-4853-BFC3-E78A7B8398DB)
+* [Oracle Cloud Infrastructure Documentation](https://docs.cloud.oracle.com/en-us/iaas/Content/GSG/Concepts/baremetalintro.htm)
+* [Using Oracle Autonomous Database Serverless](https://docs.oracle.com/en/cloud/paas/autonomous-database/adbsa/index.html)
+
+## Acknowledgements
+
+* **Author:** Lauran K. Serhal, Consulting User Assistance Developer
+* **Contributor:** Alexey Filanovskiy, Senior Principal Product Manager
+* **Last Updated By/Date:** Lauran K. Serhal, July 2024
+
+Data about movies in this workshop were sourced from Wikipedia.
+
+Copyright (C) 2024, Oracle Corporation.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3
+or any later version published by the Free Software Foundation;
+with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+A copy of the license is included in the section entitled [GNU Free Documentation License](files/gnu-free-documentation-license.txt)