3.40.0-preview.0

3.40.0-preview.0 - 2024-04-15

Fixed

• 4334 ChangeFeedProcessor: Fixes when ChangeFeedMode is switched, an exception is thrown

Added

• 4370 ChangeFeedProcessor: Adds AllVersionsAndDeletes support to ChangeFeedProcessor
• 4380 ChangeFeedProcessor: Refactors AllVersionsAndDeletes Metadata Contract for ChangeFeed and ChangeFeedProcessor

  Note: A Rename refactoring was performed in the effort to reduce redundancy and achieve clarity from a user perspective. The previous type ChangeFeedItemChange<T> was strategically renamed to ChangeFeedItem<T>. The refactoring affects both ChangeFeed (pull), and the new ChangeFeedProcessor (push), when in AllVersionsAndDeletes ChangeFeedMode. LatestVersion ChangeFeedMode is not affected and will continue to function as expected.

3.39.0

3.39.0 - 2024-04-15

Fixed

• 4357 Distributed Tracing Documentation : Fixes the default value mentioned in code doc

Added

• 4377 Integrated cache: Adds BypassIntegratedCache for public release
• 4265 CosmosClientOptions: Adds Private Custom Account Endpoints
• 4316 Distributed Tracing: Refactors code to rename net.peer.name attribute to server.address. Warning: This is a breaking change, only server.address will be emitted starting with this version.
• 4339 Diagnostics: Adds Client Configuration for Synchronization context cases
• 4333 Distributed Tracing: Adds configuration to disable network level tracing in sdk permanently
• 4323 Query: Adds Support for LINQ Custom Serializer in Public Release
• 4362 Query: Adds support for non streaming ORDER BY
• 4074 Query: Adds translation support for single key single value select GROUP BY LINQ queries
• 4361 Performance: Refactors query prefetch mechanism
• 4386 Regions: Adds new Regions

  Note: There is added support for the following regions: Taiwan North and Taiwan Northwest.
  This also includes a Direct Package version update to 3.33.0 in PR #4353

3.39.0-preview.1

3.39.0-preview.1 - 2024-02-08

Fixed

