Create a source connection profile Stay organized with collections Save and categorize content based on your preferences.
You can create a connection profile on its own or in the context of creating aspecific migration job. Either way, all connection profiles are available forreview and modification on the Connection profiles page, and can be reusedacross migration jobs.
Creating a source connection profile on its own is useful if theperson who has the source access information is not the same person who createsthe migration job. You can also reuse a source connection profiledefinition in multiple migration jobs.
To see which source databases Database Migration Service supports, see Supported source and destination databases.To create a source connection profile, follow these steps:
Console
- Go to theConnection profiles page in the Google Cloud Console.
- ClickCreate profile.
- On theCreate a connection profile page, from theProfile role list, selectSource.
- From theDatabase engine list, select your source database engine.If you selectCloud SQL for MySQL from this list, then anInstance ID list appears. Select the ID of the Cloud SQL instance that you want to migrate.
- In theConnection profile name field, enter a human-readable name for your connection profile. This value is displayed in the connection profile list.
- Keep the auto-generatedConnection profile ID.
- Enter aHostname orIP 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 asIP 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 inGoogle Cloud or in AWS Route53.
- Enter thePort that's used to access the host. The default MySQL port is 3306.
- 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.
- In theConnection profile region section of the page, select the region where you want to save the connection profile.Connection profiles, like all resources, are saved in a region. Region selection doesn't impact which migration jobs can use them, or which regions can connect to the data location itself, but can impact availability in the case of regional downtime.
Optional: If the connection is made over a public network (by using IP allowlists), then we recommend that you useSSL/TLS encryption for the connection between the source and destination databases.
In theSecure your connection section, from theEncryption 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).This option is the default for Microsoft Azure sources. Microsoft Azure sources require that all client connections use SSL/TLS encryption. At minimum, Microsoft Azure connection profiles must use basic encryption. If you don't want to use encryption to connect to the source, set
require_secure_transporttooff. For more information about therequire_secure_transportsetting, seeConfigure your source. 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.
For more information about creating certificates and keys for your external server, see Creating SSL and RSA Certificates and Keys using MySQL.- 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).
If you're having trouble uploading the key, then select theEnter manually option, and copy and paste the key into the text area.
ClickCreate.
TheConnection profiles page appears, and the newly created connection profile is displayed.
gcloud
This sample uses the optional--no-async flag so that all operationsare performed synchronously. This means that some commands might takea while to complete. You can skip the--no-async flag to run commands asynchronously.If you do, you need to use thegcloud database-migration operations describe command to verify if your operationis 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:
Linux, macOS, or Cloud Shell
Note: Ensure you have initialized the Google Cloud CLI with authentication and a project by running eithergcloud init; orgcloud auth login andgcloud config set project.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
Windows (PowerShell)
Note: Ensure you have initialized the Google Cloud CLI with authentication and a project by running eithergcloud init; orgcloud auth login andgcloud config set project.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
Windows (cmd.exe)
Note: Ensure you have initialized the Google Cloud CLI with authentication and a project by running eithergcloud init; orgcloud auth login andgcloud config set project.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 profileCONNECTION_PROFILE_ID [OPERATION_ID]
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-17 UTC.
[8]ページ先頭