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. A typical connection requires:
    • AccountEndpoint
    • AccountKey

    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.

  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.
  • Specify the table into which the data will be exported: On the Component Properties tab, enter the table name in the TableName property, under the Custom Properties section. In this case, you will transfer Customers records.
  • 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.

     
     
    ダウンロード