MariaDB Connector/C 3.3.0.rc1 Release Notes
Release date: 15 Feb 2022
This is a RC release of MariaDB Connector/C, formerly known as MariaDB Client Library for C.
For a description of this library see the MariaDB Connector/C page.
Do not use non-stable (non-GA) releases in production!
Restrict authentication plugins (CONC-544)
Added new option MARIADB_OPT_RESTRICTED_AUTH (and corresponding "restricted-auth" option for configuration files) which specifies on or more comma spearated authentication plugins which are allowed for authenication.
If the server asks for an authentication plugin not listed in this option the connect attempt will fail with error CR_PLUGIN_NOT_ALLOWED.
ZStandard compresion support
Zstd compression is now supported for connections to a MySQL Server 8.0 or newer. Compression algorithms are now provided via plugins. If the Zstd compression plugin is not part of a downloaded package it means, that zstd is not installed by default on this platform. In this case you have to install the zstd libraries and include files and build the plugin from source.
Support for semi synchronous replication (CONC-470)
Beside already supported asynchronous replication the replication/binlog API now supports semi synchronous replication.
Failover capabilities (CONC-365)
host parameter of mysql_real_connect (and corresponding configuration settings MYSQL_OPT_HOST for mysql_options() api call and host key in configuration files) now accepts to specify multiple hosts and ports.
When establishing a connection, the list of specified hosts is run through until a connection can be established. If no connection can be established to any of the specified hosts, an error is returned.
MARIADB_CONNECTION_BYTES_READ and MARIADB_CONNECTION_BYTES_SENT
mariadb_get_infov now supports options MARIADB_CONNECTION_BYTES_READ and MARIADB_CONNECTION_BYTES_SENT to obtain the bytes sent or read to/from database server.
Connection string support (CONC-247)
A connection string contains key/value pairs, separated by a semicolon as used in ODBC. Supported keys are all configuration options which can be used in MariaDB configuration files. For a complete list check https://github.com/mariadb-corporation/mariadb-connector-c/wiki/config_files#configuration-options.
The connection string must contain at least one semicolon, otherwise it wil be interpreted as hostname. Unknown or invalid keys will be ignored.
To connect via connection string, the following methods might be used: - by specifing connection option in configuration file: - by using mariadb_connect() macro - by passing connection string in host parameter to mysql_real_connect
- CONC-467: rotate as first event isn't handled correctly (replication/binlog api)
For a list of changes made in this release, with links to detailed information on each push, see the changelog.