Changes in MySQL Connector/C++ 8.0.33 (2023-04-18; General Availability)$$$Compilation Notes$$$$$$Packaging Notes$$$$$$Pluggable Authentication$$$$$$Functionality Added or Changed$$$$$$Bugs Fixed$$$$$$Compilation Notes$$$To simplify building the legacy JDBC connector with Linux distributions that do not ship static libraries; the MYSQLCLIENT_STATIC_LINKING default now is OFF (use dynamic linking to the client library). Previously; the default setting was ON and the binary distributions from Oracle are still built with static linking. (WL #15466)$$$$$$Binary distributions from Oracle are built in C++17 mode. When building Connector/C++ from sources; the compilation now fails if the compiler used does not support C++17. To compile Connector/C++ applications that use X DevAPI (or if the code uses C++17); enable C++17 support in the compiler using the -std=c++17 option. (WL #15429)$$$$$$Connector/C++ now compiles cleanly using Clang on Windows. (WL #15290)$$$$$$Packaging Notes$$$ZSTD sources bundled in the Connector/C++ source tree are upgraded to ZSTD 1.5.0. (Bug #34983529)$$$$$$LZ4 sources bundled in the Connector/C++ source tree are upgraded to LZ4 1.9.4. (Bug #34983380)$$$$$$ZLIB sources bundled in the Connector/C++ source tree are upgraded to ZLIB 1.2.13 to match the server. (Bug #34888141)$$$$$$RapidJSON sources bundled in the Connector/C++ source tree are upgraded to RapidJSON 1.1.0 to match the server. (Bug #34842662)$$$$$$Pluggable Authentication$$$The Connector/C++ implementation of the authentication_oci_client plugin (together with libmysqlclient) now enables using a security-token file to support ephemeral key-pair authentication when integration with an external identity provider is needed for classic MySQL protocol connections. The Oracle Cloud Infrastructure CLI generates the ephemeral key pair and security token.$$$$$$In addition; applications that use the legacy JDBC API now can set the new OPT_OCI_CLIENT_CONFIG_PROFILE connection option to specify which profile in the configuration file to use for authentication. It defaults to the [DEFAULT] profile. (WL #15481)$$$$$$Functionality Added or Changed$$$The Connector/C++ legacy JDBC connector now identifies itself through the following new connection attributes (in addition to the connection attributes obtained from the libmysql client library by default):$$$$$$_connector_version to indicate the connector version (for example; 8.0.33).$$$$$$_connector_license to indicate the license type of the connector; either GPL-2.0 or Commercial.$$$$$$_connector_name with a constant value of mysql-connector-cpp.$$$$$$The new attributes are not configurable by applications. Instead; the connector sets all of the attribute values; which it determines automatically after connecting to the server. If the libmysql client library or MySQL Server version being used lack support for query attributes; then returning related connection-attribute errors is not possible.$$$$$$For general information about connection attributes; see Performance Schema Connection Attribute Tables. (WL #15425)$$$$$$Bugs Fixed$$$X DevAPI: Operations attempting to modify an entire document; for example;$$$$$$coll.modify(_id = 1).set($; R({ name: bar }))cute();$$$emitted a server error rather than modifying the document. An error is expected when passing in a string. To modify an entire document; the caller should pass in a DbDoc() document. For example:$$$$$$coll.modify(_id = 1).set($; DbDoc(R({ name: bar })))cute();$$$(Bug #35046616)$$$$$$X DevAPI: When a connection was made to MySQL Router; rather than directly to the server; closing a session using mysqlx_session_close was not possible. Now; the connector no longer waits for a reply to the call before closing the session. (Bug #107693; Bug #34338937)$$$$$$Minimum CMake version required was changed to 3.12 from the previous version; which was deprecated and produced warnings. (Bug #20422957)$$$$$$

Security Notes$$$This release of Connector/C++ upgrades Cyrus SASL to version 2.1.28; which has been publicly reported as not vulnerable to CVE-2022-24407. (Bug #34680980)$$$$$$Functionality Added or Changed$$$For applications that use the legacy JDBC API (that is; not X DevAPI or X DevAPI for C); setting the OPT_METADATA_INFO_SCHEMA (metadataUseInfoSchema) connection option was essential to the performance of Information_Schema in the older versions of MySQL Server. The option is no longer needed for performance. Now; setting OPT_METADATA_INFO_SCHEMA has no affect on the behavior of the connector and the option is ignored. (WL #15322)$$$$$$Bugs Fixed$$$X DevAPI: A call to close a session while other Session objects are in use could return a busy error. (Bug #34704048)$$$$$$X DevAPI: An attempt to execute a long SQL statement emitted an error when the connection was established using mysqlx_get_session_from_options() to connect to MySQL Router and with compression enabled on the connection. (Bug #107694; Bug #34338921)$$$$$$A local object move in a return statement could prevent copy elision (or copy omission). Our thanks to Octavio Valle for the patch. (Bug #108652; Bug #34654192)

Functionality Added or Changed$$$If building the legacy JDBC connector from source; using an additional git command to perform submodule initialization is no longer necessary. (WL #15182)$$$ $$$Bugs Fixed$$$X DevAPI: If an application program called mysqlx_session_close after disconnecting from the Internet; an exception from Connector/C++ could cause the application to halt unexpectedly. (Bug #107692; Bug #34338950)$$$$$$On Windows; compiler difficulties were encountered because unistd.h was used to call getcwd rather than using various Windows alternatives. Our thanks to Luis Pinto for the patch. (Bug #108355; Bug #34553226)$$$$$$The libcrypto library; which libssl attempted to link to; was installed in an unexpected directory by the Connector/C++ binary distribution for macOS. This fix ensures that both bundled libraries are installed in the same directory. (Bug #107947; Bug #34417381)$$$$$$