設定資料庫參數

選取文件版本：

本頁說明如何使用 AlloyDB Omni RPM 自動調度管理工具設定資料庫參數。

資料庫參數 (又稱 Grand Unified Configuration (GUC) 參數) 可用來微調 AlloyDB Omni 資料庫叢集的效能和行為。詳情請參閱 PostgreSQL 說明文件中的「設定參數」。

事前準備

設定資料庫參數前，請確認您具備下列項目：

  1. 安裝 AlloyDB Omni 自動調度管理工具。
  2. 佈建並建立 AlloyDB Omni 叢集。

設定資料庫參數

如要設定資料庫參數，請使用 DBCluster 資源規格的 primarySpec 區段中的 parameters 欄位。

更新資源規格

在 DBCluster 資源規格中新增或修改必要參數及其值。您可以在建立叢集時設定參數，也可以在叢集建立後更新參數。

以下程式碼片段顯示 GUC 參數範例。您可以透過類似方式設定其他支援的資料庫參數：

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        # ... existing parameters ...
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"
        huge_pages: "HUGE_PAGES"
        log_statement: "LOG_STATEMENT"
        # ... other parameters ...

更改下列內容：

  • CLUSTER_NAME：資料庫叢集名稱。
  • MAX_WAL_SIZE：範例參數，可控制 WAL 在自動 WAL 檢查點之間可成長的最大大小，例如 2GB。
  • MAX_CONNECTIONS_LIMIT： 控制資料庫伺服器允許的並行連線數量上限的參數範例，例如 200。支援的值最小值為 50。
  • HUGE_PAGES：控制使用巨型頁面的參數範例，例如 on。
  • LOG_STATEMENT：控制要記錄哪些 SQL 陳述式的範例參數，例如 all。

套用設定

使用偏好的自動化調度管理工具介面套用變更。

Ansible

如果您使用 Ansible 直接管理 AlloyDB Omni RPM 自動調度管理工具基礎架構，系統會執行適當的劇本並傳遞所選 update_action 做為額外變數，藉此觸發更新。

update.yml 範例檔案：

---
- hosts: localhost
  vars:
    update_action: "update_resource_spec"
    ansible_user: your_ssh_user
    ansible_ssh_private_key_file: ~/path/to/private-key
  roles:
    - role: google.alloydbomni_orchestrator.update

執行 Ansible 指令：

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -e resource_spec="DBCLUSTER_SPECIFICATION"

請替換下列變數：

  • DEPLOYMENT_SPECIFICATION： 您在安裝 AlloyDB Omni 元件中建立的部署規格路徑。

  • DBCLUSTER_SPECIFICATION：叢集規格的路徑。

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

請替換下列變數：

  • DEPLOYMENT_SPECIFICATION： 您在安裝 AlloyDB Omni 元件中建立的部署規格路徑。

  • DBCLUSTER_SPECIFICATION：叢集規格的路徑。

驗證參數變更

套用設定後，您可以使用 psql 中的 SHOW 指令，確認參數已更新：

SHOW PARAMETER_NAME;

將 PARAMETER_NAME 替換為您設定的參數名稱。