MySQL Connector/Python Release Notes
MySQL Connectors and other MySQL client tools and applications now synchronize the first digit of their version number with the (latest) 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 earlier). 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.
Connector/Python now supports MySQL servers configured to use
utf8mb4
as the default character set.
(WL #10659)
To avoid unintentional changes to all items in a collection, the
Collection.modify()
and
Collection.remove()
methods now require a
nonempty selection expression as argument. To intentionally
apply an operation to an entire collection, pass a condition
that always evaluates to true, such as True
.
A similar change was made to Table.update()
and Table.delete()
.
(Bug #25991574, WL #10754)
For MSI and Solaris packages, the pure Python Protobuf support implementation was replaced by a C++ extension. This enables Connector/Python to support Python 2 and 3 as well Protobuf 2 and 3. (WL #10198)
The NodeSession
class has been renamed to
Session
, and the XSession
class has been removed.
(WL #10658)
Connections created using Session
objects now
are encrypted by default. Also, the
ssl-enabled
connection option has been
replaced by ssl-mode
. Permitted
ssl-mode
values are
disabled
, required
(the
default), verify_ca
and
verify_identity
.
(WL #10770)
The format of document ID values generated when adding documents to a collection has changed. It is still a string of 32 hexadecimal digits based on UUID, but the order of digits was changed to match the requirement of a stable ID prefix. (WL #10004)