Release Notes for MariaDB MaxScale 6.2.0
This page is part of MariaDB's Documentation.
The parent of this page is: Release Notes for MariaDB MaxScale 6
Topics on this page:
Overview
MariaDB MaxScale is an advanced database proxy, firewall, and query router.
MariaDB MaxScale 6.2.0 was released on 2021-11-26. This release is of General Availability (GA) maturity.
New Features
MaxGUI
Adds a multi-tab query editor (MXS-3638)
Adds a right-click context menu to schema tree (MXS-3632)
Adds a DDL editor (MXS-3634)
Adds functionality to reconnect when a connection encounters errors (MXS-3838)
Adds ability to open multiple active SQL connections (MXS-3681)
Adds drag-and-drop functionality for quicker access to "Place Schema in Editor" (MXS-3635)
Adds ability to filter results by specific columns (MXS-3636)
Adds a view that shows history/favorite queries (MXS-3675)
Shows the status of replica servers (MXS-3659)
Shows stored procedures and triggers in the schema tree (MXS-3639)
MaxCtrl
REST API
Filters
Most filters can be reconfigured at runtime (MXS-3594)
Hint Filter (
hintfilter
) supports direct execution of prepared statements (PS) (MXS-3813)Tee Filter (
tee
) can operate in a synchronous mode when thesync
parameter is enabled (MXS-3363)Masking Filter (
masking
) can be reconfigured at runtime (MXS-3709)Named Server Filter (
namedserverfilter
):Query Log All Filter (
qlafilter
):Can log the canonical form of a query when the
use_canonical_form
parameter is enabled (MXS-3701)Logs the number of rows in a result set (MXS-3771)
Logs transaction-related details previously logged by the Transaction Performance Monitoring Filter (
tpmfilter
) (MXS-3645)Can be reconfigured at runtime (MXS-3711)
Logs several new output fields:
num_rows
: Number of rows in result setreply_size
: Number of bytes received from the servertransaction
:BEGIN
,COMMIT
, andROLLBACK
transaction_time
: The duration of a transactionnum_warnings
: Number of warnings in the server replyerror_msg
: Error message from the server (if any)
MariaDB Monitor (mariadbmon
)
Clears existing replication sources on rejoin when
enforce_simple_topology
is enabled (MXS-3755)
MariaDB Protocol
Adds the ability to read client user accounts from a file and map them to backend users when the
user_accounts_file
parameter is set for a service or listenerAdds support for the
DEPRECATE_EOF
flag, which improves session tracking capabilities (MXS-1892)Adds support for the
MARIADB_CLIENT_CACHE_METADATA
flag, which allows metadata to be skipped for prepared statements (PS) (MXS-3613)Automatically installs MariaDB Connector/C authentication plugins and sets the
connector_plugindir
parameter (MXS-3770)
Authenticators
GSSAPI Authenticator (
GSSAPIAuth
) adds thegssapi_keytab_path
authenticator option to set the path to the keytab file (MXS-3733)PAM Authenticator (
PAMAuth
):Adds support for group mapping (MXS-3475)
Adds the
pam_mapped_pw_file
authenticator option to configure a file path used to store mapped user names and passwords. Only applies whenpam_backend_mapping=mariadb
is set
Other Changes
Enhancements to the nosqlprotocol module
Speeds up special query parsing (PCRE2) (MXS-3514)
Improves performance of multi-statement detection (MXS-3498)
Issues Fixed
Can result in a hang or crash
Binlog Router (
binlogrouter
) causes crash (MXS-3815)Cache Filter (
cache
) causes crash (MXS-3778)Kafka Importer (
kafkaimporter
) causes crash when no servers are available (MXS-3736)Crash on object type change with
config_sync_cluster
(MXS-3717)Race condition in GCUpdater shutdown can rarely lead to hang (MXS-3793)
Can result in unexpected behavior
MaxGUI:
MaxCtrl:
NoSQL Listener (
nosqlprotocol
):Avro Router (
avrorouter
) does not store full GTID coordinates (MXS-3580)Read/Write Split Router (
readwritesplit
):Schema Router (
schemarouter
):Binlog Router (
binlogrouter
):Some monitors do not log enough information when server state changes (MXS-3800)
MariaDB Monitor (
mariadbmon
): (MXS-3809)When MariaDB Monitor acquires lock majority, the log message gives the impression that
auto_failover
is enabled even when it is not configured
Masking Filter (
masking
) blocksALTER TABLE
statements (MXS-2992)Tee Filter (
tee
) loses statements if branch target is slower (MXS-3353)Query Log All Filter (
qlafilter
):idle_session_pool_time=0s
doesn't immediately pool idle connections (MXS-3730)idle_session_pool_time
should support prepared statements (MXS-3720)Protocol module configurations are not persisted (MXS-3689)
Lack of nested parameters is not detected (MXS-3687)
Object names with characters outside of the ASCII range are not rejected (MXS-3686)
Cached user account details are not updated when login fails (MXS-3630)
Node hostname used for
config_sync_cluster
is not escaped properly (MXS-3847)Configuration change detection with
config_sync_cluster
is inadequate (MXS-3618)
Interface Changes
list queries
maxctrl utility addedmaxctrl list queries
--max-length
command-line option addedProtocol.MariaDBProtocol
type
module parameter removedProtocol.MariaDBProtocol
user_mapping_file
module parameter addedRouter.readconnroute
user_accounts_file
module parameter addedRouter.readconnroute
user_accounts_file_usage
module parameter addedRouter.readwritesplit
user_accounts_file
module parameter addedRouter.readwritesplit
user_accounts_file_usage
module parameter added
Platforms
In alignment to the MariaDB Corporation Engineering Policy, MariaDB MaxScale 6.2.0 is provided for:
CentOS 7
CentOS 8
Debian 9
Debian 10
Red Hat Enterprise Linux 7
Red Hat Enterprise Linux 8
SUSE Linux Enterprise Server 12
SUSE Linux Enterprise Server 15
Ubuntu 18.04
Ubuntu 20.04