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

本頁說明如何為 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 角色)

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

控制台

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

    前往「Clusters」(叢集)

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

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

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

    新增旗標

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

    修改旗標

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

    刪除標記

    1. 如要從執行個體刪除資料庫標記，請選取標記並按一下刪除圖示。
    2. 按一下 [完成]。

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

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