Adding MySQL JSON Duality Workshop

mysql-json-duality/connect-mysql-heatwave/connect-mysql-heatwave.md

@@ -0,0 +1,86 @@
+# Connect to MySQL HeatWave DB system
+
+## Introduction
+
+Modern application development demands tools that reduce context switching and improve developer productivity. The MySQL Shell extension for Visual Studio Code brings powerful database interaction directly into your development workspace.
+
+With seamless support for SQL, Javascript, and TypeScript right inside the familiar VS Code environment developers can connect, query, and script against MySQL databases without ever leaving their IDE.
+
+In this lab, you'll learn how to connect to a MySQL DB system using the MySQL Shell extension in Visual Studio Code. This setup is especially useful if you are working in a development environment and prefer using VS code interface to manage your databases.
+
+Estimated time: 10 minutes
+
+### Objectives
+
+* Connect to a MySQL DB system using MySQL Shell extension for VS Code
+
+## Task 1: Connect to a MySQL DB system using MySQL Shell extension for VS Code
+
+1. Launch Visual Studio Code and click on the **MySQL Shell for VS Code icon** in the left sidebar. This opens the database panel where you can add and manage connections.
+
+     ![Launch VS Code](./images/launch-vs-code.png " ")
+
+2. Click the **+ New Connection** button within the Database Connections panel or on the home tab. Either ways will work to create a new connection.
+
+     ![Add New Connection](./images/add-new-connection.png " ")
+
+3. This opens up a new connection tab to fill in the required details in the dialog box.
+
+     ![Fill Connection Details](./images/fill-connection-details.png " ")
+
+4. Fill in the required fields:
+
+    * **Caption**: A friendly name for your connection. In this example, use **HeatWave_DB**
+    * **Description**: An optional but helpful description. Use **HeatWave_DB** as the description
+    * **Host Name or IP Address**: Enter the hostname which you copied from the connections tab of the MySQL HeatWave DB system
+    * **Port**: This is the port your MySQL server is running on. Typically, it is **3306**
+    * **Username**: Enter the username as **admin**
+
+    ![Filled Connection Details](./images/connection-filled-details.png " ")
+
+5. Once you filled in the above details, click on **Store Password** to minimize entering the password every time for convenience. Enter password as **Welcome1!** to connect to the host.
+
+    ![Store Password](./images/store-password.png " ")
+
+6. Once the password is entered, click on **OK** to save the password.
+
+    ![Filled Password](./images/filled-password.png " ")
+
+7. You can securely connect to your HeatWave MySQL DB system using an SSH tunnel through a compute instance, which acts as a jump host or bastion host. OCI also provides the Bastion service as an alternative for secure access to private resources.
+
+8. Check Connect Using SSH Tunnel box under Tunneling options.
+
+    ![SSH Tunnel](./images/check-ssh-tunneling.png " ")
+
+9. Expand the SSH tunnel section and configure:
+
+* SSH Host: Public IP or hostname of your Compute instance
+* SSH Port: 22 (default SSH port)
+* SSH Username: Username for the Compute instance (e.g., opc on Oracle Linux)
+* SSH Key: Browse and Select your private key file
+
+    ![SSH Tunnel](./images/ssh-tunneling.png " ")
+
+10. After all the details are entered, click on **OK** to save connection to the MySQL DB system.
+
+    ![Click OK](./images/click-ok.png " ")
+
+> **Note:** _The MySQL Shell extension with route your connection securely through the tunnel._
+
+11. If the connection is successful, you will see a connection created and the MySQL DB system connection name appears under Database Connections as well.
+
+    ![Connection Created](./images/connection-created.png " ")
+
+12. Clicking on the connection opens MySQL Shell DB Notebook for MySQL DB system.
+
+    ![Notebook Interface](./images/notebook-interface.png " ")
+
+13. You can also connect to your MySQL DB system from the left bar navigation by clicking on the **notebook** icon beside the connection name.
+
+    ![Notebook Connection](./images/notebook-connection.png " ")
+
+## Acknowledgements
+
+* **Author** - Sindhuja Banka, MySQL HeatWave Product Manager
+* **Contributors** - Sindhuja Banka
+* **Last Updated By/Date** - Sindhuja Banka, November 2025

mysql-json-duality/create-mysql-heatwave/mysql-heatwave.md

