Release Notes for MariaDB Connector/Python 1.1 releases
Release date: Jul 15 2025
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
If a cursor will be reused, methods execute(), executemany(), and callproc() will aways reset the cursor to avoid possible memory leaks
Fixed various memory leaks in unittest suite
CONPY-313: Raise NotSupportedError for unsupported float and Decimal values like "nan" and "inf"
CONPY-300: Fix crash when getting invalid unicode from server
CONPY-314: Always use binary protocol for callproc() method
MariaDB Connector/Python 1.1.13 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 24 Feb 2025
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-299: Added support for VECTOR: Vectors can be directly used in parameters as float arrays without using tobytes() method or SQL Function Vec_FromText()
CONPY-295: Fix unsigned check when using executemany() method
CONPY-300: Documentation fix (ConnectionPool)
CONPY-302: Fix segfault when using threads()
Fixed exception type for ER_BAD_FIELD_ERROR (now OperationalError instead of ProgrammingError)
MariaDB Connector/Python 1.1.12 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 15 Nov 2024
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
Added new property tls_peer_cert_info which returns peer certificate information (TLS connections only).
Added support for Python 3.13
Removed Python 3.8 builds
Binary packages for Windows are now built with Connector/C 3.4.3
Build fixes for MariaDB Connector/C 3.4.x
CONPY-289: BIGINT out of range on bulk insert
CONPY-293: Fix gcc warnings
CONPY-283: Incorrect result format after cursor.scroll()
MariaDB Connector/Python 1.1.11 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 22 Feb 2024
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-277: cursor.execute fails when running in sql_mode ANSI_QUOTES.
CONPY-278: Return updated connection_id in case of automatic reconnect
CONPY-279: Allow None values for password and database in change_user() method
CONPY-281: Use METH_O calling conventions for c functions which accept only one parameter
MariaDB Connector/Python 1.1.10 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 22 Dec 2023
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-276: Allow to retrieve data from buffered cursor if the connection was already closed before.
CONPY-274: Instead of releasing non freed objects (cursor and connection) in tp_dealloc, they are freed now in tp_finalize to avoid possible crashes.
CONPY-273: Fixed crash in escape_string of the connection object
MariaDB Connector/Python 1.1.9 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 16 Oct 2023
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-271: Cusor object provides now a metadata attribute, which returns resultset metadata as a dictionary. metadata attribute also contains information about extended field types like JSON, UUID, INET4/6 and geometry types.
Added new constants mariadb.constants.EXT_FIELD_TYPE which describe extended field types..
CONPY-270: Data will be converted to Binary only if the character set is binary, the BINARY_FLAG will be ignored.
CONPY-269: If cursors rowcount attribute will be retrieved after the cursor was closed, rowcount now returns -1 instead of raising an exception. This is a workaround for a pandas bug.
MariaDB Connector/Python 1.1.8 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 10 Jul 2023
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-253: The connection method now offers the option of specifying the version of the TLS protocol using tls_version.
CONPY-258: Fixed ValueError exception if ZEROFILL flag is defined
CONPY-255: If all connections from a pool are in use, pool.get_connection now returns None instead of raising an exception.
CONPY-256: Fix indexing when moving a free connection to used connections to avoid returning the same connection twice. Kudos and thanks to G.Mech for reporting this bug and providing the fix.
MariaDB Connector/Python 1.1.7 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 1 Mar 2023
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-247: Added optional parameter "pool_invalidation_interval", which specifies the validation interval in milliseconds after which the status of a connection requested from the pool is checked. The default values is 500 milliseconds, a value of 0 means that the status will always be checked.
CONPY-251: Check if stmt was already initialized in cursor nextset() method.
CONPY-250: Fixed calculation of connection pool size
CONPY-248: Replace broken connections in connection pool
CONPY-246: Rollback transaction if connection pool was created without pool_reset_connection option.
CONPY-245: Implementation of LRU cache in connection pool.
CONPY-240: Don't overwrite errormessage/stacktrace if an exception was generated during module initialization.
MariaDB Connector/Python 1.1.6 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 7 Nov 2022
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-220: Added _get_socket() method
Performance improvement: Instead of iterating via fetchone(), fetchall() and fetchmany() methods now load the data directly at once.
CONPY-222: Removed del() method from cursor
CONPY-224: Fixed bulk_operation when reexecuted using same cursor
CONPY-225: Fixed cursor.affected_rows property
CONPY-226: Replaced deprecated distutils (PEP-632)
CONPY-227: Replaced collections.named_tuple by PyStruct_Sequence (C-Python)
CONPY-228: Fixed Installation error (if C/C version < 3.2.4 was found)
CONPY-229: Converter: added missing support for None conversions
CONPY-231: Fixed memory leak
MariaDB Connector/Python 1.1.5 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 10 Aug 2022
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-217: Added reconnect keyword for connection
Added CAPABILITY constants
Code styling fixes (flake8)
CONPY-218: Allow None as data parameter in cursor->execute(). Kudos to Luciano Barcaro for providing a fix
CONPY-214: Replaced cursor iterator by native Python iter() method.
MariaDB Connector/Python 1.1.4 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 07 Jul 2022
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-209: Wrong unicode substitution in SELECT statement
CONPY-211: Added missing error constants
CONPY-212: unbuffered cursor.execute() doesn't work
MariaDB Connector/Python 1.1.3 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 27 Jun 2022
This is a stable release of MariaDB Connector/Python.
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-194: Support for INSERT RETURNING in executemany() method.
Removed utf8 part of internal parser and use binary objects for parameter substitution
CONPY-205: Fixed inconsistent exceptions:
All parameter exceptions are returned as ProgrammingError
A dictionary now might contain more keys than specified in SQL statement
Fixed memory leak when using decimal parameters
CONPY-201: Fixed build issues with Python 3.11 beta
MariaDB Connector/Python 1.1.2 can be obtained from central python repository:
pip3 install mariadbor to upgrade to the most recent version
pip3 install --upgrade mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 7 Apr 2022
This is a Release Candidate (RC) release of MariaDB Connector/Python.
Do not use non-stable (non-GA) releases in production!
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-44: Added support for simple failover (Requires MariaDB Connector/C 3.3)
CONPY-184: Display status of objects in string representation (cursor, connection, pool)
CONPY-88: Get additional information in fieldinfo: cursor->description() now contains 3 additional elements: table_name, orginal column name and original table name
CONPY-187: Fixed wrong detection of bulk capabilities
CONPY-188: If a connection or cursor is closed, an exception is returned whether a method or property of a closed object is called
CONPY-189: Fixed build with Visual Studio 2022
CONPY-178: If a cursor was not properly cleared (all results weren't fetched) the clear_result routine has to free result sets only if field_count > 0
CONPY-175: Allocate heap memory for string escaping
MariaDB Connector/Python 1.1.0-rc1 can be obtained from central python repository:
pip3 install --pre mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
Do not use non-stable (non-GA) releases in production!
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 22 Oct 2021
This is a Beta release of MariaDB Connector/Python and not intended for production use.
Do not use Beta releases in production!
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
Python 3.10 is now supported
CONPY-167: reprepare statement if executemany() was called directly after execute()
CONPY-168: Force use of binary protocol if binary parameters were provided
CONPY-169: Added unicode support for parser
CONPY-170: Added documentation for configuration file handling
CONPY-173: Windows build fix for Python 3.10
MariaDB Connector/Python 1.1.0-beta2 can be obtained from central python repository:
pip3 install --pre mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
Do not use beta releases in production!
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 27 Sep 2021
This is a beta release of MariaDB Connector/Python and not intended for production use.
Do not use beta releases in production!
For a description of this library see the MariaDB Connector/Python documentation .
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-162: Added attributes for obtaining version of MariaDB Connector/C library:
mariadb.client_version returns an integer, describing the version in the following format: MAJOR_VERSION * 10000 + MINOR_VERSION * 1000 + PATCH_VERSION
mariadb_client_version_info returns client version in tuple format
CONPY-159: Parse integer instead of short integer when retrieving server status
CONPY-160: ConnectionPool.get_connection might return None due to low precision of time.monotonic()
CONPY-161: ConnectionPool.connection_count returns list of connections instead of a numeric value
MariaDB Connector/Python 1.1.0-beta1 can be obtained from central python repository:
pip3 install --pre mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
Do not use beta releases in production!
This page is: Copyright © 2025 MariaDB. All rights reserved.
The most recent Stable (GA) release of MariaDB Connector/Python is:
Release date: 18 Aug 2021
This is an Alpha release of MariaDB Connector/Python and not intended for production use.
Do not use Alpha releases in production!
For a description of this library see the MariaDB Connector/Python documentation.
MariaDB Connector/Python enables python programs to access MariaDB and MySQL databases, using an API which is compliant with the Python DB API 2.0 (PEP-249). It is written in C and uses MariaDB Connector/C client library for client server communication.
CONPY-97: All classes (including cursor and connection) are implemented in native Python. Instead of using the default cursor and connection classes, it is now possible to use own classes which are based on default classes.
The default behaviour for cursor result sets changed: instead of using unbuffered result sets buffered result sets are used (buffered= True).
Parser was partially reworked: Beside several fixes for different comment styles, the parser checks if binary or text protocol will be used.
Several new constants were added. CLIENT for capability checking, FIELD_FLAGS for use together with Cursor.descriptor, STATUS for checking current status of database server.
For reducing releasing and locking of the GIL, executemany() method was optimized and a new method was added to MariaDB Connector/C.
The minimum required version of Connector/C is now 3.2.4
Documentation was updated and extended.
New methods and attributes:
Connection class:
method begin() - starts a new transaction
method select_db() - changes the default database
method show_warnings() - Shows error, warning and note messages from last executed command
attribute client_capabilities - allows to check the capabilities of client library
attribute server_capabilities - allows to check the capabilities of connected database server
attribute server_status - allows to check the current server status
attribute open - returns True if the connection is alive, otherwise False
Cursor class
attribute buffered - default is now True.
paramcount - returns the number of parameters in a statement
MariaDB Connector/Python 1.1.0a1 can be obtained from central python repository:
pip3 install --pre mariadbFor a list of changes made in this release, with links to detailed information on each push, see the changelog.
Sources are hosted on Github
Do not use alpha releases in production!
This page is: Copyright © 2025 MariaDB. All rights reserved.