建立及管理 AlloyDB Express 叢集

本文說明如何建立、連線、編輯、查看、刪除及升級 AlloyDB Express 叢集和執行個體。

如要進一步瞭解 AlloyDB Express 與 AlloyDB 的功能差異，請參閱「AlloyDB Express 總覽」。如要改為建立 AlloyDB 叢集，請參閱「建立叢集及其主要執行個體」。

事前準備

建立或管理 AlloyDB Express 叢集前，請先完成下列必要條件：

  • 在 Google Cloud 專案中啟用 AlloyDB API 和其他必要 API，讓專案可存取 AlloyDB。
  • 如果使用 AlloyDB 遠端 MCP 伺服器，請設定 MCP 用戶端，連線至全域 MCP 伺服器端點 (https://alloydb.googleapis.com/mcp) 或區域端點 (https://alloydb.REGION_ID.rep.googleapis.com/mcp)。區域端點目前處於預先發布版階段。

必要的角色

如要取得建立及管理 AlloyDB Express 叢集和執行個體所需的權限，請要求管理員授予您專案的下列 IAM 角色：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

建立 AlloyDB Express 叢集和執行個體

您可以使用 Google Cloud 控制台、Google Cloud CLI、AlloyDB REST API 或 AlloyDB 遠端 MCP 伺服器，建立 AlloyDB Express 叢集及其主要執行個體。

AlloyDB Express 叢集支援 PostgreSQL 18，並包含單一可用區主要執行個體，該執行個體一開始有 1 個 vCPU (4 GB RAM)，儲存空間會自動擴充至 20 GB。如果您打算日後就地將 1 個 vCPU 執行個體升級至 AlloyDB，而不調整為 2 個 vCPU，請在支援 C4A 機器系列的區域建立叢集。

預設連線能力設定取決於您使用的工具：

  • Google Cloud 控制台：根據預設，會同時在主要執行個體上啟用公開 DNS，並在叢集上啟用 Private Service Connect。您可以稍後再編輯執行個體的連線設定，設定 Private Service Connect 用戶Google Cloud 專案。

  • gcloud CLI、REST API 和 AlloyDB 遠端 MCP 伺服器：根據預設，只會在叢集上啟用 Private Service Connect。建立主要執行個體時，如要透過公開 DNS 連線，請啟用公開 DNS，並將要為執行個體建立 Private Service Connect 端點的用戶Google Cloud 專案加入許可清單。

控制台

  1. 前往 Google Cloud 控制台的「Get started」(開始使用) 頁面。

    前往「開始使用」

    如果 Google Cloud 專案已有叢集，且您是從「Clusters」(叢集) 頁面開始，請按一下工具列中的「Create cluster」(建立叢集)，開啟「Select configuration」(選取設定) 頁面。這兩個頁面都會顯示預設叢集設定資訊卡 (「AlloyDB Express」、「Production (single zone)」和「Production (multi-zone)」)。

  2. 在「AlloyDB Express」資訊卡中，點選「Create cluster」(建立叢集)，開啟「Create an AlloyDB Express cluster」(建立 AlloyDB Express 叢集) 窗格。

  3. 在「Create an AlloyDB Express cluster」(建立 AlloyDB Express 叢集) 窗格中，設定叢集：

    • 在「Cluster ID」(叢集 ID) 中，輸入叢集的 ID，或保留預設 ID。
    • 在「Password」(密碼) 部分，輸入預設 postgres 使用者的密碼，或按一下「Generate」(產生) 來產生密碼。您之後可以前往「Users」(使用者) 頁面變更密碼。
    • 在「Region」(區域) 部分，選取叢集支援的區域。如果打算日後將 1 個 vCPU 執行個體升級至 AlloyDB，而不調整為 2 個 vCPU，請選取支援 C4A 機器系列的區域。

  4. 點選「建立叢集」。

    Google Cloud 控制台會建立 AlloyDB Express 叢集和 1 個 vCPU 主要執行個體，並預設啟用 Private Service Connect 和公開 DNS，然後開啟 AlloyDB Studio，方便您查詢資料庫。

    在Google Cloud 控制台建立叢集時，無法變更連線設定，但之後可以編輯執行個體的連線設定，更新授權的外部網路或 Private Service Connect 設定。

gcloud

如要使用 gcloud CLI，您可以安裝並初始化 Google Cloud CLI，也可以使用 Cloud Shell。

  1. 如要建立 AlloyDB Express 叢集，請執行 gcloud beta alloydb clusters create 指令並加上 --enable-express 旗標：

    gcloud beta alloydb clusters create CLUSTER_ID \
    --region=REGION_ID \
    --password=PASSWORD \
    --enable-express \
    --project=PROJECT_ID

    更改下列內容：

    • CLUSTER_ID：要建立的叢集 ID。ID 開頭須為小寫英文字母，且只能使用小寫英文字母、數字和連字號。
    • REGION_ID：要建立叢集的支援區域。如果您打算日後將 1 個 vCPU 執行個體升級至 AlloyDB，而不調整為 2 個 vCPU，請選擇也支援 C4A 機器系列的區域。
    • PASSWORD：預設 postgres 資料庫使用者的初始密碼。
    • PROJECT_ID：要建立叢集的Google Cloud 專案 ID。

  2. 如要在 AlloyDB Express 叢集中建立主要執行個體，請執行 gcloud beta alloydb instances create 指令，並選擇連線能力旗標：

    • 僅限公開 DNS：指定 --enable-public-dns 並省略 --allowed-psc-projects。
    • 僅限 Private Service Connect：省略 --enable-public-dns 並指定 --allowed-psc-projects=ALLOWED_PROJECT_ID，允許來自用戶端 Google Cloud 專案的 Private Service Connect 連線。
    • 公開 DNS 和 Private Service Connect：同時指定 --enable-public-dns 和 --allowed-psc-projects=ALLOWED_PROJECT_ID。
    gcloud beta alloydb instances create INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --instance-type=PRIMARY \
    --cpu-count=1 \
    --enable-public-dns \
    --allowed-psc-projects=ALLOWED_PROJECT_ID \
    --project=PROJECT_ID

    更改下列內容：

    • INSTANCE_ID：要建立的主要執行個體 ID。
    • ALLOWED_PROJECT_ID (選用)：以逗號分隔的 Google Cloud 專案 ID 或專案編號清單，允許為這個執行個體建立 Private Service Connect 端點。如果只設定公用 DNS，請省略 --allowed-psc-projects。

REST

  1. 如要建立 AlloyDB Express 叢集，請將 POST 要求傳送至 projects.locations.clusters.create 端點，並將 expressConfig.enabled 設為 true。

    使用任何要求資料之前，請先替換下列項目：

    • PROJECT_ID：Google Cloud 專案的 ID。
    • REGION_ID：要建立叢集的支援區域。如果您打算日後將 1 個 vCPU 執行個體升級至 AlloyDB，而不調整為 2 個 vCPU，請選擇也支援 C4A 機器系列的區域。
    • CLUSTER_ID：要建立的叢集 ID。
    • INITIAL_USERNAME：初始資料庫使用者的使用者名稱 (例如 postgres)。
    • INITIAL_USER_PASSWORD：初始資料庫使用者的密碼。

    HTTP 方法和網址：

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters?clusterId=CLUSTER_ID

    JSON 要求主體：

    {
  "databaseVersion": "POSTGRES_18",
  "expressConfig": {
    "enabled": true
  },
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  }
}

  2. 叢集建立作業完成後，請將 POST 要求傳送至 projects.locations.clusters.instances.create 端點，並將 machineConfig.cpuCount 設為 1，以建立主要執行個體 (如果指定 1 以外的值，建立作業會失敗)。在要求主體中選擇連線欄位：

    • 僅限公開 DNS：設定 "networkConfig": {"publicDnsEnabled": true} 並省略 "pscInstanceConfig"。
    • 僅限 Private Service Connect：省略 "publicDnsEnabled" (預設為 false)，並設定 "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}。
    • 公開 DNS 和 Private Service Connect：同時包含 "networkConfig": {"publicDnsEnabled": true} 和 "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}。

    使用任何要求資料之前，請先替換下列項目：

    • INSTANCE_ID：要建立的主要執行個體 ID。
    • ALLOWED_PROJECT_ID (選用)：允許為這個執行個體建立 Private Service Connect 端點的Google Cloud 專案 ID 或專案編號。

    HTTP 方法和網址：

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances?instanceId=INSTANCE_ID

    JSON 要求主體：

    {
  "instanceType": "PRIMARY",
  "availabilityType": "ZONAL",
  "machineConfig": {
    "cpuCount": 1
  },
  "networkConfig": {
    "publicDnsEnabled": true
  },
  "pscInstanceConfig": {
    "allowedConsumerProjects": [
      "ALLOWED_PROJECT_ID"
    ]
  }
}

