建立來源連線設定檔

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

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

控制台

  1. 前往 Google Cloud 控制台的「Connection Profiles」(連線設定檔) 頁面。
  2. 按一下 Create profile。
  3. 在「建立連線設定檔」頁面，從「設定檔角色」清單選取「來源」。
  4. 從「Database engine」(資料庫引擎) 清單中，選取來源資料庫引擎。
  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 設定選項：

    • 無：AlloyDB for PostgreSQL 目的地叢集會連至來源資料庫，不加密。
    • TLS 驗證：AlloyDB for PostgreSQL 目的地叢集連線至來源資料庫時，叢集會驗證來源，確保叢集安全連線至正確的主機。如要使用 TLS 驗證，您必須提供 CA 的 x509 PEM 編碼憑證，該 CA 簽署了來源伺服器的憑證。
    • mTLS 驗證：目的地叢集連線至來源時，叢集會驗證來源，來源也會驗證叢集。如要使用 mTLS 驗證，您必須提供：
      • 簽署來源資料庫伺服器憑證的 CA 憑證。
      • 叢集用於向來源資料庫伺服器驗證的憑證 (用戶端憑證)。
      • 與用戶端憑證 (用戶端金鑰) 相關聯的私密金鑰。

  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 替換為來源資料庫遷移使用者的密碼。
  • 選用：如要調整其他來源連線設定檔設定，可以傳遞下列旗標：
    • --display-name：連線設定檔的人類可讀名稱。
    • --cloudsql-instance：如果來源是 PostgreSQL 適用的 Cloud SQL，則為來源 PostgreSQL 適用的 Cloud SQL 執行個體 ID。
    • --ssl-type：連至來源資料庫的 SSL/TLS 加密類型 (NONE、SERVER_ONLY：使用 --ca-certificate 進行 TLS 驗證，或 SERVER_CLIENT：使用 --ca-certificate、--client-certificate 和 --private-key 進行 mTLS 驗證)。

執行下列指令：

Linux、macOS 或 Cloud Shell

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 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 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

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

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

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

Created connection profile SOURCE_CONN_ID [OPERATION_ID]

後續步驟