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

このページでは、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. [Update instance] をクリックします。

gcloud

インスタンスのデータベース フラグを変更するには、gcloud alloydb instances update コマンドを使用します。

注意: 次のコマンドを実行すると、以前に設定されたすべてのデータベース フラグが上書きされます。--database-flags リストに明示的に含まれていないデータベース フラグは、デフォルト値にリセットされます。新しいフラグを追加しながらインスタンスのデータベース フラグを保持するには、現在のフラグと新しいフラグの両方を --database-flags リストに含める必要があります。

   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