MCP

您可以使用 MCP 用戶端，或直接呼叫 AlloyDB 遠端 MCP 伺服器，建立 AlloyDB Express 叢集和主要執行個體。

在 MCP 用戶端中，您可以使用單一提示詞，同時建立 AlloyDB Express 叢集及其主要執行個體。MCP 用戶端會自動呼叫 create_cluster、輪詢 get_operation，並呼叫 create_instance：

Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID with a primary instance named INSTANCE_ID.

如要個別執行每個步驟，或直接呼叫 MCP 工具，請按照下列步驟操作：

  1. 如要建立 AlloyDB Express 叢集，請在 MCP 用戶端中輸入提示，或呼叫 create_cluster MCP 工具，並將 express_config.enabled 設為 true。

    使用任何要求資料之前，請先替換下列項目：

    在 MCP 用戶端中，您可以輸入類似以下的提示：

    Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.

    工具呼叫參數：

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_cluster",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID",
      "cluster_id": "CLUSTER_ID",
      "express_config": {
        "enabled": true
      }
    }
  }
}

    如要讓虛擬私有雲網路連上 Private Service Connect，請在建立或更新主要執行個體時，將"psc_instance_config"中的用戶Google Cloud 專案加入許可清單。

  2. create_cluster 工具會傳回長時間執行的作業。使用 get_operation MCP 工具輪詢作業狀態，直到 done 為 true，且叢集處於 READY 狀態。

  3. 如要在 AlloyDB Express 叢集建立主要執行個體，請在 MCP 用戶端輸入提示，或呼叫 create_instance MCP 工具。選擇連線設定：

    • 僅限公開 DNS：設定 "public_dns_enabled": true 並省略 "psc_instance_config"。

    • 僅限 Private Service Connect：省略 "public_dns_enabled" (預設為 false)，並使用 "allowed_consumer_projects" (或指定 "consumer_project" 和 "consumer_network" 的 "psc_auto_connections") 設定 "psc_instance_config"。

    • 公開 DNS 和 Private Service Connect：同時設定 "public_dns_enabled": true 和 "psc_instance_config"。

    使用任何要求資料之前，請先替換下列項目：

    • INSTANCE_ID：要建立的主要執行個體 ID。

    • ALLOWED_PROJECT_ID：選用：允許為這個執行個體建立 Private Service Connect 端點的Google Cloud 專案 ID 或專案編號。

    在 MCP 用戶端中，您可以輸入類似以下的提示：

    Please create a primary instance named INSTANCE_ID in my AlloyDB Express cluster CLUSTER_ID.

    工具呼叫參數：

    {
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_instance",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID",
      "instance_id": "INSTANCE_ID",
      "type": "PRIMARY",
      "public_dns_enabled": true,
      "psc_instance_config": {
        "allowed_consumer_projects": [
          "ALLOWED_PROJECT_ID"
        ]
      }
    }
  }
}

  4. 使用 get_operation MCP 工具輪詢執行個體建立作業，直到 done 為 true，且執行個體處於 READY 狀態。

