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

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

AlloyDB Omni のデータベース パラメータを構成するには、Kubernetes クラスタで AlloyDB Omni を実行する環境のデータベース クラスタ マニフェスト(DBCluster)で Grand Unified Configuration(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. ナビゲーション メニューで [データベース フラグ] をクリックします。
  3. 次のコントロールを使用して、パラメータを検索してフィルタします。
    • フラグを検索する: キーワード(max など)を入力して、パラメータを名前でフィルタします。
    • 変更されたフラグを表示する: このチェックボックスをオンにすると、アクティブな値がデフォルトのエンジン値と異なるパラメータのみが表示されます。カスタマイズされた値は、[現在の値] 列でも黄色でハイライト表示されます。
    • すべて折りたたむまたはすべて展開: パラメータ カテゴリ グループ(Google AlloyDB オプション、クライアント接続のデフォルト / ロケールと形式、クライアント接続のデフォルト / その他のデフォルト、クライアント接続のデフォルト / 共有ライブラリのプリロードなど)を折りたたむか展開します。
  4. 各カテゴリ グループ内のパラメータ表の列を確認します。
    • 設定: データベース パラメータの名前。
    • Type: パラメータのデータ型(INTEGER など)。
    • 現在の値: インスタンスのパラメータのアクティブな値(デフォルトから変更されている場合は黄色でハイライト表示されます)。
    • デフォルト値: パラメータのデフォルトのエンジン値。
    • 再起動が必要: パラメータの変更にデータベースの再起動が必要かどうかを示します(true または false)。
    • Source: 現在の値の構成ソース(例: default)。