管理连接配置文件

本页介绍了如何对连接个人资料执行查看、更新和删除操作。

查看连接配置文件

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

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

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

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

如需查看连接配置文件详情，请按以下步骤操作：

控制台

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

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

控制台

  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 控制台中。
  • （可选，仅适用于来源连接配置文件）将 SOURCE_STORAGE_BUCKET_NAME 替换为包含您用于创建“完整”“差异”和“日志”文件夹（用于存储完整备份、差异备份和事务日志文件）的父级数据库文件夹的 Cloud Storage 存储桶名称。
  • （可选，仅适用于目标连接配置文件）
    • CLOUDSQL_INSTANCE_ID 替换为目标 Cloud SQL for SQL Server 实例的实例标识符。如需了解如何查看 Cloud SQL 实例详情，请参阅 Cloud SQL 文档中的 查看实例信息。
    • 迁移用户详细信息：提供目标实例中专用数据库用户账号的详细信息。如需详细了解此用户账号，请参阅 创建和配置 Cloud SQL for SQL Server 目标实例。
      • CLOUD_SQL_DB_USERNAME 替换为迁移用户名。
      • CLOUD_SQL_DB_USER_PASSWORD 替换为迁移账号的密码。
如需详细了解这些值，请参阅 连接配置文件概览。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud database-migration connection-profiles \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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 `
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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 ^
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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 互动式确认提示。