データベース パラメータを構成する

ドキュメントのバージョンを選択してください。

このページでは、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"

次の変数を置き換えます。

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

次の変数を置き換えます。

パラメータの変更を確認する

構成を適用した後、psql の SHOW コマンドを使用して、パラメータが更新されていることを確認できます。

SHOW PARAMETER_NAME;

PARAMETER_NAME は、構成したパラメータの名前に置き換えます。