Azure Cosmos DB 表 .NET API:下载和发行说明Azure Cosmos DB Table .NET API: Download and release notes

适用于: 表 API

SDK 下载SDK download NuGetNuGet
快速入门Quickstart Azure Cosmos DB:使用 .NET 和表 API 生成应用Azure Cosmos DB: Build an app with .NET and the Table API
教程Tutorial Azure Cosmos DB:在 .NET 中使用表 API 进行开发Azure Cosmos DB: Develop with the Table API in .NET
当前受支持的框架Current supported framework Microsoft .NET Framework 4.5.1Microsoft .NET Framework 4.5.1


.NET Framework SDK Microsoft.Azure.CosmosDB.Table 目前处于维护模式,不久将被弃用。The .NET Framework SDK Microsoft.Azure.CosmosDB.Table is in maintenance mode and it will be deprecated soon. 请升级到新的 .NET Standard 库 Microsoft.Azure.Cosmos.Table 来继续获取表 API 支持的最新功能。Please upgrade to the new .NET Standard library Microsoft.Azure.Cosmos.Table to continue to get the latest features supported by the Table API.

如果已在预览期间创建表 API 帐户,请新建表 API 帐户,这样才能使用正式版表 API SDK。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

  • Bug 修复Bug fixes

  • Bug 修复Bug fixes

  • 添加了多区域写入支持Added Multi-region write support
  • 修复了 NuGet 包对 Microsoft.Azure.DocumentDB、Microsoft.OData.Core、Microsoft.OData.Edm、Microsoft.Spatial 的依赖性Fixed NuGet package dependencies on Microsoft.Azure.DocumentDB, Microsoft.OData.Core, Microsoft.OData.Edm, Microsoft.Spatial

  • 修复了 NuGet 包对 Microsoft.Azure.Storage.Common 和 Microsoft.Azure.DocumentDB 的依赖关系。Fixed NuGet package dependencies on Microsoft.Azure.Storage.Common and Microsoft.Azure.DocumentDB.
  • 修复了配置 JsonConvert.DefaultSettings 时表序列化的 Bug。Bug fixes on table serialization when JsonConvert.DefaultSettings are configured.

  • 针对直接模式下格式不正确的 ETAG 添加了验证。Added validation for malformed ETAGs in Direct Mode.
  • 修复了网管模式下的 LINQ 查询 Bug。Fixed LINQ query bug in Gateway Mode.
  • 同步 API 现于 SynchronizationContext 的线程池上运行。Synchronous APIs now run on the thread pool with SynchronizationContext.

  • 将 TableQueryMaxItemCount、TableQueryEnableScan、TableQueryMaxDegreeOfParallelism 和 TableQueryContinuationTokenLimitInKb 添加到 TableRequestOptionsAdd TableQueryMaxItemCount, TableQueryEnableScan, TableQueryMaxDegreeOfParallelism, and TableQueryContinuationTokenLimitInKb to TableRequestOptions
  • Bug 修复Bug Fixes

  • 正式发布版General availability release


  • 初始预览版Initial preview release

发布日期和停用日期Release and Retirement dates

Azure 会在停用 SDK 时至少提前 12 个月发出通知,以便用户顺利转换为更高版本/受支持版本。Azure provides notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version.

Microsoft.Azure.CosmosDB.Table 库目前仅适用于 .NET Framework,处于维护模式,即将弃用。The Microsoft.Azure.CosmosDB.Table library is currently available for .NET Framework only, and is in maintenance mode and will be deprecated soon. 新特性、功能和优化仅添加到 .NET 标准库 Microsoft.Azure.Cosmos.Table,因此建议你升级到 Microsoft.Azure.Cosmos.TableNew features and functionalities and optimizations are only added to the .NET Standard library Microsoft.Azure.Cosmos.Table, as such it is recommended that you upgrade to Microsoft.Azure.Cosmos.Table.

WindowsAzure.Storage-PremiumTable 预览版包已弃用。The WindowsAzure.Storage-PremiumTable preview package has been deprecated. WindowsAzure.Storage-PremiumTable SDK 将在 2018 年 11 月 15 日停用,到时将不允许向已停用的 SDK 发出请求。The WindowsAzure.Storage-PremiumTable SDK will be retired on November 15, 2018, at which time requests to the retired SDK will not be permitted.

