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

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

    これらのロールを付与されていない場合は、組織管理者に連絡してアクセス権をリクエストしてください。

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

    [クラスタ] に移動

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

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

  4. インスタンスからデータベース フラグを追加、変更、削除します。

    フラグを追加する

    1. インスタンスにデータベース フラグを追加するには、[フラグを追加] をクリックします。
    2. [新しいデータベース フラグ] リストからフラグを選択します。
    3. フラグの値を指定します。
    4. [完了] をクリックします。

    フラグを変更する

    1. インスタンス内のデータベース フラグを変更するには、データベース フラグを展開し、[データベース フラグを編集] セクションで既存のフラグの値を変更します。
    2. [完了] をクリックします。

    フラグを削除する

    1. インスタンスからデータベース フラグを削除するには、フラグを選択して削除アイコンをクリックします。
    2. [完了] をクリックします。
  5. [Update instance] をクリックします。

インスタンスのデータベース フラグを変更するには、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: 1 つ以上のデータベース フラグ仕様のカンマ区切りリスト。各仕様は、フラグの名前、等号(=)、フラグに割り当てる値で構成されます。値を受け取らないデータベース フラグの場合は、フラグ名の後に等号(=)を付けます。
  • 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