Cosmos DB ADO.NET Provider
 
ADO.NET
Cosmos DB Logo

Cosmos DB ADO.NET Provider

SQL-based Access to Cosmos DB through ADO.NET for your custom .NET applications and SSAS.

download buy now

Other Microsoft Azure Technologies

Other Microsoft Azure Drivers

The Cosmos DB ADO.NET Data Provider enables user to easily connect to Cosmos DB data from .NET applications. Rapidly create and deploy powerful .NET applications that integrate with Cosmos DB document databases.

ADO architecture

Cosmos DB .NET Connectivity Features

  • Access any Azure CosmosDB instance setup using the MongoDB API
  • Enables SQL-92 capabilities on Azure Cosmos DB NoSQL data.
  • Flexible NoSQL flattening - automatic schema generation, flexible querying etc.
  • Connect to live Azure Cosmos DB data, for real-time data access with the Azure Cosmos DB JDBC Driver
  • Full support for data aggregation and complex JOINs in SQL queries
  • Secure connectivity through modern cryptography, including TLS 1.2, SHA-256, ECC, etc.
  • Seamless integration with leading BI, reporting, and ETL tools and with custom applications via the Cosmos DB Connector.

Target Service, API

The driver connects to Azure Cosmos DB via SQL API. Supports partitioned collections and multi-region deployments.

Schema, Data Model

Models Cosmos DB containers as tables with automatic schema detection. Handles nested documents and arrays with flattening options.

Key Objects

Databases, Containers (Collections), Documents, Stored Procedures, Triggers, and User-Defined Functions. Access to all Cosmos DB data.

Operations

SQL queries translated to Cosmos DB SQL. Full CRUD operations with support for partial updates. Handles partition keys automatically.

Authentication

Azure AD authentication or Master Key/Resource Tokens. Connection requires account endpoint and authentication credentials.

Start a 30-day Free Trial Today

Cosmos DB ADO.NET Download

See what you can do with Cosmos DB ADO.NET provider

SSAS Cube
SSAS Cube

Use Cosmos DB from SQL Server Analysis Service (SSAS) multi-dimensional cubes. Keep your analytical data modeling and access to any source including cloud and on-premises.

Custom .NET Application
Custom .NET Application

The Cosmos DB ADO.NET Provider allows developers to build applications that connect to Cosmos DB using familiar SQL and Entity Framework. Integrate Cosmos DB to your mission -critical applications or create easy side-by-side applications.

Reporting & BI
Low-Code Dev Platforms

You can connect from ADO.NET compliant low-code development tools:

Reporting & BI
Reporting Tools

You can connect Cosmos DB from .NET-based reporting and analytics tools:

Standard ADO.NET Access to CosmosDB

The Cosmos DB ADO.NET Provider offers the most natural way to access Cosmos DB data from any .NET application. Simply use Cosmos DB Data Provider objects to connect and access data just as you would access any traditional database. You will be able to use the Cosmos DB Data Provider through Visual Studio Server Explorer, in code through familiar classes, and in data controls like DataGridView, GridView, DataSet, etc.

The CData ADO.NET Provider for Cosmos DB hides the complexity of accessing data and provides additional powerful security features, smart caching, batching, socket management, and more.

Working with DataAdapters, DataSets, DataTables, etc.

The Cosmos DB Data Provider has the same ADO.NET architecture as the native .NET data providers for SQL Server and OLEDB, including: CosmosDBConnection, CosmosDBCommand, CosmosDBDataAdapter, CosmosDBDataReader, CosmosDBDataSource, CosmosDBParameter, etc. Because of this you can now access Cosmos DB data in an easy, familiar way.

For example:

using (CosmosDBConnection conn = new CosmosDBConnection("...")) {
	string select = "SELECT * FROM DocumentDB";
	CosmosDBCommand cmd = new CosmosDBCommand(select, conn);
	CosmosDBDataAdapter adapter = new CosmosDBDataAdapter(cmd);
	using (adapter) {
		DataTable table = new DataTable();
		adapter.Fill(table);		
		...
	}
}

