Release Notes for MariaDB Connector/C++ 1.1.2
This page is part of MariaDB's Documentation.
The parent of this page is: Release Notes for MariaDB Connector/C++ 1.1
Topics on this page:
Overview
MariaDB Connector/C++ is the interface between C++ applications and MariaDB Server. MariaDB Connector/C++ enables development of C++ applications using a JDBC-based API, which is also used by MariaDB Connector/J. This is the first release candidate (RC) release of MariaDB Connector/C++ 1.1.
MariaDB Connector/C++ 1.1.2 was released on 2022-11-30. This release is of Release Candidate (RC) maturity, and should not be used with production workloads.
MariaDB Connector/C++ in its current implementation uses the MariaDB protocol via the MariaDB Connector/C API. Connector/C 3.3.0 is used in this release.
Notable Changes
Added macOS PKG packages.
Added support of two optimized modes of
executeBatch/executeLargeBatch
PreparedStatement methods execution: (CONCPP-106)rewriteBatchedStatements
connection optionuseBulkStmts
connection option
rewriteBatchedStatements
When using the
rewriteBatchedStatements
connection option, forINSERT
queries the connector will construct a single query using batch parameter sets. For example:INSERT INTO ab (i) VALUES (?) with first batch values = 1, second = 2
will be rewritten as:
INSERT INTO ab (i) VALUES (1), (2)
If the query cannot be rewritten in
multi-values
, therewriteBatchedStatements
connection option will usemulti-queries
. For example:INSERT INTO ab(col1) VALUES (?) ON DUPLICATE KEY UPDATE col2=? with values [1,2] and [2,3]
will be rewritten as:
INSERT INTO ab(col1) VALUES (1) ON DUPLICATE KEY UPDATE col2=2;INSERT INTO TABLE(col1) VALUES (3) ON DUPLICATE KEY UPDATE col2=4
If the
rewriteBatchedStatements
connection option is selected, theuseServerPrepStmts
option is set to false.If both
rewriteBatchedStatements
anduseBulkStmts
options are selected,rewriteBatchedStatements
takes precedence.
useBulkStmts
The
useBulkStmts
connection option uses the MariaDB bulk execution feature, so it requires MariaDB Server 10.2.7 or later.useBulkStmts
will be used even ifuseServerPrepStmts
is not set, in other words, if the default statement prepare method is client-side prepare.If both
useBulkStmts
andrewriteBatchedStatements
options are selected,rewriteBatchedStatements
takes precedence.
Issues Fixed
Attempting connections from multiple threads causes the connector to crash. (CONCPP-105)
PreparedStatement
setDouble
only processes the first 6 significant digits and zeros any additional digits. (CONCPP-96)Result-set streaming is not supported in this release series, but setting
setFetchSize
does not throw an exception and can cause the application to crash.Starting with this release, setting
setFetchSize
will throwSQLFeatureNotImplementedException
at the attempt to setfetch size >0
(CONCPP-107)