Create MySQL Connections

Contents:

Expand all Collapse all

Our documentation site is moving!

For up-to-date documentation of Dataprep, please visit us at https://help.alteryx.com/Dataprep/.

Feature Availability: This feature may not be available in all product editions. For more information on available features, see Compare Editions.

Contents:

You can create connections to one or more MySQL databases from Dataprep by Trifacta. For more information on MySQL, see https://www.mysql.com/.

If you are connecting Dataprep by Trifacta to any relational source of data, such as Redshift or Oracle, you must add the Dataprep by Trifacta Service to your whitelist for those resources.

For more information, see Getting Started with Cloud Dataprep.

Configure

To create this connection:

In the Import Data page, click the Plus sign. Then, select the Relational tab. Click the MySQL card.
You can also create connections through the Connections page.
See Connections Page.

Modify the following properties as needed:

Property	Description
Host	Enter your fully qualified hostname. Example: mysql-server.example.net
Port	Set this value to `3306`.
Connect String Options	Insert any additional connection parameters, if needed. See below.
User Name	Username to use to connect to the database.
Password	Password associated with the above username.
Test Connection	After you have defined the connection credentials type, credentials, and connection string, you can validate those credentials.
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`.
Connection Name	Display name of the connection
Connection Description	Description of the connection, which appears in the application.

Reference

Connection URL

The properties that you provide are inserted into the following URL, which connects Dataprep by Trifacta to the connection:

jdbc:mysql://<host>:<port>/<database><connect-string-options>

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:

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

where:

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

delimiters:

? : any set of connect string options must begin with a question mark.
& : 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.

useCursorFetch=true;

Driver Information

This connection uses the following driver:

Driver name: com.mysql.cj.jdbc.Driver
Driver version: 8.0
Driver documentation: https://dev.mysql.com/doc/connector-j/8.0/en/

Troubleshooting

Error message	Description
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: 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: zeroDateTimeBehavior=convertToNull

For more information on error messages for this connection type, see https://dev.mysql.com/doc/refman/8.0/en/error-handling.html.

Use

For more information, see Database Browser.

Data Conversion

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

Send Feedback

Page tree