How to Use Caching with Azure Cosmos DB

Azure Cosmos DB is a fully managed NoSQL database provided by Microsoft Azure. It is popular for the high data availability, scalability, and low-latency access it offers. However, such frequent database access can lead to performance bottlenecks and increased costs, as Azure charges users for each database transaction. Caching is essential to optimize performance and reduce costs. This article explores how NCache an open-source, in-memory, distributed caching solution can be integrated with this database in .NET 8 applications.

Why Caching is Needed for Azure Cosmos DB

As previously discussed, Azure Cosmos DB’s distributed nature can add latency, and large query volumes incur high RU (database transaction) costs. NCache optimizes performance by minimizing database trips, saving costs, and enhancing scalability. It provides high availability, loads the workload efficiently, and speeds up response times by providing frequently accessed data from memory. Moreover, NCache’s Client Cache, which can execute InProc on the application server, also enhances speed by avoiding network travel for cached data.

Implementing Caching with Azure Cosmos DB

Below is an optimized approach to implementing NCache with this database in .NET 8. This example assumes an application that retrieves customer data and caches it to optimize performance. However, please ensure you have Azure Cosmos DB and NCache (Open Source or Enterprise) installed and set up before proceeding. You will also require .NET 8 SDK, and Azure SDK for .NET.

Caching a Single Database Item

The following code snippet shows how to cache a single Customer record from Azure Cosmos DB using NCache.

using Alachisoft.NCache.Client;

using Alachisoft.NCache.Runtime.Caching;

using Microsoft.Azure.Cosmos;

using System;

using System.Threading.Tasks;

class Program

{

private static readonly string cosmosConnectionString = "";

private static readonly string cacheName = "myClusteredCache";

static async Task Main(string[] args)

{

string customerId = "ALFKI";

string cacheKey = $"Customer:{customerId}";

ICache cache = CacheManager.GetCache(cacheName);

var cachedCustomer = cache.Get(cacheKey);

if (cachedCustomer == null)

{

Console.WriteLine("Cache miss. Fetching from Cosmos DB...");

var client = new CosmosClient(cosmosConnectionString);

var container = client.GetContainer("Northwind", "Customer");

PartitionKey partitionKey = new PartitionKey("Seattle");

var itemResponse =

await container.ReadItemAsync(customerId, partitionKey);

cachedCustomer = itemResponse.Resource;

var cacheItem = new CacheItem(cachedCustomer)

{

Expiration =

new Expiration(ExpirationType.Absolute, TimeSpan.FromMinutes(10))

};

cache.Insert(cacheKey, cacheItem);

Console.WriteLine("Customer data cached successfully.");

}

else

{

Console.WriteLine("Cache hit! Fetching from NCache...");

}

Caching a Collection of Database Items

Caching multiple database records improves efficiency when querying large datasets. Below is an optimized method to cache a list of customers from the database.

string key = "CustomersFromGermany";

IDistributedList germanCustomers = cache.DataTypeManager.GetList(key);

if (germanCustomers == null)

{

var container = cosmosClient.GetContainer("Northwind", "Customer");

var query =

new QueryDefinition("SELECT * FROM Customers c WHERE c.Country = 'Germany'");

var feedIterator = container.GetItemQueryIterator(query);

var attributes = new DataTypeAttributes()

{

Expiration =

new Expiration(ExpirationType.Absolute, TimeSpan.FromMinutes(10))

};

germanCustomers = cache.DataTypeManager.CreateList(key, attributes);

while (feedIterator.HasMoreResults)

{

var response = await feedIterator.ReadNextAsync();

foreach (var customer in response.Resource)

{

germanCustomers.Add(customer);

}

NCache Deployment in Azure

You can deploy NCache in Azure using multiple methods:

NCache Cloud: Fully managed caching solution available in Azure Marketplace.
Virtual Machines: Deploy NCache manually on Azure VMs for on-premises-like control.
Azure Kubernetes Service (AKS): Run NCache in containers for a scalable architecture.
Azure App Service: Host NCache as part of a PaaS deployment.

For more details on NCache Azure Deployment, visit NCache Documentation.

Conclusion

Integrating NCache with Azure Cosmos DB improves performance, lowers costs, provides low-latency, and high-availability. With distributed lists, bulk operations, and tag-based caching, NCache best handles caching for .NET 8 applications. For e-commerce, IoT, or AI-powered analytics, it provides a scalable, and efficient caching solution.