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

SDK 下载SDK download NuGetNuGet
API 文档API documentation 参考文档.NET API reference documentation
快速入门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

Important

如果已在预览期间创建表 API 帐户,请新建表 API 帐户,这样才能使用正式版表 API SDK。

故障排除Troubleshooting

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

Unable to resolve dependency 'Microsoft.Azure.Storage.Common'. Source(s) used: 'nuget.org', 
'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.

常见问题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.