Export Data from SQL Server to Cosmos DB through SSIS

SQL Server databases are commonly used to store enterprise records. It is often necessary to move this data to other locations. The CData SSIS Task for Cosmos DB allows you to easily transfer Cosmos DB data. In this article you will export data from SQL Server to Cosmos DB.

Add Source and Destination Components

To get started, add a new ADO.NET Source control and a new Cosmos DB Destination control to the data flow task.

Configure the ADO.NET Source

Follow the steps below to specify properties required to connect to the SQL Server instance.

1. Open the ADO.NET Source and add a new connection. Enter your server and database information here.
2. In the Data access mode menu, select "Table or view" and select the table or view to export into Cosmos DB.
3. Close the ADO NET Source wizard and connect it to the destination component.

Create a New Connection Manager for Cosmos DB

Follow the steps below to set required connection properties in the Connection Manager.

1. Create a new connection manager: In the Connection Manager window, right-click and then click New Connection. The Add SSIS Connection Manager dialog is displayed.
2. Select CData CosmosDB Connection Manager in the menu.
3. Configure the connection properties.

   To obtain the connection string needed to connect to a Cosmos DB account using the SQL API, log in to the Azure Portal, select Azure Cosmos DB, and select your account. In the Settings section, click Connection String and set the following values:

   • AccountEndpoint: The Cosmos DB account URL from the Keys blade of the Cosmos DB account
   • AccountKey: In the Azure portal, navigate to the Cosmos DB service and select your Azure Cosmos DB account. From the resource menu, go to the Keys page. Find the PRIMARY KEY value and set AccountKey to this value.

Configure the Cosmos DB Destination

In the destination component Connection Manager, define mappings from the SQL Server source table into the Cosmos DB destination table and the action you want to perform on the Cosmos DB data. In this article, you will insert Customers entities to Cosmos DB.

1. Double-click the Cosmos DB destination to open the destination component editor.
2. In the Connection Managers tab, select the connection manager previously created.
3. In the Use a Table, menu, select Customers. In the Action menu, select Insert.
4. On the Column Mappings tab, configure the mappings from the input columns to the destination columns.

Run the Project

You can now run the project. After the SSIS Task has finished executing, data from your SQL table will be exported to the chosen table.