| 頁面 | 連結 |
|---|---|
| 下載 SDK | PyPI |
| API 文件 | Python API 參考檔 |
| SDK 安裝指示 | Python SDK 安裝指示 |
| 開始 | 開始使用 Python SDK |
| 範例 | Python SDK 範例 |
| 目前支援的平臺 | 蟒蛇 3.6+ |
Important
- 4.3.0b2 版和更新版本僅支援 Python 3.8+,支援異步 IO 作業和 4.5.2b4 版和更新版本。 不支援 Python 2。
發行歷史與退休日期
版本歷程記錄會保留在 azure-sdk-for-python 存放庫中,如需版本的詳細清單,請參閱 變更記錄檔。
Microsoft 至少會在 12 個月 前通知,以便順利過渡到更新或支援版本。 新的功能與最佳化項目只會新增至目前的 SDK,因此建議您一律盡早升級至最新的 SDK 版本。
Warning
在 2022 年 8 月 31 日之後,Azure Cosmos DB 將不再進行 Bug 修正,或支援適用於 NoSQL 的 Azure Cosmos DB Python SDK for API 1.x 和 2.x 版。 如果您還不想升級,Azure Cosmos DB 服務會繼續處理從 1.x 版和 2.x 版 SDK 傳送的要求。
FAQ
如何收到即將淘汰 SDK 的通知?
Microsoft 將在即將退休的 SDK 支援結束前提前 12 個月通知,以促進順利過渡到支援的 SDK。 我們會透過多種溝通管道通知您:Azure 入口網站、Azure 更新,以及直接與指定服務管理員的溝通。
我可以在12個月期間使用 to-be-退休的Azure Cosmos DB SDK來撰寫應用程式嗎?
是的,你可以在 12 個月通知期內使用 to-be-retired Azure Cosmos DB SDK 來撰寫、部署和修改應用程式。 我們建議您在 12 個月通知期內,視情況遷移至支援更新的 Azure Cosmos DB SDK 版本。
退休日期過後,使用不支援的 Azure Cosmos DB SDK 的應用程式會怎麼辦?
退休日期過後,Azure Cosmos DB 將不再修復錯誤、新增功能,也不會支援已退休的 SDK 版本。 如果你不想升級,從已退休版本的 SDK 發送的請求仍會由 Azure Cosmos DB 服務提供。
哪些 SDK 版本會有最新的功能和更新?
新功能和更新只會新增至最新支援的主要 SDK 版本的最新次要版本。 建議您一律使用最新版本來利用新功能、效能改善和錯誤修正。 如果你使用的是舊版且未退休的 SDK,你對 Azure Cosmos DB 的請求仍能運作,但你將無法使用任何新功能。
如果我無法在截止日期之前更新應用程式,該怎麼辦?
建議您儘早升級至最新的 SDK。 將 SDK 標記為淘汰之後,您將有 12 個月的時間更新您的應用程式。 如果你無法在退休日期前更新,從已退休版本的 SDK 發送的請求仍會由 Azure Cosmos DB 處理,因此你正在執行的應用程式仍能正常運作。 但 Azure Cosmos DB 將不再修復錯誤、新增功能,也不會支援已退休的 SDK 版本。
如果您有支援方案並需要技術支援, 請提出支援票證以與我們連絡 。
如何要求功能新增至 SDK 或連接器?
新功能不一定會立即新增至每個 SDK 或連接器。 如果不支援您想要新增的功能,請將意見反應新增至我們的 社群論壇。
下一步
欲了解更多Azure Cosmos DB資訊,請參閱 Microsoft Azure Cosmos DB 服務頁面。