• 4294 DisableServerCertificateValidation: Fixes Default HttpClient to honor DisableServerCertificateValidation (#4294)

Added

• 4299 Query: Adds environment variable for overriding EnableOptimisticDirectExecution default (#4299)

  ⚠️ Note: This change provides another way to manage the upgrade to 3.38. It provides an option to avoid potential disruption due to the breaking change (see the note below) if only config deployment is preferred, instead of any explicit code modification.
  With this change, users can set the environment variable AZURE_COSMOS_OPTIMISTIC_DIRECT_EXECUTION_ENABLED to false in their production environments while upgrading from previous minor version (3.37 or below) to 3.38.1 (or above).
  This will signal the SDK to disable Optimistic Direct Execution by default.
  Once the environment is fully upgraded to the target version, the environment variable can be removed (or set to true) to enable ODE.
  It is recommended that the environment variable is used only to manage the upgrade and removed once the deployment is complete.
  Please note that environment variable acts as the override only for choosing the default value. If the code explicitly modifies the setting, that value will be honored during actual operations.

3.38.1

3.38.1 - 2024-02-08

Fixed

• 4294 DisableServerCertificateValidation: Fixes Default HttpClient to honor DisableServerCertificateValidation (#4294)

Added

• 4299 Query: Adds environment variable for overriding EnableOptimisticDirectExecution default (#4299)

  ⚠️ Note: This change provides another way to manage the upgrade to 3.38. It provides an option to avoid potential disruption due to the breaking change (see the note below) if only config deployment is preferred, instead of any explicit code modification.
  With this change, users can set the environment variable AZURE_COSMOS_OPTIMISTIC_DIRECT_EXECUTION_ENABLED to false in their production environments while upgrading from previous minor version (3.37 or below) to 3.38.1 (or above).
  This will signal the SDK to disable Optimistic Direct Execution by default.
  Once the environment is fully upgraded to the target version, the environment variable can be removed (or set to true) to enable ODE.
  It is recommended that the environment variable is used only to manage the upgrade and removed once the deployment is complete.
  Please note that environment variable acts as the override only for choosing the default value. If the code explicitly modifies the setting, that value will be honored during actual operations.

3.39.0-preview.0

Added

• 4138 Query: Adds support for LINQ Custom Serializer (#4138)

3.38.0

3.38.0 - 2024-01-31

⚠️ Note: Starting with version 3.38.0, the .NET SDK enables the ODE feature by default. This can potentially cause a new type of continuation token to be generated. Such a token is not recognized by the older SDKs by design and this could result in a Malformed Continuation Token Exception.
If you have a scenario where tokens generated from the newer SDKs are used by an older SDK, we recommend a 2 step approach to upgrade:

• Upgrade to the new SDK and disable ODE, both together as part of a single deployment. Wait for all nodes to upgrade.
  • In order to disable ODE, set EnableOptimisticDirectExecution to false in the QueryRequestOptions.
• Enable ODE as part of second deployment for all nodes.

Fixed

• 4205 ClientRetryPolicy: Fixes Metadata Requests Retry Policy (#4205)
• 4220 Change Feed Processor: Fixes disposal of unused CancellationTokenSource (#4220)
• 4229 GatewayClientStore: Fixes an issue with dealing with invalid JSON HTTP responses (#4229)
• 4260 Query: Fixes LINQ Translation of SqlNullLiteral Values (#4260)
• 4276 Change Feed Processor: Fixes LeaseLostException on Notifications API for Renewer (#4276)
• 4241 GlobalEndpointManager: Fixes Unobserved and Unhandled Exception from Getting Thrown (#4241)

Added

• 4122 Query: Adds Optimistic Direct Execution configuration override support on the Client (#4122)
• 4240 BulkMode: Adds PartitionKeyRangeId in Bulk Mode and TransactionalBatch Response Headers (#4240)
• 4252 Query: Adds Request Charge to Query Metrics (#4252)
• 4225 Query: Refactors Optimistic Direct Execution to be turned on by default on .NET SDK (#4225). WARNING: This is breaking change for GA. For more details, please take a look at the 3.38.0 Note section.
• 4251 Emulator : Adds support for flag in connection string to ignore SSL check (#4251)
• 4279 Region Availability: Adds Spain Central and Mexico Central Regions For Public Usage (#4279)
• 4286 Query: Adds LINQ Support for FirstOrDefault (#4286)
• 4262 PriorityBasedExecution: Adds PriorityLevel in CosmosClientOptions (#4262)

3.37.1

3.37.0 - 2024-1-2

Fixed

• 4226 GlobalEndpointManager: Fixes Memory Leak (#4226)

3.37.0

3.37.0 - 2023-11-20

Fixed

• 4100 Query : Fixes querying conflicts (#4100)
• 4125 Item Operations: Fixes JsonSerialization exception when MissingMemberHandling = Error on Json default settings when NotFound on Item operations (#4125)

Added

• 4180 Upgrade Resiliency: Adds Code to Enable Advanced Replica Selection Feature for Preview and GA (#4180)
• 4128 Routing: Adds ExcludeRegions Feature to RequestOptions (#4128)

3.37.0-preview

3.37.0-preview - 2023-11-20

Fixed

• 4100 Query : Fixes querying conflicts (#4100)
• 4125 Item Operations: Fixes JsonSerialization exception when MissingMemberHandling = Error on Json default settings when NotFound on Item operations (#4125)

Added

• 4180 Upgrade Resiliency: Adds Code to Enable Advanced Replica Selection Feature for Preview and GA (#4180)
• 4128 Routing: Adds ExcludeRegions Feature to RequestOptions (#4128)

3.36.0

Fixed

#4039 GatewayAddressCache: Fixes Unobserved Exception During Background Address Refresh (#4039)
#4098 Distributed Tracing: Fixes dependency failure on appinsights (#4098)
#4097 Distributed Tracing: Fixes SDK responses compatibility with opentelemetry response (#4097)
#4111 Distributed Tracing: Fixes traceid null exception issue (#4111)

Added

#4009 Query: Adds ODE continuation token support for non-ODE pipelines (#4009)
#4078 Query: Adds LINQ RegexMatch Extension method (#4078)
#4001 Query: Adds public backend metrics property to Diagnostics (#4001)
#4016 CosmosClientOptions: Adds support for multiple formats of Azure region names (#4016)
#4056 Client Telemetry: Adds new public APIs (#4056)
Note: Refer this #3983 for API signature and default values.

#4119 TriggerOperation: Adds Upsert Operation Support(#4119)