管理連線設定檔

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

查看連線設定檔

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

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

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

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

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

控制台

  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

更新連線設定檔

您可以修改下列連線設定檔詳細資料：

  • 顯示名稱
  • (僅限目的地設定檔) PostgreSQL 適用的 Cloud SQL 目的地執行個體 ID、資料庫使用者名稱和密碼

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

控制台

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

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

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

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

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

gcloud

這個範例使用選用的 --no-async 旗標，因此所有作業都會同步執行。這表示某些指令可能需要一段時間才能完成。您可以略過 --no-async 旗標，以非同步方式執行指令。如果這麼做，您必須使用 gcloud database-migration operations describe 指令，確認作業是否成功。

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

  • 將 CONNECTION_PROFILE_ID 替換為連線設定檔 ID。

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

  • 將 REGION 替換為連線設定檔儲存區域的 ID。
  • 選用：CONNECTION_PROFILE_NAME 連線設定檔的人類可讀名稱。這個值會顯示在 Google Cloud 控制台中。
  • 僅適用於目的地連線設定檔： CLOUDSQL_INSTANCE_ID 替換為目的地 Cloud SQL 執行個體的執行個體 ID。如要瞭解如何查看 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 控制台中，前往「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 互動式確認提示。