你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
用于 API for NoSQL 的 Azure Cosmos DB Python SDK：发行说明和资源
适用范围：
NoSQL
| 页 | 链接 |
|---|---|
| 下载 SDK | PyPI |
| API 文档 | Python API 参考文档 |
| SDK 安装说明 | Python SDK 安装说明 |
| 入门 | Python SDK 入门 |
| 示例 | Python SDK 示例 |
| 当前受支持的平台 | Python 3.6+ |
重要
- 版本 4.3.0b2 及更高版本支持异步 IO 操作，而版本 4.5.2b4 及更高版本仅支持 Python 3.8+。 不支持 Python 2。
版本历史记录
版本历史记录将保存在 azure-sdk-for-python 存储库中。有关版本的详细列表，请参阅 changelog 文件。
发布和停用日期
Microsoft 至少会在停用 SDK 前提前 12 个月发出通知，以便顺利转换为更高版本/受支持版本。 新特性和功能以及优化仅添加到当前 SDK，因此建议始终尽早升级到最新的 SDK 版本。
警告
在 2022 年 8 月 31 日之后，Azure Cosmos DB 将不再进行 bug 修复，也不再支持适用于 API for NoSQL 的 1.x 和 2.x 版的 Azure Cosmos DB Python SDK。 如果你不想升级，则从 1.x 或 2.x 版 SDK 发送的请求将继续由 Azure Cosmos DB 服务处理。
| 版本 | 发布日期 | 停用日期 |
|---|---|---|
| 4.6.0 | 2023 年 3 月 15 日 | --- |
| 4.5.1 | 2023 年 9 月 14 日 | --- |
| 4.5.0 | 2023 年 8 月 10 日 | --- |
| 4.4.0 | 2023 年 6 月 10 日 | --- |
| 4.3.1 | 2023 年 2 月 24 日 | --- |
| 4.3.0 | 2022 年 5 月 23 日 | --- |
| 4.2.0 | 2020 年 10 月 9 日 | --- |
| 4.1.0 | 2020 年 8 月 10 日 | --- |
| 4.0.0 | 2020 年 5 月 20 日 | --- |
| 3.0.2 | 2018 年 11 月 15 日 | --- |
| 3.0.1 | 2018 年 10 月 4 日 | --- |
| 2.3.3 | 2018 年 9 月 8 日 | 2022 年 8 月 31 日 |
| 2.3.2 | 2018 年 5 月 8 日 | 2022 年 8 月 31 日 |
| 2.3.1 | 2017 年 12 月 21 日 | 2022 年 8 月 31 日 |
| 2.3.0 | 2017 年 11 月 10 日 | 2022 年 8 月 31 日 |
| 2.2.1 | 2017 年 9 月 29 日 | 2022 年 8 月 31 日 |
| 2.2.0 | 2017 年 5 月 10 日 | 2022 年 8 月 31 日 |
| 2.1.0 | 2017 年 5 月 1 日 | 2022 年 8 月 31 日 |
| 2.0.1 | 2016 年 10 月 30 日 | 2022 年 8 月 31 日 |
| 2.0.0 | 2016 年 9 月 29 日 | 2022 年 8 月 31 日 |
| 1.9.0 | 2016 年 7 月 7 日 | 2022 年 8 月 31 日 |
| 1.8.0 | 2016 年 6 月 14 日 | 2022 年 8 月 31 日 |
| 1.7.0 | 2016 年 4 月 26 日 | 2022 年 8 月 31 日 |
| 1.6.1 | 2016 年 4 月 8 日 | 2022 年 8 月 31 日 |
| 1.6.0 | 2016 年 3 月 29 日 | 2022 年 8 月 31 日 |
| 1.5.0 | 2016 年 1 月 3日 | 2022 年 8 月 31 日 |
| 1.4.2 | 2015 年 10 月 6 日 | 2022 年 8 月 31 日 |
| 1.4.1 | 2015 年 10 月 6 日 | 2022 年 8 月 31 日 |
| 1.2.0 | 2015 年 8 月 6 日 | 2022 年 8 月 31 日 |
| 1.1.0 | 2015 年 7 月 9 日 | 2022 年 8 月 31 日 |
| 1.0.1 | 2015 年 5 月 25 日 | 2022 年 8 月 31 日 |
| 1.0.0 | 2015 年 4 月 7 日 | 2022 年 8 月 31 日 |
| 0.9.4-prelease | 2015 年 1 月 14日 | 2016 年 2 月 29 日 |
| 0.9.3-prelease | 2014 年 12 月 9 日 | 2016 年 2 月 29 日 |
| 0.9.2-prelease | 2014 年 11 月 25 日 | 2016 年 2 月 29 日 |
| 0.9.1-prelease | 2014 年 9 月 23 日 | 2016 年 2 月 29 日 |
| 0.9.0-prelease | 2014 年 8 月 21 日 | 2016 年 2 月 29 日 |
常见问题解答
如何收到即将停用的 SDK 的通知？
Microsoft 会在即将停用的 SDK 的支持结束之前提前 12 个月进行通知，以便协助平稳地转换到支持的 SDK。 我们会通过以下通信通道通知你：Azure 门户、Azure 更新以及与分配的服务管理员的直接通信。
在这 12 个月期间，我是否可以使用即将停用的 Azure Cosmos DB SDK 来创作应用程序？
可以，你可以在 12 个月的宽限期内使用即将停用的 Azure Cosmos DB SDK 创作、部署和修改应用程序。 建议在 12 个月的宽限期内根据相应情况迁移到支持的较新版本 Azure Cosmos DB SDK。
停用日期之后，使用不受支持的 Azure Cosmos DB SDK 的应用程序会发生什么情况？
停用日期之后，Azure Cosmos DB 将不再进行 bug 修复、添加新功能或为已停用的 SDK 版本提供支持。 如果不想升级，从已停用的 SDK 版本发送的请求将继续由 Azure Cosmos DB 服务提供服务。
哪些 SDK 版本将包含最新功能和更新？
新功能和更新将仅添加到最新的受支持的主要 SDK 版本的最新次要版本。 建议始终使用最新版本，以充分利用新功能、性能改进和 bug 修补程序。 如果使用的是未停用的旧版本 SDK，则对 Azure Cosmos DB 进行的请求仍然有效，但是你无法访问任何新功能。
如果无法在截止日期之前更新应用程序，该怎么办？
我们建议尽早升级到最新 SDK。 SDK 标记为要停用之后，你将有 12 个月的时间来更新应用程序。 如果无法在停用日期之前更新，从已停用的 SDK 版本发送的请求将继续由 Azure Cosmos DB 提供服务，因此正在运行的应用程序将继续运行。 但 Azure Cosmos DB 将不再进行 bug 修复、添加新功能或为已停用的 SDK 版本提供支持。
如果你有支持计划并需要技术支持，请创建支持工单以联系我们。
如何请求将功能添加到 SDK 或连接器？
新功能并不总是立即添加到每个 SDK 或连接器中。 如果你想添加的功能不受支持，请在我们的社区论坛提出反馈。
后续步骤
若要详细了解 Azure Cosmos DB，请参阅 Microsoft Azure Cosmos DB 服务页。