Migrate data to Azure Cosmos DB SQL API account using Striim

The Striim image in the Azure marketplace offers continuous real-time data movement from data warehouses and databases to Azure. While moving the data, you can perform in-line denormalization, data transformation, enable real-time analytics, and data reporting scenarios. It’s easy to get started with Striim to continuously move enterprise data to Azure Cosmos DB SQL API. Azure provides a marketplace offering that makes it easy to deploy Striim and migrate data to Azure Cosmos DB.

This article shows how to use Striim to migrate data from an Oracle database to an Azure Cosmos DB SQL API account.

Prerequisites

Deploy the Striim marketplace solution

  1. Sign into the Azure portal.

  2. Select Create a resource and search for Striim in the Azure marketplace. Select the first option and Create.

    Find Striim marketplace item

  3. Next, enter the configuration properties of the Striim instance. The Striim environment is deployed in a virtual machine. From the Basics pane, enter the VM user name, VM password (this password is used to SSH into the VM). Select your Subscription, Resource Group, and Location details where you’d like to deploy Striim. Once complete, select OK.

    Configure basic settings for Striim

  4. In the Striim Cluster settings pane, choose the type of Striim deployment and the virtual machine size.

    Setting Value Description
    Striim deployment type Standalone Striim can run in a Standalone or Cluster deployment types. Standalone mode will deploy the Striim server on a single virtual machine and you can select the size of the VMs depending on your data volume. Cluster mode will deploy the Striim server on two or more VMs with the selected size. Cluster environments with more than 2 nodes offer automatic high availability and failover.
    In this tutorial, you can select Standalone option. Use the default “Standard_F4s” size VM.
    Name of the Striim cluster <Striim_cluster_Name> Name of the Striim cluster.
    Striim cluster password <Striim_cluster_password> Password for the cluster.

    After you fill the form, select OK to continue.

  5. In the Striim access settings pane, configure the Public IP address (choose the default values), Domain name for Striim, Admin password that you’d like to use to login to the Striim UI. Configure a VNET and Subnet (choose the default values). After filling in the details, select OK to continue.

    Striim access settings

  6. Azure will validate the deployment and make sure everything looks good; validation takes few minutes to complete. After the validation is completed, select OK.

  7. Finally, review the terms of use and select Create to create your Striim instance.

Configure the source database

In this section, you configure the Oracle database as the source for data movement. You’ll need the Oracle JDBC driver to connect to Oracle. To read changes from your source Oracle database, you can either use the LogMiner or the XStream APIs. The Oracle JDBC driver must be present in Striim's Java classpath to read, write, or persist data from Oracle database.

Download the ojdbc8.jar driver onto your local machine. You will install it in the Striim cluster later.

Configure the target database

In this section, you will configure the Azure Cosmos DB SQL API account as the target for data movement.

  1. Create an Azure Cosmos DB SQL API account using the Azure portal.

  2. Navigate to the Data Explorer pane in your Azure Cosmos account. Select New Container to create a new container. Assume that you are migrating products and orders data from Oracle database to Azure Cosmos DB. Create a new database named StriimDemo with a container named Orders. Provision the container with 1000 RUs (this example uses 1000 RUs, but you should use the throughput estimated for your workload), and /ORDER_ID as the partition key. These values will differ depending on your source data.

    Create a SQL API account