@@ -0,0 +1,284 @@
+# Create MySQL HeatWave DB system
+
+## Introduction
+
+In this lab, you will learn how to launch a MySQL HeatWave DB system on Oracle Cloud Infrastructure (OCI) and later connect to it using MySQL Shell extension for Visual Studio Code.
+
+Estimated Time: 20 minutes
+
+### About MySQL HeatWave Service
+
+MySQL HeatWave is a fully-managed OCI service that is developed, managed, and supported by the MySQL team in Oracle.
+
+### Objectives
+
+In this lab, you will be guided through the following steps:
+
+- Create a compartment
+- Create a policy
+- Create a virtual cloud network (VCN)
+- Create a MySQL HeatWave DB system
+- Create a client virtual machine
+
+### Prerequisites
+
+- An Oracle Free Tier, Always Free, Paid or LiveLabs Cloud Account
+- Some Experience with MySQL Shell
+- Create a local Secure Shell (SSH) key
+
+## Task 1: Create a Compartment
+
+You must have an OCI tenancy subscribed to your home region and enough limits configured for your tenancy to create a MySQL HeatWave Database System. Make sure to log in to the Oracle Cloud Console as an Administrator.
+
+1. Click the **Navigation Menu** in the upper left, navigate to **Identity & Security** and select **Compartments**.
+
+    ![Oracle Cloud Console](https://oracle-livelabs.github.io/common/images/console/id-compartment.png "Oracle Cloud Console")
+
+2. On the Compartments page, click **Create Compartment**.
+
+    ![Compartment2](./images/create-compartment.png "In Compartments page ")
+
+   > **Note:** Two Compartments, _Oracle Account Name_ (root) and a compartment for PaaS, were automatically created by the Oracle Cloud.
+
+3. In the Create Compartment dialog box, in the **NAME** field, enter **HeatWave_Sandbox**, and then enter a Description, select the **Parent Compartment**, and click **Create compartment**.
+
+    ![Create a Compartment](./images/compartment-details.png "Enter Compartment Details")
+
+    The following screen shot shows a completed compartment:
+
+    ![Completed Compartment](./images/compartment-completed.png "Completed compartment")
+
+## Task 2: Create a Policy
+
+1. Click the **Navigation Menu** in the upper-left corner, navigate to **Identity & Security** and select **Policies**.
+
+     ![Navigation Menu](https://oracle-livelabs.github.io/common/images/console/id-policies.png "Navigation Menu")
+
+2. On the Policies page, in the **List Scope** section, select the Compartment (root) and click **Create Policy**.
+
+    ![Policies page](./images/policy-page.png "Policies page")
+
+3. On the Create Policy page, in the **Description** field, enter **HeatWave_Policy** and select the root compartment.
+
+4. In the **Policy Builder** section, turn on the **Show manual editor** toggle switch.
+
+    ![Create Policy page](./images/policy-builder.png "Create Policy page")
+
+5. Enter the following required MySQL HeatWave policies:
+
+    - Policy statement 1:
+
+        ```bash
+        <copy>Allow group Administrators to {COMPARTMENT_INSPECT} in tenancy</copy>
+        ```
+
+    - Policy statement 2:
+
+        ```bash
+        <copy>Allow group Administrators to {VCN_READ, SUBNET_READ, SUBNET_ATTACH, SUBNET_DETACH} in tenancy</copy>
+        ```
+
+    - Policy statement 3:
+
+        ```bash
+        <copy>Allow group Administrators to manage mysql-family in tenancy</copy>
+        ```
+
+6. Click **Create**.
+
+    ![Create Policy page](./images/policy-create.png "Create Policy page")
+
+## Task 3: Create a VCN
+
+1. Click the **Navigation Menu** in the upper-left corner, navigate to **Networking**, and select **Virtual Cloud Networks**.
+
+   ![Virtual Cloud Networks](https://oracle-livelabs.github.io/common/images/console/networking-vcn.png "Virtual Cloud Networks")
+
+2. Click **Start VCN Wizard**.
+
+3. Select **VCN with Internet Connectivity** and click **Start VCN Wizard**.
+
+    ![Start VCN Wizard](./images/vcn-start.png "Start VCN Wizard")
+    ![Start VCN Wizard Select](./images/vcn-start-select.png "Start VCN Wizard Select")
+
+
+
+4. On the Create a VCN with Internet Connectivity page, in the **Basic Information** section, in the **VCN Name** field, enter `HeatWave_VCN` and from the **Compartment** drop-down list, select **HeatWave_Sandbox**.
+    > **Note:** Your screen should look similar to the following screen shot:
+
+    ![VCN with Internet Connectivity page](./images/vcn-basic.png "VCN with Internet Connectivity page")
+
+5. Click **Next** at the bottom of the screen.
+
+6. Review the **Oracle Virtual Cloud Network (VCN)**, **Subnets**, and **Gateways** sections and click **Create** to create the VCN.
+
+    ![VCN](./images/vcn-review.png "VCN Review")
+
+    > **Note:** The VCN creation is completing.
+
+    ![VCN creation page](./images/vcn-create.png "VCN creation page")
+
+7. Click **View Virtual Cloud Network** to display the created VCN.
+
+    ![View Virtual Cloud Network](./images/vcn-view.png "View Virtual Cloud Network")
+
+
+8. On the Virtual Cloud Network Details page, select the **Security** tab, click on **Security List for Private Subnet-HeatWave_VCN**
+
+     ![Security Lists](./images/vcn-security-list.png "VCN Security Lists")
+
+## Task 4: Configure security list to allow MySQL incoming connection HeatWave_VCNs
+
+1. In the **Security List for Private Subnet-HeatWave_VCN** section, in the **Ingress Rules** section, click **Add Ingress Rules**.
+
+    ![Ingress Rules](./images/vcn-private-subnet-ingress-rules.png "Ingress Rules")
+
+2. In the **Add Ingress Rule** dialog box, add an ingress rule with **Source CIDR** `0.0.0.0/0` and destination port number `3306, 33060` and click **Add Ingress Rule**.
+
+    ![MySQL Port](./images/vcn-private-subnet-ingress-rules-input.png "MySQL Port")
+
+3. On the Security List for Private Subnet-HeatWave_VCN page, the new ingress rules will be shown in the **Ingress Rules** list.
+
+    ![Private Subnet-HeatWave_VCN page](./images/vcn-private-subnet-ingress-rules-page.png "Private Subnet-HeatWave_VCN page")
+
+## Task 5: Create a MySQL HeatWave DB system
+
+1. Click the **Navigation Menu** in the upper-left corner, navigate to **Databases**, and select **Database Systems**.
+
+   ![Database Systems](https://oracle-livelabs.github.io/common/images/console/database-dbsys.png "Database Systems")
+
+2. Click **Create MySQL HeatWave Database System**.
+
+    ![Create Database System](./images/mysql-create-menu.png "MySQL Create Database System")
+
+3. Select the Development or Testing Option
+
+    ![Development](./images/mysql-development.png "Select Development")
+
+4. On the Create MySQL HeatWave Database System dialog box, complete the fields in each section:
+
+    - Provide basic information for the database system
+    - Set up your required database system
+    - Create administrator credentials
+    - Configure networking
+    - Configure placement
+    - Configure hardware
+    - Configure backups
+    - Show advanced options
+
+5. In **Provide basic information for the DB System**, select the **HeatWave\_Sandbox** Compartment, in the **Name** field and **Description** field, enter **HeatWave_DB**.
+
+    ![Create MySQL HeatWave Database Basic](./images/mysql-basic.png "Create MySQL HeatWave Database Basic")
+
+6. In **Create Administrator credentials**, enter **admin** for the user name, enter **Welcome1!** for the password, and then enter **Welcome1!** to confirm the password.
+
+    ![HeatWave](./images/mysql-admin.png "MySQL Admin ")
+
+7. In **Setup your required Database System**, select **Standalone** to specify a single-instance database system.
+
+    ![Standalone](./images/mysql-standalone.png "Standalone")
+
+8. In **Configure networking**, keep default values **HeatWave\_VCN** for the VCH and **private subnet-HeatWave\_VCN (Regional)** for the subnet.
+
+    ![Configure networking](./images/mysql-networking.png "Configure networking")
+
+9. In **Configure placement**, keep **Availability Domain** selected.
+
+    > **Note:** Do not select **Choose a Fault Domain** for this database system. Oracle will select the best placement for you.
+
+    ![Configure placement](./images/mysql-placement.png "MySQL Configure placement")
+
+10. In **Configure hardware**:  
+    - Remove the check mark from **Enable HeatWave**  
+    - Set the default shape to **MySQL.2** 
+    - Set the value **100** for the **Data Storage Size (GB)**.  
+
+    ![MySQL HardWare](./images/mysql-configure-hardware.png "MySQL Configure HardWare")
+
+11. In **Configure Backups**, keep **Enable Automatic Backups** selected. Set the retention period to `7` and select **Default Backup Window**.
+
+    ![Configure Backups](./images/mysql-configure-backup.png "Configure Backups")
+
+12. Expand advanced options at the end to select the database version.
+
+    ![Configure Version](./images/mysql-configure-version.png "Configure Version")
+
+13. Expand Configuration tab under advanced options to select the database version to **9.4.1** and click **Create**.
+
+    ![Configure Version](./images/mysql-configure-database-version.png "Configure Version")
+
+    > **Note:** The New MySQL HeatWave Database System will be ready to use after a few minutes. The state will be shown as **Creating** during the creation.
+
+    ![Creating DB](./images/mysql_creating.png "Creating DB")
+
+    > **Note:** The **Active** state indicates that the database system is ready to use.
+
+14. The state **Active** indicates that the DB system is ready for use. On the **HeatWave_DB** page,select the **Connections** tab, check and save the Endpoint (Private IP Address). Later, you will need this value to connect to the Heatwave DB using the MySQL Shell client tool.
+
+    ![HeatWave Details page](./images/mysql-active.png "MySQL Details page")
+
+## Task 6: Create the Client Virtual Machine
+
+> **Important:** If you have not already completed the **Create Local SSH Key** lab, please do so now. When you are finished, return to this task.
+
+1. You need a client machine to connect to your brand new MySQL database. Click the **Navigation Menu** in the upper-left corner, navigate to **Compute**, and select **Instances**.
+
+   ![Compute Menu](https://oracle-livelabs.github.io/common/images/console/compute-instances.png "Compute Menu")
+
+2. In the **Instances in HeatWave_Sandbox Compartment** section, click **Create Instance**.
+
+    ![Compute Instance Menu](./images/compute-menu-create-instance.png "Compute Instance Menu")
+
+3. In the **Create Compute Instance** section, enter **HeatWave_Client** for the instance name.
+
+4. Make sure the **HeatWave_Sandbox** compartment is selected.
+
+5. Choose an operating system or image source (for this lab, select **Oracle Linux**).
+
+6. In the **Configure placement and hardware** section, keep the default **Availability Domain** and keep the default **Shape**.
+
+   ![Configure placement and hardware](./images/compute-create-info.png "Configure placement and hardware")
+
+    > **Note:** For the **Security** section, click Next
+    ![Configure security](./images/compute-create-security.png "Configure security")
+
+    > **Note:** **Virtual cloud network**, make sure **HeatWave_VCN** is selected and **Assign a public IPv4 address** is **selected**
+
+   ![Assign a public IPv4 address](./images/compute-create-vnic.png "Assign a public IPv4 address")
+
+7. If you have not already created your SSH key, complete the **Create Local SSH Key** lab. When you are done, continue on to the next step.
+
+8. In the **Add SSH keys** section, generate an SSH key pair or upload your own public key. Select one of the following options:
+
+    - **Generate SSH key pair:** Oracle Cloud Infrastructure (OCI) generates an RSA key pair for the instance. Click **Save Private Key**, and then save the private key on your computer. Optionally, click **Save Public Key** and then save the public key.
+    - **Choose public key files:** Upload the public key portion of your key pair. Either browse to the key file that you want to upload, or drag and drop the file into the field. To provide multiple keys, press and hold down the Command key (on Mac) or the CTRL key (on Windows) while selecting files.
+    - **Paste public keys:** Paste the public key portion of your key pair in the field.
+    - **No SSH keys:** Do _not_ select this option. You will not be able to connect to the compute instance using SSH.
+
+    ![SSH key pair](./images/compute-create.png "SSH key pair")
+
+    > **Note:** For the **Storage** section, click Next
+    ![Configure storage](./images/compute-create-storage.png "Configure storage")
+
+9. Click the Create **button**
+
+    ![Click create](./images/compute-create-click.png "Click create")
+    **Note:** The new virtual machine will be ready to use after a few minutes. The state will be shown as **Provisioning** during the creation.
+
+    ![Compute Provisioning](./images/compute-provisioning.png "Compute Provisioning")
+
+    > **Note:** The **Running** state indicates that the virtual machine is ready for use. **Save the Public IP Address** is under **Instance Access**  on the **HeatWave_Client** page.
+
+    ![Compute Active](./images/compute-active.png "Compute Active")
+
+## Learn More
+
+- [MySQL Heatwave Documentation](https://docs.oracle.com/en-us/iaas/mysql-database/)
+
+- [MySQL HeatWave Database Documentation](https://www.mysql.com)
+
+## Acknowledgements
+
+- **Author** -  Sindhuja Banka, MySQL Product Manager
+- **Contributors** -  Sindhuja Banka
+- **Last Updated By/Date** - Sindhuja Banka, November 2025