diff --git a/shared/adb-speaks-human/cleanup/cleanup.md b/shared/adb-speaks-human/cleanup/cleanup.md index ccefe696..1a849828 100644 --- a/shared/adb-speaks-human/cleanup/cleanup.md +++ b/shared/adb-speaks-human/cleanup/cleanup.md @@ -57,7 +57,7 @@ If you created an optional compartment for this workshop, you can delete it if y ## Acknowledgements * **Author:** Lauran K. Serhal, Consulting User Assistance Developer -* **Last Updated By/Date:** Lauran K. Serhal, October 2023 +* **Last Updated By/Date:** Lauran K. Serhal, December 2023 Data about movies in this workshop were sourced from Wikipedia. diff --git a/shared/adb-speaks-human/connect-to-ai-model/connect-to-ai-model.md b/shared/adb-speaks-human/connect-to-ai-model/connect-to-ai-model.md index 5a977474..a0af450a 100644 --- a/shared/adb-speaks-human/connect-to-ai-model/connect-to-ai-model.md +++ b/shared/adb-speaks-human/connect-to-ai-model/connect-to-ai-model.md @@ -89,7 +89,7 @@ You may now proceed to the next lab. ## Acknowledgements * **Author:** Lauran K. Serhal, Consulting User Assistance Developer * **Contributors:** Marty Gubar, Product Management -* **Last Updated By/Date:** Lauran K. Serhal, October 2023 +* **Last Updated By/Date:** Lauran K. Serhal, January 2024 Data about movies in this workshop were sourced from **Wikipedia**. diff --git a/shared/adb-speaks-human/introduction/introduction.md b/shared/adb-speaks-human/introduction/introduction.md index 6b71fef8..f5aa7eae 100644 --- a/shared/adb-speaks-human/introduction/introduction.md +++ b/shared/adb-speaks-human/introduction/introduction.md @@ -34,7 +34,7 @@ You may now proceed to the next lab. ## Acknowledgements * **Author:** Lauran K. Serhal, Consulting User Assistance Developer * **Contributor:** Marty Gubar, Product Manager -* **Last Updated By/Date:** Lauran K. Serhal, October 2023 +* **Last Updated By/Date:** Lauran K. Serhal, January 2024 Data about movies in this workshop were sourced from **Wikipedia**. diff --git a/shared/adb-speaks-human/query-using-select-ai/query-using-select-ai.md b/shared/adb-speaks-human/query-using-select-ai/query-using-select-ai.md index a02a9a4a..57c79bc2 100644 --- a/shared/adb-speaks-human/query-using-select-ai/query-using-select-ai.md +++ b/shared/adb-speaks-human/query-using-select-ai/query-using-select-ai.md @@ -160,6 +160,8 @@ _**In summary, using LLMs infer a lot from human language. It's always good to v You can import, create, and work with notebooks in Oracle Machine Learning Notebooks. You can access Oracle Machine Learning Notebooks from Autonomous Database. +>**Note:** You can run **`Select AI`** SQL queries from most tools; however, it is not yet supported by the **SQL Worksheet**. + If you already have the **SQL| Oracle Database Actions** browser tab open from the previous lab, click the **Database Actions | SQL banner** to display the Database **Actions | Launchpad** Home page. In the **Development** section, click the **Oracle Machine Learning** card to display the **Sign In** page. Continue with step **step 7** below. ![Click the banner](./images/click-banner.png " ") @@ -277,7 +279,7 @@ You may now proceed to the next lab. * **Author:** Lauran K. Serhal, Consulting User Assistance Developer * **Contributor:** Marty Gubar, Product Manager -* **Last Updated By/Date:** Lauran K. Serhal, October 2023 +* **Last Updated By/Date:** Lauran K. Serhal, January 2024 Data about movies in this workshop were sourced from **Wikipedia**. diff --git a/shared/adb-speaks-human/setup-environment/setup-environment.md b/shared/adb-speaks-human/setup-environment/setup-environment.md index 6b1e2a7f..d56b62d9 100644 --- a/shared/adb-speaks-human/setup-environment/setup-environment.md +++ b/shared/adb-speaks-human/setup-environment/setup-environment.md @@ -205,7 +205,7 @@ You may now proceed to the next lab. * **Author:** Lauran K. Serhal, Consulting User Assistance Developer * **Contributor:** Marty Gubar, Product Manager -* **Last Updated By/Date:** Lauran K. Serhal, October 2023 +* **Last Updated By/Date:** Lauran K. Serhal, January 2024 Data about movies in this workshop were sourced from **Wikipedia**. diff --git a/shared/adb-speaks-human/use-select-ai-demo/use-select-ai-demo.md b/shared/adb-speaks-human/use-select-ai-demo/use-select-ai-demo.md index 38f65a59..4225e608 100644 --- a/shared/adb-speaks-human/use-select-ai-demo/use-select-ai-demo.md +++ b/shared/adb-speaks-human/use-select-ai-demo/use-select-ai-demo.md @@ -103,7 +103,7 @@ You may now proceed to the next lab. ## Acknowledgements * **Author:** Lauran K. Serhal, Consulting User Assistance Developer * **Contributors:** Marty Gubar, Product Management -* **Last Updated By/Date:** Lauran K. Serhal, October 2023 +* **Last Updated By/Date:** Lauran K. Serhal, January 2024 Data about movies in this workshop were sourced from **Wikipedia**. diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/cleanup/cleanup.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/cleanup/cleanup.md index 4713ff3f..0fdd46dc 100644 --- a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/cleanup/cleanup.md +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/cleanup/cleanup.md @@ -53,7 +53,7 @@ This concludes the workshop. ## Acknowledgements * **Author:** Lauran Serhal, Consulting User Assistance Developer, Oracle Autonomous Database and Big Data -* **Last Updated By/Date:** Lauran Serhal, October 2023 +* **Last Updated By/Date:** Lauran Serhal, January 2024 Data about movies in this workshop were sourced from Wikipedia. diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/consume-share.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/consume-share.md new file mode 100644 index 00000000..8482b151 --- /dev/null +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/consume-share.md @@ -0,0 +1,300 @@ +# 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. + +![Recipient diagram.](images/recipient-diagram.png) + +Estimated Time: 10 minutes + +### Objectives + +In this lab, you will: + +* Create a share consumer user. +* Grant the share consumer privileges to the share provider. +* Discover the available data shares and tables. +* Create a share link and a view using the data share table. + +### Prerequisites + +This lab assumes that you have successfully completed all of the preceding labs in the **Contents** menu on the left. + +## Task 1: (Optional) Create a Share Consumer User + +In this lab, you will log in as the `admin` user to create a database user (schema) that will be used to consume the data share that the `share_provider` user created and shared with the `live_share_oracle_user` recipient. If you already have an existing schema with the appropriate privileges, you can use it. We chose to separate the share\_provider user (schema) from the share\_consumer user (schema) to simulate a real use case of data sharing between a provider and a consumer. + +1. Log out of the `share_provider` user. On the **Oracle Database Actions | SQL** banner, click the drop-down list next to the `SHARE_PROVIDER` user, and then select **Sign Out** from the drop-down menu. Click **Leave**. + +2. Log in as the **`admin`** user. On the **Sign-in** page, enter **`admin`** as the username and **`TrainingADW`** as the password, and then click **Sign in**. + +3. In the **Development** section, click the **SQL** card. + +4. Create a new consumer user named **`share_consumer`**. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script (F5)** icon. + + ``` + + -- Create a new user that will consume the shared data. + + CREATE USER share_consumer IDENTIFIED BY DataShare4ADW; + + -- Grant the new user the required roles. + + GRANT CONNECT TO share_consumer; + GRANT DWROLE TO share_consumer; + GRANT RESOURCE TO share_consumer; + GRANT UNLIMITED TABLESPACE TO share_consumer; + + BEGIN + ORDS_ADMIN.ENABLE_SCHEMA + (p_enabled => TRUE, + p_schema => 'share_consumer', + p_url_mapping_type => 'BASE_PATH', + p_auto_rest_auth=> TRUE ); + END; + / + + ``` + + ![Run the script](images/run-script.png) + + The results are displayed in the **Script Output** tab. + + ![View the script results](images/script-results.png) + + At this point, the **`share_consumer`** user doesn't have the required privileges to read cloud links yet. + +## Task 2: Grant the Share Consumer Privileges to the Share Provider + +1. To consume a live share, a recipient user must have the required privileges to access the live share. The **`PRIV_CONSUME_ORACLE_SHARE`** privilege allows the specified user to consume Oracle-to-Oracle live shares. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon. + + ``` + + BEGIN + DBMS_SHARE.ENABLE_SCHEMA( + 'share_consumer', + enabled=>TRUE, + privileges=>dbms_share.PRIV_CONSUME_ORACLE_SHARE); + END; + / + + ``` + + ![Enable share_consumer schema.](images/enable-share-consumer-schema.png) + +2. Log out of the `admin` user. On the **Oracle Database Actions | SQL** banner, click the drop-down list next to the `ADMIN` user, and then select **Sign Out** from the drop-down menu. Click **Leave**. + +3. Log in as the newly created user, `share_consumer`. On the **Sign-in** page, enter **`share_consumer`** as the username and **`DataShare4ADW`** as the password, and then click **Sign in**. + + ![Log in as share_consumer](images/login-share-consumer.png) + + You are now logged in as the `share_consumer` user. In the **Development** section, click the **SQL** card to display the SQL Worksheet. + +4. Verify that you as the `share_consumer` have the privilege to read the data share. You can use the following query to check if the current session user is enabled for `READ` access to a data set. + + ``` + + SELECT SYS_CONTEXT('USERENV','CLOUD_LINK_READ_ENABLED') + FROM dual; + + ``` + + ![Have access to cloud links?](images/cloud-links-access.png) + + The `YES` indicates that the `share_consumer` user is enabled for `READ` access to a data set. + +5. Query the share providers that are available to the `share_consumer` user. + + ``` + + SELECT provider_name, description, contact + FROM all_available_oracle_share_providers + + ``` + + ![Check the available providers](images/available-providers.png) + + >**Note:** If the above query doesn't show the published data share, wait for a few more minutes until the publishing process is completed, and then run the query again. + +6. Copy the value for the **`provider_name`** entry that starts with **`live_share_provider`**. You will need this value in the next task. Click the **eye** icon. The **`provider_name`** value is displayed. + + ![Copy the sharing id value](images/copy-provider-name.png) + +7. Click the **`provider_name`** value to highlight it and copy it. + + ![Copy the highlighted provider_name value](images/highlight-provider-name.png) + + Next, paste the copied value into your text editor file. + + ![Paste the value into a text editor file](images/paste-provider-name-value.png) + +## Task 3: Discover Available Data Shares and Tables + +1. Obtain the share provider's ID. _**Important:** Copy and paste the following script into your SQL Worksheet; **however, don't run it yet**. Replace the text place holder in the script for the **`provider_name`** argument with your own **`provider_name`** value that you obtained (and saved in a text editor file) in the previous task._ Next, click the **Run Script** icon. + + ``` + + declare + oracle_provider_id VARCHAR2(64); + BEGIN + SELECT oracle_provider_id INTO oracle_provider_id + FROM all_available_oracle_share_providers + WHERE provider_name = 'enter the share provider name here'; + SYS.DBMS_OUTPUT.PUT_LINE('provider id = ' || oracle_provider_id); + END; + / + + ``` + + ![Get provider id](images/get-provider-id.png) + + Copy the value of the returned **provider id** as you will need it in the next step. + +2. Subscribe to the data share provider by creating a new share provider name that we called **`demo_live_provider`** in our example. _**Important:** Copy and paste the following script into your SQL Worksheet; **however, don't run it yet**. Replace the text place holder in the script for the **`oracle_provider_id`** argument with your own **`oracle_provider_id`** value that you obtained in the previous step._ Next, click the **Run Script** icon. + + ``` + + BEGIN + dbms_share.create_oracle_share_provider + (oracle_provider_id=> 'Enter the provider id here', + provider_name=> 'DEMO_LIVE_PROVIDER'); + END; + / + + ``` + + ![Create provider](images/create-provider.png) + +3. Query the available providers to confirm the creation of the new share provider name. + + ``` + + SELECT provider_name share_provider_name + FROM user_share_providers + ORDER BY 1; + + ``` + + ![Verify provider](images/verify-provider.png) + +4. Query the available shares from the newly created share provider. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon. + + ``` + + SELECT available_share_name share_name + FROM dbms_share.discover_available_shares('DEMO_LIVE_PROVIDER'); + + ``` + + ![Query available shares](images/query-shares.png) + +5. Query the available tables in the share. Copy and paste the following script into your SQL Worksheet, and then click the **Run Statement** icon. + + ``` + + SELECT schema_name, table_name + FROM dbms_share.discover_available_tables( + share_provider=>'DEMO_LIVE_PROVIDER', + share_name=>'DEMO_LIVE_SHARE') + ORDER BY 1, 2; + + ``` + + ![Query available tables in the share](images/query-tables.png) + +## Task 4: Create a Share Link and a View Using the Data Share Table + +1. Create a new share link to subscribe to a data share from a registered share provider. Copy and paste the following query into your SQL Worksheet, and then click the **Run Script** icon. + + ``` + + BEGIN + dbms_share.create_share_link + ( + share_link_name => 'SALES_DATA', + share_provider => 'DEMO_LIVE_PROVIDER', + share_name => 'DEMO_LIVE_SHARE' + ); + END; + / + + ``` + + ![Create a share link.](images/create-share-link.png) + +2. Verify the share link. Copy and paste the following query into your SQL Worksheet, and then click the **Run Statement** icon. + + ``` + + SELECT share_provider_name, link_name, share_name + FROM user_share_links + ORDER BY 1, 2; + + ``` + + ![Verify the share link](images/verify-share-link.png) + + +2. Use the new share link to create a view over the shared table. Copy and paste the following query into your SQL Worksheet, and then click the **Run Script** icon. + + ``` + + BEGIN + dbms_share.create_share_link_view( + view_name=>'CUSTSALES_SHARE_V', + share_link_name=>'SALES_DATA', + share_schema_name=>'share_provider', + share_table_name=>'CUSTSALES'); + END; + + ``` + + ![Create a view.](images/create-view.png) + +3. Describe the view. + + ``` + + SELECT dbms_metadata.get_ddl('VIEW', 'CUSTSALES_SHARE_V') view_definition + FROM dual; + + ``` + + ![Describe the view.](images/describe-view.png) + +4. Query the view. Copy and paste the following query into your SQL Worksheet, and then click the **Run Statement** icon. + + ``` + + SELECT app, count(*) + FROM custsales_share_v + GROUP BY app + ORDER BY 1; + + ``` + + ![Query the view.](images/query-view.png) + +You may now proceed to the next lab. + +## Learn More + +* [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, January 2024 + +Data about movies in this workshop were sourced from Wikipedia. + +Copyright (C) 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) \ No newline at end of file diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/alexey-code-1.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/alexey-code-1.png new file mode 100644 index 00000000..4ba6cf26 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/alexey-code-1.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/available-providers.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/available-providers.png new file mode 100644 index 00000000..9e23f49c Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/available-providers.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/cloud-links-access.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/cloud-links-access.png new file mode 100644 index 00000000..58409ba0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/cloud-links-access.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/copy-profile-content.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/copy-profile-content.png new file mode 100644 index 00000000..fea244f0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/copy-profile-content.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/copy-provider-name.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/copy-provider-name.png new file mode 100644 index 00000000..aef42e15 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/copy-provider-name.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-credential-result.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-credential-result.png new file mode 100644 index 00000000..cd08028b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-credential-result.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-credential.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-credential.png new file mode 100644 index 00000000..b9de3b0f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-credential.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-provider.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-provider.png new file mode 100644 index 00000000..4b4cfced Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-provider.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-share-link.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-share-link.png new file mode 100644 index 00000000..9c6e5d3f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-share-link.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-share-provider.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-share-provider.png new file mode 100644 index 00000000..d3f7731a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-share-provider.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-view.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-view.png new file mode 100644 index 00000000..750c35c5 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/create-view.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/describe-view.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/describe-view.png new file mode 100644 index 00000000..7d04a1d4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/describe-view.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/enable-share-consumer-schema.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/enable-share-consumer-schema.png new file mode 100644 index 00000000..e81b26f2 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/enable-share-consumer-schema.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/endpoint.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/endpoint.png new file mode 100644 index 00000000..2ad005f2 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/endpoint.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/get-provider-id.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/get-provider-id.png new file mode 100644 index 00000000..40924dfc Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/get-provider-id.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/highlight-provider-name.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/highlight-provider-name.png new file mode 100644 index 00000000..b2d47f60 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/highlight-provider-name.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/login-share-consumer.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/login-share-consumer.png new file mode 100644 index 00000000..5294e742 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/login-share-consumer.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/method-2.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/method-2.png new file mode 100644 index 00000000..0291db8b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/method-2.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/paste-provider-name-value.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/paste-provider-name-value.png new file mode 100644 index 00000000..e8f4af53 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/paste-provider-name-value.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-credentials.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-credentials.png new file mode 100644 index 00000000..796db50a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-credentials.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-data-shares.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-data-shares.png new file mode 100644 index 00000000..2ba8b8b7 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-data-shares.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-share-unnamed.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-share-unnamed.png new file mode 100644 index 00000000..06fdc612 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-share-unnamed.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-shares.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-shares.png new file mode 100644 index 00000000..c649b4cd Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-shares.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-tables-share.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-tables-share.png new file mode 100644 index 00000000..46b62c75 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-tables-share.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-tables.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-tables.png new file mode 100644 index 00000000..dabc0076 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-tables.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-view.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-view.png new file mode 100644 index 00000000..aa5f1b02 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/query-view.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/read-access.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/read-access.png new file mode 100644 index 00000000..6c0563bf Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/read-access.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/reate-share-link.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/reate-share-link.png new file mode 100644 index 00000000..e7f6f6eb Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/reate-share-link.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/recipient-diagram.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/recipient-diagram.png new file mode 100644 index 00000000..3f78aa6a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/recipient-diagram.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/run-script.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/run-script.png new file mode 100644 index 00000000..df3709f4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/run-script.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/screen-1_2.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/screen-1_2.png new file mode 100644 index 00000000..9f93e9dc Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/screen-1_2.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/script-results.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/script-results.png new file mode 100644 index 00000000..5ba244f3 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/script-results.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-acls-all.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-acls-all.png new file mode 100644 index 00000000..f9c0282b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-acls-all.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-acls.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-acls.png new file mode 100644 index 00000000..f1340465 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-acls.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-credential.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-credential.png new file mode 100644 index 00000000..5e611aa2 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/set-credential.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/verify-provider.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/verify-provider.png new file mode 100644 index 00000000..56430a4c Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/verify-provider.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/verify-share-link.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/verify-share-link.png new file mode 100644 index 00000000..c806f3f4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/verify-share-link.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/versioned-share-type.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/versioned-share-type.png new file mode 100644 index 00000000..6a61fed9 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/consume-share/images/versioned-share-type.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/create-share-recipients.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/create-share-recipients.md new file mode 100644 index 00000000..f8dba3b4 --- /dev/null +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/create-share-recipients.md @@ -0,0 +1,109 @@ +# Create and Authorize the Data Share Recipient + +## Introduction + +A data share recipient is an entity such as an individual, an institution, or a software system that receives a data share from a data share provider.A recipient can access the data in the share. A recipient can have access to multiple shares. If you remove a recipient, that recipient loses access to all shares it could previously access. + +In this lab, as a data share provider, you will create and authorize a new recipient that will access the **`demo_live_share`** data share that you just published and to the `custsales` table in this share. You will need the sharing ID that you saved from an earlier step. + +![Recipient flow.](images/recipient-diagram.png) + +Estimated Time: 5 minutes + +### Objectives + +In this lab, you will: + +* Create a new recipient. +* Grant the recipient access privileges to the data share. + +### 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 Data Share Recipient + +1. As the **`share_provider`** user, create a new data share recipient named **`live_share_oracle_user`**. +_**Important:** Copy and paste the following script into your SQL Worksheet; **however, don't run it yet**. Replace the text place holder in the script for the **`sharing_id`** argument with your own **sharing id** value that you obtained (and saved in a text editor file) in **Lab 2 > Task 2 > Step 2**_. Next, click the **Run Script** icon. + + ``` + + BEGIN + dbms_share.create_share_recipient + (recipient_name=>'live_share_oracle_user', + sharing_id=>'Enter your share provider user sharing id here' + ); + END; + / + + ``` + + ![Create recipient.](images/create-recipient.png) + +2. Query the available recipients. Copy and paste the following script into your SQL Worksheet, and then click the **Run Statement** icon. + + ``` + + SELECT recipient_name, updated + FROM user_share_recipients + ORDER BY 1; + + ``` + + ![Query recipients.](images/query-recipients.png) + +## Task 2: Grant the Recipient Access Privileges to the Data Share + +1. As the **`share_provider`** user, grant the new `live_share_oracle_user` recipient access to the `demo_live_share` data share. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon. + + ``` + + BEGIN + DBMS_SHARE.GRANT_TO_RECIPIENT( + share_name=>'demo_live_share', + recipient_name=> 'live_share_oracle_user'); + COMMIT; + END; + / + + ``` + + ![Grant access to share.](images/grant-recipient-access.png) + +2. Determine the data shares to which the `live_share_oracle_user` recipient has access privileges. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon. + + ``` + + SELECT recipient_name, share_name + FROM user_share_recipient_grants + WHERE recipient_name = 'LIVE_SHARE_ORACLE_USER' + ORDER BY 1; + + ``` + + ![Check recipient access privileges.](images/query-privileges.png) + + The **`live_share_oracle_user`** recipient has access privileges to only one data share, **`demo_live_share`**. + +You may now proceed to the next lab. + +## Learn More + +* [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, January 2024 + +Data about movies in this workshop were sourced from Wikipedia. + +Copyright (C) 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) \ No newline at end of file diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/alexey-code-1.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/alexey-code-1.png new file mode 100644 index 00000000..9a79c3a0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/alexey-code-1.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/click-download-script-output.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/click-download-script-output.png new file mode 100644 index 00000000..e43d6890 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/click-download-script-output.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/click-get-profile.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/click-get-profile.png new file mode 100644 index 00000000..2b217289 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/click-get-profile.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/consume-share.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/consume-share.png new file mode 100644 index 00000000..a966b7bc Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/consume-share.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/create-recipient.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/create-recipient.png new file mode 100644 index 00000000..b69aa2d1 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/create-recipient.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/delta-share-profile.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/delta-share-profile.png new file mode 100644 index 00000000..08ac1208 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/delta-share-profile.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/downloaded-file.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/downloaded-file.png new file mode 100644 index 00000000..be419f3b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/downloaded-file.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/edited-activation-url.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/edited-activation-url.png new file mode 100644 index 00000000..5e0a7cf0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/edited-activation-url.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/endpoint.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/endpoint.png new file mode 100644 index 00000000..636bcc9f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/endpoint.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/grant-recipient-access.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/grant-recipient-access.png new file mode 100644 index 00000000..84e60367 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/grant-recipient-access.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/host-url.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/host-url.png new file mode 100644 index 00000000..d280f2fd Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/host-url.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/logged-admin.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/logged-admin.png new file mode 100644 index 00000000..715f321f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/logged-admin.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1-fix.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1-fix.png new file mode 100644 index 00000000..f353507f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1-fix.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1-temp.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1-temp.png new file mode 100644 index 00000000..0f2359a0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1-temp.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1.png new file mode 100644 index 00000000..ca34dc16 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-1.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-2.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-2.png new file mode 100644 index 00000000..ad2f1b35 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/method-2.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/open-profile.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/open-profile.png new file mode 100644 index 00000000..c7648ea5 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/open-profile.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/query-privileges.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/query-privileges.png new file mode 100644 index 00000000..ec951c3b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/query-privileges.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/query-recipients.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/query-recipients.png new file mode 100644 index 00000000..71ce7e82 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/query-recipients.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/recipient-diagram.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/recipient-diagram.png new file mode 100644 index 00000000..862eb2d6 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/recipient-diagram.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/sample-generated-file.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/sample-generated-file.png new file mode 100644 index 00000000..bbc1c803 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/sample-generated-file.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/save-activation-link.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/save-activation-link.png new file mode 100644 index 00000000..35e298da Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/save-activation-link.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/save-json-file.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/save-json-file.png new file mode 100644 index 00000000..3ee72e20 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/save-json-file.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-1.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-1.png new file mode 100644 index 00000000..4f1842d9 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-1.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-2.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-2.png new file mode 100644 index 00000000..df25406b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-2.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-3.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-3.png new file mode 100644 index 00000000..ee7f85e4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-3.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-4.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-4.png new file mode 100644 index 00000000..649104dd Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/screen-4.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/script-output-downloaded.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/script-output-downloaded.png new file mode 100644 index 00000000..033a6c5f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/script-output-downloaded.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/set-acls.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/set-acls.png new file mode 100644 index 00000000..255db72e Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/set-acls.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/share-activation-link.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/share-activation-link.png new file mode 100644 index 00000000..c9b7e5d8 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share-recipients/images/share-activation-link.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/create-share.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/create-share.md new file mode 100644 index 00000000..ec8f0735 --- /dev/null +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/create-share.md @@ -0,0 +1,218 @@ +# 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 publish the data share to make it available to the authorized recipient that you will define in the next lab. + + ![Create a data share diagram.](images/data-share-diagram.png) + +Estimated Time: 15 minutes + +### Objectives + +In this lab, you will: + +* Create a new data share. +* Create two tables. +* Add one of the newly created tables to the data share. +* 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 Data Share + +1. As the **`share_provider`** user, create a new data share named **`demo_share`**. The **`DATA_SHARE_STORAGE_LINK`** value refers to the storage link that you created in **Lab 2** which points to your Object Storage bucket's URI. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon in the Worksheet toolbar. + + ``` + + BEGIN + DBMS_SHARE.CREATE_SHARE( + share_name=>'demo_live_share', + share_type=>'LIVE'); + END; + / + + ``` + + ![Create data share.](images/create-data-share.png) + + >**Note:** To drop a share, use the `DBMS_SHARE.DROP_SHARE` procedure as follows: + + ``` + BEGIN + DBMS_SHARE.DROP_SHARE('demo_live_share'); + END; + / + ``` + +2. Verify the creation of the data share. Copy and paste the following script into your SQL Worksheet, and then click the **Run Statement** icon in the Worksheet toolbar. + + ``` + + SELECT share_name, current_version + FROM user_shares + WHERE share_name='DEMO_LIVE_SHARE'; + + ``` + + ![Query new data share.](images/query-data-share.png) + + Before you publish the data share, the **Current Version** column shows **`(null)`**. After you publish the data share, the the **Current Version** column will show **`1`**. + +## Task 2: Create Tables to Add to the Data Share + +1. Create an external table from a public dataset that you will add to the data share. The **moviestream_landing** Oracle Object Storage public bucket that contains some `Parquet` data is located in a different tenancy than yours, **`c4u04`**; therefore, you will use the following public URL. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon in the Worksheet toolbar. + + ``` + + BEGIN + DBMS_CLOUD.CREATE_EXTERNAL_TABLE( + table_name =>'custsales_external', + file_uri_list =>'https://objectstorage.us-ashburn-1.oraclecloud.com/n/c4u04/b/moviestream_landing/o/sales_sample/*.parquet', + format => '{"type":"parquet", "schema": "first"}'); + END; + / + + ``` + + ![Create external table.](images/create-external-table.png) + +2. Create a table based on the external table which you will add to the data share. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon in the Worksheet toolbar. + + ``` + + CREATE TABLE custsales + AS + SELECT * + FROM custsales_external; + + ``` + + ![Create heap table.](images/create-heap-table.png) + +3. Query the newly created **`custsales`** table. Copy and paste the following script into your SQL Worksheet, and then click the **Run Statement** icon. + + ``` + + SELECT app, count(*) + FROM custsales + GROUP BY app + ORDER BY 1; + + ``` + + ![Query new data share.](images/query-custsales.png) + +## Task 3: Add the custsales Table to the Data Share + +1. Add the `custsales` table to the `demo_share` data share. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon in the Worksheet toolbar. + + ``` + + BEGIN + DBMS_SHARE.ADD_TO_SHARE( + share_name=>'demo_live_share', + owner=> 'share_provider', + table_name=> 'custsales', + share_table_name=> 'custsales'); + END; + / + + ``` + + ![Add table to share.](images/add-table-share.png) + +2. Verify the addition of the table to the data share. Copy and paste the following script into your SQL Worksheet, and then click the **Run Statement** icon. + + ``` + + SELECT share_table_name, table_name, table_owner + FROM user_share_tables + WHERE share_name='DEMO_LIVE_SHARE' + ORDER BY 1; + + ``` + + ![Verify table addition.](images/verify-table-added.png) + + >**Note:** To remove a table from a share, use the following script: + + ``` + BEGIN + DBMS_SHARE.REMOVE_FROM_SHARE( + share_name=>'demo_live_share', + share_table_name => 'custsales' + ); + END; + ``` + +## Task 4: Publish the Data Share + +Up to this point, the share and its table are stored in the database and therefore are not yet available to anyone. In this task, you will call the `PUBLISH_SHARE` API which offloads data to the Cloud Store and makes it accessible to recipients that you define and authorize in a later lab. + +_**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 before you proceed with **step 1** below:_ + +``` + +BEGIN + DBMS_SHARE.UPDATE_DEFAULT_SHARE_PROPERTY('job_type', 'DBMS_CLOUD'); +END; +/ + +``` + +1. Publish the `demo_share` data share to make it visible to authorized recipients. To ensure that the publishing job is complete before you move on to the next lab, you will use the `PUBLISH_SHARE_WAIT` procedure. It also makes a share visible to authorized recipients; however, it waits for publishing task to complete. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script** icon. It could take few minutes for the publishing process (export) to complete. + + ``` + + BEGIN + DBMS_SHARE.PUBLISH_SHARE_WAIT(share_name=>'demo_live_share'); + END; + / + + ``` + + ![Publish the share.](images/publish-share.png) + +2. Use the `user_share_versions` view to track the state of the export. Copy and paste the following script into your SQL Worksheet, and then click the **Run Statement** icon. + + ``` + + SELECT SHARE_NAME, SHARE_VERSION, STATUS + FROM user_share_versions v + WHERE v.share_name = 'DEMO_LIVE_SHARE' + ORDER BY share_version desc; + + ``` + + ![Track the data export.](images/track-export.png) + + If the **STATUS** shows **EXPORTING**, that indicates the publishing process is not yet complete. You might have to wait for a few minutes for the publishing to finish. Don't proceed to the next lab until the **STATUS** shows **CURRENT**. + +You may now proceed to the next lab. + +## Learn More + +* [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, January 2024 + +Data about movies in this workshop were sourced from Wikipedia. + +Copyright (C) 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) diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/add-table-share.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/add-table-share.png new file mode 100644 index 00000000..cdbac0bc Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/add-table-share.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-data-share.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-data-share.png new file mode 100644 index 00000000..6ed5dcc4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-data-share.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-external-table.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-external-table.png new file mode 100644 index 00000000..591eff47 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-external-table.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-heap-table.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-heap-table.png new file mode 100644 index 00000000..fe7f8778 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-heap-table.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-recipient.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-recipient.png new file mode 100644 index 00000000..9d577802 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/create-recipient.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/current-version.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/current-version.png new file mode 100644 index 00000000..4f905507 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/current-version.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/data-share-diagram.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/data-share-diagram.png new file mode 100644 index 00000000..f102279c Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/data-share-diagram.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/method-1.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/method-1.png new file mode 100644 index 00000000..d83e072f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/method-1.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/publish-share.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/publish-share.png new file mode 100644 index 00000000..68b5b786 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/publish-share.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/query-custsales.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/query-custsales.png new file mode 100644 index 00000000..53d9f802 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/query-custsales.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/query-data-share.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/query-data-share.png new file mode 100644 index 00000000..6b4c2965 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/query-data-share.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/track-export.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/track-export.png new file mode 100644 index 00000000..79de803b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/track-export.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/verify-table-added.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/verify-table-added.png new file mode 100644 index 00000000..d43e5108 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/verify-table-added.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/versioned-share-type.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/versioned-share-type.png new file mode 100644 index 00000000..0368b1ba Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-share/images/versioned-share-type.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/create-user.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/create-user.md new file mode 100644 index 00000000..64788a07 --- /dev/null +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/create-user.md @@ -0,0 +1,179 @@ +# Create a Share Provider User and Grant the User Privileges + +## Introduction + +In this lab, you as the **`admin`**, you will create a **data share provider** user and grant this user the necessary role and privileges, and enable data sharing. + +![Create a user and grant roles and privileges](./images/create-user-privileges-diagram.png " ") + +Estimated Time: 15 minutes + +### Objectives + +In this lab, you will: + +* Create a user that will be the data share provider. +* Grant the data share provider the necessary role and privileges. +* Enable data sharing for the schema. + +### Prerequisites + +This lab assumes that you have successfully completed all of the preceding labs in the **Contents** menu on the left. + +## Task 1: Navigate to the SQL Worksheet + +1. Log in to the **Oracle Cloud Console**, if you are not already logged in. + +2. Open the **Navigation** menu and click **Oracle Database**. Under **Oracle Database**, click **Autonomous Database**. + +3. On the **Autonomous Databases** page, click your **ADW-Data-Lake** ADB instance. + ![The Autonomous Database is displayed and highlighted.](./images/adb-page.png " ") + +4. On the **Autonomous Database details** page, click the **Database actions** drop-down list, and then click **SQL**. + + ![On the partial Autonomous Database Details page, the Database Actions button is highlighted.](./images/click-db-actions.png " ") + +5. The SQL Worksheet is displayed. + + ![The SQL worksheet is displayed.](./images/sql-worksheet.png " ") + +## Task 2: Create a Share Provider User and Grant Privileges to the User + +As the **`admin`** user, create a **share_provider** user and grant this user the required role and privileges and enable REST and data sharing. + +### **The Data Share Provider** + +Oracle Autonomous Database Serverless enables the data share provider to share existing objects such as tables with authorized recipients. The share can contain a single table, a set of related tables, a set of tables with some logical grouping. The provider could be a person, an institution, or a software system that shares the objects. + +Autonomous Database comes with a predefined database role named `DWROLE`. This role provides the privileges necessary for most database users;however, The DWROLE role does not allocate any tablespace quota to the user. If the user is going to be adding data or other objects, you need to grant the user tablespace quota. For more information about this role, see [Manage Database User Privileges](https://docs.oracle.com/en-us/iaas/autonomous-database/doc/managing-database-users.html). + +1. Create a **share_provider** user and grant this user the required role and privileges and enable REST and data sharing. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script (F5)** icon in the Worksheet toolbar. + + ``` + + -- Create a new user that will provide the shared data. + + CREATE USER share_provider IDENTIFIED BY DataShare4ADW; + + -- Grant the new user the required role and privileges. + + GRANT CONNECT TO share_provider; + GRANT DWROLE TO share_provider; + GRANT RESOURCE TO share_provider; + GRANT UNLIMITED TABLESPACE TO share_provider; + + -- Enable REST. + + BEGIN + ORDS_ADMIN.ENABLE_SCHEMA( + p_enabled => TRUE, + p_schema => 'SHARE_PROVIDER', + p_url_mapping_type => 'BASE_PATH', + p_url_mapping_pattern => 'share_provider', + p_auto_rest_auth=> TRUE + ); + + -- Enable data sharing. + DBMS_SHARE.ENABLE_SCHEMA( + SCHEMA_NAME => 'SHARE_PROVIDER', + ENABLED => TRUE + ); + commit; + END; + / + + ``` + + ![Run the script](images/run-script.png) + + The results are displayed in the **Script Output** tab. + + ![View the script results](images/script-results.png) + +## Task 3: Get the Consumer's Share ID and the Share Provider User Information + +1. As the **`ADMIN`** user, get the consumer's Share ID. The Data Provider intends to share data with some Oracle ADB. To identify the data consumer, you need to get the **Sharing ID**. Copy and paste the following script into your SQL Worksheet, and then click the **Run Statement** icon in the Worksheet toolbar. + + ``` + + SELECT dbms_share.get_sharing_id + FROM dual; + + ``` + + ![Determine the consumer share id](images/get-sharing-id.png) + +2. Copy the **`get_sharing_id`** value to a text editor of your choice. You will need this value later. Click the **eye** icon. The **`get_sharing_id`** value is highlighted. + + ![Copy the sharing id value](images/copy-sharing-id.png) + + Copy the value and paste it into your text editor file. + + ![Paste the value into a text editor file](images/copy-value-text-editor.png) + +3. Log out of the **`ADMIN`** user. On the **Oracle Database Actions | SQL** banner, click the drop-down list next to the **`ADMIN`** user, and then select **Sign Out** from the drop-down menu. When prompted if you want to leave the site, click **Leave**. + + ![Log out of admin](images/logout-admin.png) + +4. Log in as the newly created user, **`share_provider`**. On the **Sign-in** page, enter **`share_provider`** as the username and **`DataShare4ADW`** as the password, and then click **Sign in**. + + ![Log in as share_provider](images/login-share-provider.png) + + You are now logged in as the newly created **`share_provider`** user. In the **Development** section, click the **SQL** card to display the SQL Worksheet. + + ![Logged in as share_provider](images/logged-share-provider.png) + +5. Provide the share provider user identity information. This enables consumers to see this share provider user and the user's shared data. This is a free formed metadata. Provide a meaningful **name**, **description**, and an **email** address. Copy and paste the following script into your SQL Worksheet, and then click the **Run Script (F5)** icon in the Worksheet toolbar. + + ``` + + BEGIN + dbms_share.set_published_identity(SYS.JSON_OBJECT_T(JSON_OBJECT( + -- A name that will be visible to recipients. + -- Give enough information to be identifiable + 'name' VALUE 'LIVE_SHARE_PROVIDER_' + || SYS_CONTEXT('USERENV', 'CON_NAME') || '/' || USER, + 'description' VALUE 'Live Share Provider', + 'contact' VALUE 'provider@example.com'))); + END; + / + + ``` + + ![Run the script](images/identify-share-provider.png) + +6. Query the share provider user identity information. Copy and paste the following query into your SQL Worksheet, and then click the **Run Script (F5)** icon. + + ``` + + SELECT * + FROM JSON_TABLE( + dbms_share.get_published_identity, '$' + COLUMNS (name, description, contact)); + + ``` + + ![Query the credentials](images/query-identity.png) + +You may now proceed to the next lab. + +## Learn More + +* [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, January 2024 + +Data about movies in this workshop were sourced from Wikipedia. + +Copyright (C) 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) diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/access-bucket.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/access-bucket.png new file mode 100644 index 00000000..edf2d93b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/access-bucket.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/access-user-bucket.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/access-user-bucket.png new file mode 100644 index 00000000..0b7e4417 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/access-user-bucket.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/adb-page.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/adb-page.png new file mode 100644 index 00000000..762de19a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/adb-page.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/associate-link-credential.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/associate-link-credential.png new file mode 100644 index 00000000..ddc6c119 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/associate-link-credential.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-created (2).png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-created (2).png new file mode 100644 index 00000000..62967d62 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-created (2).png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-created.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-created.png new file mode 100644 index 00000000..206e25da Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-created.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-page.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-page.png new file mode 100644 index 00000000..1b37f9df Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/bucket-page.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/buckets-page.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/buckets-page.png new file mode 100644 index 00000000..5e1be20b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/buckets-page.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/can-user-share.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/can-user-share.png new file mode 100644 index 00000000..5f6928f4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/can-user-share.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/check-version-state.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/check-version-state.png new file mode 100644 index 00000000..03a637a9 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/check-version-state.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-add-api-key.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-add-api-key.png new file mode 100644 index 00000000..6ec622ec Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-add-api-key.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-api-key.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-api-key.png new file mode 100644 index 00000000..37998d1b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-api-key.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-db-actions.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-db-actions.png new file mode 100644 index 00000000..320bd509 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-db-actions.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-sql-card.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-sql-card.png new file mode 100644 index 00000000..96d0d83a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-sql-card.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-your-username.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-your-username.png new file mode 100644 index 00000000..85730f56 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/click-your-username.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/code-example-completed.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/code-example-completed.png new file mode 100644 index 00000000..465842d7 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/code-example-completed.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/config-file-preview.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/config-file-preview.png new file mode 100644 index 00000000..1baf5d76 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/config-file-preview.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/copy-sharing-id.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/copy-sharing-id.png new file mode 100644 index 00000000..b4b87eeb Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/copy-sharing-id.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/copy-value-text-editor.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/copy-value-text-editor.png new file mode 100644 index 00000000..0398341e Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/copy-value-text-editor.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-bucket-panel (2).png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-bucket-panel (2).png new file mode 100644 index 00000000..78b82bba Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-bucket-panel (2).png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-bucket-panel.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-bucket-panel.png new file mode 100644 index 00000000..9986a67d Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-bucket-panel.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-credential.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-credential.png new file mode 100644 index 00000000..472b57bc Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-credential.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-role.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-role.png new file mode 100644 index 00000000..a475977d Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-role.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-storage-link.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-storage-link.png new file mode 100644 index 00000000..da18407f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-storage-link.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-user-privileges-diagram.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-user-privileges-diagram.png new file mode 100644 index 00000000..ce4a024b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/create-user-privileges-diagram.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/credentials-items.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/credentials-items.png new file mode 100644 index 00000000..e72729d0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/credentials-items.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/data-sharing-tile.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/data-sharing-tile.png new file mode 100644 index 00000000..cea18af0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/data-sharing-tile.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/download-private-key.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/download-private-key.png new file mode 100644 index 00000000..86b18496 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/download-private-key.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/download-public-key.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/download-public-key.png new file mode 100644 index 00000000..1e283fc0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/download-public-key.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/edit-visibility.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/edit-visibility.png new file mode 100644 index 00000000..54b30e62 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/edit-visibility.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/get-sharing-id.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/get-sharing-id.png new file mode 100644 index 00000000..88a0b8f4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/get-sharing-id.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/identify-share-provider.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/identify-share-provider.png new file mode 100644 index 00000000..60360756 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/identify-share-provider.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/load-os-data-private.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/load-os-data-private.md new file mode 100644 index 00000000..2891cc01 --- /dev/null +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/load-os-data-private.md @@ -0,0 +1,284 @@ +# Link Data from Private Object Storage Buckets + +## Introduction +In this lab, you will link to data from the MovieStream data lake on [Oracle Cloud Infrastructure Object Storage](https://www.oracle.com/cloud/storage/object-storage.html) into your Oracle Autonomous Database instance, in preparation for exploration and analysis. + +You will practice linking to data from a **private** Object Storage bucket. You learn how to set up and use an authentication token and object store credentials to access sensitive data in the private object store. Instead of using the wizard-driven data loading tools of Database Actions, you practice loading data using the **DBMS_CLOUD** PL/SQL package, the preferred method for load automation. + +> **Note:** While this lab uses Oracle Autonomous Data Warehouse, the steps are identical for loading data into an Oracle Autonomous Transaction Processing database. + +Estimated Time: 20 minutes + +### Objectives + +In this lab, you will: +- Download to your local computer a comma-separated value (.csv) file containing a simulation of sensitive customer data +- Create a private OCI Object Storage bucket +- Upload the .csv file to the OCI private bucket +- Create an object store auth token +- Define object store credentials for your autonomous database to communicate with the bucket +- Link to data from the object store using the DBMS_CLOUD PL/SQL package +- Troubleshoot the data link + +### Prerequisites + +- This lab requires completion of **Lab 1: Set up the Workshop Environment > Task 3: Create an Autonomous Data Warehouse Instance**, from the **Contents** menu on the left. + +## Task 1: Download Customer Data from a Public Bucket + +Download a **.csv** file that contains a simulation of sensitive customer retention data. Later, you will stage the file on a private **OCI Object Storage** bucket, to populate a table in later tasks. + +1. Copy and paste the following URL into a _**new tab**_ in your web browser, and then press **[ENTER]**. The **moviestream\_sandbox** Oracle Object Storage bucket that contains the data is located in a different tenancy than yours, **c4u04**. + + ``` + + https://objectstorage.us-ashburn-1.oraclecloud.com/n/c4u04/b/moviestream_sandbox/o/potential_churners/potential_churners.csv + + ``` + +2. The browser page downloads (**Downloads** directory by default in MS-Windows) and displays the **`potential_churners.csv`** file. This file contains customers who will stop or might stop being repeat customers. + + ![Download the potential_churners.csv file to your local computer.](images/potential-churners-csv-file.png " ") + +## Task 2: Create a Private Oracle Object Storage Bucket + +Create a private Object Storage bucket to store your data. For more information about Oracle Object Storage, see [Explore more about Object Storage in Oracle Cloud.](https://docs.oracle.com/en-us/iaas/Content/Object/home.htm) + + + +1. Navigate back to the Oracle Cloud Console. In your **Run Workshop** browser tab, click the **View Login Info** tab. In your **Reservation Information** panel, click the **Launch OCI** button. + + ![Click the Launch OCI button.](images/click-launch-oci.png " ") + +2. Open the **Navigation** menu in the Oracle Cloud console and click **Storage**. Under **Object Storage & Archive Storage**, click **Buckets**. + +3. On the **Buckets** page, select the compartment where you want to create the bucket from the **Compartment** drop-down list in the **List Scope** section. Make sure you are in the region where you want to create your bucket. + +4. Click **Create Bucket**. + +5. In the **Create Bucket** panel, specify the following: + - **Bucket Name:** Enter a meaningful name for the bucket. + - **Default Storage Tier:** Accept the default **Standard** storage tier. Use this tier for storing frequently accessed data that requires fast and immediate access. For infrequent access, choose the **Archive** storage tier. + - **Encryption:** Accept the default **Encrypt using Oracle managed keys**. + + >**Note:** Bucket names must be unique per tenancy and region. + +6. Click **Create** to create the bucket. + + ![The completed Create Bucket panel is displayed.](./images/create-bucket-panel.png " ") + +7. The new bucket is displayed on the **Buckets** page. The default bucket type (visibility) is **Private**. + + ![The new bucket is displayed on the Buckets page.](./images/ll-bucket-created.png " ") + + + + +1. In the **Autonomous Database** browser tab, open the **Navigation** menu in the Oracle Cloud console and click **Storage**. Under **Object Storage & Archive Storage**, click **Buckets**. + +2. On the **Buckets** page, select the compartment where you want to create the bucket from the **Compartment** drop-down list in the **List Scope** section. Make sure you are in the region where you want to create your bucket. + +3. Click **Create Bucket**. + +4. In the **Create Bucket** panel, specify the following: + - **Bucket Name:** Enter a meaningful name for the bucket. + - **Default Storage Tier:** Accept the default **Standard** storage tier. Use this tier for storing frequently accessed data that requires fast and immediate access. For infrequent access, choose the **Archive** storage tier. + - **Encryption:** Accept the default **Encrypt using Oracle managed keys**. + + >**Note:** Bucket names must be unique per tenancy and region. + +5. Click **Create** to create the bucket. + + ![The completed Create Bucket panel is displayed.](./images/create-bucket-panel.png " ") + +6. The new bucket is displayed on the **Buckets** page. The default bucket type (visibility) is **Private**. + + ![The new bucket is displayed on the Buckets page.](./images/bucket-created.png " ") + + + +## Task 3: Upload Customer Data to the Private Object Storage Bucket + +Upload the **`potential_churners.csv`** file that you downloaded earlier in this lab to your newly created private Object Storage bucket. + +1. On the **Buckets** page, click the new bucket name link. On the **Bucket Details** page, scroll down the page to the **Objects** section, and then click **Upload**. + + ![The Bucket Details page is displayed.](./images/bucket-details.png " ") + +2. In the **Upload Objects** panel, you can drag and drop a single or multiple files into the **Choose Files from your Computer** field or click **select files** to choose the file(s) that you want to upload from your computer. In this example, we used the drag-and-drop method to select the **`potential_churners.csv`** file from our **Downloads** folder. + + ![The Upload Objects panel is displayed.](./images/select-file.png " ") + +6. Click **Upload** to upload the selected file to the bucket. + +7. When the file is uploaded successfully, a **Finished** status is displayed next to the file's name. Click **Close** to close the **Upload Objects** panel. + + ![The file is uploaded. Close the panel.](./images/file-uploaded.png " ") + + The **Bucket Details** page is re-displayed. The newly uploaded file is displayed in the **Objects** section. + + ![The Upload file is displayed.](./images/uploaded-file-displayed.png " ") + +## Task 4: Locate the Base URL for the Object Storage File + +Find the base URL of the object you just uploaded to your private Object Storage bucket. + +1. On the **Bucket Details** page, scroll down to the **Objects** section. In the row for the **`potential_churners.csv`** file, click the 3-dot ellipsis icon, and then select **View Object Details** from the context menu. + + ![Select View Object Details from the ellipsis on the right of any uploaded file.](images/view-object-details.png " ") + +2. In the **Object Details** panel, copy the **URL Path (URI)** that points to the location of the file in your private Object Storage bucket up to the **`/o`** part. **_Do not include the trailing slash;otherwise, you will get an error message when you use the URL_**. Save the base URL in a text editor of your choice such as Notepad in MS-Windows. You will use this URL in the upcoming tasks. Next, click **Cancel** to close the **Object Details** page. + + ![Copy the base URL.](images/url-path.png " ") + +3. The format of the URL is as follows: + + `https://objectstorage.<`**region name**`>.oraclecloud.com/n/<`**namespace name**`>/b/<`**bucket name**`>/o` + + In our example, the **region name** is `ca-toronto-1`, the **Namespace** is blurred for security, and the **bucket name** is `training-data-lake`. + + ![The URL highlighted.](images/url.png " ") + +## Task 5: Generate an RSA Key Pair and Get the Key's Fingerprint + +_**IMPORTANT:** If you already have an RSA key pair in PEM format (minimum 2048 bits) and a fingerprint of the public key, you can skip this optional task and proceed to **Task 6**. To get your user's and tenancy's OCID, see [Where to Get the Tenancy's OCID and User's OCID](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#five); however, going through the entire task might be easier for you as you can get all the information that you need from the **Configuration File Preview** dialog box when you create your keys ._ + +In this task, you will get the following items that are required to create a Cloud location in the next task. + ++ An RSA key pair in PEM format (minimum 2048 bits). See [How to Generate an API Signing Key](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#two). ++ The Fingerprint of the public key. See [How to Get the Key's Fingerprint](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#four). ++ The Tenancy's OCID and the user's OCID. See [Where to Get the Tenancy's OCID and User's OCID](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#five). + +1. In the Console banner, click the **Profile** icon. From the drop-down menu, click your **User settings**. + + ![Click the person icon at the far upper right and click your username.](./images/click-your-username.png " ") + +2. The **User Details** page is displayed. In the **User Information** tab, click the **Copy** link next to the **OCID** field. Make a note of this username's OCID as you will need it in a later task. Scroll down the page to the **Resources** section, and then click **API Keys**. + + ![Click Auth Tokens under Resources at the bottom left.](./images/click-api-key.png " ") + +3. In the **API Keys** section, click **Add API Key**. The **Add API Key** dialog box is displayed. + + ![Click Add API Key.](./images/click-add-api-key.png " ") + +4. Click **Download Private Key**. The private key is downloaded to your Web browser's default directory such as the **Downloads** folder in MS-Windows. A checkmark is displayed next to the **Download Private Key**. + + ![Download private key.](./images/download-private-key.png " ") + + The name of the downloaded private key is usually as follows: + + **`oraclecloudidentityservice_username-date.pem`** + + Rename your downloaded private key to something shorter such as: + + **`oci-api-private-key.pem`** + +5. In most cases, you do not need to download the public key; however, you will download the public key for potential future use. click **Download Public Key**. The public key is downloaded to your Web browser's default directory such as the **Downloads** folder in MS-Windows. A checkmark is displayed next to the **Download Public Key**. + + ![Download public key.](./images/download-public-key.png " ") + + The name of the downloaded public key is usually as follows: + + **`oraclecloudidentityservice_username-date_public.pem`** + + Rename your downloaded private key to something shorter such as: + + **`oci-api-public-key.pem`** + +6. A checkmark should appear next to each Click **Add**. The key is added and the **Configuration File Preview** dialog box is displayed. The file snippet includes required parameters and values you'll need to create your configuration file. + + ![Configuration file preview.](./images/config-file-preview.png " ") + + This dialog box contains all of the information that you will need in the next task to create a new Cloud location and credential. Copy the **User's OCID**, **API Key Fingerprint**, and **Tenancy OCID** to a text editor of your choice such as Notepad in MS-Windows. You will need those values in the next task. + + ![Credentials items.](./images/credentials-items.png " ") + +7. Click **Close**. + +## Task 6: Define a Cloud Location and Create a Credential + +You will load data from the `potential_churners.csv` file you uploaded to your private Oracle Object Store in an earlier task using the `DBMS_CLOUD` PL/SQL package. There are two parts to this process: + ++ Set up a connection to Oracle Object Storage by defining a cloud location with a credential. You perform this step only once. ++ Load the file using the `DBMS_CLOUD` PL/SQL package. + +In this task, you define a **Cloud Location** to connect to Oracle Object Storage. To begin this process, you need to navigate back to the **DATA LOAD** page of **Database Actions**. + +1. On the **Oracle Cloud Console** Home page, open the **Navigation** menu and click **Oracle Database**. Under **Oracle Database**, click **Autonomous Database**. + + +2. On the **Autonomous Databases** page, click your **DB-DCAT** ADB instance. + + + +2. On the **Autonomous Databases** page, click your **ADW-Data-Lake** ADB instance. + + +3. On the **Autonomous Database details** page, click **Database actions**. + +4. The **Database Actions | Launchpad** Home page is displayed in a new tab in your browser. In the **Data Studio** section, click the **DATA LOAD** card. + + ![The Database Actions Launchpad Home page is displayed. The Data Load card in the Data Studio section is highlighted.](./images/click-data-load.png " ") + +5. In the **Administration** section, click **CLOUD LOCATIONS**, and then click **Next**. + + ![Click the Cloud Locations card.](./images/click-cloud-locations.png " ") + +6. On the **Manage Cloud Store** page, click **Add Cloud Store Location**. + + ![Click Add Cloud Storage.](./images/click-add-cloud-store-location.png " ") + +7. Specify the following in the **Add Cloud Store Location** panel. + + **Name:** Enter **`training-data-lake`**. + + **Description:** Enter an optional description. + + Select the **Create Credential** option. To access data in the Object Store, you need to enable your database user to authenticate itself with the Object Store using your OCI object store account and a credential. You do this by creating a private CREDENTIAL object for your user that stores this information encrypted in your Autonomous Data Warehouse. This information is only usable for your user schema. + + In the **Credential** section, specify the following: + + **Credential Type:** Select the **Oracle Cloud Infrastructure Signing Keys** option. + + **Credential Name:** Enter **OBJ\_STORAGE\_CRED**. **Note:** The credential name must conform to Oracle object naming conventions, which do not allow spaces or hyphens. + + **Fingerprint:** Enter the fingerprint for your RSA key pair that you copied earlier to a text file. + + **Private Key:** Paste your unencrypted private key in the RSA key pair. + Open the private key file in a text editor, and then copy the entire content from the (and including) **-----BEGIN PRIVATE KEY-----** line to (and including) the **-----END PRIVATE KEY-----** line. + ![Private key.](./images/private-key-value.png " ") + + + **Oracle Cloud Infrastructure Tenancy:** Enter your tenancy OCID that you copied earlier to a text file. + + **Oracle Cloud Infrastructure User Name:** Enter your _**user's OCID**_ (and not the actual username). _**Note:** If you did complete the optional **Task 5**, then the you should have already saved the user's OCID (and not the actual username) in a text file of your choice. If you didn't perform the optional **Task 5**, you can find the user's OCID as follows: Navigate to the **Oracle Cloud Console**. Click the **User's** drop-down list, and then select **User settings**. In the **User Details** page, in the **User Information** tab, click **Copy** next to the **OCID** field. Save this user OCID in your text file._ + + Select the **Bucket URI** option. + + **Bucket URI:** Enter the Bucket URI that you identified and saved in **Task 4**. Remember to use this general structure, swapping in your own values. _Remember, don't include the trailing slash after the **`/o`**; otherwise, you will get an error_. + + `https://objectstorage.region name.oraclecloud.com/n/namespace name/b/bucket name/o` + + ![Complete the Add Cloud Store Location.](./images/complete-add-cloud-store-location.png " ") + +8. Click **Next** to see the available objects in the bucket that you specified. There is only one file that you uploaded to your private Object Storage bucket, `potential_churners.csv`. + + ![Click Next to see the objects in the bucket.](./images/click-next.png " ") + +9. Click **Create**. The **training-data-lake** cloud location is displayed in the **Manage Cloud Store** page. + + ![The cloud store location is created.](./images/cloud-store-location-created.png " ") + +## Learn more + +* [Load Data from Files in the Cloud](https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/autonomous-data-warehouse-cloud&id=CSWHU-GUID-07900054-CB65-490A-AF3C-39EF45505802). +* [Load Data with Autonomous Database](https://docs.oracle.com/en/cloud/paas/autonomous-data-warehouse-cloud/user/load-data.html#GUID-1351807C-E3F7-4C6D-AF83-2AEEADE2F83E) + +You may now proceed to the next lab. + +## Acknowledgements + +* **Author:** + * Lauran Serhal, Consulting User Assistance Developer, Oracle Database and Big Data +* **Contributors:** + + Alexey Filanovskiy, Senior Principal Product Manager + + Rick Green, Principal Developer, Database User Assistance +* **Last Updated By/Date:** Lauran Serhal, June 2023 + +Data about movies in this workshop were sourced from Wikipedia. + +Copyright (C) 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) diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/logged-share-provider.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/logged-share-provider.png new file mode 100644 index 00000000..a37efd1a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/logged-share-provider.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/login-share-provider.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/login-share-provider.png new file mode 100644 index 00000000..a9906046 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/login-share-provider.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/logout-admin.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/logout-admin.png new file mode 100644 index 00000000..d463a5b8 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/logout-admin.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/private-key-value.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/private-key-value.png new file mode 100644 index 00000000..a9e33771 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/private-key-value.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/public-option.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/public-option.png new file mode 100644 index 00000000..531ff827 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/public-option.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-cloud-stores.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-cloud-stores.png new file mode 100644 index 00000000..c559e562 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-cloud-stores.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-credentials.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-credentials.png new file mode 100644 index 00000000..5bd6b46a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-credentials.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-identity.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-identity.png new file mode 100644 index 00000000..cc4a549e Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/query-identity.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/run-script.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/run-script.png new file mode 100644 index 00000000..e4afe267 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/run-script.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/script-results.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/script-results.png new file mode 100644 index 00000000..ddb4a056 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/script-results.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/sql-worksheet.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/sql-worksheet.png new file mode 100644 index 00000000..85e832e0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/sql-worksheet.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/user-bucket-credential-diagram.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/user-bucket-credential-diagram.png new file mode 100644 index 00000000..e56ac403 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/create-user/images/user-bucket-credential-diagram.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/data-sharing-diagram.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/data-sharing-diagram.png index c65657d2..36168e5b 100644 Binary files a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/data-sharing-diagram.png and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/data-sharing-diagram.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/users-diagram.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/users-diagram.png index 3701752d..82e0cc27 100644 Binary files a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/users-diagram.png and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/images/users-diagram.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/introduction.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/introduction.md index f7b50b0c..8afb6386 100644 --- a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/introduction.md +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/introduction/introduction.md @@ -2,7 +2,7 @@ -Data sharing enables you to share the same data with one or more consumers. Sharing data and consuming data from external sources enables collaboration with partners, establishes new partnerships, and generates new revenue streams with data monetization. The Oracle Data Sharing for general recipients is based on the open _delta sharing standard protocol_, providing a simple REST-based API to share data in `Parquet` format. +Data sharing enables you to share the same data with one or more consumers. Sharing data and consuming data from external sources enables collaboration with partners, establishes new partnerships, and generates new revenue streams with data monetization. The Oracle Data Sharing for general recipients is based on the open _delta sharing standard protocol_, providing a simple REST-based API to share data in `Parquet` format. In addition, you can implement data sharing using Database Actions in Autonomous Database (ADB) using Cloud links. Data is made accessible by the data sharing provider (such as Oracle Autonomous Database) to the data sharing recipient (such as Microsoft Power BI) at query time in `Parquet` format. The provider can only share data which they have access to when they log into an ADB instance. The parquet files are physically stored in an OCI bucket or use the bucket to store live share parquet files to cache them and improve performance. @@ -10,7 +10,7 @@ Data is made accessible by the data sharing provider (such as Oracle Autonomous There are several methods to set up and consume data sharing using: -* PL/SQL scripts using delta sharing protocol **(covered in this workshop)** +* PL/SQL scripts using delta sharing protocol * PL/SQL scripts using Cloud links **(covered in this workshop)** * Database Actions in Autonomous Database (ADB) using delta sharing protocol * Database Actions in Autonomous Database (ADB) using Cloud links @@ -56,7 +56,7 @@ While the traditional methods work in general, they come with certain _drawbacks Modern data sharing must be open, secure, real-time, vendor-agnostic, and avoid the pitfalls of extracting and duplicating data for individual consumers of data in a collaborative environment. Delta Sharing is an open protocol for secure real-time data exchange of large datasets that satisfies all these criteria, supported by multiple clients and program languages, and vendor agnostic. -The open Delta Sharing protocol is aimed to solve the following problems: +Data sharing is aimed to solve the following problems: * Share data without copying it to another system * Producer controls the state of data (version of data) @@ -67,21 +67,20 @@ The open Delta Sharing protocol is aimed to solve the following problems: * Scale to massive data sets **Important:** -In this workshop, you will assume the responsibilities of several users. Initially, you will log in as the default ADB **`admin`** user to create a **`share_provider`** user, a **`share_consumer`** user, and to perform various administration tasks. The **`share_provider`** user creates a data share recipient named **`training_user`**. In various labs, you will log in as either the **`share_provider`** user or the **`share_consumer`** user to perform the appropriate tasks associated with those users. +In this workshop, you will assume the responsibilities of several users. Initially, you will log in as the default ADB **`admin`** user to create a **`share_provider`** user, a **`share_consumer`** user, and to perform various administration tasks. The **`share_provider`** user creates a data share recipient named **`live_share_oracle_user`**. In various labs, you will log in as either the **`share_provider`** user or the **`share_consumer`** user to perform the appropriate tasks associated with those users. **_In real use cases, there will be different users performing different responsibilities._** ![The workshop users.](images/users-diagram.png) -### How Does Delta Sharing Work? +### How Does Cloud Links Data Sharing Work? -At the high level, the delta sharing protocol works as follows: +At the high level, sharing data using cloud links works as follows: * The share provider user creates and publishes a data share that can be shared with one or more recipients. * The share provider user creates and authorizes recipients. -* Every recipient will get a personal activation link to download their own `.JSON` profile with the necessary information to access their data share. -* The recipient subscribes to the data share provider by using the .JSON configuration profile. -* The recipient retrieves data from the share. +* The recipient uses the share provider's id to discover the available data shares and tables. +* The recipient subscribes to the data share provider, retrieves data from the data share, and creates a share link and a view using the data share table. ![The data sharing overview.](images/data-sharing-diagram.png) @@ -101,7 +100,7 @@ You may now proceed to the next lab. * **Contributor:** * Alexey Filanovskiy, Senior Product Manager -* **Last Updated By/Date:** Lauran K. Serhal, December 2023 +* **Last Updated By/Date:** Lauran K. Serhal, January 2024 Data about movies in this workshop were sourced from Wikipedia. diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-admin-credentials.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-admin-credentials.png new file mode 100644 index 00000000..2efc5062 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-admin-credentials.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-basic-info.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-basic-info.png new file mode 100644 index 00000000..97b3b147 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-basic-info.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-configure-db-ecpu.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-configure-db-ecpu.png new file mode 100644 index 00000000..8be1ec64 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-configure-db-ecpu.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-configure-db.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-configure-db.png new file mode 100644 index 00000000..b7343fe8 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-configure-db.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-deployment-type.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-deployment-type.png new file mode 100644 index 00000000..6526c287 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-deployment-type.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-license-type.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-license-type.png new file mode 100644 index 00000000..d765913f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-license-type.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-network-access.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-network-access.png new file mode 100644 index 00000000..58312405 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-network-access.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page copy 2.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page copy 2.png new file mode 100644 index 00000000..762de19a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page copy 2.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page copy.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page copy.png new file mode 100644 index 00000000..762de19a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page copy.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page.png new file mode 100644 index 00000000..798d8efa Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-page.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-provisioned.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-provisioned.png new file mode 100644 index 00000000..a638b359 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-provisioned.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-provisioning.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-provisioning.png new file mode 100644 index 00000000..028c40bd Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-provisioning.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-workload-type.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-workload-type.png new file mode 100644 index 00000000..810501e5 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adb-workload-type.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adw-provisioned.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adw-provisioned.png new file mode 100644 index 00000000..c5beeff5 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adw-provisioned.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adw-provisioning.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adw-provisioning.png new file mode 100644 index 00000000..4b381d18 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/adw-provisioning.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/backup-retention.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/backup-retention.png new file mode 100644 index 00000000..62b45e10 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/backup-retention.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/check-version-state.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/check-version-state.png new file mode 100644 index 00000000..03a637a9 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/check-version-state.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-adb.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-adb.png new file mode 100644 index 00000000..5c8fa816 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-adb.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-compartment.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-compartment.png new file mode 100644 index 00000000..06377bf1 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-compartment.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-glossary.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-glossary.png new file mode 100644 index 00000000..e4a97bb5 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-create-glossary.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-data-catalog.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-data-catalog.png new file mode 100644 index 00000000..b802cdb6 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-data-catalog.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-db-actions copy.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-db-actions copy.png new file mode 100644 index 00000000..8e726bd9 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-db-actions copy.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-db-actions.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-db-actions.png new file mode 100644 index 00000000..8e726bd9 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-db-actions.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-glossaries.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-glossaries.png new file mode 100644 index 00000000..e73b5af0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-glossaries.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-import.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-import.png new file mode 100644 index 00000000..2931486b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-import.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-sql-card.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-sql-card.png new file mode 100644 index 00000000..96d0d83a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/click-sql-card.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/compartment-created.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/compartment-created.png new file mode 100644 index 00000000..16bef5bf Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/compartment-created.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/copy-compartment-ocid.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/copy-compartment-ocid.png new file mode 100644 index 00000000..804ed89c Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/copy-compartment-ocid.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/copy-url-new-tab.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/copy-url-new-tab.png new file mode 100644 index 00000000..e663c42a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/copy-url-new-tab.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-compartment.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-compartment.png new file mode 100644 index 00000000..f921f5c5 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-compartment.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-data-catalog.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-data-catalog.png new file mode 100644 index 00000000..bd6e62e3 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-data-catalog.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-glossary-panel.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-glossary-panel.png new file mode 100644 index 00000000..634abced Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-glossary-panel.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-os-policy.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-os-policy.png new file mode 100644 index 00000000..1dc22f6a Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-os-policy.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-role.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-role.png new file mode 100644 index 00000000..a475977d Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/create-role.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-catalog-overview.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-catalog-overview.png new file mode 100644 index 00000000..ad35edc4 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-catalog-overview.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-catalog-page.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-catalog-page.png new file mode 100644 index 00000000..e17ef255 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-catalog-page.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-sharing-tile.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-sharing-tile.png new file mode 100644 index 00000000..cea18af0 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/data-sharing-tile.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dcat-policy-detail.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dcat-policy-detail.png new file mode 100644 index 00000000..bb3f5c81 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dcat-policy-detail.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-created.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-created.png new file mode 100644 index 00000000..d06ca96f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-created.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-details.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-details.png new file mode 100644 index 00000000..62705fba Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-details.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-instances-os-policy.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-instances-os-policy.png new file mode 100644 index 00000000..2fb3421b Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-instances-os-policy.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-page.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-page.png new file mode 100644 index 00000000..a91e1d59 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/dynamic-group-page.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/expand-all.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/expand-all.png new file mode 100644 index 00000000..45be4e79 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/expand-all.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/glossary-imported.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/glossary-imported.png new file mode 100644 index 00000000..cbfcad74 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/glossary-imported.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/import-job-initiated.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/import-job-initiated.png new file mode 100644 index 00000000..a63d7803 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/import-job-initiated.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/license-default.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/license-default.png new file mode 100644 index 00000000..e1341a73 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/license-default.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/ll-create-glossary-panel.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/ll-create-glossary-panel.png new file mode 100644 index 00000000..1eaedc8e Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/ll-create-glossary-panel.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/ll-workshop-details-section.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/ll-workshop-details-section.png new file mode 100644 index 00000000..22644d37 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/ll-workshop-details-section.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/magnify-image.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/magnify-image.png new file mode 100644 index 00000000..e049f81f Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/magnify-image.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/moviestream-dcat-policy-created.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/moviestream-dcat-policy-created.png new file mode 100644 index 00000000..3e9f3238 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/moviestream-dcat-policy-created.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/moviestream-dynamic-group-db.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/moviestream-dynamic-group-db.png new file mode 100644 index 00000000..7409a170 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/moviestream-dynamic-group-db.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-compartment.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-compartment.png new file mode 100644 index 00000000..d2d22619 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-compartment.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-data-catalog.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-data-catalog.png new file mode 100644 index 00000000..c116b500 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-data-catalog.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-dynamic-group.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-dynamic-group.png new file mode 100644 index 00000000..dda5d257 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/navigate-dynamic-group.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/note-proceed.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/note-proceed.png new file mode 100644 index 00000000..8d942063 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/note-proceed.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/object-storage-policy-detail.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/object-storage-policy-detail.png new file mode 100644 index 00000000..86245a41 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/object-storage-policy-detail.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/oracle-cloud-console-home.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/oracle-cloud-console-home.png new file mode 100644 index 00000000..701ef2c3 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/oracle-cloud-console-home.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/paste-url-new-tab.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/paste-url-new-tab.png new file mode 100644 index 00000000..43e0b16d Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/paste-url-new-tab.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/pin-items.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/pin-items.png new file mode 100644 index 00000000..097223d7 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/pin-items.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/pinned-item.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/pinned-item.png new file mode 100644 index 00000000..c70d2814 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/pinned-item.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/recent-items.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/recent-items.png new file mode 100644 index 00000000..1aa02c09 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/recent-items.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/setup-workshop-environment.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/setup-workshop-environment.md new file mode 100644 index 00000000..a3593750 --- /dev/null +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/setup-workshop-environment.md @@ -0,0 +1,198 @@ + + + +# Review the Workshop Environment Setup (Optional) + +## Introduction + +Since you are using the LiveLabs environment, you **don't** have administrative privileges to create any OCI resources; therefore, all of the OCI resources that you need in this workshop are already created for you with your LiveLabs reservation. + +If you want to review the detailed steps on how to set up the workshop environment when you are using either the **freetier** version or your own paid tenancy, see **Lab 1: Set Up the Workshop Environment** in the freetier version of the workshop on LiveLabs titled **Build a Data Lake with Autonomous Warehouse**. + +> **Note:** This lab is directed at administrator users because they are granted the required access permissions. In real life scenarios, you would create a new ADW administrator user and a ADW administrator group, and then add the new administrator user to the new group. Next, you create the Oracle Cloud Infrastructure Identity and Access Management (IAM) policies that are required to create and manage an ADW and Data Catalog instances. + +Estimated Time: 5 minutes + + + + +# Set Up the Workshop Environment + +## Introduction + +This lab walks you through the steps to set up the workshop environment. + +> **Note:** This workshop is directed at administrator users because they are have the required privileges. + +Estimated Time: 5 minutes + +### Objectives + +In this lab, you will: + +* Log in to the Oracle Cloud Console. +* (Optional) Create a compartment for your resources. +* Create an Autonomous Warehouse instance. + +### Prerequisites + +* An Oracle Cloud Account - Please view this workshop's LiveLabs landing page to see which environments are supported. + +> **Note:** If you have a **Free Trial** account, when your Free Trial expires your account will be converted to an **Always Free** account. You will not be able to conduct Free Tier workshops unless the Always Free environment is available. [Click here for the Free Tier FAQ page.](https://www.oracle.com/cloud/free/faq.html) + +## Task 1: Log in to the Oracle Cloud Console + +1. Log in to the **Oracle Cloud Console** as the Cloud Administrator. You will complete all the labs in this workshop using this Cloud Administrator. +See [Signing In to the Console](https://docs.cloud.oracle.com/en-us/iaas/Content/GSG/Tasks/signingin.htm) in the _Oracle Cloud Infrastructure_ documentation. + +2. On the **Sign In** page, select your tenancy, enter your username and password, and then click **Sign In**. + + ![The blurred username and masked password are displayed on the OCI Sign in screen. The tenancy's name and username are blurred. The Sign In button is highlighted.](./images/sign-in.png " ") + + The **Oracle Cloud Console** Home page is displayed. + + ![The partial Oracle Cloud Console Home Page is displayed.](./images/oracle-cloud-console-home.png "Partial Oracle Cloud Console is displayed.") + + >**Note:** To zoom in (magnify) a displayed image in this workshop, hover over the image to display the magnifying glass icon, and then then click the image. + + ![An example of magnifying an image. The magnifying glass icon with a plus sign is shown as hoovering over a sample image.](./images/magnify-image.png "Click an image to magnify it.") + +## Task 2: (Optional) Create a Compartment + +A Cloud Administrator can optionally create a compartment in your tenancy to help organize your resources. In this lab, as a Cloud Administrator, you will create a new compartment that will group all of your resources that you will use in the workshop. + +1. Open the **Navigation** menu and click **Identity & Security**. Under **Identity**, click **Compartments**. + + ![The Navigation menu is clicked. The navigation path to Compartments is displayed.](./images/navigate-compartment.png "Click the Navigation menu, and navigate to Compartments.") + + For faster navigation, you can pin items that you use frequently. To pin an item, hover over the menu item and then click pin to the left of the item name. + + ![An example on pinning an item such as Data Lake/Data Catalog for quicker access is shown.](./images/pin-items.png " ") + + The pinned item is displayed in the **Pinned** section of the **Home** tab the next time you use the Navigation menu. + + ![An example that shows the Compartment item pinned.](./images/pinned-item.png " ") + + The **Recently visited** section of the **Home** tab shows recently used navigation items. + + To quickly find navigation menu items, use the **Search** box. + +2. On the **Compartments** page, click **Create Compartment**. + + ![The Compartments page is displayed. The Create Compartment button is highlighted.](./images/click-create-compartment.png " ") + +3. In the **Create Compartment** dialog box, enter **`training-adw-compartment`** in the **Name** field and **`Training ADW Compartment`** in the **Description** field. + +4. In the **Parent Compartment** drop-down list, select your parent compartment, and then click **Create Compartment**. + + ![On the completed Create Compartment dialog box, click Create Compartment.](./images/create-compartment.png " ") + + The **Compartments** page is re-displayed and the newly created compartment is displayed in the list of available compartments. + + ![The newly created compartment is highlighted with its status as Active.](./images/compartment-created.png " ") + +## Task 3: Create an Autonomous Data Warehouse Instance + +1. Log in to the **Oracle Cloud Console** as the Cloud Administrator, if you are not already logged in. On the **Sign In** page, select your tenancy, enter your username and password, and then click **Sign In**. The **Oracle Cloud Console** Home page is displayed. + +2. Open the **Navigation** menu and click **Oracle Database**. Under **Oracle Database**, click **Autonomous Data Warehouse**. + +3. On the **Autonomous Databases** page, select your compartment from the **Compartment** drop-down list in the **List Scope** section. In this example, we selected our **`training-adw-compartment`**. Click **Create Autonomous Database**. The **Create Autonomous Database** page is displayed. + +4. In the **Provide basic information for the Autonomous Database** section, specify the following: + * **Compartment:** Select your own compartment. + * **Display Name:** **`ADW-Data-Lake`**. + * **Database Name:** **`TrainingADW`**. + + ![The completed "Provide basic information for the Autonomous Database" section is displayed.](./images/adb-basic-info.png " ") + +5. In the **Choose a workload type** section, accept the **Data Warehouse** default selection. + + ![The selected Data Warehouse option of the "Choose a workload type" section is displayed and highlighted.](./images/adb-workload-type.png " ") + +6. In the **Choose a deployment type** section, accept the **Serverless** default selection. + + ![The selected Shared Infrastructure option of the "Choose a deployment type" section is displayed and highlighted.](./images/adb-deployment-type.png " ") + + + + + +7. In the **Configure the database** section, accept the default selections as follows: + + * **Choose database version:** Accept the default selection. + * **ECPU count:** **`1`**. + * **Complete auto scaling:** Leave the checkbox checked (default). + * **Storage (TB):** **`1`** (TB). + * **Storage auto scaling:** Leave the checkbox unchecked (default). + + ![The completed "Configure the database" section is displayed.](./images/adb-configure-db-ecpu.png " ") + +8. In the **Backup retention** section, you can either accept the default value or specify your own preferred backup retention days value. Accept the default **60** days default value. + + ![The Backup retention section is displayed.](./images/backup-retention.png " ") + +9. In the **Create administrator credentials** section, specify the following: + + * **Username:** This read-only field displays the default administrator username, **`ADMIN`**. + **Important:** Make a note of this _username_ as you will need it to perform later tasks. + * **Password:** Enter a password for the **`ADMIN`** user of your choice such as **`Training4ADW`**. + **Important:** Make a note of this _password_ as you will need it to perform later tasks. + * **Confirm password:** Confirm your password. + + ![The completed "Create administrator credentials" section is displayed.](./images/adb-admin-credentials.png " ") + +10. In the **Choose network access** section, select the **Secure access from everywhere** option as the access type. + + ![The selected "Secure access from everywhere" option of the "Choose network access" section is displayed and highlighted.](./images/adb-network-access.png " ") + +11. In the **Choose a license and Oracle Database edition** section, accept the default selection, **This Database is provisioned with License included license type**. + + ![Accept the default license selection.](./images/license-default.png " ") + +12. Click __Create Autonomous Database__. + + ![Click create autonomous database.](./images/click-create-adb.png " ") + +13. The **Autonomous Database Details** page is displayed. The status of your ADB instance is **PROVISIONING**. + + ![The breadcrumbs and PROVISIONING Status on the Autonomous Database Details page are highlighted.](./images/adw-provisioning.png " ") + + A **Check database lifcycle state** informational box is displayed. You can navigate through this tour or choose to skip it. Click **Skip tour**. A **Skip guided tour** dialog box is displayed. Click **Skip**. + + In a few minutes, the instance status changes to **AVAILABLE**. At this point, your Autonomous Data Warehouse database instance is ready to use! Review your instance's details including its name, database version, OCPU count, and storage size. + + ![The breadcrumbs and AVAILABLE Status on the Autonomous Database Details page are highlighted. The Autonomous Database Information tab displays many details about your provisioned database.](./images/adb-provisioned.png " ") + +14. Click the **Autonomous Database** link in the breadcrumbs. The **Autonomous Database** page is displayed. The new Autonomous Database instance is displayed. + + ![The provisioned Autonomous Database instance is displayed on the Autonomous Databases page. The state of the instance is AVAILABLE.](./images/adb-page.png " ") + +You may now proceed to the next lab. + +## Learn More + +* [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 +* **Last Updated By/Date:** Lauran Serhal, August 2023 + +Data about movies in this workshop were sourced from Wikipedia. + +Copyright (C) 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](https://oracle-livelabs.github.io/adb/shared/adb-15-minutes/introduction/files/gnu-free-documentation-license.txt) diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/sign-in.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/sign-in.png new file mode 100644 index 00000000..83cf1c98 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/sign-in.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/specify-url.png b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/specify-url.png new file mode 100644 index 00000000..2c467714 Binary files /dev/null and b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/images/specify-url.png differ diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/setup-workshop-environment.md b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/setup-workshop-environment.md new file mode 100644 index 00000000..342808a9 --- /dev/null +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/setup-workshop-environment/setup-workshop-environment.md @@ -0,0 +1,199 @@ + + + +# Review the Workshop Environment Setup (Optional) + +## Introduction + +Since you are using the LiveLabs environment, you **don't** have administrative privileges to create any OCI resources; therefore, all of the OCI resources that you need in this workshop are already created for you with your LiveLabs reservation. + +If you want to review the detailed steps on how to set up the workshop environment when you are using either the **freetier** version or your own paid tenancy, see **Lab 1: Set Up the Workshop Environment** in the freetier version of the workshop on LiveLabs titled **Build a Data Lake with Autonomous Warehouse**. + +> **Note:** This lab is directed at administrator users because they are granted the required access permissions. In real life scenarios, you would create a new ADW administrator user and a ADW administrator group, and then add the new administrator user to the new group. Next, you create the Oracle Cloud Infrastructure Identity and Access Management (IAM) policies that are required to create and manage an ADW and Data Catalog instances. + +Estimated Time: 5 minutes + + + + +# Set Up the Workshop Environment + +## Introduction + +This lab walks you through the steps to set up the workshop environment. + +> **Note:** This workshop is directed at administrator users because they are have the required privileges. + +Estimated Time: 5 minutes + +### Objectives + +In this lab, you will: + +* Log in to the Oracle Cloud Console. +* (Optional) Create a compartment for your resources. +* Create an Autonomous Warehouse instance. + +### Prerequisites + +* An Oracle Cloud Account - Please view this workshop's LiveLabs landing page to see which environments are supported. + +> **Note:** If you have a **Free Trial** account, when your Free Trial expires your account will be converted to an **Always Free** account. You will not be able to conduct Free Tier workshops unless the Always Free environment is available. [Click here for the Free Tier FAQ page.](https://www.oracle.com/cloud/free/faq.html) + +## Task 1: Log in to the Oracle Cloud Console + +1. Log in to the **Oracle Cloud Console** as the Cloud Administrator. You will complete all the labs in this workshop using this Cloud Administrator. +See [Signing In to the Console](https://docs.cloud.oracle.com/en-us/iaas/Content/GSG/Tasks/signingin.htm) in the _Oracle Cloud Infrastructure_ documentation. + +2. On the **Sign In** page, select your tenancy, enter your username and password, and then click **Sign In**. + + ![The blurred username and masked password are displayed on the OCI Sign in screen. The tenancy's name and username are blurred. The Sign In button is highlighted.](./images/sign-in.png " ") + + The **Oracle Cloud Console** Home page is displayed. + + ![The partial Oracle Cloud Console Home Page is displayed.](./images/oracle-cloud-console-home.png "Partial Oracle Cloud Console is displayed.") + + >**Note:** To zoom in (magnify) a displayed image in this workshop, hover over the image to display the magnifying glass icon, and then then click the image. + + ![An example of magnifying an image. The magnifying glass icon with a plus sign is shown as hoovering over a sample image.](./images/magnify-image.png "Click an image to magnify it.") + +## Task 2: (Optional) Create a Compartment + +A Cloud Administrator can optionally create a compartment in your tenancy to help organize your resources. In this lab, as a Cloud Administrator, you will create a new compartment that will group all of your resources that you will use in the workshop. + +1. Open the **Navigation** menu and click **Identity & Security**. Under **Identity**, click **Compartments**. + + ![The Navigation menu is clicked. The navigation path to Compartments is displayed.](./images/navigate-compartment.png "Click the Navigation menu, and navigate to Compartments.") + + For faster navigation, you can pin items that you use frequently. To pin an item, hover over the menu item and then click pin to the left of the item name. + + ![An example on pinning an item such as Data Lake/Data Catalog for quicker access is shown.](./images/pin-items.png " ") + + The pinned item is displayed in the **Pinned** section of the **Home** tab the next time you use the Navigation menu. + + ![An example that shows the Compartment item pinned.](./images/pinned-item.png " ") + + The **Recently visited** section of the **Home** tab shows recently used navigation items. + + To quickly find navigation menu items, use the **Search** box. + +2. On the **Compartments** page, click **Create Compartment**. + + ![The Compartments page is displayed. The Create Compartment button is highlighted.](./images/click-create-compartment.png " ") + +3. In the **Create Compartment** dialog box, enter **`training-adw-compartment`** in the **Name** field and **`Training ADW Compartment`** in the **Description** field. + +4. In the **Parent Compartment** drop-down list, select your parent compartment, and then click **Create Compartment**. + + ![On the completed Create Compartment dialog box, click Create Compartment.](./images/create-compartment.png " ") + + The **Compartments** page is re-displayed and the newly created compartment is displayed in the list of available compartments. + + ![The newly created compartment is highlighted with its status as Active.](./images/compartment-created.png " ") + +## Task 3: Create an Autonomous Data Warehouse Instance + +1. Log in to the **Oracle Cloud Console** as the Cloud Administrator, if you are not already logged in. On the **Sign In** page, select your tenancy, enter your username and password, and then click **Sign In**. The **Oracle Cloud Console** Home page is displayed. + +2. Open the **Navigation** menu and click **Oracle Database**. Under **Oracle Database**, click **Autonomous Data Warehouse**. + +3. On the **Autonomous Databases** page, select your compartment from the **Compartment** drop-down list in the **List Scope** section. In this example, we selected our **`training-adw-compartment`**. Click **Create Autonomous Database**. The **Create Autonomous Database** page is displayed. + +4. In the **Provide basic information for the Autonomous Database** section, specify the following: + * **Compartment:** Select your own compartment. + * **Display Name:** **`ADW-Data-Lake`**. + * **Database Name:** **`TrainingADW`**. + + ![The completed "Provide basic information for the Autonomous Database" section is displayed.](./images/adb-basic-info.png " ") + +5. In the **Choose a workload type** section, accept the **Data Warehouse** default selection. + + ![The selected Data Warehouse option of the "Choose a workload type" section is displayed and highlighted.](./images/adb-workload-type.png " ") + +6. In the **Choose a deployment type** section, accept the **Serverless** default selection. + + ![The selected Shared Infrastructure option of the "Choose a deployment type" section is displayed and highlighted.](./images/adb-deployment-type.png " ") + + + + + +7. In the **Configure the database** section, accept the default selections as follows: + + * **Always Free:** An Always Free database is especially useful for development and trying new features. You can deploy an Always Free instance in an Always Free account or a paid account. The only option you can specify in an Always Free database is the database version. For this lab, we recommend that you leave the **Always Free** option disabled unless you are in an Always Free account. + * **Choose database version:** Accept the default selection. + * **ECPU count:** **`2`**. + * **Compute auto scaling:** Leave the checkbox checked (default). + * **Storage (TB):** **`1`** (TB). + * **Storage auto scaling:** Leave the checkbox unchecked (default). + + ![The completed "Configure the database" section is displayed.](./images/adb-configure-db-ecpu.png " ") + +8. In the **Backup retention** section, you can either accept the default value or specify your own preferred backup retention days value. Accept the default **60** days default value. + + ![The Backup retention section is displayed.](./images/backup-retention.png " ") + +9. In the **Create administrator credentials** section, specify the following: + + * **Username:** This read-only field displays the default administrator username, **`ADMIN`**. + **Important:** Make a note of this _username_ as you will need it to perform later tasks. + * **Password:** Enter a password for the **`ADMIN`** user of your choice such as **`Training4ADW`**. + **Important:** Make a note of this _password_ as you will need it to perform later tasks. + * **Confirm password:** Confirm your password. + + ![The completed "Create administrator credentials" section is displayed.](./images/adb-admin-credentials.png " ") + +10. In the **Choose network access** section, select the **Secure access from everywhere** option as the access type. + + ![The selected "Secure access from everywhere" option of the "Choose network access" section is displayed and highlighted.](./images/adb-network-access.png " ") + +11. In the **Choose a license and Oracle Database edition** section, accept the default selection, **This Database is provisioned with License included license type**. + + ![Accept the default license selection.](./images/license-default.png " ") + +12. Click __Create Autonomous Database__. + + ![Click create autonomous database.](./images/click-create-adb.png " ") + +13. The **Autonomous Database details** page is displayed. The status of your ADB instance is **PROVISIONING**. + + ![The breadcrumbs and PROVISIONING Status on the Autonomous Database Details page are highlighted.](./images/adw-provisioning.png " ") + + A **Check database lifecycle state** informational box is displayed. You can navigate through this tour or choose to skip it. Click **Skip tour**. A **Skip guided tour** dialog box is displayed. Click **Skip**. + + In a few minutes, the instance status changes to **AVAILABLE**. At this point, your Autonomous Data Warehouse database instance is ready to use! Review your instance's details including its name, database version, ECPU count, and storage size. + + ![The breadcrumbs and AVAILABLE Status on the Autonomous Database Details page are highlighted. The Autonomous Database Information tab displays many details about your provisioned database.](./images/adb-provisioned.png " ") + +14. Click the **Autonomous Database** link in the breadcrumbs. The **Autonomous Database** page is displayed. The new Autonomous Database instance is displayed. + + ![The provisioned Autonomous Database instance is displayed on the Autonomous Databases page. The state of the instance is AVAILABLE.](./images/adb-page.png " ") + +You may now proceed to the next lab. + +## Learn More + +* [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 +* **Last Updated By/Date:** Lauran Serhal, January 2024 + +Data about movies in this workshop were sourced from Wikipedia. + +Copyright (C) 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](https://oracle-livelabs.github.io/adb/shared/adb-15-minutes/introduction/files/gnu-free-documentation-license.txt) diff --git a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/workshops/freetier/manifest.json b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/workshops/freetier/manifest.json index 55d86737..9938b56a 100644 --- a/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/workshops/freetier/manifest.json +++ b/shared/adw-data-lake/use-data-sharing-cloud-links-plsql/workshops/freetier/manifest.json @@ -1,5 +1,5 @@ { - "workshoptitle": "Implement Data Sharing with PL/SQL", + "workshoptitle": " Set up live data sharing between Oracle Databases using Cloud Links and PL/SQL APIs", "help": "livelabs-help-db_us@oracle.com", "tutorials": [ { @@ -20,10 +20,10 @@ "filename": "./../../setup-workshop-environment/setup-workshop-environment.md" }, { - "title": "Lab 2: Create a User, an Object Storage Bucket, and an OCI Credential", + "title": "Lab 2: Create a Share Provider User", "type":"freetier", - "description": "This lab walks you through how to load local data into your ADW instance.", - "filename": "./../../create-user-storage-credentials/create-user-storage-credentials.md" + "description": "This lab walks you through how to create a share provider user.", + "filename": "./../../create-user/create-user.md" }, { "title": "Lab 3: Create, Populate, and Publish a Data Share",