管理连接配置文件

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

查看连接配置文件

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

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

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

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

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

控制台

  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

更新连接配置文件

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

  • 显示名称
  • 对于来源连接配置文件：主机名或 IP 地址、端口、用户名、密码、数据库名称和 SSL/TLS 证书
  • 对于目标连接配置文件（仅限现有集群）：目标 AlloyDB for PostgreSQL 集群标识符

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

控制台

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

    前往“连接配置文件”

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

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

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

gcloud

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

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

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

  • 将 REGION 替换为保存连接配置文件的区域的标识符。
  • 可选：将 CONNECTION_PROFILE_NAME 替换为连接配置文件的简单易记名称。此值会显示在 Google Cloud 控制台中。
  • 对于源连接配置文件：您还可以传递 --host、--port、--username 和 --password 等标志，以更新源数据库连接详细信息。如需查看受支持标志的完整列表，请参阅 gcloud database-migration connection-profiles update 参考文档。
  • 对于目标连接配置文件（仅限现有集群）：将 ALLOYDB_CLUSTER_ID 替换为 AlloyDB for PostgreSQL 目标集群的集群标识符。如需了解如何查看 AlloyDB for PostgreSQL 集群详细信息，请参阅 AlloyDB for PostgreSQL 文档中的 查看集群详细信息。
如需详细了解这些值，请参阅 连接配置文件概览。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud database-migration connection-profiles \
update CONNECTION_PROFILE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows (PowerShell)

gcloud database-migration connection-profiles `
update CONNECTION_PROFILE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
update CONNECTION_PROFILE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

结果

该操作以异步方式执行。 因此，此命令会返回一个表示长时间运行的操作的 操作实体：

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: CONNECTION_PROFILE_ID
  verb: update
name: 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 交互式确认提示。