3.27.0-preview

3.27.0-preview - 2022-05-06

Added

• #3123 Availability: Adds optimization to reduce reduce metadata calls for addresses
• #3127 Availability: Adds logic to reduce impact of replica failovers and upgrades
• #3093 Patch: Adds Null support for Set operation
• #3111 & #3015 Merge support: Minimum SDK version that includes partition merge support.
• #2924 Performance: Adds a LINQ optimization for member access in LINQ-to-SQL (Thanks @notheotherben)
• #3165 Diagnostics: Adds response serialization time
• #3168 Performance: Adds aggressive prefetching for scalar aggregates for Query

Fixed

• #3102 Upsert item: Fixes a bug causing session tokens for partition 0 to be overridden by session token for another partition when users don't pass the token as input
• #3119 Session: Fixes NotFound/ReadSessionNotAvailable (404/1002) on collection-recreate scenario for query-only workloads
• #3124 Change Feed Processor: Fixes noisy error notification when lease is stolen by other host
• #3141 Diagnostics: Fixes contacted replica count
• #3173 UserAgent: Optimized size by removing irrelevant information

3.26.2

3.26.2 - 2022-05-05

• #3155 Query: Fixes "System.ArgumentException: Stream was not readable." when using WithParameterStream
• #3154 Query: Fixes possible missing query results on Windows x64 when using a custom serializer
• #3137 Query: Fixes exception message readability for invalid query text. Introduced in 3.14.0 PR #1812

3.26.1

Added

• #3080 & #3081 Availability: Adds optimization to partition key ranges cache to reduce number of gateway calls in exception scenarios
• #3079 Availability: Adds a memory optimization to remove cached values when a not found is returned on a refresh
• #3089 Availability: Adds retries to gateway calls for metadata operations on 408 responses

3.26.0

3.26.0 - 2022-03-11

Added

• #3037 Diagnostics: Adds total number of active clients information
• #3068 Query: Adds FeedRange API for Query to GA
• #3035 Client Encryption: Adds Client Encryption APIs to GA SDK

3.26.0-preview

3.26.0-preview - 2022-02-28

Added

• #3037 Diagnostics: Adds total number of active clients information
• #3049 ClientEncryption: Adds algorithm to EncryptionKeyWrapMetadata

3.25.0

3.25.0 - 2022-02-18

Added

• #3029 Dependencies: Upgrades to Azure.Core 1.19.0.

Fixed

• #3034, #3024, #3018, #3000 Documentation: Improvements in code samples within xml documentation.
• #3027 Initialization: Fixes the SDK to retry if the initialization fails due to transient errors.

3.25.0-preview

3.25.0-preview - 2022-02-18

Added

• #3029 Dependencies: Upgrades to Azure.Core 1.19.0.

Fixed

• #3034, #3024, #3018, #3000 Documentation: Improvements in code samples within xml documentation.
• #3027 Initialization: Fixes the SDK to retry if the initialization fails due to transient errors.

3.24.0

3.24.0 - 2022-01-31

⚠️ 3.24.0 removes the DefaultTraceListener from the SDK TraceSource for performance reasons by default when not running in Debug mode.

Added

• #2926 Performance: Removes DefaultTraceListener by default.
• #3008 Performance: Adds buffer optimizations to Direct mode.
• #2875 Query: Adds Index Metrics to Stream API.
• #2401 Query: Adds Correlated ActivityId wiring through query.
• #2917 LINQ: Adds support for Nullable<T>.Value or Nullable<T>.HasValue when using camelCase serialization.
• #2893 Diagnostics: Adds address info to diagnostics on force cache refresh.
• #3008 Diagnostics: Adds diagnostics for splits and timeouts.
• #2907 Diagnostics: Adds performance improvement to GetContactedRegions().
• #2988 Diagnostics: Adds performance improvement by reducing size and removing irrelevant information (caller info).
• #3008 Diagnostics: Adds ServiceEndpoint and Connection Stats to the diagnostics.
• #3008 Availability: Direct mode removes blocking call on broken connection exception.
• #3008 Supportability: Adds SDK generated substatus codes for 503's to separate from server side 503.

