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

Viewing Cosmos DB Data in RAD Studio Data Explorer


How to view Cosmos DB data in RAD Studio Data Explorer using the CData ODBC Driver for Cosmos DB.

Embarcadero RAD Studio provides a development environment for Delphi and C++Builder applications. With the CData ODBC Driver for Cosmos DB, you gain access to live Cosmos DB data within RAD Studio, abstracting the data into tables, views, and stored procedures that can be used to both retrieve and update Cosmos DB data. This article will walk through connecting to Cosmos DB using the Data Explorer.

Configure a Connection to Cosmos DB

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.

Connecting to Cosmos DB Data Using Data Explorer

You can create a simple application for displaying Cosmos DB data by utilizing the CData FireDAC Components for Cosmos DB and a new VCL Forms Application:

  1. Open the Data Explorer in RAD Studio and expand FireDAC.
  2. Right-click the ODBC Data Source node in the Data Explorer.
  3. Click Add New Connection.
  4. Enter a name for the connection.
  5. In the FireDAC Connection Editor that appears, set the DataSource property to the name of the ODBC DSN for Cosmos DB.
  6. Back in the Data Explorer, expand the tables for the connection.

  7. Create a new VCL Forms application and drag a table (for example: Customers) onto the form.

  8. Select the CustomersTable object on the form and set the Active property to true.

  9. Right-click on the object, bind visually, and link everything (*) to a new control (TStringGrid).

  10. Arrange the TStringGrid on the form and run the application to see the Customers data.