azure-cosmos-dotnet-v2/Readme.md

# 🚨Deprecated 🚨

## We've recently announced the deprecation of the Azure Cosmos DB .NET SDK Version 2. Starting August 2024 Microsoft will no longer provide support for this SDK. Existing applications using this library will continue to work as-is. We strongly recommend upgrading to the latest [version of the SDK](https://github.com/Azure/azure-cosmos-dotnet-v3). For details on how to migrate your existing applications, follow our [migration guide](https://docs.microsoft.com/en-us/azure/cosmos-db/sql/migrate-dotnet-v3?tabs=dotnet-v3).

# Microsoft Azure Cosmos DB .NET SDK Version 2
This project provides a client tools or utilities in .NET that makes it easy to interact with Azure Cosmos DB. Azure cosmos DB is published with nuget name [Microsoft.Azure.DocumentDB](https://www.nuget.org/packages/Microsoft.Azure.DocumentDB/). 

## Useful links:

- [Get Started APP](https://docs.microsoft.com/azure/cosmos-db/sql-api-get-started)
- [Samples](https://docs.microsoft.com/azure/cosmos-db/sql-api-dotnet-samples)
- [Github samples](https://github.com/Azure/azure-documentdb-dotnet/tree/master/samples)
- [MultiMaster samples](https://github.com/markjbrown/azure-cosmosdb-dotnet/tree/master/samples/MultiMaster)
- [Resource Model of Azure Cosmos DB Service]( https://docs.microsoft.com/azure/cosmos-db/sql-api-resources)
- [Cosmos DB Resource URI](https://docs.microsoft.com/rest/api/documentdb/documentdb-resource-uri-syntax-for-rest)
- [Partitioning](https://docs.microsoft.com/azure/cosmos-db/partition-data)
- [Introduction to SQL API of Azure Cosmos DB Service](https://docs.microsoft.com/azure/cosmos-db/sql-api-sql-query)
- [SDK API](https://docs.microsoft.com/dotnet/api/overview/azure/cosmosdb?view=azure-dotnet)
- [Using emulator](https://github.com/Azure/azure-documentdb-dotnet/blob/master/docs/documentdb-nosql-local-emulator.md)
- [Capture traces](https://github.com/Azure/azure-documentdb-dotnet/blob/master/docs/documentdb-sdk_capture_etl.md)
- [Release notes](https://github.com/Azure/azure-documentdb-dotnet/blob/master/changelog.md)


## Disclaimer
The implementation in this project is intended for reference purpose only.


## Minimum Requirements
.Net 4.5


## Consuming the official Microsoft Azure Cosmos DB SDK
From Package Manager Console

    **Install-Package Microsoft.Azure.DocumentDB**
   
## SDK release notes
https://github.com/Azure/azure-documentdb-dotnet/blob/master/changelog.md 

https://docs.microsoft.com/azure/cosmos-db/sql-api-sdk-dotnet

## Performance tips
https://docs.microsoft.com/azure/cosmos-db/performance-tips

## Diagnose and troubleshooting issues
https://docs.microsoft.com/azure/cosmos-db/troubleshoot-dot-net-sdk

## Samples
https://docs.microsoft.com/azure/cosmos-db/sql-api-dotnet-samples is a good starting point.

Also great source of samples can be found at https://github.com/Azure/azure-documentdb-dotnet/tree/master/samples