連線至 AlloyDB Express 執行個體

AlloyDB Express 支援下列傳入資料庫連線選項：

  • 公開 DNS (預設)：提供可公開轉送的 DNS 名稱 (networkInfo.publicDnsName)，方便您從虛擬私有雲網路外部的用戶端連線。
  • Private Service Connect：可讓您透過 Private Service Connect 端點，從虛擬私有雲網路私下連線至執行個體，不必將資料庫公開至網際網路。

透過公開 DNS 連線

從虛擬私有雲網路外部透過公開 DNS 連線時，您可以執行下列任一操作：

使用 PostgreSQL 用戶端直接連線

根據預設，公開 DNS 端點會拒絕所有直接用戶端 IP 位址。您必須先將用戶端 CIDR 區塊加入許可清單，才能直接連線至 psql。

  1. 在主要執行個體上設定已授權的外部網路。

    您無法個別新增或移除已授權的外部網路。每次更新都會覆寫現有清單。請提供以半形逗號分隔的清單，列出所有要允許的 CIDR 區塊。

    控制台

    1. 前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。

      前往叢集

    2. 在「Resource name」(資源名稱) 欄中，按一下 AlloyDB Express 叢集名稱。

    3. 在「Overview」(總覽) 頁面中，前往「Instances in your cluster」(叢集中的執行個體)，找到主要執行個體，然後依序點選 「Instance actions」(執行個體動作) >「Edit」(編輯) (或前往導覽選單中的「Connectivity」(連線)，然後點選「Edit」(編輯))。

    4. 在「連線」下方，確認已啟用公開連線。

    5. 在「Authorized external networks」(授權的外部網路) 下方，輸入以半形逗號分隔的 IPv4 CIDR 範圍清單 (例如 203.0.113.0/24)，或按一下「Use my IP」(使用我的 IP)，新增目前機器的 /32 IPv4 位址。

    6. 按一下「更新執行個體」。

    gcloud

    如要使用 gcloud CLI，您可以安裝並初始化 Google Cloud CLI，也可以使用 Cloud Shell。

    執行 gcloud alloydb instances update 指令並加上 --authorized-external-networks 旗標：

    gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2 \
    --project=PROJECT_ID

    更改下列內容：

    • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。
    • CLUSTER_ID：AlloyDB Express 叢集的 ID。
    • REGION_ID：叢集所在的區域。
    • CIDR_RANGE1、CIDR_RANGE2：以逗號分隔的 IPv4 位址範圍清單，採用 CIDR 標記法 (例如 203.0.113.0/24)。
    • PROJECT_ID：Google Cloud 專案的 ID。

    REST

    使用 updateMask=networkConfig.authorizedExternalNetworks 向 projects.locations.clusters.instances.patch 端點傳送 PATCH 要求。

    使用任何要求資料之前，請先替換下列項目：

    • PROJECT_ID：Google Cloud 專案的 ID。
    • REGION_ID：叢集所在的區域。
    • CLUSTER_ID：AlloyDB Express 叢集的 ID。
    • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。
    • CIDR_RANGE1、CIDR_RANGE2：採用 CIDR 標記法的 IPv4 位址範圍 (例如 203.0.113.0/24)。

    HTTP 方法和網址：

    PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=networkConfig.authorizedExternalNetworks

    JSON 要求主體：

    {
  "networkConfig": {
    "authorizedExternalNetworks": [
      {
        "cidrRange": "CIDR_RANGE1"
      },
      {
        "cidrRange": "CIDR_RANGE2"
      }
    ]
  }
}

    MCP

    在 MCP 用戶端輸入提示，或使用 authorized_external_networks 欄位呼叫 update_instance MCP 工具。

    使用任何要求資料之前，請先替換下列項目：

    • PROJECT_ID：Google Cloud 專案的 ID。

    • REGION_ID：叢集所在的區域。

    • CLUSTER_ID：AlloyDB Express 叢集的 ID。

    • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。

    • CIDR_RANGE1、CIDR_RANGE2：採用 CIDR 標記法的 IPv4 位址範圍，例如 203.0.113.0/24。

    在 MCP 用戶端中，您可以輸入類似以下的提示：

    Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to allow external connections from CIDR_RANGE1.

    工具呼叫參數：

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "authorized_external_networks": [
        "CIDR_RANGE1",
        "CIDR_RANGE2"
      ]
    }
  }
}

  2. 擷取執行個體的公開 DNS 名稱：

    控制台

    1. 前往 Google Cloud 控制台的「Clusters」(叢集) 頁面，然後按一下 AlloyDB Express 叢集名稱。
    2. 前往「Connectivity」(連線) (或查看「Overview」(總覽) 頁面上的主要執行個體資訊卡)，然後複製執行個體的公開 DNS 名稱。

    gcloud

    執行 gcloud beta alloydb instances describe 指令，擷取 networkInfo.publicDnsName 值：

    gcloud beta alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(networkInfo.publicDnsName)" \
    --project=PROJECT_ID

    輸出內容會採用下列格式：

    IDENTIFIER.IDENTIFIER.REGION_ID.alloydb.s.cloud.goog

    在輸出內容中，IDENTIFIER 是系統產生的英數字元 ID。

    REST

    將 GET 要求傳送至 projects.locations.clusters.instances.get 端點，並讀取回應中的 networkInfo.publicDnsName 欄位：

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

    MCP

    在 MCP 用戶端中輸入提示，或呼叫 get_instance MCP 工具，然後讀取回應中的 networkInfo.publicDnsName 欄位。

    在 MCP 用戶端中，您可以輸入類似以下的提示：

    Please get the public DNS name of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    工具呼叫參數：

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

  3. 使用標準 PostgreSQL 連線 URI 和執行個體的公開 DNS 名稱，連線至資料庫：

    psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME

    更改下列內容：

    • USERNAME：PostgreSQL 資料庫使用者名稱 (例如 postgres)。
    • PUBLIC_DNS_NAME：AlloyDB Express 執行個體的公開 DNS 名稱 (例如 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog)。
    • DATABASE_NAME：要連線的資料庫名稱 (預設資料庫為 postgres)。

  4. 系統提示時，請輸入資料庫使用者的密碼。

