執行自助式維護

如要盡快將最新的 AlloyDB for PostgreSQL 更新套用至叢集，可以執行自助式維護作業。更新至最新版本可解鎖 AlloyDB 功能、套用修補程式，以及設定拒絕時間範圍，避免在敏感時間範圍內發生中斷。

詳情請參閱「維護總覽」。

自助維護應用實例

AlloyDB 通常會為叢集套用維護作業，執行維護作業來升級叢集中的資料庫軟體。根據預設，AlloyDB 會在區域營業時間以外執行維護作業。您可以視需要設定維護期間，定義偏好的定期維護時間，並接收即將進行的定期維護通知。針對特定版本和 PostgreSQL 版本，系統會先完成沒有維護時間範圍的叢集維護作業，然後排定有維護時間範圍的叢集維護作業。

您可能會基於下列原因，決定執行自助式維護：

  • 您的叢集已略過維護作業。如果您設定拒絕期，或叢集在遷移期間處於啟動狀態，就會發生這種情況。
  • 叢集必須先更新，才能進行排定的維護作業。
  • 您必須在未更新的叢集上設定拒絕期間。 如果叢集中的執行個體使用較舊版本，可能無法設定拒絕期間。
  • 您想以自訂或不規律的頻率執行維護作業。在這種情況下，您可以設定拒絕期，然後在需要時執行自助式維護。拒絕維護期不會阻擋自助式維護。

更新期間的資源精細程度

AlloyDB 僅支援叢集層級的維護作業。 在叢集內，AlloyDB 會決定執行個體更新的順序。AlloyDB 會嘗試並完成每個執行個體的維護作業，因此執行個體可能採用不同版本。舉例來說，叢集可能會因為拒絕期而略過現有執行個體的維護作業，然後在之後建立最新版本的執行個體。

查看最新可用版本

如要查看最新版本，請參閱 AlloyDB 維護變更記錄。維護作業套用至所有區域的叢集後，系統就會更新變更記錄。如要進一步瞭解最新版本如何套用至區域，請參閱「最新版本」。

查看執行個體的目前版本

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

您只能在執行個體層級查看版本。

  1. 如要查看執行個體的目前維護版本，請執行 gcloud alloydb instances describe 指令：

    gcloud alloydb instances describe INSTANCE_ID \
--cluster CLUSTER_ID \
--region LOCATION_ID

    更改下列內容：

    • INSTANCE_ID：您要查看版本的執行個體 ID。
    • CLUSTER_ID：執行個體所在的叢集 ID。
    • LOCATION_ID：這個叢集所在的 Google Cloud 區域，例如 us-central1。

  2. 在回應中找出 maintenanceVersionName 欄位，即可查看執行例項的版本。例如：

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

將叢集更新至最新可用版本

gcloud

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

如要將叢集更新至最新版本，請執行 gcloud alloydb clusters update 指令並加上 maintenance-version 旗標：

gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest

更改下列內容：

  • CLUSTER_ID：要更新至最新版本的叢集 ID。
  • LOCATION_ID：這個叢集所在的 Google Cloud 區域，例如 us-central1。

回應範例：

Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.

REST v1

這個範例會將叢集更新為最新版本。如需這項呼叫的完整參數清單，請參閱方法：projects.locations.clusters.patch。

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

  • CLUSTER_ID：要更新至最新版本的叢集。
  • PROJECT_ID：叢集所在的專案 ID。
  • LOCATION_ID：這個叢集所在的 Google Cloud 區域，例如 us-central1。

如要將叢集更新至最新版本，請使用下列 PATCH 要求：

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_version_selection_policy}

maintenance_version_selection_policy 查詢參數會指定要將叢集執行個體更新至哪個版本。

JSON 要求主體如下所示：

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

後續步驟