Configure Oracle to Azure Cosmos DB data flow

  1. Now, let’s get back to Striim. Before interacting with Striim, install the Oracle JDBC driver that you downloaded earlier.

  2. Navigate to the Striim instance that you deployed in the Azure portal. Select the Connect button in the upper menu bar and from the SSH tab, copy the URL in Login using VM local account field.

    Get the SSH URL

  3. Open a new terminal window and run the SSH command you copied from the Azure portal. This article uses terminal in a MacOS, you can follow the similar instructions using PuTTY or a different SSH client on a Windows machine. When prompted, type yes to continue and enter the password you have set for the virtual machine in the previous step.

    Connect to Striim VM

  4. Now, open a new terminal tab to copy the ojdbc8.jar file you downloaded previously. Use the following SCP command to copy the jar file from your local machine to the tmp folder of the Striim instance running in Azure:

    cd <Directory_path_where_the_Jar_file_exists> 
    scp ojdbc8.jar striimdemo@striimdemo.westus.cloudapp.azure.com:/tmp
    

    Copy the Jar file from location machine to Striim

  5. Next, navigate back to the window where you did SSH to the Striim instance and Login as sudo. Move the ojdbc8.jar file from the /tmp directory into the lib directory of your Striim instance with the following commands:

    sudo su
    cd /tmp
    mv ojdbc8.jar /opt/striim/lib
    chmod +x ojdbc8.jar
    

    Move the Jar file to lib folder

  6. From the same terminal window, restart the Striim server by executing the following commands:

    Systemctl stop striim-node
    Systemctl stop striim-dbms
    Systemctl start striim-dbms
    Systemctl start striim-node
    
  7. Striim will take a minute to start up. If you’d like to see the status, run the following command:

    tail -f /opt/striim/logs/striim-node.log
    
  8. Now, navigate back to Azure and copy the Public IP address of your Striim VM.

    Copy Striim VM IP address

  9. To navigate to the Striim’s Web UI, open a new tab in a browser and copy the public IP followed by: 9080. Sign in by using the admin username, along with the admin password you specified in the Azure portal.

    Sign in to Striim

  10. Now you’ll arrive at Striim’s home page. There are three different panes – Dashboards, Apps, and SourcePreview. The Dashboards pane allows you to move data in real time and visualize it. The Apps pane contains your streaming data pipelines, or data flows. On the right hand of the page is SourcePreview where you can preview your data before moving it.

  11. Select the Apps pane, we’ll focus on this pane for now. There are a variety of sample apps that you can use to learn about Striim, however in this article you will create our own. Select the Add App button in the top right-hand corner.

    Add the Striim app

  12. There are a few different ways to create Striim applications. Select Start with Template to start with an existing template.

    Start the app with the template

  13. In the Search templates field, type “Cosmos” and select Target: Azure Cosmos DB and then select Oracle CDC to Azure Cosmos DB.

    Select Oracle CDC to Cosmos DB

  14. In the next page, name your application. You can provide a name such as oraToCosmosDB and then select Save.

  15. Next, enter the source configuration of your source Oracle instance. Enter a value for the Source Name. The source name is just a naming convention for the Striim application, you can use something like src_onPremOracle. Enter values for rest of the source parameters URL, Username, Password, choose LogMiner as the reader to read data from Oracle. Select Next to continue.

    Configure source parameters

  16. Striim will check your environment and make sure that it can connect to your source Oracle instance, have the right privileges, and that CDC was configured properly. Once all the values are validated, select Next.

    Validate source parameters

  17. Select the tables from Oracle database that you’d like to migrate. For example, let’s choose the Orders table and select Next.

    Select source tables

  18. After selecting the source table, you can do more complicated operations such as mapping and filtering. In this case, you will just create a replica of your source table in Azure Cosmos DB. So, select Next to configure the target

  19. Now, let’s configure the target:

    • Target Name - Provide a friendly name for the target.
    • Input From - From the dropdown list, select the input stream from the one you created in the source Oracle configuration.
    • Collections- Enter the target Azure Cosmos DB configuration properties. The collections syntax is SourceSchema.SourceTable, TargetDatabase.TargetContainer. In this example, the value would be “SYSTEM.ORDERS, StriimDemo.Orders”.
    • AccessKey - The PrimaryKey of your Azure Cosmos account.
    • ServiceEndpoint – The URI of your Azure Cosmos account, they can be found under the Keys section of the Azure portal.

    Select Save and Next.

    Configure target parameters

  20. Next, you’ll arrive at the flow designer, where you can drag and drop out of the box connectors to create your streaming applications. You will not make any modifications to the flow at this point. so go ahead and deploy the application by selecting the Deploy App button.

    Deploy the app

  21. In the deployment window, you can specify if you want to run certain parts of your application on specific parts of your deployment topology. Since we’re running in a simple deployment topology through Azure, we’ll use the default option.

    Use the default option

  22. After deploying, you can preview the stream to see data flowing through. Select the wave icon and the eyeball next to it. Select the Deployed button in the top menu bar, and select Start App.

    Start the app

  23. By using a CDC(Change Data Capture) reader, Striim will pick up only new changes on the database. If you have data flowing through your source tables, you’ll see it. However, since this is a demo table, the source isn’t connected to any application. If you use a sample data generator, you can insert a chain of events into your Oracle database.

  24. You’ll see data flowing through the Striim platform. Striim picks up all the metadata associated with your table as well, which is helpful to monitor the data and make sure that the data lands on the right target.

    Configure CDC pipeline

  25. Finally, let’s sign into Azure and navigate to your Azure Cosmos account. Refresh the Data Explorer, and you can see that data has arrived.

    Validate migrated data in Azure

By using the Striim solution in Azure, you can continuously migrate data to Azure Cosmos DB from various sources such as Oracle, Cassandra, MongoDB, and various others to Azure Cosmos DB. To learn more please visit the Striim website, download a free 30-day trial of Striim, and for any issues when setting up the migration path with Striim, file a support request.

Next steps