管理连接配置文件

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

查看连接配置文件

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

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

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

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

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

控制台

  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 SQL for PostgreSQL 实例标识符、数据库用户名和密码

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

控制台

  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 update postgresql \
  CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (PowerShell)

gcloud database-migration connection-profiles update postgresql `
  CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (cmd.exe)

gcloud database-migration connection-profiles update postgresql ^
  CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

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

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

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

Updated 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 交互式确认提示。