Learn more
 

Ready to get started?

Download a free trial of the Cosmos DB ODBC Driver to get started:

 Download Now

Learn more:

Cosmos DB Icon Cosmos DB ODBC Driver

The Cosmos DB ODBC Driver is a powerful tool that allows you to connect with live Cosmos DB document databases, directly from any applications that support ODBC connectivity.

Access Cosmos DB like you would a database - read, write, and update through a standard ODBC Driver interface.

In this article

Related articles

Use the CData ODBC Driver for Cosmos DB in Microsoft Power Query


You can use the CData Cosmos DB ODBC Driver with Microsoft Power Query. In this article, you will use the ODBC driver to import Cosmos DB data into Microsoft Power Query.

The CData ODBC Driver for Cosmos DB enables you to link to Cosmos DB data in Microsoft Power Query, ensuring that you see any updates. This article details how to use the ODBC driver to import Cosmos DB data into Microsoft Power Query.

Connect to Cosmos DB as an ODBC Data Source

If you have not already, first specify connection properties in an ODBC DSN (data source name). This is the last step of the driver installation. You can use the Microsoft ODBC Data Source Administrator to create and configure ODBC DSNs.

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.

Import Cosmos DB Data

Follow the steps below to import Cosmos DB data using standard SQL:

  1. From the ribbon in Excel, click Power Query -> From Other Data Sources -> From ODBC.

  2. Enter the ODBC connection string. Below is a connection string using the default DSN created when you install the driver: Provider=MSDASQL.1;Persist Security Info=False;DSN=CData CosmosDB Source

  3. Enter the SELECT statement to import data with. For example:

    SELECT City, CompanyName FROM Customers

  4. Enter credentials, if required, and click Connect. The results of the query are displayed in the Query Editor Preview. You can combine queries from other data sources or refine the data with Power Query formulas. To load the query to the worksheet, click the Close and Load button.