Skip to content

Latest commit

 

History

History
102 lines (77 loc) · 4.55 KB

table-sdk-dotnet.md

File metadata and controls

102 lines (77 loc) · 4.55 KB
title description services author manager ms.service ms.component ms.devlang ms.topic ms.date ms.author
Azure Cosmos DB Table API .NET SDK & Resources | Microsoft Docs
Learn all about the Azure Cosmos DB Table API including release dates, retirement dates, and changes made between each version.
cosmos-db
rnagpal
kfile
cosmos-db
cosmosdb-table
dotnet
reference
08/17/2018
rnagpal

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

[!div class="op_single_selector"]
SDK download NuGet
API documentation .NET API reference documentation
Quickstart Azure Cosmos DB: Build an app with .NET and the Table API
Tutorial Azure Cosmos DB: Develop with the Table API in .NET
Current supported framework Microsoft .NET Framework 4.5.1

Important

If you created a Table API account during the preview, please create a new Table API account to work with the generally available Table API SDKs.

Release notes

2.0.0

  • Added Multi-region write support
  • Fixed NuGet package dependencies on Microsoft.Azure.DocumentDB, Microsoft.OData.Core, Microsoft.OData.Edm, Microsoft.Spatial

1.1.3

  • Fixed NuGet package dependencies on Microsoft.Azure.Storage.Common and Microsoft.Azure.DocumentDB.
  • Bug fixes on table serialization when JsonConvert.DefaultSettings are configured.

1.1.1

  • Added validation for malformed ETAGs in Direct Mode.
  • Fixed LINQ query bug in Gateway Mode.
  • Synchronous APIs now run on the thread pool with SynchronizationContext.

1.1.0

  • Add TableQueryMaxItemCount, TableQueryEnableScan, TableQueryMaxDegreeOfParallelism, and TableQueryContinuationTokenLimitInKb to TableRequestOptions
  • Bug Fixes

1.0.0

  • General availability release

0.9.0-preview

  • Initial preview release

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.

The WindowsAzure.Storage-PremiumTable preview package has been deprecated and replaced by the Microsoft.Azure.CosmosDB.Table package. The WindowsAzure.Storage-PremiumTable SDK will be retired on November 15, 2018, at which time requests to the retired SDK will not be permitted. The Microsoft.Azure.CosmosDB.Table library is currently available for .NET Standard only, it's not yet available for .NET Core.

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.

Any requests to Azure Cosmos DB using a retired SDK are rejected by the service.

Version Release Date Retirement Date
1.1.3 July 17, 2018 ---
1.1.1 March 26, 2018 ---
1.1.0 February 21, 2018 ---
1.0.0 November 15, 2017 ---
0.9.0-preview November 11, 2017 ---

Troubleshooting

If you get the error

Unable to resolve dependency 'Microsoft.Azure.Storage.Common'. Source(s) used: 'nuget.org', 
'CliFallbackFolder', 'Microsoft Visual Studio Offline Packages', 'Microsoft Azure Service Fabric SDK'`

when attempting to use the Microsoft.Azure.CosmosDB.Table NuGet package, you have two options to fix the issue:

  • Use Package Manage Console to install the Microsoft.Azure.CosmosDB.Table package and its dependencies. To do this, type the following in the Package Manager Console for your solution.

    Install-Package Microsoft.Azure.CosmosDB.Table -IncludePrerelease

  • Using your preferred NuGet package management tool, install the Microsoft.Azure.Storage.Common NuGet package before installing Microsoft.Azure.CosmosDB.Table.

FAQ

[!INCLUDE cosmos-db-sdk-faq]

See also

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