使用 gcloud CLI 或 Auth Proxy 連線

如要透過公開 DNS 連線，而不設定授權的外部網路，可以使用 gcloud beta alloydb connect 指令，或搭配 --public-ip 旗標使用獨立 Auth Proxy 用戶端 (alloydb-auth-proxy)。雖然 AlloyDB Express 顯示的是公開 DNS 名稱，而非公開 IP 位址，但控制層會為執行個體佈建基礎公開連線，當您指定 --public-ip 時，Auth Proxy 會自動解析該連線。

如要啟動本機 Auth Proxy 執行個體，並使用 gcloud CLI 開啟 psql 工作階段，請執行 gcloud beta alloydb connect 指令並加上 --public-ip 旗標：

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip \
    --user=USERNAME \
    --database=DATABASE_NAME \
    --project=PROJECT_ID

更改下列內容：

  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。
  • REGION_ID：叢集所在的區域。
  • USERNAME：資料庫使用者名稱 (預設為 postgres)。
  • DATABASE_NAME：資料庫名稱 (預設為 postgres)。
  • PROJECT_ID： Google Cloud 專案的 ID。

如要進一步瞭解如何使用 gcloud CLI 連線，包括 IAM 資料庫驗證 (--auto-iam-authn)，請參閱「使用 gcloud CLI 連線」。

