MySQL Source Connector
The MySQL source connector lets DataSync retrieve data from a MySQL database and load it into your data warehouse. Once your source connection is ready, configure your destination connection to finish the setup.
Create the source connection in DataSync
- Log in to DataSync.
- From the welcome screen, select Connections.
- Next to Source Connections, click New.
- Select MySQL.
- Enter all required connection properties.
- (Optional) In the Additional Connection Properties panel, click Add property and enter any extra parameters you need.
- Configure the advanced settings to match your environment, including Tracking Type.
- Click Save.
Connection properties
| Property | What to enter |
|---|---|
| Description | Unique name for the connection. Example: MySQL. |
| Server | Server name or IP address of the MySQL server. Example: mysqlserver.company.com. |
| Database | Name of the MySQL database. Example: SalesDB. |
| Port | Port number for the MySQL connection. Default: 3306. |
| Username | Login account for accessing the database. Example: db_user. |
| Password | Password for this account. |
| Convert zero-dates to null | Returns NULL for Date or DateTime values made entirely of zeros. In MySQL, a zero date signals an invalid date and can cause parsing errors during extraction. Enable this if your data contains zero dates. |
| Verbosity | Controls how much detail the connector writes to the log. Each level includes everything from the level below it, plus additional detail.
|
| Enable Pooling | Enables connection pooling, which keeps a set of database connections open and reuses them across extractions instead of opening a new connection each time. This reduces overhead and improves performance when multiple extractions run at the same time. |
| Pool idle timeout | Time in seconds a connection can stay idle before returning to the pool. |
| Max Pool Size | Maximum number of connections allowed in the pool at the same time. |
| Pool wait time | Time in seconds DataSync waits for an available connection before throwing an error. |
Additional connection properties
Use this panel to enter connection string properties not available in the Connection Properties panel. For sensitive values such as passwords, set the type to Encrypted. The value is hidden in the interface and stored encrypted in the back end.
| Property | What to enter |
|---|---|
Other | Write timeout in seconds before DataSync aborts a large write operation. Recommended when syncing large datasets over 500,000 rows. Enter as net_write_timeout=numberOfSeconds. |
Characterset | Character set used in the database collation. The character set must match between source and destination databases, otherwise tables cannot be added to extractions. Only one Characterset property can be set per connection. Example: utf8mb4 or latin1. |
Advanced settings
These settings control how the connector tracks data changes, handles time and regional configuration, and processes records during extraction. Configure them to match your MySQL environment so that results stay accurate and consistent.
| Setting | What to select |
|---|---|
| Tracking Type | Method for tracking data changes: None or Date. |
| Region | Region setting for the connector, if required by your setup. |
| Time Zone | Time zone matching your MySQL environment. |
| Time Offset | Refresh offset in seconds to compensate for timing issues in record selection. Minimum 0, maximum 3600. |
| Batch Size | Number of records processed per batch during extraction. Larger batches can improve performance but use more memory. Default is 2000, maximum is 10000. Adjust based on your network speed and disk performance. The default works well in most cases. |
Example setup
