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

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

Release notes

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.

Version Release Date Retirement Date
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

1. How will customers be notified of the retiring SDK?

Microsoft will provide 12 month advance notification to the end of support of the retiring SDK in order to facilitate a smooth transition to a supported SDK. Further, customers will be notified through various communication channels – Azure Management Portal, Developer Center, blog post, and direct communication to assigned service administrators.

2. Can customers author applications using a "to-be" retired Azure Cosmos DB SDK during the 12 month period?

Yes, customers will have full access to author, deploy and modify applications using the "to-be" retired Azure Cosmos DB SDK during the 12 month grace period. During the 12 month grace period, customers are advised to migrate to a newer supported version of Azure Cosmos DB SDK as appropriate.

3. Can customers author and modify applications using a retired Azure Cosmos DB SDK after the 12 month notification period?

After the 12 month notification period, the SDK will be retired. Any access to Azure Cosmos DB by an applications using a retired SDK will not be permitted by the Azure Cosmos DB platform. Further, Microsoft will not provide customer support on the retired SDK.

4. What happens to Customer’s running applications that are using unsupported Azure Cosmos DB SDK version?

Any attempts made to connect to the Azure Cosmos DB service with a retired SDK version will be rejected.

5. Will new features and functionality be applied to all non-retired SDKs?

New features and functionality will only be added to new versions. If you are using an old, non-retired, version of the SDK your requests to Azure Cosmos DB will still function as previous but you will not have access to any new capabilities.

6. What should I do if I cannot update my application before a cut-off date?

We recommend that you upgrade to the latest SDK as early as possible. Once an SDK has been tagged for retirement you will have 12 months to update your application. If, for whatever reason, you cannot complete your application update within this timeframe then please contact the Cosmos DB Team and request their assistance before the cutoff date.

See also

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