或者，您也可以下載並執行獨立的 Auth Proxy 用戶端，並加上 --public-ip 旗標：

./alloydb-auth-proxy \
    "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID" \
    --public-ip

如要瞭解如何透過獨立 Auth Proxy 用戶端下載、設定及連線，請參閱「使用 AlloyDB Auth Proxy 連線」。

透過 Private Service Connect 連線

如要從虛擬私有雲網路內建立私人連線，而不將資料庫公開至網際網路，可以在 AlloyDB Express 執行個體上設定 Private Service Connect。您可以直接從虛擬私有雲網路中的用戶端，或使用 Auth Proxy 連線至 Private Service Connect 端點。如要進一步瞭解如何連線至 Private Service Connect，請參閱「使用 Private Service Connect 連線至執行個體」。

按照 AlloyDB Express 的操作說明，建立叢集和 1 個 vCPU 可用區主要執行個體，如「建立 AlloyDB Express 叢集和執行個體」所述，並啟用 Private Service Connect。AlloyDB Express 支援連至單一可用區主要執行個體的傳入 Private Service Connect 連線能力。

編輯 AlloyDB Express 執行個體

您可以更新 AlloyDB Express 主要執行個體的 CPU 數量 (1 個或 2 個 vCPU) 或資料庫旗標。

控制台

  1. 前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。

    前往叢集

  2. 在「Resource name」(資源名稱) 欄中，按一下 AlloyDB Express 叢集名稱。

  3. 在「總覽」頁面的「叢集內的執行個體」部分， 找出主要執行個體，然後點選「編輯主要節點」(或依序點選 「執行個體動作」>「編輯」)。

  4. 在「Edit primary instance」(編輯主要執行個體) 頁面中，更新執行個體設定：

    • 在「Machine」(機器) 下方的「Machine Type」(機器類型) 清單中，選取「1 vCPU, 4 GB」(1 個 vCPU，4 GB) 或「2 vCPU, 8 GB」(2 個 vCPU，8 GB)。
    • 選用：如要設定資料庫旗標，請展開「Flags」(旗標) (或按一下「Show advanced options」(顯示進階選項)，然後展開「Flags」(旗標))，接著按一下「Add flag」(新增旗標)。從「New database flag」(新增資料庫旗標) 清單中選取旗標，提供值，然後按一下「Done」(完成)。

  5. 按一下「更新執行個體」。

gcloud

如要使用 gcloud CLI，您可以安裝並初始化 Google Cloud CLI，也可以使用 Cloud Shell。

如要透過變更 CPU 數量 (1 或 2) 來調度執行個體資源，或更新資料庫旗標，請執行 gcloud alloydb instances update 指令：

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --cpu-count=CPU_COUNT \
    --database-flags=FLAGS \
    --project=PROJECT_ID

更改下列內容：

  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。
  • REGION_ID：叢集所在的區域。
  • CPU_COUNT：執行個體的 vCPU 數量 (1 代表 1 個 vCPU、4 GB RAM，2 代表 2 個 vCPU、8 GB RAM)。
  • FLAGS (選用)：以半形逗號分隔的資料庫旗標和值清單，格式為 FLAG_NAME=VALUE。如果只要更新 CPU 數量，請省略 --database-flags 旗標。如要進一步瞭解支援的旗標，請參閱「支援的資料庫旗標」。
  • PROJECT_ID：Google Cloud 專案的 ID。
  • --enable-public-dns 或 --no-enable-public-dns：啟用或停用執行個體的公開 DNS。這個旗標僅適用於 gcloud beta (gcloud beta alloydb instances update)。
  • --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]：更新以半形逗號分隔的用戶 Google Cloud 專案 ID 或專案編號清單，允許為執行個體建立 Private Service Connect 端點。

REST

如要更新 AlloyDB Express 主要執行個體的 CPU 數量或資料庫旗標，請傳送 PATCH 要求至 projects.locations.clusters.instances.patch 端點，並在 updateMask 查詢參數中指定要更新的欄位。

