The most recent Stable (GA) release of MariaDB Connector/Python is:MariaDB Connector/Python 1.1.12

DownloadRelease NotesConnector/Python Overview

Release date: 18 Aug 2021

This is an alpha release of the MariaDB Connector/Python and not intended for production use.

Do not use alpha releases in production!

For a description of this library see theMariaDB 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.

Notable changes

• 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

Installation

MariaDB Connector/Python 1.1.0a1 can be obtained from central python repository:

pip3 install --pre mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• Sources are hosted on Github

Do not use alpha releases in production!

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

The most recent Stable (GA) release of MariaDB Connector/Python is:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 27 Sep 2021

This is an beta release of the MariaDB Connector/Python and not intended for production use.

Do not use beta releases in production!

For a description of this library see theMariaDB 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.

Notable changes

• 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

Bug fixes

• 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

Installation

MariaDB Connector/Python 1.1.0-beta1 can be obtained from central python repository:

pip3 install --pre mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 22 Oct 2021

This is an beta release of the MariaDB Connector/Python and not intended for production use.

Do not use beta releases in production!

For a description of this library see theMariaDB 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.

Notable changes

Python 3.10 is now supported

Bug fixes

• 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

Installation

MariaDB Connector/Python 1.1.0-beta2 can be obtained from central python repository:

pip3 install --pre mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 7 Apr 2022

This is an rc release of the MariaDB Connector/Python.

Do not use non-stable (non-GA) releases in production!

For a description of this library see theMariaDB 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.

Notable changes

• 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)

Bug fixes

• 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

Installation

MariaDB Connector/Python 1.1.0-rc1 can be obtained from central python repository:

pip3 install --pre mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 22 Feb 2024

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Bug fixes

• 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

Installation

MariaDB Connector/Python 1.1.10 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 15 Nov 2024

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• 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

Bug fixes

• 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()

Installation

MariaDB Connector/Python 1.1.11 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• Sources are hosted on Github

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 24 Feb 2025

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• 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()

Bug fixes

• 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)

Installation

MariaDB Connector/Python 1.1.12 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 27 Jun 2022

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• CONPY-203: Error constants added

• CONPY-204: New connection method dump_debug_info()

Bug fixes

• 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

Installation

MariaDB Connector/Python 1.1.2 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 07 Jul 2022

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Bug fixes

• CONPY-209: Wrong unicode substitution in SELECT statement

• CONPY-211: Added missing error constants

• CONPY-212: unbuffered cursor.execute() doesn't work

Installation

MariaDB Connector/Python 1.1.3 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 10 Aug 2022

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• CONPY-217: Added reconnect keyword for connection

• Added CAPABILITY constants

• Code styling fixes (flake8)

Bug fixes

• 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.

Installation

MariaDB Connector/Python 1.1.4 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 7 Nov 2022

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• CONPY-220: Added _get_socket() method

• Performance improvement: Instead of iterating via fetchone(), fetchall() and fetchmany() methods now load the data directly at once.

Bug fixes

• 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

Installation

MariaDB Connector/Python 1.1.5 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 1 Mar 2023

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• 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.

Bug fixes

• 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.

Installation

MariaDB Connector/Python 1.1.6 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 10 Jul 2023

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• CONPY-253: The connection method now offers the option of specifying the version of the TLS protocol using tls_version.

Bug fixes

• 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.

Installation

MariaDB Connector/Python 1.1.7 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 16 Oct 2023

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Notable changes

• 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..

Bug fixes

• 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.

Installation

MariaDB Connector/Python 1.1.8 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• 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:MariaDB Connector/Python 1.1.12

DownloadRelease NotesChangelogConnector/Python Overview

Release date: 22 Dec 2023

This is a stable release of the MariaDB Connector/Python.

For a description of this library see theMariaDB 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.

Bug fixes

• 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

Installation

MariaDB Connector/Python 1.1.9 can be obtained from central python repository:

pip3 install mariadb

or to upgrade to the most recent version

pip3 install --upgrade mariadb

Changelog

For a list of changes made in this release, with links to detailed information on each push, see the changelog.

Links:

• Documentation

• Bug tracker

• Sources are hosted on Github

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}