Ready to get started?

Learn more about the CData SSIS Components for Cosmos DB or download a free trial:

Download Now

Export Data from SQL Server to Cosmos DB through SSIS

Easily push SQL Server data to Cosmos DB using the CData SSIS Tasks for Cosmos DB.

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 MongoDB API, log in to the Azure Portal, select Azure Cosmos DB, and select your account. In the Settings section, click Connection String.

    • Server: Set this to the Host value. You can specify the port here or in Port.
    • Port: Specify the port number.
    • Database: Set this to the database you want to read from and write to.
    • User: Set this to the username to be used to perform MongoDB authentication to the database.
    • Password: Set this to the user's password.

    To access Cosmos DB tables you can use automatic schema discovery or write your own schema definitions. Schemas are defined in .rsd files, which have a simple format that makes them easy to extend. You can also execute free-form queries that are not tied to the schema.

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 restaurants 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 restaurants. 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.