設定 AlloyDB Omni 資料庫參數

如要設定 AlloyDB Omni 的資料庫參數，您可以在Kubernetes 叢集上執行 AlloyDB Omni 的環境中，更新資料庫叢集資訊清單 (DBCluster) 中的通用統一設定 (GUC) 參數。如需支援的旗標清單，請參閱「支援的資料庫旗標」。

在 Kubernetes 叢集更新 AlloyDB Omni 參數

您可以使用資料庫叢集資訊清單 primarySpec 區段中的 parameters 欄位，設定資料庫參數：

spec:
  primarySpec:
    parameters:
      "PARAMETER_NAME": "PARAMETER_VALUE"
      ...

更改下列內容：

  • PARAMETER_NAME：參數名稱，例如 autovacuum。
  • PARAMETER_VALUE：參數的值，例如 off。

部分參數需要重新啟動叢集，變更才會生效。您可以從 pg_catalog.pg_settings 取得需要重新啟動的參數清單。任何含有 pg_catalog.pg_settings.context = 'postmaster' 的參數都需要重新啟動。

如要更新資料庫參數，請執行下列指令：

kubectl patch dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -p '{"spec":{"primarySpec":{"parameters": {"PARAMETER_NAME": "PARAMETER_VALUE"}}}}' --type=merge

參數設定位於 currentParameters 欄位的 status 部分。

如要查看資料庫參數，請執行下列指令：

kubectl get dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -o jsonpath={.status.primary.currentParameters}

輸出結果會與下列內容相似：

{"autovacuum":"off","max_connections":"3000"}

如果 AlloyDB Omni 無法套用要求的更新，輸出內容會分別列出目前和要求的值。舉例來說，如果您套用不存在的參數，或為整數參數設定字串值，就可能發生這種差異。

使用網頁版 UI 稽核資料庫參數

您可以使用 AlloyDB Omni 網頁使用者介面的「資料庫旗標」頁面，稽核使用中的資料庫旗標，並找出與預設引擎值不同的自訂參數。

如要在網頁 UI 稽核資料庫參數，請完成下列步驟：

  1. 連線至網頁版 UI，然後選取叢集。
  2. 在導覽選單中，按一下「Database flags」(資料庫旗標)。
  3. 使用下列控制項搜尋及篩選參數：
    • 搜尋旗標：輸入關鍵字 (例如 max)，依名稱篩選參數。
    • 顯示修改過的標記：勾選這個核取方塊，即可只顯示有效值與預設引擎值不同的參數。「目前值」欄中的自訂值也會以黃色醒目顯示。
    • 「Collapse all」(全部收合) 或「Expand all」(全部展開)：收合或展開參數類別群組 (例如「Google AlloyDB Options」(Google AlloyDB 選項)、「Client Connection Defaults / Locale and Formatting」(用戶端連線預設值/語言代碼和格式設定)、「Client Connection Defaults / Other Defaults」(用戶端連線預設值/其他預設值) 和「Client Connection Defaults / Shared Library Preloading」(用戶端連線預設值/共用資料庫預先載入))。
  4. 查看每個類別群組中的參數表格欄：
    • 設定：資料庫參數的名稱。
    • 類型：參數的資料類型 (例如 INTEGER)。
    • 目前的值：執行個體上參數的有效值 (如果已從預設值修改，則會以黃色醒目顯示)。
    • 預設值：參數的預設引擎值。
    • Restart required：指出修改參數是否需要重新啟動資料庫 (true 或 false)。
    • 來源：目前值的設定來源 (例如 default)。