管理连接配置文件

本页面介绍了如何对连接配置文件执行查看、更新和删除操作。

查看连接配置文件

您可以查看有关连接配置文件的以下信息：

  • 在创建配置文件期间提供的所有配置详细信息。如需了解详情，请参阅 连接配置文件概览。

  • 连接配置文件的创建时间和上次修改时间。

  • 使用此连接配置文件的迁移作业的列表。

如需查看连接配置文件详细信息，请执行以下步骤：

控制台

  1. 在 Google Cloud 控制台中，前往 连接配置文件 页面。

    前往“连接配置文件”

  2. 点击要查看的连接配置文件的显示名称。

    系统会显示连接配置文件概览页面。

gcloud

在使用下面的命令数据之前， 请先进行以下替换：

  • 将 REGION 替换为保存连接配置文件的区域的标识符。
  • 将 CONNECTION_PROFILE_ID 替换为 您的连接配置文件标识符。

    如果您不知道标识符，可以使用 gcloud database-migration connection-profiles list 命令列出给定区域中的所有配置文件并查看其标识符。

如需详细了解这些值，请参阅 连接配置文件概览。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud database-migration connection-profiles \
describe CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration connection-profiles `
describe CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
describe CONNECTION_PROFILE_ID ^
  --region=REGION

更新连接配置文件

您可以修改以下连接配置文件详细信息：

  • 显示名称
  • （仅限来源配置文件）Cloud Storage 存储桶名称
  • （仅限目标配置文件）目标 Cloud SQL for MySQL 实例标识符、数据库用户名和密码

如需更新连接配置文件，请执行以下步骤：

控制台

  1. 在 Google Cloud 控制台中，前往 连接配置文件 页面。

    前往“连接配置文件”

  2. 点击要修改的连接配置文件的显示名称。

    系统会显示连接配置文件的概览页面。

  3. 点击修改 ，然后更新连接配置文件。
  4. 点击保存 。

gcloud

此示例使用可选的 --no-async 标志，以便所有操作都同步执行。这意味着某些命令可能需要一段时间才能完成。您可以跳过 --no-async 标志以异步运行命令。 如果这样做，您需要使用 gcloud database-migration operations describe命令来验证操作 是否成功。

在使用下面的命令数据之前， 请先进行以下替换：

  • 将 CONNECTION_PROFILE_ID 替换为 您的连接配置文件标识符。

    如果您不知道标识符，可以使用 gcloud database-migration connection-profiles list 命令列出给定区域中的所有配置文件并查看其标识符。

  • 将 REGION 替换为保存连接配置文件的区域的标识符。
  • 可选：将 CONNECTION_PROFILE_NAME 替换为连接配置文件的易记名称。此值会显示在 Google Cloud 控制台中。
  • 仅限目标连接配置文件： CLOUDSQL_INSTANCE_ID 将实例 标识符替换为目标 Cloud SQL 实例的实例标识符。如需了解如何查看 Cloud SQL 实例详细信息，请参阅 Cloud SQL 文档中的 查看实例信息。
如需详细了解这些值，请参阅 连接配置文件概览。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud database-migration connection-profiles \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID \
  --username=CLOUD_SQL_DB_USERNAME \
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (PowerShell)

gcloud database-migration connection-profiles `
create sqlserver CONNECTION_PROFILE_ID `
  --no-async
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID `
  --username=CLOUD_SQL_DB_USERNAME `
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
create sqlserver CONNECTION_PROFILE_ID ^
  --no-async
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID ^
  --username=CLOUD_SQL_DB_USERNAME ^
  --password=CLOUD_SQL_DB_USER_PASSWORD

您应该会收到类似如下所示的响应：

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

删除连接配置文件

只有在没有迁移作业使用连接配置文件的情况下，您才能删除该配置文件。如果您要删除正在被迁移作业使用的连接配置文件，请先 删除与该连接配置文件关联的所有迁移作业。

如需删除连接配置文件，请执行以下步骤：

控制台

  1. 在 Google Cloud 控制台中，前往 连接配置文件 页面。

    前往“连接配置文件”

  2. 点击要删除的连接配置文件的显示名称。

    系统会显示连接配置文件概览页面。

  3. 点击删除 。
  4. 在该对话框中，点击删除 。

gcloud

此命令会返回一个交互式确认提示，您需要输入内容才能完成该提示。 您可以使用 可选的 --quiet 标志跳过确认提示。

在使用下面的命令数据之前， 请先进行以下替换：

  • 将 REGION 替换为保存连接配置文件的区域的标识符。
  • 将 CONNECTION_PROFILE_ID 替换为 您的连接配置文件标识符。

    如果您不知道标识符，可以使用 gcloud database-migration connection-profiles list 命令列出给定区域中的所有配置文件并查看其标识符。

如需详细了解这些值，请参阅 连接配置文件概览。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud database-migration connection-profiles \
delete CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration connection-profiles `
delete CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
delete CONNECTION_PROFILE_ID ^
  --region=REGION
 结果

delete 会返回一个交互式提示，您可以在其中确认 操作。输入 Y 以移除连接配置文件： 

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?
您可以使用 可选的 --quiet 标志跳过 Google Cloud CLI 交互式确认提示。