建立來源連線設定檔

連線設定檔會擷取來源資料庫的 ID。每個連線設定檔都包含資料庫遷移服務所需的最低資訊量，方便在資料來源和目的地之間移動資料。

如要建立來源連線設定檔，請按照下列步驟操作：

控制台

1. 前往 Google Cloud 控制台的「連線設定檔」頁面。
2. 按一下 Create profile。
3. 在「建立連線設定檔」頁面，從「設定檔角色」清單選取「來源」。
4. 從「Database engine」(資料庫引擎) 清單中，選取來源資料庫引擎。
   如果從這個選單選取「MySQL 適用的 Cloud SQL」，請選取要遷移的 Cloud SQL 執行個體 ID。清單，然後畫面上會顯示「執行個體 ID」清單。
5. 在「Connection profile name」(連線設定檔名稱) 欄位中，輸入人類可讀的連線設定檔名稱。這個值會顯示在連線設定檔清單中。
6. 保留自動產生的連線設定檔 ID。
7. 輸入主機名稱或 IP 位址。

   • 這裡使用的值取決於您用於遷移的連線方法。舉例來說，如果來源資料庫託管於 Google Cloud，或使用反向 SSH 通道將目的地資料庫連線至來源資料庫，請指定來源資料庫的私人 (內部) IP 位址。詳情請參閱「 網路連線總覽」。

   • MySQL 的主機名稱長度上限為 60 個半形字元。Amazon RDS 資料庫主機名稱通常超過 60 個半形字元。如果遷移的資料庫屬於這種情況，請設定 DNS 重新導向，建立將網域名稱與 RDS 資料庫執行個體網域名稱建立關聯的 CNAME 記錄。如要進一步瞭解如何設定 DNS CNAME，請參閱 Cloud DNS 說明文件中的「 為網域名稱設定 DNS 記錄」，或查看 AWS 說明文件中的「 將網路流量轉送至 AWS 資源」。
8. 輸入用於存取主機的通訊埠。MySQL 預設通訊埠為 3306。
9. 輸入來源資料庫的使用者名稱和密碼。
10. 在頁面的「Connection profile region」(連線設定檔區域) 部分，選取要儲存連線設定檔的區域。
    連線設定檔與所有資源一樣，都會儲存在區域中。區域選擇不會影響哪些遷移工作可以使用這些工作，也不會影響哪些區域可以連線至資料位置本身，但可能會影響區域停機時的可用性。

11. 點選「建立」。

    「連線設定檔」頁面隨即顯示，並列出新建立的連線設定檔。

gcloud

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

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

• CONNECTION_PROFILE_ID，其中包含連線設定檔的機器可讀取 ID。
• 將 REGION 替換為要儲存連線設定檔的區域 ID。
• HOST_IP_ADDRESS：資料庫遷移服務可連線至來源資料庫執行個體的 IP 位址。這個值會因遷移時使用的 連線方式而異。
• PORT_NUMBER 替換為來源資料庫接受傳入連線的通訊埠編號。MySQL 通訊埠預設為 3306。
• USERNAME：資料庫使用者帳戶名稱，資料庫遷移服務會以這個帳戶連線至來源資料庫執行個體。
• PASSWORD：資料庫使用者帳戶的密碼。
• (選用) CONNECTION_PROFILE_NAME 連線設定檔的人類可讀名稱。這個值會顯示在 Google Cloud 控制台中。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意：請務必執行 gcloud init，或 gcloud auth login 和 gcloud config set project，初始化 Google Cloud CLI 並設定驗證和專案。

gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --host=HOST_IP_ADDRESS \
  --port=PORT_NUMBER \
  --username=USERNAME \
  --password=PASSWORD \
  --display-name=CONNECTION_PROFILE_NAME

Windows (PowerShell)

注意：請務必執行 gcloud init，或 gcloud auth login 和 gcloud config set project，初始化 Google Cloud CLI 並設定驗證和專案。

gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --host=HOST_IP_ADDRESS `
  --port=PORT_NUMBER `
  --username=USERNAME `
  --password=PASSWORD `
  --display-name=CONNECTION_PROFILE_NAME

Windows (cmd.exe)

注意： 請執行下列任一指令，確保已透過驗證和專案初始化 Google Cloud CLI： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --host=HOST_IP_ADDRESS ^
  --port=PORT_NUMBER ^
  --username=USERNAME ^
  --password=PASSWORD ^
  --display-name=CONNECTION_PROFILE_NAME

您應該會收到類似以下的回應：

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

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

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

後續步驟

• 管理連線設定檔