Connect string options
The connect string options are optional. If you are passing additional properties and values to complete the connection, the connect string options must be structured in the following manner:
<prop>: the name of the property
<val>: the value for the property
&: all additional property names must be prefixed with an ampersand (
=: property names and values must be separated with an equal sign (
Default connect string options
The following connect string options are specified by default.
NOTE: These options should not be overridden or modified.
The following connect string option requires the driver to use cursor-based fetching to retrieve rows.
Enable TLS (SSL)
You can insert the following connection string option to enable secure (TLS) connectivity with the MySQL server. Please note the TLS version numbers in the string listed below:
Column aliasing issues
In some environments, data fetched from a MySQL database table using column aliasing fails, returning incorrect null values after sampling. In these cases, you can try to add the following connection string option. This option reverts to an earlier behavior in how column aliasing is handed:
|1042 - ER_BAD_HOST_ERROR|
Unable to connect to host. Please verify the host and port values.
|1045 - ER_ACCESS_DENIED_ERROR|
Credentials failed to connect. Please verify your credentials.
Set the following option in the connect string options:
|Prepared statement needs to be re-prepared.|
Database Cursor is not compatible with PREPARED statements in MySQL. The fix is to set the following in the Connect String Options:
|SSLHandshakeException: No appropriate protocol (protocol is disabled or cipher suites are inappropriate)||SSL ciphers need to be enabled. For more information, see "Enable TLS (SSL)" above.|
For more information on error messages for this connection type, see https://dev.mysql.com/doc/refman/8.0/en/error-handling.html.