Azure Cosmos DB Table .NET Standard API: Download and release notes

APPLIES TO: Table API

SDK download NuGet
Sample Cosmos DB Table API .NET Sample
Quickstart Quickstart
Tutorial Tutorial
Current supported framework Microsoft .NET Standard 2.0
Report Issue Report Issue

Release notes for 2.0.0 series

2.0.0 series takes the dependency on Microsoft.Azure.Cosmos, with performance improvements and namespace consolidation to Cosmos DB endpoint.

2.0.0-preview

  • initial preview of 2.0.0 Table SDK that takes the dependency on Microsoft.Azure.Cosmos, with performance improvements and namespace consolidation to Cosmos DB endpoint. The public API remains the same.

Release notes for 1.0.0 series

1.0.0 series takes the dependency on Microsoft.Azure.DocumentDB.Core.

1.0.8

  • Add support to set TTL property if it's cosmosdb endpoint
  • Honor retry policy upon timeout and task cancelled exception
  • Fix intermittent task cancelled exception seen in asp .net applications
  • Fix azure table storage retrieve from secondary endpoint only location mode
  • Update Microsoft.Azure.DocumentDB.Core dependency version to 2.11.2 which fixes intermittent null reference exception
  • Update Odata.Core dependency version to 7.6.4 which fixes compatibility conflict with azure shell

1.0.7

  • Performance improvement by setting Table SDK default trace level to SourceLevels.Off, which can be opted in via app.config

1.0.5

  • Introduce new config under TableClientConfiguration to use Rest Executor to communicate with Cosmos DB Table API

1.0.5-preview

  • Bug fixes

1.0.4

  • Bug fixes
  • Provide HttpClientTimeout option for RestExecutorConfiguration.

1.0.4-preview

  • Bug fixes
  • Provide HttpClientTimeout option for RestExecutorConfiguration.

1.0.1

  • Bug fixes

1.0.0

  • General availability release

0.11.0-preview

  • Changes were made to how CloudTableClient can be configured. It now takes an a TableClientConfiguration object during construction. TableClientConfiguration provides different properties to configure the client behavior depending on whether the target endpoint is Cosmos DB Table API or Azure Storage Table API.
  • Added support to TableQuery to return results in sorted order on a custom column. This feature is only supported on Cosmos DB Table endpoints.
  • Added support to expose RequestCharges on various result types. This feature is only supported on Cosmos DB Table endpoints.

0.10.1-preview

  • Add support for SAS token, operations of TablePermissions, ServiceProperties, and ServiceStats against Azure Storage Table endpoints.

    Note

    Some functionalities in previous Azure Storage Table SDKs are not yet supported, such as client-side encryption.

0.10.0-preview

  • Add support for core CRUD, batch, and query operations against Azure Storage Table endpoints.

    Note

    Some functionalities in previous Azure Storage Table SDKs are not yet supported, such as client-side encryption.

0.9.1-preview

  • Azure Cosmos DB Table .NET Standard SDK is a cross-platform .NET library that provides efficient access to the Table data model on Cosmos DB. This initial release supports the full set of Table and Entity CRUD + Query functionalities with similar APIs as the Cosmos DB Table SDK For .NET Framework.

    Note

    Azure Storage Table endpoints are not yet supported in the 0.9.1-preview version.

Release and Retirement dates

Microsoft provides notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.

This cross-platform .NET Standard library Microsoft.Azure.Cosmos.Table will replace the .NET Framework library Microsoft.Azure.CosmosDB.Table.

2.0.0 series

Version Release Date Retirement Date
2.0.0-preview Auguest 22, 2019 ---

1.0.0 series

Version Release Date Retirement Date
1.0.5 September 13, 2019 ---
1.0.5-preview Auguest 20, 2019 ---
1.0.4 Auguest 12, 2019 ---
1.0.4-preview July 26, 2019 ---
1.0.2-preview May 2, 2019 ---
1.0.1 April 19, 2019 ---
1.0.0 March 13, 2019 ---
0.11.0-preview March 5, 2019 ---
0.10.1-preview January 22, 2019 ---
0.10.0-preview December 18, 2018 ---
0.9.1-preview October 18, 2018 ---

FAQ

How will I be notified of the retiring SDK?

Microsoft will provide 12 month's advance notice before the end of support of the retiring SDK to facilitate a smooth transition to a supported SDK. We'll notify you through various communication channels: the Azure portal, Azure updates, and direct communication to assigned service administrators.

Can I author applications by using a to-be-retired Azure Cosmos DB SDK during the 12-month period?

Yes, you'll be able to author, deploy, and modify applications by using the to-be-retired Azure Cosmos DB SDK during the 12-month notice period. We recommend that you migrate to a newer supported version of the Azure Cosmos DB SDK during the 12-month notice period, as appropriate.

After the retirement date, what happens to applications that use the unsupported Azure Cosmos DB SDK?

After the retirement date, Azure Cosmos DB will no longer make bug fixes, add new features, or provide support to the retired SDK versions. If you prefer not to upgrade, requests sent from the retired versions of the SDK will continue to be served by the Azure Cosmos DB service.

Which SDK versions will have the latest features and updates?

New features and updates will be added only to the latest minor version of the latest supported major SDK version. We recommend that you always use the latest version to take advantage of new features, performance improvements, and bug fixes. If you're using an old, non-retired version of the SDK, your requests to Azure Cosmos DB will still function, but you won't have access to any new capabilities.

What should I do if I can't update my application before a cutoff date?

We recommend that you upgrade to the latest SDK as early as possible. After an SDK is tagged for retirement, you'll have 12 months to update your application. If you're not able to update by the retirement date, requests sent from the retired versions of the SDK will continue to be served by Azure Cosmos DB, so your running applications will continue to function. But Azure Cosmos DB will no longer make bug fixes, add new features, or provide support to the retired SDK versions.

If you have a support plan and require technical support, contact us by filing a support ticket.

See also

To learn more about the Azure Cosmos DB Table API, see Introduction to Azure Cosmos DB Table API.