使用任何要求資料之前，請先替換下列項目：

  • PROJECT_ID：Google Cloud 專案的 ID。
  • REGION_ID：叢集所在的區域。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。
  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。
  • CPU_COUNT：執行個體的 vCPU 數量 (1 或 2)。
  • FLAG_NAME 和 FLAG_VALUE (選用)：要設定的資料庫旗標名稱和值。如果只要更新 CPU 數量，請設定 updateMask=machineConfig.cpuCount，並從要求主體中省略 databaseFlags。

HTTP 方法和網址：

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=machineConfig.cpuCount,databaseFlags

JSON 要求主體：

{
  "machineConfig": {
    "cpuCount": CPU_COUNT
  },
  "databaseFlags": {
    "FLAG_NAME": "FLAG_VALUE"
  }
}

MCP

如要更新 AlloyDB Express 主要執行個體的 CPU 數量或資料庫旗標，請在 MCP 用戶端輸入提示，或呼叫 update_instance MCP 工具。

使用任何要求資料之前，請先替換下列項目：

  • PROJECT_ID：Google Cloud 專案的 ID。

  • REGION_ID：叢集所在的區域。

  • CLUSTER_ID：AlloyDB Express 叢集的 ID。

  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。

  • CPU_COUNT：執行個體的 vCPU 數量 (1 或 2)。

  • FLAG_NAME 和 FLAG_VALUE：選用：要設定的資料庫旗標名稱和值。如果只要更新 CPU 數量，請從 arguments 中省略 database_flags。

在 MCP 用戶端中，您可以輸入類似以下的提示：

Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to CPU_COUNT vCPUs.

工具呼叫參數：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "cpu_count": CPU_COUNT,
      "database_flags": {
        "FLAG_NAME": "FLAG_VALUE"
      }
    }
  }
}

查看 AlloyDB Express 叢集和執行個體詳細資料

您可以查看 AlloyDB Express 叢集清單、特定 AlloyDB Express 叢集或執行個體的詳細資料，以及叢集的運算和儲存空間用量。

詳情請參閱「查看叢集清單」、「查看叢集詳細資料」和「查看執行個體詳細資料」。

控制台

  1. 前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。

    前往叢集

    在「Resource name」(資源名稱) 欄中，AlloyDB Express 叢集的名稱旁會顯示 「Express」標記。

  2. 如要查看叢集及其主要執行個體的詳細資訊，請按一下「Resource name」(資源名稱) 欄中的叢集名稱。

  3. 在「Overview」(總覽) 頁面中，查看「Cluster details」(叢集詳細資料) 下方的叢集詳細資料 (包括「Cluster ID」(叢集 ID) 旁的 Express 標記，以及「Total storage used」(已用儲存空間總量)，上限為 20 GB)，以及「Instances in your cluster」(叢集中的執行個體) 下方的主要執行個體詳細資料。

gcloud

如要使用 gcloud CLI，您可以安裝並初始化 Google Cloud CLI，也可以使用 Cloud Shell。

  • 如要查看專案中的叢集清單，請執行 gcloud alloydb clusters list 指令：

    gcloud alloydb clusters list --project=PROJECT_ID

  • 如要查看特定叢集的詳細資料，請執行 gcloud alloydb clusters describe 指令：

    gcloud alloydb clusters describe CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • 如要查看特定執行個體的詳細資料，請執行 gcloud alloydb instances describe 指令：

    gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

更改下列內容：

  • PROJECT_ID：Google Cloud 專案的 ID。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。
  • REGION_ID：叢集所在的區域。
  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。

REST

使用任何要求資料之前，請先替換下列項目：

  • PROJECT_ID：Google Cloud 專案的 ID。
  • REGION_ID：叢集所在的區域。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。

  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。

  • 如要查看區域中的叢集清單，請向 projects.locations.clusters.list 端點傳送 GET 要求：

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters

  • 如要查看叢集的詳細資料，請向 projects.locations.clusters.get 端點傳送 GET 要求：

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID

  • 如要查看執行個體的詳細資料，請向 projects.locations.clusters.instances.get 端點傳送 GET 要求：

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

MCP

