從 Compute Engine 連線

如要從虛擬私有雲 (VPC) 網路中的虛擬機器 (VM) 執行 SQL 查詢及管理資料庫，您可以透過私人服務存取權，將 Compute Engine VM 上的 psql 用戶端工具連線至 AlloyDB 執行個體：

  1. 建立 Compute Engine VM，可透過私人服務存取權連線至 AlloyDB 執行個體。
  2. 在 Compute Engine VM 上安裝 psql 用戶端。
  3. 取得要連線的 AlloyDB 執行個體 IP 位址。
  4. 執行 psql 用戶端。

前兩項工作是一次性作業。建立 Compute Engine VM 並安裝 psql 用戶端後，您可以繼續使用 VM，完成其餘工作，將 psql 連線至 AlloyDB 執行個體。

事前準備

  • 您使用的 Google Cloud 專案必須啟用 AlloyDB 存取權。
  • 您使用的 Google Cloud 專案中，必須已有虛擬私有雲網路設定為可透過私人服務存取權連至 AlloyDB。
  • 您必須在使用的 Google Cloud 專案中具備下列其中一個 IAM 角色：
    • roles/alloydb.admin (AlloyDB 管理員預先定義的 IAM 角色)
    • roles/owner (擁有者基本 IAM 角色)
    • roles/editor (編輯者基本 IAM 角色)

    如果您不具備上述任一角色，請向組織管理員要求存取權。

  • 如果用戶端主機設有防火牆，則必須允許輸出連線至 AlloyDB 執行個體 IP 位址的通訊埠 5432。

建立 Compute Engine VM

  1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

    前往 VM 執行個體

  2. 選取要連線的 AlloyDB 執行個體所在專案。
  3. 點選「建立執行個體」。
  4. 按一下「機器設定」部分。
  5. 輸入執行個體的「Name」(名稱)。
  6. 設定要建立執行個體的區域和可用區。
  7. 選取機器系列和對應的機器類型。
  8. 保留「OS 和儲存空間」專區的預設值。
  9. 按一下「網路」部分，然後將「網路介面」設為已設定私人服務存取 AlloyDB 的虛擬私有雲網路。
    如果「網路介面」未設為已設定私人服務存取權的虛擬私有雲網路，請展開該區段，然後將「網路」設為該虛擬私有雲網路。
  10. 保留「觀測能力」部分的預設值。
  11. 按一下「安全性」部分。
  12. 在「身分及 API 存取權」部分，將「存取權範圍」設為「允許所有 Cloud API 的完整存取權」。
  13. 保留「Advanced」(進階) 區段中的預設值。
  14. 點選「建立」。

VM 建立完成後，使用 SSH 連線至您建立的 Compute Engine VM。

安裝 psql 用戶端工具

如要在用戶端主機上安裝 psql 用戶端工具，請參閱「安裝 psql 用戶端工具」。

如果您使用 Compute Engine VM 做為用戶端主機，請按照下列步驟連線至 VM 並安裝 psql：

  1. 使用 SSH 連線至您建立的 Compute Engine VM。

    控制台

    1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

      前往 VM 執行個體

    2. 在虛擬機器執行個體清單中，按一下您建立的執行個體那一列的「SSH」SSH。

    gcloud

    使用 gcloud compute ssh 指令連線至您建立的執行個體。

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    更改下列內容：

    • PROJECT_ID：執行個體所在專案的 ID
    • ZONE：執行個體所在的可用區名稱
    • VM_NAME：執行個體的名稱

  2. 利用套件管理員安裝 psql 用戶端：

    sudo apt-get update
sudo apt-get install postgresql-client

取得 AlloyDB 執行個體的 IP 位址

如要取得要連線的 AlloyDB 執行個體 IP 位址，請查看該執行個體的設定。

執行 psql 用戶端

  1. 使用 SSH 連線至您建立的 VM。

    控制台

    1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

      前往 VM 執行個體

    2. 在虛擬機器執行個體清單中，按一下您建立的執行個體那一列的「SSH」SSH。

    gcloud

    使用 gcloud compute ssh 指令連線至您建立的執行個體。

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    更改下列內容：

    • PROJECT_ID：執行個體所在專案的 ID。
    • ZONE：執行個體所在的可用區名稱。
    • VM_NAME：執行個體的名稱。
  2. 執行 psql 用戶端工具：
    psql -h IP_ADDRESS -p 5432 -U USERNAME -d postgres

    系統會提示您輸入 USERNAME 使用者的密碼。

    如果是首次連線，請為 USERNAME 和資料庫指定 postgres。指令如下所示：

    psql -h IP_ADDRESS -p 5432 -U postgres -d postgres

    請使用建立叢集時設定的密碼。

後續步驟