| title | description | author | ms.service | ms.subservice | ms.devlang | ms.topic | ms.date | ms.author | ms.custom |
|---|---|---|---|---|---|---|---|---|---|
Azure Cosmos DB SQL Python API, SDK & resources |
Learn all about the SQL Python API and SDK including release dates, retirement dates, and changes made between each version of the Azure Cosmos DB Python SDK. |
Rodrigossz |
cosmos-db |
nosql |
python |
reference |
01/25/2022 |
rosouz |
devx-track-python |
[!INCLUDENoSQL]
[!INCLUDESDK selector]
| Page | Link |
|---|---|
| Download SDK | PyPI |
| API documentation | Python API reference documentation |
| SDK installation instructions | Python SDK installation instructions |
| Get started | Get started with the Python SDK |
| Samples | Python SDK samples |
| Current supported platform | Python 3.6+ |
Important
- Versions 4.3.0b2 and higher support Async IO operations and version 4.5.2b4 and higher only support Python 3.8+. Python 2 is not supported.
Release history is maintained in the azure-sdk-for-python repo, for detailed list of releases, see the changelog file.
Microsoft provides notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version. New features and functionality and optimizations are only added to the current SDK, as such it is recommended that you always upgrade to the latest SDK version as early as possible.
Warning
After 31 August 2022, Azure Cosmos DB will no longer make bug fixes or provide support to versions 1.x and 2.x of the Azure Cosmos DB Python SDK for API for NoSQL. If you prefer not to upgrade, requests sent from version 1.x and 2.x of the SDK will continue to be served by the Azure Cosmos DB service.
| Version | Release Date | Retirement Date |
|---|---|---|
| 4.6.0 | Mar 15, 2023 | --- |
| 4.5.1 | Sep 14, 2023 | --- |
| 4.5.0 | Aug 10, 2023 | --- |
| 4.4.0 | Jun 10, 2023 | --- |
| 4.3.1 | Feb 24, 2023 | --- |
| 4.3.0 | May 23, 2022 | --- |
| 4.2.0 | Oct 09, 2020 | --- |
| 4.1.0 | Aug 10, 2020 | --- |
| 4.0.0 | May 20, 2020 | --- |
| 3.0.2 | Nov 15, 2018 | --- |
| 3.0.1 | Oct 04, 2018 | --- |
| 2.3.3 | Sept 08, 2018 | August 31, 2022 |
| 2.3.2 | May 08, 2018 | August 31, 2022 |
| 2.3.1 | December 21, 2017 | August 31, 2022 |
| 2.3.0 | November 10, 2017 | August 31, 2022 |
| 2.2.1 | Sep 29, 2017 | August 31, 2022 |
| 2.2.0 | May 10, 2017 | August 31, 2022 |
| 2.1.0 | May 01, 2017 | August 31, 2022 |
| 2.0.1 | October 30, 2016 | August 31, 2022 |
| 2.0.0 | September 29, 2016 | August 31, 2022 |
| 1.9.0 | July 07, 2016 | August 31, 2022 |
| 1.8.0 | June 14, 2016 | August 31, 2022 |
| 1.7.0 | April 26, 2016 | August 31, 2022 |
| 1.6.1 | April 08, 2016 | August 31, 2022 |
| 1.6.0 | March 29, 2016 | August 31, 2022 |
| 1.5.0 | January 03, 2016 | August 31, 2022 |
| 1.4.2 | October 06, 2015 | August 31, 2022 |
| 1.4.1 | October 06, 2015 | August 31, 2022 |
| 1.2.0 | August 06, 2015 | August 31, 2022 |
| 1.1.0 | July 09, 2015 | August 31, 2022 |
| 1.0.1 | May 25, 2015 | August 31, 2022 |
| 1.0.0 | April 07, 2015 | August 31, 2022 |
| 0.9.4-prelease | January 14, 2015 | February 29, 2016 |
| 0.9.3-prelease | December 09, 2014 | February 29, 2016 |
| 0.9.2-prelease | November 25, 2014 | February 29, 2016 |
| 0.9.1-prelease | September 23, 2014 | February 29, 2016 |
| 0.9.0-prelease | August 21, 2014 | February 29, 2016 |
[!INCLUDE cosmos-db-sdk-faq]
To learn more about Azure Cosmos DB, see Microsoft Azure Cosmos DB service page.