使用任何要求資料之前，請先替換下列項目：

  • PROJECT_ID：Google Cloud 專案的 ID。

  • REGION_ID：叢集所在的區域。

  • CLUSTER_ID：AlloyDB Express 叢集的 ID。

  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。

  • 如要查看區域中的叢集清單，請在 MCP 用戶端中輸入提示，或呼叫 list_clusters MCP 工具。

    在 MCP 用戶端中，您可以輸入類似以下的提示：

    Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.

    工具呼叫參數：

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clusters",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID"
    }
  }
}

  • 如要查看叢集的詳細資料，請在 MCP 用戶端中輸入提示，或呼叫 get_cluster MCP 工具。

    在 MCP 用戶端中，您可以輸入類似以下的提示：

    Please show the details of the AlloyDB cluster CLUSTER_ID in REGION_ID.

    工具呼叫參數：

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_cluster",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID"
    }
  }
}

  • 如要查看執行個體的詳細資料，請在 MCP 用戶端中輸入提示，或呼叫 get_instance MCP 工具。

    在 MCP 用戶端中，您可以輸入類似以下的提示：

    Please show the details of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    工具呼叫參數：

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

查看運算和儲存空間用量

如要查看 AlloyDB Express 叢集和主要執行個體使用的儲存空間和運算資源，請使用 Google Cloud 控制台或 Cloud Monitoring：

  • 在 Google Cloud 控制台中，開啟叢集的「Overview」(總覽) 頁面：

    • 已用儲存空間：在「Cluster details」(叢集詳細資料) 下方，查看「Total storage used」(已用儲存空間總量)，瞭解叢集在 20 GB 限制內使用了多少儲存空間。
    • 運算和連線：在「Overview」(總覽) 頁面中查看「CPU utilization」(CPU 使用率) 和「Active connections」(有效連線) 圖表，或是在導覽選單中點選「System insights」(系統深入分析)，查看詳細的 CPU、記憶體和儲存空間指標。

  • 在 Cloud Monitoring Metrics Explorer 中，查詢 alloydb.googleapis.com/Cluster 和 alloydb.googleapis.com/Instance 受監控資源類型的下列指標：

    • 儲存空間使用量：alloydb.googleapis.com/cluster/storage/usage
    • CPU 使用率：alloydb.googleapis.com/instance/cpu/average_utilization和alloydb.googleapis.com/instance/cpu/maximum_utilization
    • 有效連線數：alloydb.googleapis.com/database/postgresql/backends

刪除 AlloyDB Express 叢集或執行個體

如果不再需要 AlloyDB Express 主要執行個體或叢集，可以將其刪除。

詳情請參閱「刪除執行個體」和「刪除叢集」。

控制台

  1. 前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。

    前往叢集

  2. 在「Resource name」(資源名稱) 欄中，按一下 AlloyDB Express 叢集名稱。

  3. 在「總覽」頁面，刪除主要執行個體或叢集：

    • 如要刪除主要執行個體，請前往「Instances in your cluster」(叢集中的執行個體) 專區，依序點選 「Instance actions」(執行個體動作)>「Delete」(刪除)，在對話方塊中輸入執行個體 ID，然後點選「Delete」(刪除)。
    • 如要刪除叢集，請先刪除叢集中的主要執行個體，然後按一下「Delete cluster」(刪除叢集)，在「Delete cluster」(刪除叢集) 對話方塊中輸入叢集 ID，再按一下「Delete」(刪除)。

gcloud

如要使用 gcloud CLI，您可以安裝並初始化 Google Cloud CLI，也可以使用 Cloud Shell。

  • 如要刪除執行個體，請執行 gcloud alloydb instances delete 指令：

    gcloud alloydb instances delete INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • 如要刪除叢集，請執行 gcloud alloydb clusters delete 指令。如果叢集仍包含主要執行個體，請加入 --force 旗標，一併刪除主要執行個體和叢集：

    gcloud alloydb clusters delete CLUSTER_ID \
    --region=REGION_ID \
    --force \
    --project=PROJECT_ID

更改下列內容：

  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。
  • REGION_ID：叢集所在的區域。
  • PROJECT_ID：Google Cloud 專案的 ID。

REST

使用任何要求資料之前，請先替換下列項目：

  • PROJECT_ID：Google Cloud 專案的 ID。
  • REGION_ID：叢集所在的區域。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。

  • INSTANCE_ID：AlloyDB Express 主要執行個體的 ID。

  • 如要刪除執行個體，請向 projects.locations.clusters.instances.delete 端點傳送 DELETE 要求：

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

  • 如要刪除叢集 (包括指定 force=true 時的主要執行個體)，請將 DELETE 要求傳送至 projects.locations.clusters.delete 端點：

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?force=true

將 AlloyDB Express 叢集升級至 AlloyDB

您可以將 AlloyDB Express 叢集就地升級為 AlloyDB 叢集。

升級後，資料庫資料、結構定義、擴充功能、使用者憑證、網路設定 (包括公開 DNS 名稱和 Private Service Connect 端點) 和主要執行個體 vCPU 數量都會保留。

