建立來源連線設定檔

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

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

控制台

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

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

   • 如果遷移作業是使用 IP 許可清單透過公開網際網路連線，請提供來源資料庫的公開 IP 位址。
8. 輸入用於存取主機的通訊埠。預設的 PostgreSQL 通訊埠為 5432。
9. 輸入來源資料庫的使用者名稱和密碼。使用者必須具備來源資料庫的必要複製權限。詳情請參閱「 設定來源資料庫」。
10. 在頁面的「Connection profile region」(連線設定檔區域) 部分，選取要儲存連線設定檔的區域。
    連線設定檔與所有資源一樣，都會儲存在區域中。區域選擇不會影響哪些遷移工作可以使用這些工作，也不會影響哪些區域可以連線至資料位置本身，但可能會影響區域停機時的可用性。

11. 選用：如果連線是透過公開網路建立 (使用 IP 許可清單)，建議您為來源和目的地資料庫之間的連線設定 SSL/TLS 加密。

    在「Secure your connection」(保護連線) 區段中，選取下列其中一個 SSL/TLS 設定選項：

    • 無：Cloud SQL 目的地執行個體會連線至來源資料庫，不進行加密。
    • 基本：Cloud SQL 目的地執行個體會連線至來源資料庫，並進行加密，但不會驗證憑證授權單位 (CA)。
    • TLS 驗證：Cloud SQL 目的地執行個體連線至來源資料庫時，會驗證來源，確保執行個體安全連線至正確的主機。如要使用 TLS 驗證，您必須提供 CA 的 x509 PEM 編碼憑證，該 CA 簽署了來源伺服器的憑證。
    • mTLS 驗證：目的地執行個體連線至來源時，執行個體會驗證來源，來源也會驗證執行個體。如要使用 mTLS 驗證，您必須提供：
      • 簽署來源資料庫伺服器憑證的 CA 憑證 (CA 憑證)。
      • 執行個體用來向來源資料庫伺服器驗證身分的憑證 (用戶端憑證)。
      • 與用戶端憑證相關聯的私密金鑰 (用戶端金鑰)。
    如要進一步瞭解如何為 PostgreSQL 伺服器建立憑證和金鑰，請參閱「 使用 SSL 保護 TCP/IP 連線」。

12. 點選「建立」。

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

gcloud

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

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

• 將 SOURCE_CONN_ID 替換為來源連線設定檔 ID。
• 將 REGION 替換為要儲存連線設定檔的區域。
• SOURCE_IP_ADDRESS 替換為來源資料庫的 IP 位址。
• SOURCE_PORT 替換為來源資料庫的通訊埠 (預設為 5432)。
• SOURCE_USER 替換為來源資料庫遷移使用者的使用者名稱。
• SOURCE_PASSWORD 替換為來源資料庫遷移使用者的密碼。

執行下列指令：

Linux、macOS 或 Cloud Shell

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

gcloud database-migration connection-profiles create postgresql \
  SOURCE_CONN_ID \
  --region=REGION \
  --role=SOURCE \
  --host=SOURCE_IP_ADDRESS \
  --port=SOURCE_PORT \
  --username=SOURCE_USER \
  --password=SOURCE_PASSWORD \
  --no-async

Windows (PowerShell)

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

gcloud database-migration connection-profiles create postgresql `
  SOURCE_CONN_ID `
  --region=REGION `
  --role=SOURCE `
  --host=SOURCE_IP_ADDRESS `
  --port=SOURCE_PORT `
  --username=SOURCE_USER `
  --password=SOURCE_PASSWORD `
  --no-async

Windows (cmd.exe)

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

gcloud database-migration connection-profiles create postgresql ^
  SOURCE_CONN_ID ^
  --region=REGION ^
  --role=SOURCE ^
  --host=SOURCE_IP_ADDRESS ^
  --port=SOURCE_PORT ^
  --username=SOURCE_USER ^
  --password=SOURCE_PASSWORD ^
  --no-async

後續步驟

• 管理連線設定檔