Fixed

• #3008 Availability: Fixes the SDK to ensure it does not retry on replica that previously failed with 410, 408 and >= 500 status codes.
• #2869 Performance: Fixes query improvement to load values lazily. Introduced in 3.14.0 PR #1812
• #2883 Change Feed Processor: Fixes diagnostics on Estimator and ChangeFeedProcessorContext. Introduced in 3.15.0 PR #1933
• #2900, #2899, #2915, #2912, #2925, #3000 Documentation: Improvements in code samples within xml documentation.
• #2937, #2975 Session: Improvements on session token handling for Gateway mode across splits and merges.
• #2965 Session: Fixes operations sending the session token on Gateway mode when the operation reduced consistency to lower than Session.
• #2975 Session: Fixes session token too large exception in Gateway mode if the client had no previous cache entry.

3.24.0-preview

3.24.0-preview - 2022-01-31

⚠️ 3.24.0 removes the DefaultTraceListener from the SDK TraceSource for performance reasons by default when not running in Debug mode.

Added

• #2960 UserAgent: Adds flag to user agent string to differentiate SDK version.
• #2926 Performance: Removes DefaultTraceListener by default.
• #3008 Performance: Adds buffer optimizations to Direct mode.
• #2875 Query: Adds Index Metrics to Stream API.
• #2401 Query: Adds Correlated ActivityId wiring through query.
• #2917 LINQ: Adds support for Nullable<T>.Value or Nullable<T>.HasValue when using camelCase serialization.
• #2893 Diagnostics: Adds address info to diagnostics on force cache refresh.
• #3008 Diagnostics: Adds diagnostics for splits and timeouts.
• #2907 Diagnostics: Adds performance improvement to GetContactedRegions().
• #2988 Diagnostics: Adds performance improvement by reducing size and removing irrelevant information (caller info).
• #3008 Diagnostics: Adds ServiceEndpoint and Connection Stats to the diagnostics.
• #3008 Availability: Direct mode removes blocking call on broken connection exception.
• #3008 Supportability: Adds SDK generated substatus codes for 503's to separate from server side 503.

Fixed

• #3008 Availability: Fixes the SDK to ensure it does not retry on replica that previously failed with 410, 408 and >= 500 status codes.
• #2869 Performance: Fixes query improvement to load values lazily. Introduced in 3.14.0 PR #1812
• #2883 Change Feed Processor: Fixes diagnostics on Estimator and ChangeFeedProcessorContext. Introduced in 3.15.0 PR #1933
• #2900, #2899, #2915, #2912, #2925, #3000 Documentation: Improvements in code samples within xml documentation.
• #2937, #2975 Session: Improvements on session token handling for Gateway mode across splits and merges.
• #2965 Session: Fixes operations sending the session token on Gateway mode when the operation reduced consistency to lower than Session.
• #2975 Session: Fixes session token too large exception in Gateway mode if the client had no previous cache entry.

3.23.0

3.23.0 - 2021-11-12

Added

• #2868 Patch: Adds support for patch operations
• #2822 Availability: Adds non-blocking async lazy cache to improve upgrade and scaling scenarios
• #2807 ChangeFeedProcessor: Adds ChangeFeedProcessorUserException for detailed error notification
• #2818 Diagnostics: Adds retry after time to diagnostics
• #2818 Availability: Adds retry context to ensure requests on retries do not go to replicas that previously hit transport exceptions

Fixed

• #2851 Query: Fixes stack overflow in SkipEmptyPageQueryPipelineStage. Introduced in 3.14.0 PR #1812
• #2844 CosmosClientBuilder: Fixes accountEndpoint not being set when using TokenCredential. (Thanks @levimatheri) Introduced in 3.22.0 PR #2753
• #2793 Query: Fixes missing diagnostic from query pipeline. Introduced in 3.17.0 PR #2097
• #2818 Diagnostics: Fixes memory calculations in diagnostics
• #2818 Availability: Fixes blocking call on broken connection exception
• #2861 Performance: Fixes query performance by avoiding ImmutableDictionary. Introduced in 3.17.0 PR #2144