More Than Read-Only: Full Update/CRUD Support

Cosmos DB Data Provider goes beyond read-only functionality to deliver full support for Create, Read, Update, and Delete operations (CRUD). Your end-users can interact with the data presented by the Cosmos DB Data Provider as easily as interacting with a database table. 

using (CosmosDBConnection connection = new CosmosDBConnection(connectionString)) {
	CosmosDBDataAdapter dataAdapter = new CosmosDBDataAdapter(
	"SELECT Id, Where FROM DocumentDB", connection);
  
	dataAdapter.UpdateCommand = new CosmosDBCommand(
		"UPDATE DocumentDB SET Where = @Where " +
		"WHERE Id = @ID", connection);

	dataAdapter.UpdateCommand.Parameters.AddWithValue("@Where", "Where");
	dataAdapter.UpdateCommand.Parameters.AddWithValue("@Id", "80000173-1387137645");

	DataTable DocumentDBTable = new DataTable();
	dataAdapter.Fill(DocumentDBTable);

	DataRow firstrow = DocumentDBTable.Rows[0];
	firstrow["Where"] = "New Location";

	dataAdapter.Update(DocumentDBTable);
}

ADO.NET Provider Performance

With traditional approaches to remote access, performance bottlenecks can spell disaster for applications. Regardless if an application is created for internal use, a commercial project, web, or mobile application, slow performance can rapidly lead to project failure. Accessing data from any remote source has the potential to create these problems. Common issues include:

  1. Network Connections - Slow network connections and latency issues are common in mobile applications.
  2. Service Delays - Delays due to service interruptions, resulting in server hardware or software updates.
  3. Large Data - Intentional or unintentional requests for large amounts of data.
  4. Disconnects - Complete loss of network connectivity.

The CData ADO.NET Provider for Cosmos DB solves many of these issues with support for replication queries that can be used to sync data to local databases, greatly improving the performance and dramatically reduce application bottlenecks.

More information about ADO.NET Provider performance capabilities are available in the included documentation.

Visual Studio Integration & Server Explorer

Working with the new Cosmos DB ADO.NET Provider is easy. As a fully-managed .NET Data Provider, the Cosmos DB Data Provider integrates seamlessly with the Visual Studio development environment as well as any .NET application.

As an ADO.NET Data Provider, Cosmos DB ADO.NET Provider can be used to access and explore Azure Cosmos DB data directly from the Visual Studio Server Explorer.

It's easy. As a standard ADO.NET adapter, developers can connect the Server Explorer to Cosmos DB ADO.NET Provider just like connecting to any standard database.

  • Add a new Data Connection from the Server Explorer and select the Azure Cosmos DB Data Source
  • Configure the basic connection properties to access your Azure Cosmos DB account data.

Explore all of the data available! Cosmos DB ADO.NET Provider makes it easy to access live Azure Cosmos DB data from Visual Studio.

  • After configuring the connection, explore the feeds, views, and services provided by the Azure Cosmos DB Data Source.
  • These constructs return live Azure Cosmos DB data that developers can work with directly from within Visual Studio!

Developer Integration: Databind to Cosmos DB

Connecting Web, Desktop, and Mobile .NET applications with Azure Cosmos DB is just like working with SQL Server. It is even possible to integrate Cosmos DB ADO.NET Provider into applications without writing code.

Developers are free to access the Cosmos DB ADO.NET Provider in whatever way they like best. Either visually through the Visual Studio Winforms or Webforms designers, or directly through code.

  • Developers can connect the Azure Cosmos DB Data Source directly to form components by configuring the object's smart tags.
  • Add a new Data Connection from the Server Explorer and select the Azure Cosmos DB Data Source. Then, select the feed, view, or services you would like to connect the object to.

Done! It's just like connecting to SQL Server.

  • Once the object is bound to the data source, applications can easily interact with Azure Cosmos DB data with full read/write (CRUD) support.

Popular ADO Videos:

Connecting to Live Data from ADO Apps

Download the Cosmos DB ADO.NET driver today!

download
buy now