インスタンスのデータベース フラグを構成する

このページでは、AlloyDB for PostgreSQL クラスタ内のインスタンスにデータベース フラグを追加する方法、データベース フラグを変更する方法、インスタンスからデータベース フラグを削除する方法について説明します。

データベース フラグは、PostgreSQL パラメータの調整、オプションの調整、インスタンスの構成やチューニングなど、多くの操作で使用します。データベース フラグの値の変更は、フラグを削除するか、値を再度変更するまで、そのインスタンスに保持されます。

場合によっては、目的の機能を完全に有効にするために、1 つのフラグの設定だけでなく、別のフラグの設定も必要になることがあります。

データベース インスタンスのフラグを設定、削除、変更すると、AlloyDB によってインスタンスが再起動されることがあります。これは、サポート対象のデータベース フラグに記載されているフラグによって異なります。

再起動が必要なプライマリ インスタンスまたは読み取りプール インスタンスでデータベース フラグを変更する場合は、次のいずれかのメンテナンス ポリシーを選択できます。

  • ダウンタイムが短い。このポリシーはデフォルトで有効になっています。アプリケーションのダウンタイムを最小限に抑えることができるため、すべての本番環境 AlloyDB クラスタにこのポリシーを使用することをおすすめします。

    ダウンタイムの短縮ポリシーが有効になっている場合、クラスタのプライマリ インスタンスの再起動を必要とするフラグを更新すると、次の影響があります。

    • ほとんどのワークロードで、プライマリ インスタンスのダウンタイムは 1 秒未満です。

    • プライマリ インスタンスのフラグは、約 15 分後に新しい値に更新されます。

    読み取りプール インスタンスで再起動が必要なフラグを更新すると、次の影響があります。

    • 読み取りプール インスタンスではダウンタイムは必要ありません。

    • 読み取りプール インスタンスのフラグは、約 10 分後に新しい値への更新が完了します。

  • 強制適用。フラグの更新をより速く適用するには、gcloud beta alloydb instances update コマンドと FORCE_APPLY オプションを使用します。

    このポリシーは開発環境に適しています。インスタンスのダウンタイムが長くなり、データベースのパフォーマンスやスループットが一時的に低下する代わりに、フラグをすばやく追加または変更できます。フラグの更新を強制的に適用してから数分後に、クラスタはピーク パフォーマンスに戻ります。

    強制適用ポリシーが有効になっている場合、クラスタのプライマリ インスタンスの再起動が必要なフラグを更新すると、次の影響があります。

    • プライマリ インスタンスで約 1 分間のダウンタイムが発生します。

    • プライマリ インスタンスのフラグは、1～2 分後に新しい値への更新が完了します。

    読み取りプール インスタンスで再起動が必要なフラグを更新すると、次の影響があります。

    • 読み取りプール インスタンスで約 1 分間のダウンタイムが発生します。

    • 読み取りプール インスタンスのフラグは、1～2 分後に新しい値への更新が完了します。

始める前に

  • 使用している Google Cloud プロジェクトで AlloyDB へのアクセスが有効になっている必要があります。
  • 使用している Google Cloud プロジェクトに、次のいずれかの IAM ロールが必要です。
    • roles/alloydb.admin（AlloyDB 管理者の IAM 事前定義ロール）
    • roles/owner（オーナーの IAM 基本ロール）
    • roles/editor（編集者の IAM 基本ロール）

    これらのロールが付与されていない場合は、アクセス権を付与するよう組織管理者に依頼してください。

コンソール

  1. Google Cloud コンソールで [クラスタ] ページに移動します。

    [クラスタ] に移動

  2. [リソース名] 列でクラスタをクリックします。

  3. [概要] ページで [クラスタ内のインスタンス] に移動し、インスタンスを選択して [編集] をクリックします。

  4. インスタンスに対してデータベース フラグの追加、変更、または削除を行います。

    フラグを追加する

    1. インスタンスにデータベース フラグを追加するには、[フラグを追加] をクリックします。
    2. [新しいデータベース フラグ] リストからフラグを選択します。
    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