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

适用于: 表 API

链接Links
SDK 下载SDK download NuGetNuGet
示例Sample Cosmos DB 表 API .NET 示例Cosmos DB Table API .NET Sample
快速入门Quickstart 快速入门Quickstart
教程Tutorial 教程Tutorial
当前受支持的框架Current supported framework Microsoft .NET Standard 2.0Microsoft .NET Standard 2.0
报告问题Report Issue 报告问题Report Issue

2.0.0 系列的发行说明Release notes for 2.0.0 series

2.0.0 系列依赖于 Microsoft.Azure.Cosmos,并对 Cosmos DB 终结点进行了性能改进和命名空间合并。2.0.0 series takes the dependency on Microsoft.Azure.Cosmos, with performance improvements and namespace consolidation to Cosmos DB endpoint.

2.0.0-preview2.0.0-preview

  • 2.0.0 表 SDK 的初始预览版,它依赖于 Microsoft.Azure.Cosmos,并对 Cosmos DB 终结点进行了性能改进和命名空间合并。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. 公共 API 保持不变。The public API remains the same.

1.0.0 系列的发行说明Release notes for 1.0.0 series

1.0.0 系列依赖于 Microsoft.Azure.DocumentDB.Core1.0.0 series takes the dependency on Microsoft.Azure.DocumentDB.Core.

1.0.81.0.8

  • 添加了支持以便在是 cosmosdb 终结点时设置 TTL 属性Add support to set TTL property if it's cosmosdb endpoint
  • 在超时和任务取消异常时遵从重试策略Honor retry policy upon timeout and task cancelled exception
  • 修复了 asp .NET 应用程序中出现的间歇性任务取消异常Fix intermittent task cancelled exception seen in asp .NET applications
  • 修复了仅在位置模式下从辅助终结点进行的 azure 表存储检索Fix azure table storage retrieve from secondary endpoint only location mode
  • Microsoft.Azure.DocumentDB.Core 依赖项版本更新为 2.11.2,该版本修复了间歇性 null 引用异常Update Microsoft.Azure.DocumentDB.Core dependency version to 2.11.2 which fixes intermittent null reference exception
  • Odata.Core 依赖项版本更新为 7.6.4,该版本修复了与 azure shell 的兼容性冲突Update Odata.Core dependency version to 7.6.4 which fixes compatibility conflict with azure shell

1.0.71.0.7

  • 通过将表 SDK 默认跟踪级别设置为“SourceLevels.Off”(可通过 app.config 启用)来提高性能Performance improvement by setting Table SDK default trace level to SourceLevels.Off, which can be opted in via app.config

1.0.51.0.5

  • 在 TableClientConfiguration 下引入了新配置,以使用 Rest Executor 与 Cosmos DB 表 API 通信Introduce new config under TableClientConfiguration to use Rest Executor to communicate with Cosmos DB Table API

1.0.5-preview1.0.5-preview

  • Bug 修复Bug fixes

1.0.41.0.4

  • Bug 修复Bug fixes
  • 为 RestExecutorConfiguration 提供了 HttpClientTimeout 选项。Provide HttpClientTimeout option for RestExecutorConfiguration.

1.0.4-preview1.0.4-preview

  • Bug 修复Bug fixes
  • 为 RestExecutorConfiguration 提供了 HttpClientTimeout 选项。Provide HttpClientTimeout option for RestExecutorConfiguration.

1.0.11.0.1

  • Bug 修复Bug fixes

1.0.01.0.0

  • 正式发布版General availability release

0.11.0-preview0.11.0-preview

  • 对 CloudTableClient 的配置方式进行了更改。Changes were made to how CloudTableClient can be configured. 它现在会在构造过程中使用 TableClientConfiguration 对象。It now takes an a TableClientConfiguration object during construction. TableClientConfiguration 提供不同的属性来配置客户端行为,具体取决于目标终结点是 Cosmos DB 表 API 还是 Azure 存储表 API。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.
  • 增加了对 TableQuery 的支持,可以在自定义列中按排序顺序返回结果。Added support to TableQuery to return results in sorted order on a custom column. 只有 Cosmos DB 表终结点支持此功能。This feature is only supported on Cosmos DB Table endpoints.
  • 增加了相关支持,可以在不同的结果类型上公开 RequestCharge。Added support to expose RequestCharges on various result types. 只有 Cosmos DB 表终结点支持此功能。This feature is only supported on Cosmos DB Table endpoints.

0.10.1-preview0.10.1-preview

  • 针对 Azure 存储表终结点添加了对 SAS 令牌以及 TablePermissions、ServiceProperties 和 ServiceStats 的操作的支持。Add support for SAS token, operations of TablePermissions, ServiceProperties, and ServiceStats against Azure Storage Table endpoints.

    备注

    尚不支持以前的 Azure 存储表 SDK 中的某些功能,例如客户端加密。Some functionalities in previous Azure Storage Table SDKs are not yet supported, such as client-side encryption.

0.10.0-preview0.10.0-preview

  • 针对 Azure 存储表终结点添加了对核心 CRUD、批处理和查询操作的支持。Add support for core CRUD, batch, and query operations against Azure Storage Table endpoints.

    备注

    尚不支持以前的 Azure 存储表 SDK 中的某些功能,例如客户端加密。Some functionalities in previous Azure Storage Table SDKs are not yet supported, such as client-side encryption.

0.9.1-preview0.9.1-preview

  • Azure Cosmos DB 表 .NET Standard SDK 是一个跨平台 .NET 库,可高效访问 Cosmos DB 上的表数据模型。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. 此初始版本支持完整的表和实体 CRUD + 查询功能集,其中 API 与用于 .NET Framework 的 Cosmos DB 表 SDK 类似。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.

    备注

    0.9.1 预览版尚不支持 Azure 存储表终结点。Azure Storage Table endpoints are not yet supported in the 0.9.1-preview version.

发布日期和停用日期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.

这个跨平台的 .NET 标准库 Microsoft.Azure.Cosmos.Table 将替换 .NET Framework 库 Microsoft.Azure.CosmosDB.TableThis cross-platform .NET Standard library Microsoft.Azure.Cosmos.Table will replace the .NET Framework library Microsoft.Azure.CosmosDB.Table.

2.0.0 系列2.0.0 series

版本Version 发布日期Release Date 停用日期Retirement Date
2.0.0-preview2.0.0-preview 2019 年 8 月 22 日Auguest 22, 2019 ---

1.0.0 系列1.0.0 series

版本Version 发布日期Release Date 停用日期Retirement Date
1.0.51.0.5 2019 年 9 月 13 日September 13, 2019 ---
1.0.5-preview1.0.5-preview 2019 年 8 月 20 日Auguest 20, 2019 ---
1.0.41.0.4 2019 年 8 月 12 日Auguest 12, 2019 ---
1.0.4-preview1.0.4-preview 2019 年 6 月 26 日July 26, 2019 ---
1.0.2-preview1.0.2-preview 2019 年 5 月 2 日May 2, 2019 ---
1.0.11.0.1 2019 年 4 月 19 日April 19, 2019 ---
1.0.01.0.0 2019 年 3 月 13 日March 13, 2019 ---
0.11.0-preview0.11.0-preview 2019 年 3 月 5 日March 5, 2019 ---
0.10.1 预览版0.10.1-preview 2019 年 1 月 22 日January 22, 2019 ---
0.10.0 预览版0.10.0-preview 2018 年 12 月 18 日December 18, 2018 ---
0.9.1 预览版0.9.1-preview 2018 年 10 月 18 日October 18, 2018 ---

常见问题FAQ

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.