oracle-devrel · madhusudhanrao-ppm · Jan 21, 2026 · Jan 26, 2026 · Jan 28, 2026 · Jan 28, 2026
diff --git a/notebooks/create-oracleaidb26ai-devrel/createadb26ai-dev.md b/notebooks/create-oracleaidb26ai-devrel/createadb26ai-dev.md
@@ -0,0 +1,300 @@
+# How can I create an Oracle Autonomous AI Database for Developers with Terraform?
+
+## Introduction
+
+Autonomous AI Database for Developers provides you with low cost instances for developers and others to build and test new Autonomous AI Database applications.
+
+Autonomous AI Database for Developers are low-cost, fixed shape databases intended for development and testing uses cases, and are not recommended for production use cases. When you need more compute or storage resources or you want to take advantage of additional Autonomous AI Database features, you can upgrade your Autonomous AI Database for Developers instance to a full paid service instance. 
+
+With Oracle Autonomous AI Database you can work on many tools such as 
+
+* Oracle APEX
+* Database Actions
+* Graph Studio
+* Oracle Machine Learning user interface
+* Data Transforms
+* Web Access (ORDS)
+* MongoDB API 
+* Data Lake Accelerator  
+* SODA Drivers
+
+Estimated Time: 2 to 5 minutes (max).  
+
+### Objectives
+
+In this short sprint, you will:
+
+* Create an Oracle Autonomous AI Database for Developers using Oracle Resource Manager Stack. 
+* View Oracle Autonomous AI Database and Developer Tools.
+* (Optional) Create Oracle Autonomous AI Database for Developers using Oracle Terraform Command Line Interface CLI.
+* (Optional) Download Database Wallet, Note Connection Details and Create Database User
+* Cleanup the resources created.
+
+    [Demo video on Create Oracle Autonomous AI Database](youtube:V2PETW_F7XI:large) 
+
+### Prerequisites
+
+This lab assumes you have:
+
+* Oracle cloud account and privileges to create & manage Oracle Autonomous AI Database
+* Option 1: [Direct ORM deployment link](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://objectstorage.us-phoenix-1.oraclecloud.com/p/jtfUsV33KtLR937hWybAgrq8qtuQQuAaIw1K_VBThhlUF6Z1HYF0Ai50sQlp06bQ/n/oradbclouducm/b/medical_transcripts/o/Terraform/oracle-lakehouse-devedition-stack.zip)
+* Option 2: Download the source code from the following GitHub location or use this [.zip file direct download link](https://objectstorage.us-phoenix-1.oraclecloud.com/p/jtfUsV33KtLR937hWybAgrq8qtuQQuAaIw1K_VBThhlUF6Z1HYF0Ai50sQlp06bQ/n/oradbclouducm/b/medical_transcripts/o/Terraform/oracle-lakehouse-devedition-stack.zip)
+
+    ```
+    -- Clone the GitHub Repo
+    gh repo clone oracle-devrel/oracle-ai-developer-hub
+
+    or /sourcecode folder 
+
+    ```
+
+The **source code** folder has two subfolders 
+
+1. The folder **oracle-lakehouse-devedition-cli** has source code for Terraform command line interface, 
+2. The folder **oracle-lakehouse-devedition-stack** has source code Oracle Resource Manager zip file. you can also directly upload **oracle-lakehouse-devedition-stack.zip** file which has preconfigured values.
+
+
+## Create an Oracle Resource Manager Stack
+
+1. Create an Autonomous AI Database using the Resource Manager Stack. You can either use the [Direct ORM deployment link](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://objectstorage.us-phoenix-1.oraclecloud.com/p/jtfUsV33KtLR937hWybAgrq8qtuQQuAaIw1K_VBThhlUF6Z1HYF0Ai50sQlp06bQ/n/oradbclouducm/b/medical_transcripts/o/Terraform/oracle-lakehouse-devedition-stack.zip) or download the source code from the GitHub location mentioned in the Prerequisites section and upload the **oracle-lakehouse-devedition-stack.zip** file.
+
+    > Please Note: Billing for Autonomous AI Database for Developers databases is hourly per instance. please see more info section
+
+2. Log in to https://cloud.oracle.com from the top left navigation select **Developer Services** and **Stacks** under **Resource Manager** 
+
+    ![Navigation](images/01-navigation.png )
+
+3. Click on the **Create Stack** button. Upload the .zip file 
+
+    ![Create Stack](images/02-createstack.png )
+
+4. Provide the Stack Information. You can also accept the default values provided. Ensure that you select the right compartment, click **Next** button and verify the configuration variables, change the password as you prefer. 
+
+5. Ensure that the compartment id is correct, and click **Next** button.
+
+    ![Navigation](images/03-schema.png  )
+
+6. Review Stack Information. Check on **Run apply** and **Create** button. 
+
+    ![Apply](images/04-apply.png )
+
+    This will create ORM (Oracle Resource Manager) Job. 
+
+    ![ORM Job](images/05-orm.png )
+
+7. View the logs. 
+
+    ![Logs](images/06-logs.png )
+
+8. Our AI Database is now created in 1 minute and 15 seconds.  
+
+    ![Logs](images/07-logs.png ) 
+
+    > Please Note: Sometimes the time to create might slightly change to 2 and a half mins depending on the region and/or internet speed. 
+
+    ORM Job Success message
+
+    ![ORM](images/08-orm.png )
+
+## View Oracle Autonomous AI Database and Developer Tools
+
+1.   From the left navigation, select **Oracle AI Database** and **Oracle Autonomous AI Database**
+
+    ![ADB view](images/11-adb2.png )
+
+
+2. View the newly created Oracle Autonomous AI Database, with the Developer tag on the right side of the name.
+
+    ![ADB](images/10-adb.png  )
+
+    Click on the link, which will show all the enabled features and Tools
+
+    ![Tools](images/12-alloptions.png  ) 
+
+    * Oracle APEX
+    * Database Actions
+    * Graph Studio
+    * Oracle Machine Learning user interface
+    * Data Transforms
+    * Web Access (ORDS)
+    * MongoDB API 
+    * Data Lake Accelerator  
+    * SODA Drivers
+
+3. Copy the link and open the required tools.
+
+    ![SQL](images/13-sql.png  )
+
+    From the database actions menu, select View all database actions or select **SQL**
+
+    ![SQL Run](images/14-sql2.png )
+
+    In the **SQL Worksheet**, you can see the default **SH Schema** already pre-created, You can start using this worksheet with an example SQL
+
+        ```
+        SELECT * from SH.COUNTRIES
+        ```
+
+    Clean up the created resources by going back to the Resource Manager Stack and clicking on the **Destroy** button.
+
+    Click on the Destroy confirmation button.
+
+
+## (Optional) Create Oracle Autonomous AI Database for Developers using Oracle Terraform Command Line Interface CLI
+
+1. Install Terraform CLI, Please check this link on [Terraform CLI Installation for OCI](https://developer.hashicorp.com/terraform/tutorials/oci-get-started/install-cli) 
+
+    ```
+    % brew tap hashicorp/tap
+    % brew install hashicorp/tap/terraform
+
+    -- Verify installation
+    % terraform -help
+
+    % terraform -v   
+    Terraform v1.13.4
+    on darwin_amd64
+    ```
+
+2. Install OCI CLI, Please refer the [Quick start guide] (https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm)
+
+    ```
+    % brew update && brew install oci-cli
+
+    -- Verify installation
+    % oci -v
+    3.62.1
+    ```
+
+3. Configure OCI CLI, Please check [CLI configuration](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliconfigure.htm) document
+
+    replace  <Your-User-OCID\> , <Your-OCI-Finterprint\>, <Your-Region\> for example us-phoenix-1, <Your-key-file\> Your SSH Key file with complete path
+
+    ```
+    % cat ~/.oci/config                                                                                         
+    [DEFAULT]
+    user=ocid1.user.oc1..<Your-User-OCID>
+    fingerprint=<Your-OCI-Finterprint>
+    tenancy=ocid1.tenancy.oc1..<Your-Tenancy-OCID> 
+    region=<Your-Region>
+    key_file=/Users/<Your-Folder>/<Your-key-file>.pem 
+    ```  
+
+4. View and Edit the Terraform source code main.tf by replacing <Your-Compartment-Id\>, <Your-DB-Name\>, <Your-DB-Display-Name\> and <Your-Password\> as appropriate for your tenancy and database creation
+
+    ```
+    provider "oci" {}
+
+    resource "oci_database_autonomous_database" "oci_database_autonomous_database" { 
+        autonomous_maintenance_schedule_type = "REGULAR"
+        compartment_id = "<Your-Compartment-Id>"
+        compute_count = "4"
+        compute_model = "ECPU"
+        data_storage_size_in_gb = "20"
+        db_name = "<Your-DB-Name>"
+        display_name = "<Your-DB-Display-Name>"
+        admin_password = "<Your-Password>"
+        db_version = "26ai"
+        db_workload = "LH" 
+        is_dedicated = "false"
+        is_dev_tier = "true"
+        is_mtls_connection_required = "true"
+        is_preview_version_with_service_terms_accepted = "false"
+        license_model = "LICENSE_INCLUDED"
+    }            
+    ```
+
+    Refer [OCI CLI Terraform for Database Creation](https://registry.terraform.io/providers/oracle/oci/latest/docs/resources/database_autonomous_database)
+
+5. Start with Terraform initialisation
+6. Run the following commands from the terminal where the **main.tf** file is located.
+    ```
+    terraform init
+    ``` 
+
+    ![Plan](images/17-tfplan.png )
+
+    ```
+    terraform plan -out=myplan.tfplan
+    ```
+
+    ![Apply](images/18-tfapply.png )
+
+    ```
+    terraform apply "myplan.tfplan"
+    ```
+
+    ![Logs](images/19-tfviewlogs.png )
+
+    The script has completed resource creation in approximately 3 minutes. Once you have completed using the Oracle Autonomous AI Database 26ai environment. You can destroy the environment
+
+    > Please note: This approach will be slightly slower than running it through the Oracle resource manager stack zip file upload. as you are connecting from your local laptop to OCI using using terraform command line interface.
+
+## (Optional) Download database wallet, Note connection details and Create database user
+
+1. From the top right navigation menu click on **Database Connection** button
+
+    ![DB Conn](images/db-conn.png  )
+
+2. Download wallet
+
+    ![Wallet](images/download-wallet.png  ) 
+
+    Provide wallet password and save the wallet.
+
+3. Copy and save TNS Name, which would be of the following format, where database name and region will change. we will need this details for database connection. 
+
+    ```
+    devdbhs556l_high = (description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(connect_data=(service_name=wkrfs4xeqva1jcu_devdbhs556l_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))
+    ```
+
+4. Create Database user by clicking on **Database Actions** Menu and **Database Users**
+
+    ![Create User](images/create-user.png  )
+
+    Click on create user button 
+
+    ![Create User2](images/create-user2.png  )
+
+    Provide user name and password and select user options
+
+    ![Destroy](images/user-options.png  )
+
+5.  Update **Granted Roles** as required by your application and **Apply Changes** . 
+
+    ![Destroy](images/role-grants.png  )
+
+## Cleanup resources created
+
+1. Destroy the resources created if you have used using Oracle Stack by clicking on the  **Destroy** button.
+
+    ![Destroy](images/15-destroy.png  )
+
+    View Confirmation message logs
+
+    ![Confirm](images/16-destroyconfirm.png )
+
+2. If you have used Terraform CLI then run  
+
+    ```
+    terraform destroy
+    ```
+
+    ![Destroy](images/20-destroy.png ) 
+
+    -- Enter yes for confirmation 
+
+
+## (Optional) Try Live SQL
+
+<livesql-button src="https://livesql.oracle.com/next/worksheet?tutorial=json-duality-views-quick-start-D3wdHG&share_key=jCX1875rL3">
+
+<b>Live SQL Execution:</b> Sign-In Required</br>
+<b>Duration:</b> 2 minutes 
+
+## Learn More & Downloads
+
+* [Autonomous AI Database for Developers](https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/doc/autonomous-database-for-developers.html) 
+* [Download Source code](https://github.com/madhusudhanrao-ppm/dbdevrel/tree/main/source-codes)
+* [Direct ORM deployment link](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://objectstorage.us-phoenix-1.oraclecloud.com/p/jtfUsV33KtLR937hWybAgrq8qtuQQuAaIw1K_VBThhlUF6Z1HYF0Ai50sQlp06bQ/n/oradbclouducm/b/medical_transcripts/o/Terraform/oracle-lakehouse-devedition-stack.zip)
+
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/01-navigation.png b/notebooks/create-oracleaidb26ai-devrel/images/01-navigation.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/02-createstack.png b/notebooks/create-oracleaidb26ai-devrel/images/02-createstack.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/03-schema.png b/notebooks/create-oracleaidb26ai-devrel/images/03-schema.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/04-apply.png b/notebooks/create-oracleaidb26ai-devrel/images/04-apply.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/05-orm.png b/notebooks/create-oracleaidb26ai-devrel/images/05-orm.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/06-logs.png b/notebooks/create-oracleaidb26ai-devrel/images/06-logs.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/07-logs.png b/notebooks/create-oracleaidb26ai-devrel/images/07-logs.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/08-orm.png b/notebooks/create-oracleaidb26ai-devrel/images/08-orm.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/10-adb.png b/notebooks/create-oracleaidb26ai-devrel/images/10-adb.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/11-adb2.png b/notebooks/create-oracleaidb26ai-devrel/images/11-adb2.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/12-alloptions.png b/notebooks/create-oracleaidb26ai-devrel/images/12-alloptions.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/13-sql.png b/notebooks/create-oracleaidb26ai-devrel/images/13-sql.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/14-sql2.png b/notebooks/create-oracleaidb26ai-devrel/images/14-sql2.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/15-destroy.png b/notebooks/create-oracleaidb26ai-devrel/images/15-destroy.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/16-destroyconfirm.png b/notebooks/create-oracleaidb26ai-devrel/images/16-destroyconfirm.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/17-tfplan.png b/notebooks/create-oracleaidb26ai-devrel/images/17-tfplan.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/18-tfapply.png b/notebooks/create-oracleaidb26ai-devrel/images/18-tfapply.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/19-tfviewlogs.png b/notebooks/create-oracleaidb26ai-devrel/images/19-tfviewlogs.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/20-destroy.png b/notebooks/create-oracleaidb26ai-devrel/images/20-destroy.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/create-user.png b/notebooks/create-oracleaidb26ai-devrel/images/create-user.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/create-user2.png b/notebooks/create-oracleaidb26ai-devrel/images/create-user2.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/db-conn.png b/notebooks/create-oracleaidb26ai-devrel/images/db-conn.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/download-wallet.png b/notebooks/create-oracleaidb26ai-devrel/images/download-wallet.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/role-grants.png b/notebooks/create-oracleaidb26ai-devrel/images/role-grants.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/images/user-options.png b/notebooks/create-oracleaidb26ai-devrel/images/user-options.png
diff --git a/notebooks/create-oracleaidb26ai-devrel/sourcecode/oracle-lakehouse-devedition-stack/main.tf b/notebooks/create-oracleaidb26ai-devrel/sourcecode/oracle-lakehouse-devedition-stack/main.tf
@@ -0,0 +1,75 @@
+# Copyright (c) 2025 Oracle and/or its affiliates.
+#
+# The Universal Permissive License (UPL), Version 1.0
+#
+# Subject to the condition set forth below, permission is hereby granted to any
+# person obtaining a copy of this software, associated documentation and/or data
+# (collectively the "Software"), free of charge and under any and all copyright
+# rights in the Software, and any and all patent rights owned or freely
+# licensable by each licensor hereunder covering either (i) the unmodified
+# Software as contributed to or provided by such licensor, or (ii) the Larger
+# Works (as defined below), to deal in both
+#
+# (a) the Software, and
+# (b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+# one is included with the Software (each a "Larger Work" to which the Software
+# is contributed by such licensors),
+# without restriction, including without limitation the rights to copy, create
+# derivative works of, display, perform, and distribute the Software and make,
+# use, sell, offer for sale, import, export, have made, and have sold the
+# Software and the Larger Work(s), and to sublicense the foregoing rights on
+# either these or other terms.
+#
+# This license is subject to the following condition:
+# The above copyright notice and either this complete permission notice or at
+# a minimum a reference to the UPL must be included in all copies or
+# substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+terraform {
+  required_version = ">= 0.12.0"
+}
+
+provider "oci" {
+  tenancy_ocid = var.tenancy_ocid
+  region       = var.region
+}
+
+resource "oci_database_autonomous_database" "autonomous_ai_database" {  
+  compartment_id = var.compartment_ocid
+  admin_password = var.admin_password
+  autonomous_maintenance_schedule_type = var.autonomous_maintenance_schedule_type
+  compute_count = var.compute_count
+  compute_model = var.compute_model
+  data_storage_size_in_gb = var.data_storage_size_in_gb
+  display_name   = var.display_name
+  db_name = local.db_name_trimmed
+  db_version = var.db_version
+  db_workload = var.db_workload  
+  is_dedicated = var.is_dedicated
+  is_dev_tier = var.is_dev_tier
+  is_mtls_connection_required = var.is_mtls_connection_required
+  is_preview_version_with_service_terms_accepted = var.is_preview_version_with_service_terms_accepted
+  license_model = var.license_model
+}
+
+resource "random_string" "db_suffix" {
+  length  = 12
+  special = false
+  upper   = false
+} 
+locals {
+  db_prefix = "DevDB"
+  db_name   = "${local.db_prefix}${random_string.db_suffix.result}"
+  db_name_trimmed = substr(local.db_name, 0, 11)  
+}
+locals { 
+  timestamp        = "${formatdate("YYYY-MM-DD-hhmmss", timestamp())}" 
+}