Use the CData ODBC Driver for Cosmos DB in 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
    

   👁 The ODBC connection string and SELECT query. (Salesforce is shown.)
   

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.

   👁 Tables loaded in Power Query. (Salesforce is shown.)