The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- #822 GROUP BY query support.
3.2.0 - 2019-09-17
- #100 Configurable Tcp settings to CosmosClientOptions
- #615, #775 Added request diagnostics to Response's
- #622 Added CRUD and query operations for Users and Permissions which enables ResourceToken support
- #716 Added camel case serialization on LINQ query generation
- #729, #776 Added aggregate(CountAsync/SumAsync etc.) extensions for LINQ query
- #743 Added WebProxy to CosmosClientOptions
- #726 Query iterator HasMoreResults now returns false if an exception is hit
- #705 User agent suffix gets truncated
- #753 Reason was not being propagated for Conflict exceptions
- #756 Change Feed Processor with WithStartTime would execute the delegate the first time with no items.
- #761 CosmosClient deadlocks when using a custom Task Scheduler like Orleans (Thanks to jkonecki)
- #769 Session Consistency + Gateway mode session-token bug fix: Under few rare non-success cases session token might be in-correct
- #772 Fixed Throughput throwing when custom serializer used or offer doesn't exists
- #785 Incorrect key to throw CosmosExceptions with HttpStatusCode.Unauthorized status code
3.1.1 - 2019-08-12
- #650 CosmosSerializerOptions to customize serialization
- #612 Bug fix for ReadFeed with partition-key
- #614 Fixed SpatialPath serialization and compatibility with older index versions
- #619 Fixed PInvokeStackImbalance exception for .NET Framework
- #626 FeedResponse status code now return OK for success instead of the invalid status code 0 or Accepted
- #629 Fixed CreateContainerIfNotExistsAsync validation to limited to partitionKeyPath only
- #630 Fixed User Agent to contain environment and package information
- #541 Added consistency level to client and query options
- #544 Added continuation token support for LINQ
- #557 Added trigger options to item request options
- #572 Added partition key validation on CreateContainerIfNotExistsAsync
- #581 Added LINQ to QueryDefinition API
- #592 Added CreateIfNotExistsAsync to container builder
- #597 Added continuation token property to ResponseMessage
- #604 Added LINQ ToStreamIterator extension method
- #548 Fixed mis-typed message in CosmosException.ToString();
- #558 LocationCache ConcurrentDict lock contention fix
- #561 GetItemLinqQueryable now works with null query
- #567 Query correctly handles different language cultures
- #574 Fixed empty error message if query parsing fails from unexpected exception
- #576 Query correctly serializes the input into a stream
3.0.0 - 2019-07-15
- General availability of Version 3.0.0 of the .NET SDK
- Targets .NET Standard 2.0, which supports .NET framework 4.6.1+ and .NET Core 2.0+
- New object model, with top-level CosmosClient and methods split across relevant Database and Container classes
- New highly performant stream APIs
- Built-in support for Change Feed processor APIs
- Fluent builder APIs for CosmosClient, Container, and Change Feed processor
- Idiomatic throughput management APIs
- Granular RequestOptions and ResponseTypes for database, container, item, query and throughput requests
- Ability to scale non-partitioned containers
- Extensible and customizable serializer
- Extensible request pipeline with support for custom handlers
Microsoft provides notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.
New features and functionality and optimizations are only added to the current SDK, as such it is recommended that you always upgrade to the latest SDK version as early as possible.
Any requests to Azure Cosmos DB using a retired SDK are rejected by the service.
| Version | Release Date | Retirement Date |
|---|---|---|
| 3.2.0 | September 18, 2019 | --- |
| 3.1.1 | August 12, 2019 | --- |
| 3.1.0 | July 29, 2019 | --- |
| 3.0.0 | July 15, 2019 | --- |