Create a source connection profile

Stay organized with collections Save and categorize content based on your preferences.

Console

1. Go to the Connection profiles page in the Google Cloud Console.
2. Click Create profile.
3. On the Create a connection profile page, from the Profile role list, select Source.
4. From the Database engine list, select your source database engine.
5. In the Connection profile name field, enter a human-readable name for your connection profile. This value is displayed in the connection profile list.
6. Keep the auto-generated Connection profile ID.
7. Enter a Hostname or IP address.

   • If the source database is hosted in Google Cloud, or if a reverse SSH tunnel is used to connect the destination database to the source database, then specify the private (internal) IP address for the source database. This address will be accessible by the Cloud SQL destination. For more information, see Configure connectivity using VPC peering.

     For other connectivity methods, such as IP allowlist, provide the public IP address.

   • MySQL limits the hostname to 60 characters. Amazon RDS database hostnames are typically longer than 60 characters. If this is the case for the database you're migrating, then configure a DNS redirect to create a CNAME record that associates your domain name with the domain name of your RDS DB instance. You can read more about setting up DNS CNAME in Google Cloud or in AWS Route53.
8. Enter the Port that's used to access the host. The default MySQL port is 3306.
9. Enter a username and password for the destination database. The user account must have the required privileges to access your data. For more information, see Configure your source database.
10. In the Connection profile region section of the page, select the region where you want to save the connection profile.

11. Optional: If the connection is made over a public network (by using IP allowlists), then we recommend that you use SSL/TLS encryption for the connection between the source and destination databases.

    In the Secure your connection section, from the Encryption type list, you can select one of the following SSL/TLS configuration options:

    • None: The Cloud SQL destination instance connects to the source database without encryption. We recommend that you don't use this option if your database requires encrypted connections.
    • Basic: The Cloud SQL destination instance connects to the source database with encryption but doesn't verify the certificate authority (CA).

    • TLS authentication: When the Cloud SQL destination instance connects to the source database, the instance authenticates the source, ensuring that the instance is connecting to the correct host securely. This prevents person-in-the-middle (PITM) attacks. For TLS authentication, the source doesn't authenticate the instance.

      To use TLS authentication, you must provide the x509 PEM-encoded certificate of the CA that signed the external server's certificate.

    • mTLS authentication: When the destination instance connects to the source, the instance authenticates the source and the source authenticates the instance.

      mTLS authentication provides the strongest security. However, if you don't want to provide the client certificate and private key when you create the Cloud SQL destination instance, you can still use TLS authentication.

      To use mTLS authentication, you must provide the following items when you create the destination connection profile:

      • The certificate of the CA that signed the source database server's certificate (the CA certificate).
      • The certificate used by the instance to authenticate against the source database server (the client certificate).
      • The private key associated with the client certificate (the client key).

12. Click Create.

    The Connection profiles page appears, and the newly created connection profile is displayed.

gcloud

This sample uses the optional --no-async flag so that all operations are performed synchronously. This means that some commands might take a while to complete. You can skip the --no-async flag to run commands asynchronously. If you do, you need to use the gcloud database-migration operations describe command to verify if your operation is successful.

Before using any of the command data below, make the following replacements:

• CONNECTION_PROFILE_ID with a machine-readable identifier for your connection profile.
• REGION with the identifier of the region where you want to save the connection profile.
• HOST_IP_ADDRESS with the IP address where Database Migration Service can reach your source database instance. This value can vary depending on which connectivity method you use for your migration.
• PORT_NUMBER with the port number where your source database accepts incoming connections. The default MySQL port is 3306.
• USERNAME with the name of the database user account you want Database Migration Service to connect as to your source database instance.
• PASSWORD with the password for the database user account.
• (Optional) CONNECTION_PROFILE_NAME with a human-readable name for your connection profile. This value is displayed in the Google Cloud console.

Execute the following command:

gclouddatabase-migrationconnection-profiles\ createmysqlCONNECTION_PROFILE_ID\--no-async\--region=REGION\--host=HOST_IP_ADDRESS\--port=PORT_NUMBER\--username=USERNAME\--password=PASSWORD\--display-name=CONNECTION_PROFILE_NAME

gclouddatabase-migrationconnection-profiles` createmysqlCONNECTION_PROFILE_ID`--no-async`--region=REGION`--host=HOST_IP_ADDRESS`--port=PORT_NUMBER`--username=USERNAME`--password=PASSWORD`--display-name=CONNECTION_PROFILE_NAME

gclouddatabase-migrationconnection-profiles^ createmysqlCONNECTION_PROFILE_ID^ --no-async^ --region=REGION^ --host=HOST_IP_ADDRESS^ --port=PORT_NUMBER^ --username=USERNAME^ --password=PASSWORD^ --display-name=CONNECTION_PROFILE_NAME

You should receive a response similar to the following:

 Waiting for connection profile [CONNECTION_PROFILE_ID] to be created with [OPERATION_ID] Waiting for operation [OPERATION_ID] to complete...done. Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]