下列清單說明升級程序中會變更的資源和設定：

  • CPU 數量、記憶體比率和運算能力：執行個體會保留目前的 vCPU 數量 (1 個或 2 個 vCPU)，並從 AlloyDB Express 的 1:4 vCPU 與記憶體比率 (4 GB 或 8 GB RAM)，升級至 AlloyDB 的 1:8 vCPU 與記憶體比率 (1 個 vCPU 搭配 8 GB RAM，或 2 個 vCPU 搭配 16 GB RAM)。升級後，運算資源最多可擴充至 288 個 vCPU。
    • 升級 1 個 vCPU 執行個體時，只能選擇支援 C4A 機器系列的區域。如要瞭解支援的地區，請參閱「C4A 的區域可用性」。
    • 如果 AlloyDB Express 執行個體不在支援 C4A 機型的區域，請先將主要執行個體更新為 2 個 vCPU 設定，再進行升級。在 Google Cloud 控制台中，如果您在不支援的區域中，按一下 1 個 vCPU 執行個體的「Upgrade」(升級)，系統會提示您先將執行個體調整為 2 個 vCPU。
  • 佈建運算和計費：升級後，系統會停用將資源調度率降至零的運算功能，執行個體會以全天候運作的 AlloyDB 執行個體形式運作，並按照 AlloyDB 費率計費。
  • 儲存空間容量：升級後，20 GB 的儲存空間上限會移除。儲存空間預設配額為每個叢集 16 TiB，您可以要求提高儲存空間配額，最多可達 128 TiB。
  • 企業功能：升級後可使用區域高可用性 (HA) 功能，並享有 99.99% 運作時間的服務水準協議 (SLA)。此外，您還能使用讀取集區執行個體、跨區域複製、持續備份與復原，以及自動和隨選備份功能。

如要將 AlloyDB Express 叢集升級為 AlloyDB 叢集，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。

    前往叢集

  2. 在「Resource name」(資源名稱) 欄中，按一下 AlloyDB Express 叢集名稱。

  3. 在「Overview」(總覽) 頁面的「Cluster details」(叢集詳細資料) 下方，找到「Cluster ID」(叢集 ID)，然後按一下「Upgrade」(升級)。

    如果主要執行個體是 1 個 vCPU 執行個體，且所在區域不支援 C4A 機器系列，系統會顯示下列訊息：

    Upgrading to AlloyDB requires a 2 vCPU instance in the REGION_ID region. Resize your instance to 2 vCPUs first.

    如要將執行個體調整為 2 個 vCPU，請按一下「編輯執行個體」。調整執行個體大小後，再次點選「Upgrade」(升級)。

  4. 在「Upgrade from AlloyDB Express」(從 AlloyDB Express 升級) 窗格中，輸入叢集 ID 確認升級，然後點選「Confirm」(確認)。

gcloud

如要使用 gcloud CLI，您可以安裝並初始化 Google Cloud CLI，也可以使用 Cloud Shell。

如要將 AlloyDB Express 叢集升級為 AlloyDB 叢集，請執行 gcloud beta alloydb clusters update 指令並加上 --no-enable-express 旗標：

gcloud beta alloydb clusters update CLUSTER_ID \
    --region=REGION_ID \
    --no-enable-express \
    --project=PROJECT_ID

更改下列內容：

  • CLUSTER_ID：AlloyDB Express 叢集的 ID。
  • REGION_ID：叢集所在的區域。
  • PROJECT_ID：Google Cloud 專案的 ID。

如果主要執行個體是 1 個 vCPU 執行個體，且所在區域不支援 C4A 機器系列，指令會失敗並顯示下列錯誤：

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

如要解決這項錯誤，請將主要執行個體更新為 2 個 vCPU (--cpu-count=2)，然後再次執行升級指令。

REST

如要將 AlloyDB Express 叢集升級為 AlloyDB 叢集，請使用 updateMask=expressConfig.enabled 向 projects.locations.clusters.patch 端點傳送 PATCH 要求，並將 expressConfig.enabled 設為 false。

使用任何要求資料之前，請先替換下列項目：

  • PROJECT_ID：Google Cloud 專案的 ID。
  • REGION_ID：叢集所在的區域。
  • CLUSTER_ID：AlloyDB Express 叢集的 ID。

HTTP 方法和網址：

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?updateMask=expressConfig.enabled

JSON 要求主體：

{
  "expressConfig": {
    "enabled": false
  }
}

如果主要執行個體是 1 個 vCPU 執行個體，且所在區域不支援 C4A 機器系列，要求會失敗並顯示下列錯誤：

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

如要解決這項錯誤，請將主要執行個體更新為 2 個 vCPU ("machineConfig": {"cpuCount": 2})，然後再次傳送升級要求。

後續步驟