Documentation Home
Connectors and APIs Manual
Download this Manual
PDF (US Ltr) - 4.5Mb
PDF (A4) - 4.5Mb


6.3 Connector/Python Versions

This section describes both version releases, such as 8.0.34, along with notes specific to the two implementations (C Extension and Pure Python).

Connector/Python Releases

The following table summarizes the available Connector/Python versions. For series that have reached General Availability (GA) status, development releases in the series prior to the GA version are no longer supported.

Note

MySQL Connectors and other MySQL client tools and applications now synchronize the first digit of their version number with the (highest) MySQL server version they support. For example, MySQL Connector/Python 8.0.12 would be designed to support all features of MySQL server version 8 (or lower). This change makes it easy and intuitive to decide which client version to use for which server version.

Connector/Python 8.0.4 is the first release to use the new numbering. It is the successor to Connector/Python 2.2.3.

Table 6.1 Connector/Python Version Reference

Connector/Python Version MySQL Server Versions Python Versions Connector Status
9.1.0 8.0 and later 3.13*, 3.12, 3.11, 3.10, 3.9 General Availability
8.4.0 and 9.0.0 8.0 and later 3.12, 3.11, 3.10, 3.9, 3.8 General Availability
8.1.0 through 8.3.0 5.7 and later 3.12 (8.2.0+), 3.11, 3.10, 3.9, 3.8 General Availability
8.0 8.0, 5.7, 5.6, 5.5 3.11, 3.10, 3.9, 3.8, 3.7, (3.6 before 8.0.29), (2.7 and 3.5 before 8.0.24) General Availability
2.2 (continues as 8.0) 5.7, 5.6, 5.5 3.5, 3.4, 2.7 Developer Milestone, No releases
2.1 5.7, 5.6, 5.5 3.5, 3.4, 2.7, 2.6 General Availability
2.0 5.7, 5.6, 5.5 3.5, 3.4, 2.7, 2.6 GA, final release on 2016-10-26
1.2 5.7, 5.6, 5.5 (5.1, 5.0, 4.1) 3.4, 3.3, 3.2, 3.1, 2.7, 2.6 GA, final release on 2014-08-22

Note

MySQL server and Python versions within parentheses are known to work with Connector/Python, but are not officially supported. Bugs might not get fixed for those versions.

Note

Python 3.13 enables ssl.VERIFY_X509_STRICT SSL validation by default, which means SSL certificates must now be RFC-5280 compliant when using Python 3.13 and higher.

Note

On macOS x86_64 ARM: Python 3.7 is not supported with the c-ext implementation; note this is a non-default version of Python on macOS.

Connector/Python Implementations

Connector/Python implements the MySQL client/server protocol two ways:

  • As pure Python; an implementation written in Python. It depends on the Python Standard Library.

    The X DevAPI variant of the connector requires Python Protobuf. The required version is 4.25.3, and was >= 4.21.1,<= 4.21.12 before Connector/Python 9.0.0.

  • As a C Extension that interfaces with the MySQL C client library. This implementation of the protocol is dependent on the client library, but can use the library provided by MySQL Server packages (see MySQL C API Implementations).

Neither implementation of the client/server protocol has any third-party dependencies. However, if you need SSL support, verify that your Python installation has been compiled using the OpenSSL libraries.

Note

Support for distutils was removed in Connector/Python 8.0.32.

Python terminology regarding distributions:

  • Built Distribution: A package created in the native packaging format intended for a given platform. It contains both sources and platform-independent bytecode. Connector/Python binary distributions are built distributions.

  • Source Distribution: A distribution that contains only source files and is generally platform independent.