From ae16c9a0ec91f5459ca3e0a0d0ed0c647f89a964 Mon Sep 17 00:00:00 2001 From: Marty Date: Tue, 5 Mar 2024 09:42:49 -0500 Subject: [PATCH] Update to building blocks documentation (#241) * fix graph comment * update to blocks documentation * Added moviestream login to block * ECPU update * minor update to images for ECPUs * Updates due to ADB UX chages * minor change to always free text * Blocks changes due to ux updates * lint checker fix for an image alt * OCPU to ECPU in variable file * fixed an old image * update to building blocks doc. --------- Co-authored-by: Kevin Lazarz --- .../how-to-author-with-blocks/adb.md | 66 +++++++++++++++++++ .../all-blocks-tasks.md | 9 ++- .../workshop/manifest.json | 3 + .../workshop/freetier/manifest.json | 8 +++ 4 files changed, 85 insertions(+), 1 deletion(-) diff --git a/building-blocks/how-to-author-with-blocks/adb.md b/building-blocks/how-to-author-with-blocks/adb.md index 7212e014..18e11462 100644 --- a/building-blocks/how-to-author-with-blocks/adb.md +++ b/building-blocks/how-to-author-with-blocks/adb.md @@ -1,4 +1,26 @@ # Tasks for OCI Service: ADB +## Delete your workshop resources +**Markdown file location:** +``` +/common/building-blocks/tasks/adb/cleanup.md +``` + +**Add to your manifest.json:** +``` +"include": { + "adb-cleanup.md":"/common/building-blocks/tasks/adb/cleanup.md" +} +``` + +**Add to your workshop markdown:** +``` +[](include:adb-cleanup.md) +``` + +**Markdown Output ↓↓:** + +[](include:adb-cleanup.md) + ## Connect with SQL Worksheet **Markdown file location:** ``` @@ -21,6 +43,28 @@ [](include:adb-connect-with-sql-worksheet-body.md) +## Connect with SQL Worksheet as non-admin user +**Markdown file location:** +``` +/common/building-blocks/tasks/adb/connect-with-sql-worksheet-non-admin.md +``` + +**Add to your manifest.json:** +``` +"include": { + "adb-connect-with-sql-worksheet-non-admin.md":"/common/building-blocks/tasks/adb/connect-with-sql-worksheet-non-admin.md" +} +``` + +**Add to your workshop markdown:** +``` +[](include:adb-connect-with-sql-worksheet-non-admin.md) +``` + +**Markdown Output ↓↓:** + +[](include:adb-connect-with-sql-worksheet-non-admin.md) + ## Create Graph **Markdown file location:** ``` @@ -87,6 +131,28 @@ [](include:adb-create-user.md) +## Generate an RSA key pair +**Markdown file location:** +``` +/common/building-blocks/tasks/adb/generate-rsa-key-pair.md +``` + +**Add to your manifest.json:** +``` +"include": { + "adb-generate-rsa-key-pair.md":"/common/building-blocks/tasks/adb/generate-rsa-key-pair.md" +} +``` + +**Add to your workshop markdown:** +``` +[](include:adb-generate-rsa-key-pair.md) +``` + +**Markdown Output ↓↓:** + +[](include:adb-generate-rsa-key-pair.md) + ## Go to Data Load Utility Database Action **Markdown file location:** ``` diff --git a/building-blocks/how-to-author-with-blocks/all-blocks-tasks.md b/building-blocks/how-to-author-with-blocks/all-blocks-tasks.md index 0fccd557..8859a559 100644 --- a/building-blocks/how-to-author-with-blocks/all-blocks-tasks.md +++ b/building-blocks/how-to-author-with-blocks/all-blocks-tasks.md @@ -8,6 +8,7 @@ Building Blocks are exposed to customers. You can use these same blocks in your | Cloud Service | Block | File | Description | |---------------| ---- | ---- |------------ | | setup | [Add Workshop Utilities](/common/building-blocks/workshop/freetier/index.html?lab=add-workshop-utilities) | /common/building-blocks /setup/add-workshop-utilities.md| Utilities for adding data sets and users | +| adb | [Delete your workshop resources](/common/building-blocks/workshop/freetier/index.html?lab=cleanup.md) | /common/building-blocks/blocks/adb/cleanup/cleanup.md | Delete some or all of the resources that you created in the workshop | | adb | [Connect with SQL Worksheet](/common/building-blocks/workshop/freetier/index.html?lab=connect-sql-worksheet.md) | /common/building-blocks/blocks/adb/connect/connect-sql-worksheet.md | Connect to Autonomous Database using the SQL Worksheet in Database Actions | | adb | [Load and Analyze Data from REST Services](/common/building-blocks/workshop/freetier/index.html?lab=load-analyze-rest.md) | /common/building-blocks/blocks/adb/load-analyze-rest/load-analyze-rest.md | Analyze data sourced from REST services. Using the News API as an example. | | adb | [Use Database Actions Data Loading for Object Store data](/common/building-blocks/workshop/freetier/index.html?lab=load-data-tools.md) | /common/building-blocks/blocks/adb/load-data/load-data-tools.md | Use the Database Actions tooling to easily load data from object storage. | @@ -22,10 +23,13 @@ Building Blocks are exposed to customers. You can use these same blocks in your Listed below are the tasks that you can incorporate into your markdown. You can also use the navigation tree on the left to view the tasks. Again, contribute to the list of tasks! | Cloud Service | Task | File | Description | |---------------| ---- | ---- |------------ | +| adb | [Delete your workshop resources](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#Deleteyourworkshopresources) | /common/building-blocks/tasks/adb/cleanup.md | Delete some or all of the resources that you created in the workshop | | adb | [Connect with SQL Worksheet](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#ConnectwithSQLWorksheet) | /common/building-blocks/tasks/adb/connect-with-sql-worksheet-body.md | Connect to Autonomous Database using the SQL Worksheet in Database Actions | +| adb | [Connect with SQL Worksheet as non-admin user](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#ConnectwithSQLWorksheetasnonadminuser) | /common/building-blocks/tasks/adb/connect-with-sql-worksheet-non-admin.md | Connect to Autonomous Database using the SQL Worksheet in Database Actions. Non-admin user. | | adb | [Create Graph](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#CreateGraph) | /common/building-blocks/tasks/adb/create-graph.md | Create a bipartite Graph for MOVIESTREAM watched movies. | | adb | [Create and load JSON Collection from object storage](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#CreateandloadJSONCollectionfromobjectstorage) | /common/building-blocks/tasks/adb/create-load-json-collection.md | | | adb | [Create ADB User using Database Actions](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#CreateADBUserusingDatabaseActions) | /common/building-blocks/tasks/adb/create-user.md | Creates an ADB user using the new user database action | +| adb | [Generate an RSA key pair](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#GenerateanRSAkeypair) | /common/building-blocks/tasks/adb/generate-rsa-key-pair.md | Generate an RSA key pair and get the key's values and fingerprint | | adb | [Go to Data Load Utility Database Action](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#GotoDataLoadUtilityDatabaseAction) | /common/building-blocks/tasks/adb/goto-data-load-utility.md | Navigate to data loader. AUTHORS: For expediency, this task uses the ADMIN user/password to open Database Actions. In your workshop, you might want to substitute a different user/password to open Database Actions. | | adb | [Go to Graph Studio](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#GotoGraphStudio) | /common/building-blocks/tasks/adb/goto-graph-studio.md | Login to Graph Studio from the Autonomous Database OCI console | | adb | [Go to Autonomous Database Service](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#GotoAutonomousDatabaseService) | /common/building-blocks/tasks/adb/goto-service-body.md | Navigate to ADB using the OCI menu. AUTHORS: For expediency, this task uses the ADMIN user/password to open Database Actions. In your workshop, you might want to substitute a different user/password to open Database Actions. | @@ -33,7 +37,7 @@ Listed below are the tasks that you can incorporate into your markdown. You can | adb | [Load data from public buckets using Database Actions](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#LoaddatafrompublicbucketsusingDatabaseActions) | /common/building-blocks/tasks/adb/load-public-db-actions-15-min-quickstart.md | Uses Database Actions to load data from public object storage buckets. It loads the following two tables: | | adb | [Load data from public buckets using Database Actions. Sales data not included.](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#LoaddatafrompublicbucketsusingDatabaseActionsSalesdatanotincluded) | /common/building-blocks/tasks/adb/load-public-db-actions-no-sales.md | Uses Database Actions to load data from public object storage buckets. It loads the following tables:

To load sales_sample, use task **Load data from public buckets using Database Actions** | | adb | [Load data from public buckets using Database Actions](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#LoaddatafrompublicbucketsusingDatabaseActions) | /common/building-blocks/tasks/adb/load-public-db-actions.md | Uses Database Actions to load data from public object storage buckets. It loads the following tables:

| -| adb | [Provision Autonomous Database](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#ProvisionAutonomousDatabase) | /common/building-blocks/tasks/adb/provision-body.md | Provision an ADB. Use the `variables.json` file to update provisioning parameters, including database name, OCPUs, storage and more. | +| adb | [Provision Autonomous Database](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#ProvisionAutonomousDatabase) | /common/building-blocks/tasks/adb/provision-body.md | Provision an ADB. Use the `variables.json` file to update provisioning parameters, including database name, ECPUs, storage and more. | | adb | [Query JSON arrays](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#QueryJSONarrays) | /common/building-blocks/tasks/adb/query-json-arrays.md | Use JSON_TABLE to convert arrays into rows. | | adb | [Query simple JSON attributes](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#QuerysimpleJSONattributes) | /common/building-blocks/tasks/adb/query-json-simple.md | Use dot notation and JSON_VALUE to query JSON documents. Creates a view to simplify subsequent access. | | adb | [Query Object Storage contents with SQL](/common/building-blocks/how-to-author-with-blocks/workshop/index.html?lab=adb#QueryObjectStoragecontentswithSQL) | /common/building-blocks/tasks/adb/query-object-store-contents-with-sql.md | Use SQL to see listing of object storage files and folders. | @@ -57,10 +61,13 @@ The template assumes you copied the default **variables.json** to the same direc { "workshoptitle":"LiveLabs Workshop Template", "include": { + "adb-cleanup.md":"/common/building-blocks/tasks/adb/cleanup.md", "adb-connect-with-sql-worksheet-body.md":"/common/building-blocks/tasks/adb/connect-with-sql-worksheet-body.md", + "adb-connect-with-sql-worksheet-non-admin.md":"/common/building-blocks/tasks/adb/connect-with-sql-worksheet-non-admin.md", "adb-create-graph.md":"/common/building-blocks/tasks/adb/create-graph.md", "adb-create-load-json-collection.md":"/common/building-blocks/tasks/adb/create-load-json-collection.md", "adb-create-user.md":"/common/building-blocks/tasks/adb/create-user.md", + "adb-generate-rsa-key-pair.md":"/common/building-blocks/tasks/adb/generate-rsa-key-pair.md", "adb-goto-data-load-utility.md":"/common/building-blocks/tasks/adb/goto-data-load-utility.md", "adb-goto-graph-studio.md":"/common/building-blocks/tasks/adb/goto-graph-studio.md", "adb-goto-service-body.md":"/common/building-blocks/tasks/adb/goto-service-body.md", diff --git a/building-blocks/how-to-author-with-blocks/workshop/manifest.json b/building-blocks/how-to-author-with-blocks/workshop/manifest.json index 5b6a5f37..fb83cd7a 100644 --- a/building-blocks/how-to-author-with-blocks/workshop/manifest.json +++ b/building-blocks/how-to-author-with-blocks/workshop/manifest.json @@ -1,10 +1,13 @@ { "workshoptitle":"LiveLabs Building Blocks", "include": { + "adb-cleanup.md":"/common/building-blocks/tasks/adb/cleanup.md", "adb-connect-with-sql-worksheet-body.md":"/common/building-blocks/tasks/adb/connect-with-sql-worksheet-body.md", + "adb-connect-with-sql-worksheet-non-admin.md":"/common/building-blocks/tasks/adb/connect-with-sql-worksheet-non-admin.md", "adb-create-graph.md":"/common/building-blocks/tasks/adb/create-graph.md", "adb-create-load-json-collection.md":"/common/building-blocks/tasks/adb/create-load-json-collection.md", "adb-create-user.md":"/common/building-blocks/tasks/adb/create-user.md", + "adb-generate-rsa-key-pair.md":"/common/building-blocks/tasks/adb/generate-rsa-key-pair.md", "adb-goto-data-load-utility.md":"/common/building-blocks/tasks/adb/goto-data-load-utility.md", "adb-goto-graph-studio.md":"/common/building-blocks/tasks/adb/goto-graph-studio.md", "adb-goto-service-body.md":"/common/building-blocks/tasks/adb/goto-service-body.md", diff --git a/building-blocks/workshop/freetier/manifest.json b/building-blocks/workshop/freetier/manifest.json index a934c877..db792855 100644 --- a/building-blocks/workshop/freetier/manifest.json +++ b/building-blocks/workshop/freetier/manifest.json @@ -1,10 +1,13 @@ { "workshoptitle":"LiveLabs Building Blocks", "include": { + "adb-cleanup.md":"/common/building-blocks/tasks/adb/cleanup.md", "adb-connect-with-sql-worksheet-body.md":"/common/building-blocks/tasks/adb/connect-with-sql-worksheet-body.md", + "adb-connect-with-sql-worksheet-non-admin.md":"/common/building-blocks/tasks/adb/connect-with-sql-worksheet-non-admin.md", "adb-create-graph.md":"/common/building-blocks/tasks/adb/create-graph.md", "adb-create-load-json-collection.md":"/common/building-blocks/tasks/adb/create-load-json-collection.md", "adb-create-user.md":"/common/building-blocks/tasks/adb/create-user.md", + "adb-generate-rsa-key-pair.md":"/common/building-blocks/tasks/adb/generate-rsa-key-pair.md", "adb-goto-data-load-utility.md":"/common/building-blocks/tasks/adb/goto-data-load-utility.md", "adb-goto-graph-studio.md":"/common/building-blocks/tasks/adb/goto-graph-studio.md", "adb-goto-service-body.md":"/common/building-blocks/tasks/adb/goto-service-body.md", @@ -33,6 +36,11 @@ "title": "Add Workshop Utilities", "filename": "/common/building-blocks/setup/add-workshop-utilities.md" }, + { + "title": "[adb] Delete your workshop resources", + "type": "freetier", + "filename": "/common/building-blocks/blocks/adb/cleanup/cleanup.md" + }, { "title": "[adb] Connect with SQL Worksheet", "type": "freetier",