Create a Migration Job

On the Data Migration tab, click Create Migration Job

Relational Migrator only runs one migration job at a time. If a job is in progress, this button is disabled.

Enter the relational database connection details

On the Connect to your source database form, enter the connection details to create the JDBC URI for your relational database.

To use a saved relational database connection, click Use a saved connection and select it from the drop-down, then enter credentials if required.

To create a new connection:

1. In the Database type drop-down, select the database type.

2. To enter a connection string directly, enable the Enter URI manually toggle and paste your connection string into the JDBC URI.

3. To create a connection string by entering database information, enter the following:

   Oracle

   SQL Server

   MySQL

   PostgreSQL

   Field	Value
   Host	The host IP or DNS name.
   Port	The port number.
   Database	The database name. Required.
   Identifier	One of Service Name or SID.
   Username and Password	The credentials to use for authentication. Checking Save password saves the password securely on your machine, so you don't have to enter the Username and Password again when using the saved connection.

   Field	Value
   Host	The host IP or DNS name.
   Port	The port number.
   Database	The database name. If blank, you only see objects in the default dbo schema in all databases.
   Authentication	By default, this is set to SQL Server. Set to Windows to enable Windows Integrated Authentication, using the credentials of the user who launched the Relational Migrator executable. This disables the Username and Password fields.
   Username and Password	The credentials to use for authentication. Disabled if Authentication is set to Windows. Checking Save password saves the password securely on your machine, so you don't have to enter the Username and Password again when using the saved connection.
   General / SSL toggle	View SSL settings for the connection. To use SSL, you must first uncomment and update the server.ssl configuration properties in your user.properties file.
   SSL: Use SSL	Enable or disable SSL.
   SSL: Trust server certificate	With SSL enabled, check this to trust the stored certificate. Leave unchecked to verify the server certificate against a trusted Certificate Authority.

   Field	Value
   Host	The host IP or DNS name.
   Port	The port number.
   Database	The database name. Leave blank to load all databases.
   Username and Password	The credentials to use for authentication. Checking Save password saves the password securely on your machine, so you don't have to enter the Username and Password again when using the saved connection.
   General / SSL toggle	View SSL settings for the connection. To use SSL, you must first uncomment and update the server.ssl configuration properties in your user.properties file.
   SSL: Use SSL	Enable or disable SSL.
   SSL: SSL mode	With SSL enabled, choose from: Preferred (default): Make an encrypted connection if possible, otherwise fall back to an unencrypted connection. Required: Require an encrypted connection. Verify CA: Verify the server certificate against a trusted Certificate Authority. Verify identity: Verify the database connection information against the certificate contents.

   Field	Value
   Host	The host IP or DNS name.
   Port	The port number.
   Database	The database name. Leave blank to connect to the default database.
   Username and Password	The credentials to use for authentication. Checking Save password saves the password securely on your machine, so you don't have to enter the Username and Password again when using the saved connection.
   General / SSL toggle	View SSL settings for the connection. To use SSL, you must first uncomment and update the server.ssl configuration properties in your user.properties file.
   SSL: Use SSL	Enable or disable SSL.
   SSL: SSL mode	With SSL enabled, choose from: Prefer (default): Make an encrypted connection if possible, otherwise fall back to an unencrypted connection. Require: Require an encrypted connection. Verify CA: Verify the server certificate against a trusted Certificate Authority. Verify full: Verify the database connection information against the certificate contents.

4. Enter a Connection name and optional Environment tag.

5. Click Connect.

   The saved connection is available for use in all jobs and projects.

Enter MongoDB connection details

To use a saved MongoDB connection, click Use a saved connection and select it from the drop-down, then enter credentials if required.

To create a new connection:

1. Enter the MongoDB connection string.

   1. In MongoDB connection string (URI), enter your MongoDB URI.

      If you're using X.509 authentication, Relational Migrator verifies the connection string syntax and the certificate file format.

   2. If it isn't included in the connection string, enter the Database to connect to.

   3. If they aren't included in the connection string and you aren't using X.509 authentication, enter the Username and Password of your Relational Migrator MongoDB user.

2. Enter a Connection name and optional Environment tag.

3. Click Connect.

   The saved connection is available for use in all jobs and projects.

On the Migration Options form, select Migration Options:

When you set the Mode, Relational Migrator checks if the database is configured correctly. If it finds issues, it displays a warning banner and a Generate Script button to download an SQL script. This script includes the required configuration statements, and any additional instructions as comments.

Review and start your migration job

On the Review Summary form, you can see details about your migration job. These details include the type, the number of tables and rows affected, and the estimated data size of the migration job. To start your migration job, click Start.