管理連線設定檔

本頁面說明如何查看、更新及刪除連線設定檔。

查看連線設定檔

您可以查看連線設定檔的下列資訊：

  • 建立設定檔時提供的所有設定詳細資料。詳情請參閱「 連線設定檔總覽」。

  • 連線設定檔的建立時間和上次修改時間。

  • 使用這個連線設定檔的遷移工作清單。

如要查看連線設定檔詳細資料，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Connection profiles」(連線設定檔) 頁面。

    前往「Connection profiles」(連線設定檔) 頁面

  2. 按一下要查看的連線設定檔顯示名稱。

    連線設定檔總覽頁面隨即顯示。

gcloud

使用下列任何指令資料前，請先替換以下項目：

  • 將 REGION 替換為連線設定檔儲存區域的 ID。
  • 將 CONNECTION_PROFILE_ID 換成連線設定檔 ID。

    如果您不知道 ID，可以使用 gcloud database-migration connection-profiles list 指令列出特定區域中的所有設定檔，並查看其 ID。

如要進一步瞭解這些值，請參閱「 連線設定檔總覽」。

執行下列指令：

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 叢集 ID

如要更新連線設定檔，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Connection profiles」(連線設定檔) 頁面。

    前往「Connection profiles」(連線設定檔) 頁面

  2. 按一下要修改的連線設定檔顯示名稱。

    連線設定檔的總覽頁面隨即顯示。

  3. 按一下「Edit」(編輯)，然後更新連線設定檔。
  4. 按一下「儲存」。

gcloud

使用下列任何指令資料前，請先替換以下項目：

  • 將 CONNECTION_PROFILE_ID 換成連線設定檔 ID。

    如果您不知道 ID，可以使用 gcloud database-migration connection-profiles list 指令列出特定區域中的所有設定檔，並查看其 ID。

  • 將 REGION 替換為連線設定檔儲存區域的 ID。
  • 選用：CONNECTION_PROFILE_NAME 連線設定檔的人類可讀名稱。這個值會顯示在 Google Cloud 控制台中。
  • 來源連線設定檔：您也可以傳遞 --host、--port、--username 和 --password 等旗標，更新來源資料庫連線詳細資料。如需支援旗標的完整清單，請參閱 gcloud database-migration connection-profiles update 參考資料。
  • 目的地連線設定檔 (僅限現有叢集)： ALLOYDB_CLUSTER_ID，並附上 AlloyDB for PostgreSQL 目的地叢集的叢集 ID。如要瞭解如何查看 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 控制台的「Connection profiles」(連線設定檔) 頁面。

    前往「Connection profiles」(連線設定檔) 頁面

  2. 按一下要刪除的連線設定檔顯示名稱。

    連線設定檔總覽頁面隨即顯示。

  3. 點選「刪除」。
  4. 在對話方塊中，按一下「刪除」。

gcloud

這個指令會傳回互動式確認提示，您必須輸入內容才能完成。您可以使用 選用的 --quiet 旗標，略過確認提示。

使用下列任何指令資料前，請先替換以下項目：

  • 將 REGION 替換為連線設定檔儲存區域的 ID。
  • 將 CONNECTION_PROFILE_ID 換成連線設定檔 ID。

    如果您不知道 ID，可以使用 gcloud database-migration connection-profiles list 指令列出特定區域中的所有設定檔，並查看其 ID。

如要進一步瞭解這些值，請參閱「 連線設定檔總覽」。

執行下列指令：

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 互動式確認提示。