During workspace creation, under Connection Type, click MySQL.
In the Source Settings section, you provide the connection information for the source database.
To provide the connection details for the source database:
In the Server field, specify the server where the source database is located.
By default, Tonic Structural uses all of the databases on the source server. To instead identify specific databases, add them to the Databases field. To add a database, type the database name, then press Enter. To remove a database from the list, click its delete icon.
In the Port field, provide the port to use to connect to the source data.
In the Username field, provide the username to use to connect to the source data.
In the Password field, provide the password for the specified user.
To test the connection to the source data, click Test Source Connection.
The Enable SSL/TLS setting indicates whether to encrypt source database authentication.
By default, the toggle is in the on position. We strongly recommend that you do not turn off this setting.
For additional security, to connect through an SSH bastion:
Toggle Enable SSH Tunnel to the on position.
In the SSH Host field, provide the host for the SSH bastion.
In the SSH Port field, provide the port for the SSH bastion.
In the SSH User field, provide the name of the user to use to connect to the SSH bastion.
If you do not use a private key, then in the SSH Passphrase field, provide the passphrase to use for authentication.
If you do use a private key, then in the SSH Private Key field, provide the private key. If the private key uses a passphrase, then in the SSH Passphrase field, provide the passphrase for the private key.
By default, data generation is not blocked as long as schema changes do not conflict with your workspace configuration.
To block data generation when there are any schema changes, regardless of whether they conflict with your workspace configuration, toggle Block data generation on schema changes to the on position.
MySQL supports the upsert process. When you enable upsert for the workspace, the data generation process initially writes the transformed data to an intermediate database.
After the initial data generation is complete, the upsert job writes new records to the destination database, and updates existing records in the destination database. It does not touch any other records that are in the destination database.
In the Upsert section, when you enable upsert, you are prompted to configure the upsert processing and to provide connection information for the intermediate database.
To provide the connection details for the intermediate database:
In the Server field, specify the server where the intermediate database is located. For each database selected from the source, Structural generates data into a database of the same name. To prevent a conflict, the server for the intermediate database must be different from the server for the source database and the destination database.
In the Port field, provide the port to use to connect to the intermediate database.
In the Username field, provide the username to use to connect to the intermediate database.
In the Password field, provide the password for the specified user.
To test the connection to the intermediate database, click Test Intermediate Connection.
The Enable SSL/TLS setting indicates whether to encrypt intermediate database authentication.
By default, the toggle is in the on position. We strongly recommend that you do not turn off this setting.
For additional security, to connect through an SSH bastion:
Toggle Enable SSH Tunnel to the on position.
In the SSH Host field, provide the host for the SSH bastion.
In the SSH Port field, provide the port for the SSH bastion.
In the SSH User field, provide the name of the user to use to connect to the SSH bastion.
If you do not use a private key, then in the SSH Passphrase field, provide the passphrase to use for authentication.
If you do use a private key, then in the SSH Private Key field, provide the private key. If the private key uses a passphrase, then in the SSH Passphrase field, provide the passphrase for the private key.
For a MySQL workspace, you can write the destination data to either:
A destination database server.
A Tonic Ephemeral snapshot. For more information, go to Writing output to Tonic Ephemeral.
A container repository. For more information, go to Writing output to a container repository.
Under Destination Settings, to write the transformed data to a database server, click Database Server.
The destination database always uses the same databases as the source database.
To provide the connection details for the destination database:
In the Server field, specify the server where the destination database is located. For each database selected from the source, Structural generates data into a database of the same name. To prevent a conflict, the server for the destination database must be different from the server for the source database and the intermediate database.
In the Port field, provide the port to use to connect to the destination data.
In the Username field, provide the username to use to connect to the destination data.
In the Password field, provide the password for the specified user.
To test the connection to the destination database, click Test Destination Connection.
The Enable SSL/TLS setting indicates whether to encrypt destination database authentication.
By default, the toggle is in the on position. We strongly recommend that you do not turn off this setting.
For additional security, to connect through an SSH bastion :
Toggle Enable SSH Tunnel to the on position.
In the SSH Host field, provide the host for the SSH bastion.
In the SSH Port field, provide the port for the SSH bastion.
In the SSH User field, provide the name of the user to use to connect to the SSH bastion.
If you do not use a private key, then in the SSH Passphrase field, provide the passphrase to use for authentication.
If you do use a private key, then in the SSH Private Key field, provide the private key. If the private key uses a passphrase, then in the SSH Passphrase field, provide the passphrase for the private key.