diff --git a/source/includes/mongodb-compatibility-table-pymongo.rst b/source/includes/mongodb-compatibility-table-pymongo.rst index a01d32e3..8c087e17 100644 --- a/source/includes/mongodb-compatibility-table-pymongo.rst +++ b/source/includes/mongodb-compatibility-table-pymongo.rst @@ -13,6 +13,16 @@ - MongoDB 4.0 - MongoDB 3.6 + * - 4.11 + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + * - 4.10 - ✓ - ✓ @@ -21,10 +31,7 @@ - ✓ - ✓ - ✓ - - ⊛ - - - - - - + - ✓ * - 4.9 - ✓ @@ -34,10 +41,7 @@ - ✓ - ✓ - ✓ - - ⊛ - - - - - - + - ✓ * - 4.4 to 4.8 - ⊛ diff --git a/source/includes/troubleshooting/connection-targets.rst b/source/includes/troubleshooting/connection-targets.rst index 4ae1c3ba..73d2955f 100644 --- a/source/includes/troubleshooting/connection-targets.rst +++ b/source/includes/troubleshooting/connection-targets.rst @@ -1,16 +1,22 @@ Server Reports Wire Version X, PyMongo Requires Y ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -If you try to connect to {+mdb-server+} v3.4 or earlier, +If you try to connect to {+mdb-server+} v3.6 or earlier, {+driver-short+} might raise the following error: .. code-block:: - pymongo.errors.ConfigurationError: Server at localhost:27017 reports wire version 5, but this version of PyMongo requires at least 6 (MongoDB 3.6). + pymongo.errors.ConfigurationError: Server at localhost:27017 reports wire version 6, but this version of PyMongo requires at least 7 (MongoDB 4.0). This occurs when the driver version is too new for the server it's connecting to. -To resolve this issue, upgrade your MongoDB deployment to v3.6 or later, or downgrade to -{+driver-short+} v3.x, which supports {+mdb-server+} v2.6 and later. +To resolve this issue, you can do one of the following: + +- Upgrade your MongoDB deployment to v4.0 or later. + +- Downgrade to {+driver-short+} 4.10 or earlier, which supports {+mdb-server+} + v3.6 and later. + +- Downgrade to {+driver-short+} v3.x, which supports {+mdb-server+} v2.6 and later. AutoReconnect ~~~~~~~~~~~~~ diff --git a/source/upgrade.txt b/source/upgrade.txt index e3b8247a..7ad8b39d 100644 --- a/source/upgrade.txt +++ b/source/upgrade.txt @@ -104,6 +104,16 @@ and upgrade versions. .. diagram for this example? +.. _version-4.11-breaking-changes: + +Version 4.11 Breaking Changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- {+mdb-server+} v3.6 is no longer supported. The minimum supported {+mdb-server+} + version is now v4.0. + +- The minimum wire version is now 7. See :manual:`minWireVersion `. + .. _version-4.9-breaking-changes: Version 4.9 Breaking Changes diff --git a/source/whats-new.txt b/source/whats-new.txt index a287a189..e7e6d69b 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -15,7 +15,7 @@ What's New :values: reference .. meta:: - :keywords: update, new feature, deprecation, upgrade, driver v4.7, driver v4.8, driver v4.9, driver v4.10 + :keywords: update, new feature, deprecation, upgrade, driver v4.7, driver v4.8, driver v4.9, driver v4.10, driver v4.11 Learn what's new in: @@ -32,6 +32,11 @@ Learn what's new in: What's New in 4.11 ------------------ +.. warning:: Breaking Changes + + {+driver-short+} v4.11 contains breaking changes. For more information, see + :ref:`version-4.11-breaking-changes`. + The {+driver-short+} v4.11 release includes the following new features: - Adds support for free-threaded CPython when running Python v3.13+.