MySQL Connector/C++ 8.0 Developer Guide
To obtain a Connector/C++ binary distribution, visit the Connector/C++ downloads page.
For some platforms, Connector/C++ binary distributions are available in platform-specific packaging formats. Binary distributions are also available in more generic format, in the form of compressed tar files or Zip archives.
For descriptions here that refer to documentation files, those files
have names such as CONTRIBUTING.md,
README.md, README.txt,
README, LICENSE.txt,
LICENSE, INFO_BIN, and
INFO_SRC. (Prior to Connector/C++ 8.0.14, the
information file is BUILDINFO.txt rather than
INFO_BIN and INFO_SRC.)
On Windows platforms, Commercial and Community Connector/C++ distributions require the Visual C++ Redistributable for Visual Studio. The Redistributable is available at the Visual Studio Download Center; install it before installing Connector/C++. For information about which VC++ Redistributable versions are acceptable, see Platform Support and Prerequisites.
These methods of installing binary distributions are available on Windows:
MySQL Installer. The simplest and recommended method of installing Connector/C++ on Windows platforms is to download MySQL Installer and let it install and configure all the MySQL products on your system. For details, see MySQL Installer for Windows.
Windows MSI installer.
As of Connector/C++ 8.0.12, an MSI Installer is available for
Windows. To use the MSI Installer (.msi
file), launch it and follow the prompts in the screens it
presents. The MSI Installer can install components for these
connectors:
The connector for X DevAPI (including X DevAPI for C).
The connector for the legacy JDBC API.
For each connector, there are two components:
The DLL component includes the connector DLLs and libraries to satisfy runtime dependencies. The DLL component is required to run Connector/C++ application binaries that use the connector.
The Developer component includes header files, static libraries, and import libraries for DLLs. The Developer component is required to build from source Connector/C++ applications that use the connector.
The MSI Installer requires administrative privileges. It begins by presenting a welcome screen that enables you to continue the installation or cancel it. If you continue the installation, the MSI Installer overview screen enables you to select the type of installation to perform:
The Complete installation installs the DLL and Developer components for both connectors.
The Typical installation installs the DLL component for both connectors.
The Custom installation enables you to specify the installation location and select which components to install. The DLL and Developer components for the X DevAPI connector are preselected, but you can override the selection. The Developer component for a connector cannot be selected without also selecting the connector DLL component.
For all installation types, the MSI Installer performs these actions:
It checks whether the required Visual C++ Redistributable for Visual Studio is present. If not, the installer asks you to install it and exits with an error. For information about which VC++ Redistributable versions are acceptable, see Platform Support and Prerequisites.
It installs documentation files.
Prior to Connector/C++ 8.0.13, because the Microsoft Visual C++ 2017 Redistributable installer deletes the Microsoft Visual C++ 2015 Redistributable registry keys that identify its installation, standalone MySQL MSIs may fail to detect the Microsoft Visual C++ 2015 Redistributable if both it and the Microsoft Visual C++ 2017 Redistributable are installed. The solution is to repair the Microsoft Visual C++ 2017 Redistributable via the Windows Control Panel to recreate the registry keys needed for the runtime detection. Unlike the standalone MSIs, MySQL Installer for Windows contains a workaround for the detection problem.
This workaround is unnecessary as of Connector/C++ 8.0.13.
Zip archive package without installer.
To install from a Zip archive package
(.zip file), see
Installation Using a tar or Zip Package.
In addition to the standard Zip archive packages, packages are available that were built in debug mode. However, applications should use the same build mode as Connector/C++. If you install Connector/C++ packages built in debug mode, build applications in debug mode. If you install Connector/C++ packages built in release mode, build applications in release mode.
These methods of installing binary distributions are available on Linux:
RPM package. RPM packages are available for Linux (as of Connector/C++ 8.0.12). The packages are distinguished by their base names (the full names include the Connector/C++ version and suffixes):
mysql-connector-c++: This package
provides the shared connector library implementing X DevAPI
and X DevAPI for C.
mysql-connector-c++-jdbc: This package
provides the shared legacy connector library implementing
the JDBC API.
mysql-connector-c++-devel: This package
installs development files required for building
applications that use Connector/C++ libraries provided by the other
packages, and static connector libraries. This package
depends on the shared libraries provided by the other
packages. It cannot be installed by itself without the other
two packages.
Debian package. Debian packages are available for Linux (as of Connector/C++ 8.0.14). The packages are distinguished by their base names (the full names include the Connector/C++ version and suffixes):
libmysqlcppconn8-1: This package provides
the shared connector library implementing X DevAPI and
X DevAPI for C.
libmysqlcppconn7: This package provides
the shared legacy connector library implementing the JDBC
API.
libmysqlcppconn-dev: This package
installs development files required for building
applications that use Connector/C++ libraries provided by the other
packages, and static connector libraries. This package
depends on the shared libraries provided by the other
packages. It cannot be installed by itself without the other
two packages.
Compressed tar file.
To install from a compressed tar file
(.tar.gz file), see
Installation Using a tar or Zip Package.
These methods of installing binary distributions are available on macOS:
DMG package. DMG (disk image) packages for macOS are available as of Connector/C++ 8.0.12. A DMG package provides shared and static connector libraries implementing X DevAPI and X DevAPI for C, and the legacy connector library implementing the JDBC API. The package also includes OpenSSL libraries, public header files, and documentation files.
Compressed tar file.
To install from a compressed tar file
(.tar.gz file), see
Installation Using a tar or Zip Package.
The installation packages have a dependency on the Oracle Developer Studio 12.6 Runtime Libraries, which must be installed before you run the MySQL installation package. See the download options for Oracle Developer Studio here. The installation package enables you to install the runtime libraries only instead of the full Oracle Developer Studio; see instructions in Installing Only the Runtime Libraries on Oracle Solaris 11.
These methods of installing binary distributions are available on Solaris:
Compressed tar file.
To install from a compressed tar file
(.tar.gz file), see
Installation Using a tar or Zip Package.
Connector/C++ binary distributions are available for several platforms,
packaged in the form of compressed tar files or
Zip archives, denoted here as
PACKAGE.tar.gzPACKAGE.zip
To unpack a compressed tar file, use this command in the intended installation directory:
tar zxvf PACKAGE.tar.gz
To install from a Zip archive package (.zip
file), use WinZip or another tool that can read
.zip files to unpack the file into the location
of your choosing.