Skip to content

Commit 4f0fa57

Browse files
Merge pull request #90737 from ausfeldt/inline_v2_changelog
inline sdk v2 changelog
2 parents 7104fdc + cd4df5a commit 4f0fa57

File tree

3 files changed

+9
-686
lines changed

3 files changed

+9
-686
lines changed

.openpublishing.publish.config.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -302,11 +302,16 @@
302302
"url": "https://github.com/Azure-Samples/cosmos-dotnet-todo-app",
303303
"branch": "master"
304304
},
305-
{
305+
{
306306
"path_to_root": "samples-cosmosdb-dotnet-v3",
307307
"url": "https://github.com/Azure/azure-cosmos-dotnet-v3",
308308
"branch": "master"
309309
},
310+
{
311+
"path_to_root": "samples-cosmosdb-dotnet-v2",
312+
"url": "https://github.com/Azure/azure-cosmos-dotnet-v2",
313+
"branch": "master"
314+
},
310315
{
311316
"path_to_root": "samples-cosmosdb-dotnet-change-feed-processor",
312317
"url": "https://github.com/Azure-Samples/cosmos-dotnet-change-feed-processor",

articles/cosmos-db/sql-api-sdk-dotnet-core.md

Lines changed: 1 addition & 270 deletions
Original file line numberDiff line numberDiff line change
@@ -41,277 +41,8 @@ ms.author: sngun
4141
> [!NOTE]
4242
> If you are using .NET Core, please see the latest version 3.x of the [.NET SDK](sql-api-sdk-dotnet-standard.md), which targets .NET Standard.
4343
44-
### <a name="2.7.0"/>2.7.0
44+
[!INCLUDE[Release notes](~/samples-cosmosdb-dotnet-v2/changelog.md)]
4545

46-
* Added support for arrays and objects in order by queries
47-
* Handle effective partition key collisions
48-
* Added LINQ support for multiple OrderBy operators with ThenBy operator
49-
* Custom serialization settings are now applied to all upsert and replace operations
50-
* Fixed AysncCache deadlock issue so that it will work with a single-threaded task scheduler
51-
52-
### <a name="2.6.0"/>2.6.0
53-
54-
* Added PortReusePolicy to ConnectionPolicy
55-
* Fixed ntdll!RtlGetVersion TypeLoadException issue when SDK is used in a UWP app
56-
57-
### <a name="2.5.1"/>2.5.1
58-
59-
* SDK’s System.Net.Http version now matches what is defined in the NuGet package.
60-
* Allow write requests to fallback to a different region if the original one fails.
61-
* Add session retry policy for write request.
62-
63-
### <a name="2.4.1"/>2.4.1
64-
65-
* Fixes tracing race condition for queries which caused empty pages
66-
67-
### <a name="2.4.0"/>2.4.0
68-
69-
* Increased decimal precision size for LINQ queries.
70-
* Added new classes CompositePath, CompositePathSortOrder, SpatialSpec, SpatialType and PartitionKeyDefinitionVersion
71-
* Added TimeToLivePropertyPath to DocumentCollection
72-
* Added CompositeIndexes and SpatialIndexes to IndexPolicy
73-
* Added Version to PartitionKeyDefinition
74-
* Added None to PartitionKey
75-
76-
### <a name="2.3.0"/>2.3.0
77-
78-
* Added IdleTcpConnectionTimeout, OpenTcpConnectionTimeout, MaxRequestsPerTcpConnection and MaxTcpConnectionsPerEndpoint to ConnectionPolicy.
79-
80-
### <a name="2.2.3"/>2.2.3
81-
82-
* Diagnostics improvements
83-
84-
### <a name="2.2.2"/>2.2.2
85-
86-
* Added environment variable setting “POCOSerializationOnly”.
87-
88-
* Removed DocumentDB.Spatial.Sql.dll and now included in Microsoft.Azure.Documents.ServiceInterop.dll
89-
90-
### <a name="2.2.1"/>2.2.1
91-
92-
* Improvement in retry logic during failover for StoredProcedure execute calls.
93-
94-
* Made DocumentClientEventSource singleton.
95-
96-
* Fix GatewayAddressCache timeout not honoring ConnectionPolicy RequestTimeout.
97-
98-
### <a name="2.2.0"/>2.2.0
99-
100-
* For direct/TCP transport diagnostics, added TransportException, an internal exception type of the SDK. When present in exception messages, this type prints additional information for troubleshooting client connectivity problems.
101-
102-
* Added new constructor overload which takes a HttpMessageHandler, a HTTP handler stack to use for sending HttpClient requests (e.g., HttpClientHandler).
103-
104-
* Fix bug where header with null values were not being handled properly.
105-
106-
* Improved collection cache validation.
107-
108-
### <a name="2.1.3"/>2.1.3
109-
110-
* Updated System.Net.Security to 4.3.2.
111-
112-
### <a name="2.1.2"/>2.1.2
113-
114-
* Diagnostic tracing improvements.
115-
116-
### <a name="2.1.1"/>2.1.1
117-
118-
* Added more resilience to Multi-region request transient failures.
119-
120-
### <a name="2.1.0"/>2.1.0
121-
122-
* Added Multi-region write support.
123-
* Cross partition query performance improvements with TOP and MaxBufferedItemCount.
124-
125-
### <a name="2.0.0"/>2.0.0
126-
127-
* Added request cancellation support.
128-
* Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
129-
* Fixed Bug in Cross Partition Queries with Min/Max and a filter that matches no documents on an individual partition.
130-
* DocumentClient methods now have parity with IDocumentClient.
131-
* Updated direct TCP transport stack to reduce the number of connections established.
132-
* Added support for Direct Mode TCP for non-Windows clients.
133-
134-
### <a name="2.0.0-preview2"/>2.0.0-preview2
135-
136-
* Added request cancellation support.
137-
* Added SetCurrentLocation to ConnectionPolicy, which automatically populates the preferred locations based on the region.
138-
* Fixed Bug in Cross Partition Queries with Min/Max and a filter that matches no documents on an individual partition.
139-
140-
### <a name="2.0.0-preview"/>2.0.0-preview
141-
142-
* DocumentClient methods now have parity with IDocumentClient.
143-
* Updated direct TCP transport stack to reduce the number of connections established.
144-
* Added support for Direct Mode TCP for non-Windows clients.
145-
146-
### <a name="1.10.0"/>1.10.0
147-
148-
* Added ConsistencyLevel Property to FeedOptions.
149-
* Added JsonSerializerSettings to RequestOptions and FeedOptions.
150-
* Added EnableReadRequestsFallback to ConnectionPolicy.
151-
152-
### <a name="1.9.1"/>1.9.1
153-
154-
* Fixed KeyNotFoundException for cross partition order by queries in corner cases.
155-
* Fixed bug where JsonProperty attribute in select clause for LINQ queries was not being honored.
156-
157-
### <a name="1.8.2"/>1.8.2
158-
159-
* Fixed bug that is hit under certain race conditions, that results in intermittent "Microsoft.Azure.Documents.NotFoundException: The read session is not available for the input session token" errors when using Session consistency level.
160-
161-
### <a name="1.8.1"/>1.8.1
162-
163-
* Fixed regression where FeedOptions.MaxItemCount = -1 threw an System.ArithmeticException: page size is negative.
164-
* Added a new ToString() function to QueryMetrics.
165-
* Exposed partition statistics on reading collections.
166-
* Added PartitionKey property to ChangeFeedOptions.
167-
* Minor bug fixes.
168-
169-
### <a name="1.7.1"/>1.7.1
170-
171-
* Adds the ability to specify unique indexes for the documents by using UniqueKeyPolicy property on the DocumentCollection.
172-
* Fixed a bug in which the custom JsonSerializer settings were not being honored for some queries and stored procedure execution.
173-
174-
### <a name="1.7.0"/>1.7.0
175-
176-
* Branding change from Azure DocumentDB to Azure Cosmos DB in the API Reference documentation, metadata information in assemblies, and the NuGet package.
177-
* Expose diagnostic information and latency from the response of requests sent with direct connectivity mode. The property names are RequestDiagnosticsString and RequestLatency on ResourceResponse class.
178-
* This SDK version requires the latest version of Azure Cosmos DB Emulator available for download from https://aka.ms/cosmosdb-emulator.
179-
180-
### <a name="1.6.0"/>1.6.0
181-
182-
* Added several reliability fixes and improvements.
183-
184-
### <a name="1.5.1"/>1.5.1
185-
186-
* Internal changes related to supporting [Microsoft.Azure.Graphs](https://docs.microsoft.com/azure/cosmos-db/graph-sdk-dotnet)
187-
188-
### <a name="1.5.0"/>1.5.0
189-
190-
* Added support for PartitionKeyRangeId as a FeedOption for scoping query results to a specific partition key range value.
191-
* Added support for StartTime as a ChangeFeedOption to start looking for the changes after that time.
192-
193-
### <a name="1.4.1"/>1.4.1
194-
195-
* Fixed an issue in the JsonSerializable class that may cause a stack overflow exception.
196-
197-
### <a name="1.4.0"/>1.4.0
198-
199-
* Added support for specifying custom JsonSerializerSettings while instantiating a [DocumentClient](/dotnet/api/microsoft.azure.documents.client.documentclient?view=azure-dotnet) instance.
200-
201-
### <a name="1.3.2"/>1.3.2
202-
203-
* Supporting .NET Standard 1.5 as one of the target frameworks.
204-
205-
### <a name="1.3.1"/>1.3.1
206-
207-
* Fixed an issue that affected x64 machines that don’t support SSE4 instruction and throw SEHException when running Azure Cosmos DB queries.
208-
209-
### <a name="1.3.0"/>1.3.0
210-
211-
* Added support for a new consistency level called ConsistentPrefix.
212-
* Added support for query metrics for individual partitions.
213-
* Added support for limiting the size of the continuation token for queries.
214-
* Added support for more detailed tracing for failed requests.
215-
* Made some performance improvements in the SDK.
216-
217-
### <a name="1.2.2"/>1.2.2
218-
219-
* Fixed an issue that ignored the PartitionKey value provided in FeedOptions for aggregate queries.
220-
* Fixed an issue in transparent handling of partition management during mid-flight cross-partition Order By query execution.
221-
222-
### <a name="1.2.1"/>1.2.1
223-
224-
* Fixed an issue which caused deadlocks in some of the async APIs when used inside ASP.NET context.
225-
226-
### <a name="1.2.0"/>1.2.0
227-
228-
* Fixes to make SDK more resilient to automatic failover under certain conditions.
229-
230-
### <a name="1.1.2"/>1.1.2
231-
232-
* Fix for an issue that occasionally causes a WebException: The remote name could not be resolved.
233-
* Added the support for directly reading a typed document by adding new overloads to ReadDocumentAsync API.
234-
235-
### <a name="1.1.1"/>1.1.1
236-
237-
* Added LINQ support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG).
238-
* Fix for a memory leak issue for the ConnectionPolicy object caused by the use of event handler.
239-
* Fix for an issue wherein UpsertAttachmentAsync was not working when ETag was used.
240-
* Fix for an issue wherein cross partition order-by query continuation was not working when sorting on string field.
241-
242-
### <a name="1.1.0"/>1.1.0
243-
244-
* Added support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG). See [Aggregation support](sql-query-aggregates.md).
245-
* Lowered minimum throughput on partitioned collections from 10,100 RU/s to 2500 RU/s.
246-
247-
### <a name="1.0.0"/>1.0.0
248-
249-
The Azure Cosmos DB .NET Core SDK enables you to build fast, cross-platform [ASP.NET Core](https://www.asp.net/core) and [.NET Core](https://www.microsoft.com/net/core#windows) apps to run on Windows, Mac, and Linux. The latest release of the Azure Cosmos DB .NET Core SDK is fully [Xamarin](https://www.xamarin.com) compatible and be used to build applications that target iOS, Android, and Mono (Linux). 
250-
251-
### <a name="0.1.0-preview"/>0.1.0-preview
252-
253-
The Azure Cosmos DB .NET Core Preview SDK enables you to build fast, cross-platform [ASP.NET Core](https://www.asp.net/core) and [.NET Core](https://www.microsoft.com/net/core#windows) apps to run on Windows, Mac, and Linux.
254-
255-
The Azure Cosmos DB .NET Core Preview SDK has feature parity with the latest version of the [Azure Cosmos DB .NET SDK](sql-api-sdk-dotnet.md) and supports the following:
256-
* All [connection modes](performance-tips.md#networking): Gateway mode, Direct TCP, and Direct HTTPs.
257-
* All [consistency levels](consistency-levels.md): Strong, Session, Bounded Staleness, and Eventual.
258-
* [Partitioned collections](partition-data.md).
259-
* [Multi-region database accounts and geo-replication](distribute-data-globally.md).
260-
261-
If you have questions related to this SDK, post to [StackOverflow](https://stackoverflow.com/questions/tagged/azure-documentdb), or file an issue in the [GitHub repository](https://github.com/Azure/azure-documentdb-dotnet/issues).
262-
263-
## Release & Retirement dates
264-
Microsoft provides notification at least **12 months** in advance of retiring an SDK in order to smooth the transition to a newer/supported version.
265-
266-
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.
267-
268-
Any requests to Azure Cosmos DB using a retired SDK are rejected by the service.
269-
270-
> [!WARNING]
271-
> All versions **1.x** of the .NET Core SDK for SQL API will be retired on **August 30, 2020**.
272-
>
273-
>
274-
<br/>
275-
276-
277-
| Version | Release Date | Retirement Date |
278-
| --- | --- | --- |
279-
| [2.7.0](#2.7.0) |September 23, 2019 |--- |
280-
| [2.6.0](#2.6.0) |August 30, 2019 |--- |
281-
| [2.5.1](#2.5.1) |July 02, 2019 |--- |
282-
| [2.4.1](#2.4.1) |June 20, 2019 |--- |
283-
| [2.4.0](#2.4.0) |May 05, 2019 |--- |
284-
| [2.3.0](#2.3.0) |April 04, 2019 |--- |
285-
| [2.2.3](#2.2.3) |March 11, 2019 |--- |
286-
| [2.2.2](#2.2.2) |February 06, 2019 |--- |
287-
| [2.2.1](#2.2.1) |December 24, 2018 |--- |
288-
| [2.2.0](#2.2.0) |December 07, 2018 |--- |
289-
| [2.1.3](#2.1.3) |October 15, 2018 |--- |
290-
| [2.1.2](#2.1.2) |October 04, 2018 |--- |
291-
| [2.1.1](#2.1.1) |September 27, 2018 |--- |
292-
| [2.1.0](#2.1.0) |September 21, 2018 |--- |
293-
| [2.0.0](#2.0.0) |September 07, 2018 |--- |
294-
| [1.9.1](#1.9.1) |March 09, 2018 |August 30, 2020 |
295-
| [1.8.2](#1.8.2) |February 21, 2018 |August 30, 2020 |
296-
| [1.8.1](#1.8.1) |February 05, 2018 |August 30, 2020 |
297-
| [1.7.1](#1.7.1) |November 16, 2017 |August 30, 2020 |
298-
| [1.7.0](#1.7.0) |November 10, 2017 |August 30, 2020 |
299-
| [1.6.0](#1.6.0) |October 17, 2017 |August 30, 2020 |
300-
| [1.5.1](#1.5.1) |October 02, 2017 |August 30, 2020 |
301-
| [1.5.0](#1.5.0) |August 10, 2017 |August 30, 2020 |
302-
| [1.4.1](#1.4.1) |August 07, 2017 |August 30, 2020 |
303-
| [1.4.0](#1.4.0) |August 02, 2017 |August 30, 2020 |
304-
| [1.3.2](#1.3.2) |June 12, 2017 |August 30, 2020 |
305-
| [1.3.1](#1.3.1) |May 23, 2017 |August 30, 2020 |
306-
| [1.3.0](#1.3.0) |May 10, 2017 |August 30, 2020 |
307-
| [1.2.2](#1.2.2) |April 19, 2017 |August 30, 2020 |
308-
| [1.2.1](#1.2.1) |March 29, 2017 |August 30, 2020 |
309-
| [1.2.0](#1.2.0) |March 25, 2017 |August 30, 2020 |
310-
| [1.1.2](#1.1.2) |March 20, 2017 |August 30, 2020 |
311-
| [1.1.1](#1.1.1) |March 14, 2017 |August 30, 2020 |
312-
| [1.1.0](#1.1.0) |February 16, 2017 |August 30, 2020 |
313-
| [1.0.0](#1.0.0) |December 21, 2016 |August 30, 2020 |
314-
| [0.1.0-preview](#0.1.0-preview) |November 15, 2016 |December 31, 2016 |
31546

31647
## See Also
31748
To learn more about Cosmos DB, see [Microsoft Azure Cosmos DB](https://azure.microsoft.com/services/cosmos-db/) service page.

0 commit comments

Comments
 (0)