版本Version 发布日期Release Date 停用日期Retirement Date 2019 年 9 月 16 日September 16, 2019 2019 年 1 月 22 日January 22, 2019 2020 年 4 月 1 日April 01, 2020 2018 年 9 月 26 日September 26, 2018 2020 年 3 月 1 日March 01, 2020 2018 年 7 月 17 日July 17, 2018 2019 年 12 月 1 日December 01, 2019 2018 年 3 月 26 日March 26, 2018 2019 年 12 月 1 日December 01, 2019 2018 年 2 月 21 日February 21, 2018 2019 年 12 月 1 日December 01, 2019 2017 年 11 月 15 日November 15, 2017 2019 年 11 月 15 日November 15, 2019
0.9.0-preview0.9.0-preview 2017 年 11 月 11 日November 11, 2017 2019 年 11 月 11 日November 11, 2019


如果在尝试使用 Microsoft.Azure.CosmosDB.Table NuGet 包时看到以下错误:If you get the error

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

可以使用下列两种方法之一解决此问题:when attempting to use the Microsoft.Azure.CosmosDB.Table NuGet package, you have two options to fix the issue:

  • 使用包管理器控制台安装 Microsoft.Azure.CosmosDB.Table 包及其依赖项。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
  • 使用首选 NuGet 包管理工具先安装 Microsoft.Azure.Storage.Common NuGet 包,再安装 Microsoft.Azure.CosmosDB.Table。Using your preferred NuGet package management tool, install the Microsoft.Azure.Storage.Common NuGet package before installing Microsoft.Azure.CosmosDB.Table.


1.如何向客户通知即将停用的 SDK?1. How will customers be notified of the retiring SDK?

Azure 会在即将停用的 SDK 的支持结束之前提前 12 个月进行通知,以便协助平稳地转换到支持的 SDK。Azure 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. 此外,会通过各种通信渠道(Azure 管理门户、开发人员中心、博客文章以及与分配的服务管理员的直接通信)来通知客户。Further, customers will be notified through various communication channels - Azure Management Portal, Developer Center, blog post, and direct communication to assigned service administrators.

2.在这 12 个月期间,客户是否可以使用“即将”停用的 Azure Cosmos DB SDK 来创作应用程序?2. Can customers author applications using a "to-be" retired Azure Cosmos DB SDK during the 12 month period?

可以,客户在 12 个月宽限期内具有完全访问权限,可以使用“即将”停用的 Azure Cosmos DB SDK 创作、部署和修改应用程序。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. 在 12 个月宽限期内,建议客户根据相应情况迁移到支持的较新版本 Azure Cosmos DB SDK。During the 12 month grace period, customers are advised to migrate to a newer supported version of Azure Cosmos DB SDK as appropriate.

3.在 12 个月通知期之后,客户是否可以使用已停用的 Azure Cosmos DB SDK 创建和修改应用程序?3. Can customers author and modify applications using a retired Azure Cosmos DB SDK after the 12 month notification period?

在 12 个月通知期之后,SDK 会停用。After the 12 month notification period, the SDK will be retired. Azure Cosmos DB 平台不允许使用已停用 SDK 的应用程序对 Azure Cosmos DB 进行任何访问。Any access to Azure Cosmos DB by an applications using a retired SDK will not be permitted by the Azure Cosmos DB platform. 此外,Azure 不会对已停用的 SDK 提供客户支持。Further, Azure will not provide customer support on the retired SDK.

4.如果客户运行使用不支持的 Azure Cosmos DB SDK 版本的应用程序,会发生什么情况?4. What happens to Customer's running applications that are using unsupported Azure Cosmos DB SDK version?

任何使用已停用 SDK 版本连接 Azure Cosmos DB 服务的尝试都会被拒绝。Any attempts made to connect to the Azure Cosmos DB service with a retired SDK version will be rejected.

5.新特性和功能是否会适用于所有未停用的 SDK?5. Will new features and functionality be applied to all non-retired SDKs?

新特性和功能只添加到新版本。New features and functionality will only be added to new versions. 如果使用的是未停用的旧版本 SDK,则对 Azure Cosmos DB 进行的请求仍会与以前一样正常工作,但是你无法访问任何新功能。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.如果无法在截止日期之前更新应用程序,该怎么办?6. What should I do if I cannot update my application before a cut-off date?

我们建议尽早升级到最新 SDK。We recommend that you upgrade to the latest SDK as early as possible. SDK 标记为要停用之后,会有 12 个月来更新应用程序。Once an SDK has been tagged for retirement you will have 12 months to update your application. 如果由于任何原因而无法在此时间范围内完成应用程序更新,请在截止日期之前与 Cosmos DB 团队联系并请求其帮助。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

若要了解有关 Azure Cosmos DB 表 API 的详细信息,请参阅 Azure Cosmos DB 表 API 简介To learn more about the Azure Cosmos DB Table API, see Introduction to Azure Cosmos DB Table API.