Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r100

d-toc

d-toc
d-s-ed
rtrue
editionsgdpent,gdppro,gdppr,gdpst
,awsent,awspro,awspr,awsst


Excerpt

You can create connections to one or more 

D s conntype
typemysql
 databases from  databases from the
d-s-productplatform
rtrue
. For more information on MySQL, see https://www.mysql.com/.

D s conntype cloud

If you are connecting the

d-s-productplatform
to  to any relational source of data, such as Redshift or Oracle, you must add the
D s item
itemService
to your whitelist for those resources.

...

See Whitelist Platform Service.

...

  • Read: Supported
  • Write: Supported

...

PropertyDescription
Host
Enter your fully qualified hostname. Example:


Code Block
mysql-server.example.net
PortSet this value to 3306.
Connect String Options

Insert any additional connection parameters, if needed. See below.

User NameUsername to use to connect to the database.
PasswordPassword associated with the above username.
Test ConnectionAfter you have defined the connection credentials type, credentials, and connection string, you can validate those credentials.
Advanced options: Default Column Data Type Inference

Set to disabled to prevent the platform from applying its own type inference to each column on import. The default value is enabled.

Advanced options: Enable SSH Tunneling

If available, the SSH tunneling options allow you to configure SSH tunneling authentication between the

D s webapp
typePortal
 and your database.

Info

NOTE: SSH tunneling is available on a per-connection basis. It may not be available for all connections.

For more information, see Configure SSH Tunnel Connectivity.


Connection NameDisplay name of the connection
Connection DescriptionDescription of the connection, which appears in the application.

...

The properties that you provide are inserted into the following URL, which connects connects the

d-s-productplatform
 to the connection:

Code Block
jdbc:mysql://<host>:<port>/<database><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:

Code Block
?&<prop1>=<val1>&<prop2>=<val2>...

...

  • <prop> : the name of the property
  • <val> : the value for the property

delimiters:

...

:

...

  • & all additional property names must be prefixed with an ampersand (&).
  • =property names and values must be separated with an equal sign (=).

...

Code Block
useCursorFetch=true;

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:

Code Block
&enabledTLSProtocols=TLSv1,TLSv1.1,TLSv1.2

Set time zone

When data is imported from MySQL, the connector performs time zone adjustments to imported Datetime values. 

Tip

Tip: By default, the MySQL driver adjusts the imported data to be represented in the time zone into which it is being read. If you are located in GMT -08:00, all data is rendered that your

D s item
itemuser
reads into the application through the MySQL connector is adjusted to this time zone.

These adjustments are performed in either of the following cases:

  • The MySQL server is configured with a canonical time zone that is recognizable by Java (for example, Europe/Paris, Etc/GMT-5, UTC, etc.).
  • The server's time zone is overridden by setting the Connector/J connection property serverTimezone.

In the latter case, you can specify the override time zone to apply as part of the connection string: 

Code Block
&serverTimezone=Europe/Paris

The following value sets the time zone of imported data to be UTC:

Code Block
&serverTimezone=UTC

For more information on this behavior, see https://dev.mysql.com/doc/connector-j/8.0/en/connector-j-other-changes.html.

Driver Information

This connection uses the following driver:

...

D s api refdoclink
#operation/createConnection

Troubleshooting

Error messageDescription
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.

Tip

Tip: Click the Test Connection button to verify that your credentials are working properly.

Error: zero date value prohibited

Set the following option in the connect string options:

Code Block
zeroDateTimeBehavior=convertToNull
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:

Code Block
useCursorFetch=false
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.

...

For more information on how values are converted during input and output with this database, see MySQL Data Type Conversions.

D s also
labelmysql