設定執行個體的資料庫旗標

本頁面說明如何為 AlloyDB for PostgreSQL 叢集中的執行個體新增、修改及刪除資料庫標記。

您可以使用資料庫標記執行許多作業，包括調整 PostgreSQL 參數、調整選項，以及設定和調整執行個體。移除資料庫旗標或再次修改旗標值之前，系統都會保留執行個體的旗標值。

在部分情況下，設定某一標記可能會需要您設定另一個標記，才能完整啟用想要的功能。

設定、移除或修改資料庫執行個體的旗標後，AlloyDB 可能會重新啟動執行個體。這取決於旗標，如「支援的資料庫旗標」一文所述。

在主要或讀取集區執行個體中修改需要重新啟動的資料庫標記時，您可以選擇下列其中一項維護政策：

  • 停機時間短。這項政策預設為啟用，建議您為所有正式版 AlloyDB 叢集使用這項政策，因為這樣可盡量縮短應用程式停機時間。

    啟用低停機時間政策後，更新叢集主要執行個體上需要重新啟動的旗標，會產生下列影響：

    • 對於大多數工作負載，主要執行個體的停機時間不到一秒。

    • 主要執行個體上的旗標會在約 15 分鐘後更新為新值。

    在讀取集區執行個體上更新需要重新啟動的標記，會產生下列影響：

    • 讀取集區執行個體不需要停機。

    • 讀取集區執行個體上的旗標大約會在 10 分鐘後更新為新值。

  • 強制套用。如要加快套用旗標更新的速度，請使用 FORCE_APPLY 選項搭配 gcloud beta alloydb instances update 指令。

    這項政策較適合開發環境，可讓您快速新增或修改旗標，不過執行個體停機時間較長，資料庫效能或處理量也會暫時降低。強制套用旗標更新後，叢集會在幾分鐘內恢復最高效能。

    啟用強制套用政策後，更新需要重新啟動叢集主要執行個體的旗標，會產生下列影響：

    • 主要執行個體會停機約一分鐘。

    • 主要執行個體上的旗標會在 1 到 2 分鐘後更新為新值。

    在讀取集區執行個體上更新需要重新啟動的標記，會產生下列影響：

    • 讀取集區執行個體會停機約一分鐘。

    • 讀取集區執行個體上的旗標會在 1 到 2 分鐘後更新為新值。

事前準備

  • 您使用的 Google Cloud 專案必須啟用 AlloyDB 存取權。
  • 您必須在使用的 Google Cloud 專案中具備下列任一 IAM 角色：
    • roles/alloydb.admin (AlloyDB 管理員預先定義的 IAM 角色)
    • roles/owner (擁有者基本 IAM 角色)
    • roles/editor (編輯者基本 IAM 角色)

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

為確保維護和更新作業可以建立臨時複製運算單元，以進行狀態同步，請確認複製運算單元的總數至少比 max_wal_senders 限制少一個。如要進一步瞭解如何設定這個標記，請參閱「設定來源執行個體」。

控制台

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

    前往叢集

  2. 按一下「資源名稱」欄中的叢集。

  3. 在「總覽」頁面中，前往「叢集內的執行個體」，選取執行個體，然後點選「編輯」。

  4. 展開「進階設定選項」。

  5. 從執行個體新增、修改或刪除資料庫旗標：

    新增旗標

    1. 如要為執行個體新增資料庫旗標，請按一下「新增旗標」。
    2. 從「New database flag」(新的資料庫旗標) 清單中選取旗標。
    3. 提供旗標值。
    4. 按一下「完成」。

    修改旗標

    1. 如要修改執行個體中的資料庫旗標，請展開資料庫旗標，然後在「編輯資料庫旗標」專區中修改現有旗標的值。
    2. 按一下「完成」。

    刪除標記

    1. 如要從執行個體刪除資料庫旗標，請選取旗標，然後按一下刪除圖示。
    2. 按一下「完成」。

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

gcloud

使用 gcloud alloydb instances update 指令變更執行個體的資料庫標記。

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

如要更快套用旗標更新，請加入 --update-mode=FORCE_APPLY 引數。因為這可能會暫時降低資料庫效能，請避免在正式環境中使用這個選項。

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

更改下列內容：

  • INSTANCE_ID：執行個體的 ID。
  • FLAGS_LIST：以半形逗號分隔的一或多個資料庫旗標規格清單。每個規格都包含標記名稱、等號 (=) 和要指派給標記的值。如果資料庫旗標不接受值，請提供旗標名稱，後面加上等號 (=)。
  • REGION_ID：執行個體所在的區域，例如 us-central1。
  • CLUSTER_ID：執行個體所在的叢集 ID。
  • PROJECT_ID：叢集所在的專案 ID。修改資料庫標記後，叢集會進入低或零停機時間維護週期。

如要查看執行個體目前手動設定的旗標清單，請執行下列指令：

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