データベース クラスタの属性を更新する

GDC コンソールまたは gdcloud CLI を使用して、次のデータベース クラスタ属性を変更できます。

  • 管理者ユーザーのデータベース パスワード
  • 外部接続（有効/無効）
  • 可用性レベル（AlloyDB Omni と PostgreSQL のみ）
  • バックアップが有効で、バックアップの保持期間（日数）
  • データベース フラグ
  • データベース クラスタに割り当てられた CPU、メモリ、ストレージ

属性を変更する方法については、更新する属性タイプに対応するワークフローをご覧ください。

コンソール

高可用性

AlloyDB Omni と PostgreSQL データベース クラスタの場合は、同じゾーンの高可用性を有効または無効にします。詳細については、高可用性を構成するをご覧ください。

データ保護

すべてのデータベース クラスタ タイプで、データ保護を有効または無効にできます。

  1. [データ保護] に移動し、[編集] 編集] をクリックして、データ保護設定フォームにアクセスします。自動バックアップが有効になっている場合は、バックアップの保持期間を構成することもできます。
  2. 変更を加えたら、[保存] をクリックして、データベース クラスタに更新を適用します。

接続

すべてのデータベース クラスタタイプで、データベース クラスタに GDC プロジェクト内からのみアクセスできるか、プロジェクト外からもアクセスできるかを選択できます。

  1. [接続] に移動し、[編集] 編集 をクリックします。
  2. 接続構成を更新します。

  3. [保存] をクリックして変更を適用します。

インスタンス

すべてのデータベース クラスタ タイプで、プライマリ インスタンスのプロパティを編集できます。

  1. [プライマリ インスタンス] に移動し、[編集] 編集をクリックします。

  2. [高パフォーマンス]、[標準]、[最小]、[カスタム] のいずれかの構成を選択します。[カスタム] オプションでは、プライマリ インスタンスの CPU 数、メモリ、ストレージを選択できます。

  3. プライマリ インスタンスの CPU、メモリ、ストレージを更新するには、再起動が必要です。[保存して再起動] を選択して変更を適用します。

すべてのデータベース クラスタ タイプで、このフォームを使用してデータベース フラグの追加、変更、削除を行うこともできます。使用可能なフラグのセットは、GDC によって事前に決定されます。詳細については、データベース フラグを構成するをご覧ください。

gdcloud CLI

次のコマンドを使用して、データベース クラスタを更新します。 sh gdcloud database clusters update CLUSTER_NAME [options]

次のように置き換えます。

  • CLUSTER_NAME は、更新するデータベース クラスタの名前に置き換えます。

オプションの全リストについては、コマンド リファレンスをご覧ください。または、sh gdcloud database clusters update --help を実行してください。

API

データ保護

すべてのデータベース クラスタ タイプで、そのデータベース クラスタの BackupPlan リソースを作成して、データ保護機能を有効にできます。

apiVersion: DBENGINE_NAME.dbadmin.gdc.goog/v1
kind: BackupPlan
metadata:
  name: DBCLUSTER_NAME-backupplan
  namespace: USER_PROJECT
spec:
  dbclusterRef: DBCLUSTER_NAME
  backupRetainDays: RETENTION_DAYS

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

  • DBENGINE_NAME: データベース エンジンの名前。alloydbomni、postgresql、oracle のいずれかです。
  • DBCLUSTER_NAME: データ保護を有効にするデータベース クラスタの名前。
  • USER_PROJECT: データベース クラスタが作成されるユーザー プロジェクトの名前。
  • RETENTION_DAYS: AlloyDB Omni Operator がこのバックアップを保持する日数。1 ～ 90 の整数を指定する必要があります。

対応する BackupPlan リソースを編集して、保持日数などのデータ保護設定を構成することもできます。

データベース クラスタのデータ保護を無効にするには、以前に作成した対応する BackupPlan リソースを削除します。

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

GDC に付属するデータベース イメージには、デフォルト設定が付属しています。ただし、アプリケーションの要件を満たすようにデフォルトのデータベース エンジンをカスタマイズできます。データベース クラスタには、GDC コンソールまたは gdcloud CLI を使用して設定できる事前定義されたフラグが用意されています。

コンソール

  1. ナビゲーション メニューで [データベース サービス] を選択します。

  2. データベース クラスタのリストで、データベース フラグを構成するデータベース クラスタをクリックします。

  3. [データベース クラスタ内のインスタンス] セクションで、[プライマリを編集] をクリックします。

    プライマリ データベース クラスタを編集してフラグを構成します。

  4. [フラグ] セクションで、[データベース フラグを追加] をクリックします。

  5. フラグを選択して値を入力します。入力した値が有効でない場合、GDC コンソールに、必要な範囲または値の型を満たす方法の手順が表示されます。

  6. [完了] をクリックします。

  7. 構成を設定するには、[保存] をクリックします。一部のフラグを有効にするには、データベース クラスタを再起動する必要があります。この場合は、[保存して再起動] をクリックします。

  8. 新しいフラグが設定されていることを確認するには、データベース クラスタの [データベース クラスタ内のインスタンス] セクションに戻り、新しいフラグと値が表示されていることを確認します。

データベース フラグを編集するには、[フラグ] セクションに戻り、既存のフラグを変更します。フラグ コンポーネントにカーソルを合わせ、 削除アイコンをクリックして、データベース フラグを削除します。

gdcloud

クラスタの新しいデータベース フラグを構成するか、既存のすべてのフラグをデフォルト値にリセットできます。

  • データベース クラスタのデータベース フラグを構成するには、次のコマンドを実行します。

    gdcloud database clusters update CLUSTER_NAME \
    --database-flags DB_FLAGS

    次のように置き換えます。

    • CLUSTER_NAME: データベース クラスタの名前。
    • DB_FLAGS: データベース クラスタで実行されているデータベースに設定するデータベース フラグのカンマ区切りリスト。各データベース フラグと値は Key-Value ペアとして設定されます。値のないフラグは、= 文字の後に文字列を付けずに定義できます。

    たとえば、次のコマンドは test-db-cluster に複数のデータベース フラグを設定します。

    gdcloud database clusters update test-db-cluster \
    --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1

    使用可能なデータベース フラグの一覧については、使用可能なデータベース フラグをご覧ください。

  • すべてのデータベース フラグをデフォルト設定にリセットするには、次のコマンドを実行します。

    gdcloud database clusters update CLUSTER_NAME --clear-database-flags

    CLUSTER_NAME は、データベース クラスタの名前に置き換えます。

API

  • データベース クラスタのデータベース フラグを構成するには、次のコマンドを実行します。

      kubectl patch dbcluster.DBENGINE_NAME.dbadmin.gdc.goog DBCLUSTER_NAME -p '{"spec":{"primarySpec": {"parameters": DB_FLAGS}}}' --type=merge -n USER_PROJECT

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

    • DBENGINE_NAME: データベース エンジンの名前。alloydbomni、postgresql、oracle のいずれかです。
    • DBCLUSTER_NAME: データベース クラスタの名前。
    • USER_PROJECT: データベース クラスタが作成されたユーザー プロジェクトの名前。
    • DB_FLAGS: 追加または更新するデータベース構成パラメータ。これは、Key-Value ペアの JSON 形式のオブジェクトである必要があります。ここで、キーはデータベース パラメータ名、値はそれぞれの設定です。たとえば、次のコマンドは複数のデータベース フラグを設定します。
    "autovacuum": "on", "autovacuum_analyze_threshold": "2147483647", "dbs.enable_anon": "on"

    使用可能なデータベース フラグの一覧については、使用可能なデータベース フラグをご覧ください。

  • すべてのデータベース フラグをデフォルト設定にリセットするには、次のコマンドを実行します。

    kubectl patch dbcluster.DBENGINE_NAME.dbadmin.gdc.goog DBCLUSTER_NAME --type=json -p='[{"op": "remove", "path": "/spec/primarySpec/parameters"}]' -n USER_PROJECT

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

    • DBENGINE_NAME: データベース エンジンの名前。alloydbomni、postgresql、oracle のいずれかです。
    • DBCLUSTER_NAME: データベース クラスタの名前。
    • USER_PROJECT: データベース クラスタが作成されたユーザー プロジェクトの名前。

使用可能なデータベース フラグ

構成するデータベース クラスタで使用可能なデータベース フラグは、構成したデータベース エンジンに基づいて次に示します。

PostgreSQL データベース フラグ

フラグ 範囲 タイプ 再起動が必要
max_connections [1, 262143] Integer TRUE
temp_file_limit [1048576, 2147483647] Integer FALSE
log_min_duration_statement [-1, 2147483647] Integer FALSE
log_connections オン、オフ ブール値 FALSE
log_lock_waits オン、オフ ブール値 FALSE
log_disconnections オン、オフ ブール値 FALSE
log_checkpoints オン、オフ ブール値 FALSE
log_temp_files [-1, 2147483647] Integer FALSE
log_statement none、ddl、mod、all 列挙型 FALSE
pgaudit.log read、write、function、role、ddl、misc、misc_set、
all、none、-read、-write、-function、-role、-ddl、
-misc、-misc_set、-all、-none		 繰り返しの文字列 FALSE
work_mem [64, 2147483647] Integer FALSE
autovacuum オン、オフ ブール値 FALSE
maintenance_work_mem [1024, 2147483647] Integer FALSE
random_page_cost [0, 2147483647] 浮動小数点数 FALSE
log_min_messages debug5、debug4、debug3、debug2、debug1、info
notice、warning、error、log、fatal、panic		 列挙型 FALSE
idle_in_transaction_session_timeout [0, 2147483647] Integer FALSE
max_wal_size [2, 2147483647],. Integer FALSE
autovacuum_vacuum_scale_factor [0, 100] 浮動小数点数 FALSE
log_autovacuum_min_duration [-1, 2147483647] Integer FALSE
autovacuum_vacuum_cost_limit [-1, 10000] Integer FALSE
autovacuum_max_workers [1, 262143] Integer TRUE
autovacuum_analyze_scale_factor [0, 100] 浮動小数点数 FALSE
track_activity_query_size [100, 1048576] Integer TRUE
log_duration オン、オフ ブール値 FALSE
autovacuum_vacuum_cost_delay [-1, 100] Integer FALSE
checkpoint_completion_target [0, 1] 浮動小数点数 FALSE
log_statement_stats オン、オフ ブール値 FALSE
max_worker_processes [8, 4096] Integer TRUE
log_min_error_statement debug5、debug4、debug3、debug2、debug1、info、
notice、warning、error、log、fatal、panic		 列挙型 FALSE
default_statistics_target [1, 10000] Integer FALSE
checkpoint_timeout [30, 86400] Integer FALSE
wal_buffers [-1, 262143 ] Integer TRUE
effective_cache_size [1, 2147483647] Integer FALSE
autovacuum_work_mem [1, 2147483647] Integer FALSE
log_hostname オン、オフ ブール値 FALSE
autovacuum_vacuum_threshold [0, 2147483647] Integer FALSE
autovacuum_naptime [1, 2147483] Integer FALSE
autovacuum_analyze_threshold [0, 2147483647] Integer FALSE
pgaudit.log_client オン、オフ ブール値 FALSE
pgaudit.log_parameter オン、オフ ブール値 FALSE
pgaudit.log_level debug5、debug4、debug3、debug2、debug1、info、
notice、warning、error、log		 列挙型 FALSE
pgaudit.log_relation オン、オフ ブール値 FALSE
pgaudit.log_catalog オン、オフ ブール値 FALSE
pgaudit.role 文字列 FALSE
autovacuum_freeze_max_age [100000, 2000000000] Integer TRUE
autovacuum_multixact_freeze_max_age [10000, 2000000000] Integer TRUE
pgaudit.log_statement_once オン、オフ ブール値 FALSE
anon.algorithm 文字列 FALSE
anon.maskschema 文字列 FALSE
anon.restrict_to_trusted_schemas オン、オフ ブール値 FALSE
anon.salt 文字列 FALSE
anon.sourceschema 文字列 FALSE
dbs.enable_anon オン、オフ ブール値 TRUE
dbs.enable_pg_bigm オン、オフ ブール値 TRUE
dbs.enable_pg_cron オン、オフ ブール値 TRUE
dbs.enable_pg_hint_plan オン、オフ ブール値 TRUE
dbs.enable_pg_wait_sampling オン、オフ ブール値 TRUE
pg_bigm.enable_recheck オン、オフ ブール値 FALSE
pg_bigm.gin_key_limit [0, 2147483647] Integer FALSE
pg_bigm.similarity_limit [0, 1] 浮動小数点数 FALSE
pg_hint_plan.debug_print off、on、detailed、verbose、0、1、2、3、no、yes、false、true 列挙型 TRUE
pg_hint_plan.enable_hint オン、オフ ブール値 FALSE
pg_hint_plan.enable_hint_table オン、オフ ブール値 FALSE
pg_hint_plan.message_level debug5、debug4、debug3、debug2、debug1、debug、info、notice、warning、error、log 列挙型 FALSE
pg_hint_plan.parse_messages debug5、debug4、debug3、debug2、debug1、debug、info、notice、warning、error、log 列挙型 FALSE
pg_stat_statements.max [100, 2147483647] Integer TRUE
pg_stat_statements.save オン、オフ ブール値 FALSE
pg_stat_statements.track none、top、all 列挙型 FALSE
pg_stat_statements.track_utility オン、オフ ブール値 FALSE
pg_wait_sampling.history_period [1, 2147483647] Integer FALSE
pg_wait_sampling.history_size [1, 2147483647] Integer FALSE
pg_wait_sampling.profile_period [1, 2147483647] Integer FALSE
pg_wait_sampling.profile_pid オン、オフ ブール値 FALSE
pg_wait_sampling.profile_queries オン、オフ ブール値 FALSE
pglogical.batch_inserts オン、オフ ブール値 TRUE
pglogical.conflict_log_level debug5、debug4、debug3、debug2、debug1、info、notice、warning、error、log、fatal、panic 列挙型 FALSE
pglogical.conflict_resolution error、apply_remote、keep_local、last_update_wins、first_update_wins 列挙型 FALSE
pglogical.extra_connection_options 文字列 FALSE
pglogical.synchronous_commit オン、オフ ブール値 TRUE
pglogical.use_spi オン、オフ ブール値 TRUE
pgtt.enabled オン、オフ ブール値 FALSE
plv8.execution_timeout [1, 65536] Integer FALSE
plv8.memory_limit [256, 3096] Integer FALSE
plv8.start_proc 文字列 FALSE
rdkit.agent_FP_bit_ratio [0, 3] 浮動小数点数 FALSE
rdkit.avalon_fp_size [64, 9192] Integer FALSE
rdkit.dice_threshold [0, 1] 浮動小数点数 FALSE
rdkit.difference_FP_weight_agents [-10, 10] Integer FALSE
rdkit.difference_FP_weight_nonagents [1, 20] Integer FALSE
rdkit.do_chiral_sss オン、オフ ブール値 FALSE
rdkit.do_enhanced_stereo_sss オン、オフ ブール値 FALSE
rdkit.featmorgan_fp_size [64, 9192] Integer FALSE
rdkit.hashed_atompair_fp_size [64, 9192] Integer FALSE
rdkit.hashed_torsion_fp_size [64, 9192] Integer FALSE
rdkit.ignore_reaction_agents オン、オフ ブール値 FALSE
rdkit.init_reaction オン、オフ ブール値 FALSE
rdkit.layered_fp_size [64, 9192] Integer FALSE
rdkit.morgan_fp_size [64, 9192] Integer FALSE
rdkit.move_unmmapped_reactants_to_agents オン、オフ ブール値 FALSE
rdkit.rdkit_fp_size [64, 9192] Integer FALSE
rdkit.reaction_difference_fp_size [64, 9192] Integer FALSE
rdkit.reaction_difference_fp_type [1, 3] Integer FALSE
rdkit.reaction_sss_fp_size [64, 9192] Integer FALSE
rdkit.reaction_sss_fp_type [1, 5] Integer FALSE
rdkit.sss_fp_size [64, 4096] Integer FALSE
rdkit.tanimoto_threshold [0, 1] 浮動小数点数 FALSE
rdkit.threshold_unmapped_reactant_atoms [0, 1] 浮動小数点数 FALSE

次の表に、ベンダーのデフォルトとは異なるフラグのデフォルト値を指定します。

フラグ 値/数式
shared_buffers 1/3 * totalMemory(MiB)
max_wal_size 1,504 MB
max_connections 合計メモリ >= ? 値
120 GB 1000
60 GB 800
15 GB 500
7.5 GB 400
6 GB 200
3.75 GB 100
1.7GB 50
0 25
effective_cache_size 2/5 * totalMemory
temp_file_limit 1/10 * storageSize
log_connections オン
log_disconnections オン
pgaudit.log all, -misc
log_hostname オン
pgaudit.log_parameter オン

Oracle データベース フラグ

フラグ 範囲 タイプ 再起動が必要
aq_tm_processes [0, 40] Integer FALSE
background_core_dump FULL、PARTIAL 列挙型 FALSE
bitmap_merge_area_size [0, 2147483647] Integer TRUE
control_management_pack_access NONE、DIAGNOSTIC、DIAGNOSTIC+TUNING 列挙型 FALSE
cursor_sharing FORCE、EXACT、SIMILAR 列挙型 FALSE
db_cache_size [0, 10995116277760] Integer FALSE
db_files [200, 20000] Integer TRUE
db_flashback_retention_target [30, 2147483647] Integer FALSE
db_keep_cache_size [0, 10995116277760] Integer FALSE
db_recovery_file_dest_size [0, 10995116277760] Integer FALSE
イベント 文字列 TRUE
large_pool_size [0, 10995116277760] Integer FALSE
log_buffer [2097152, 10995116277760] Integer TRUE
open_cursors [5, 65535] Integer FALSE
pga_aggregate_limit [0, 10995116277760] Integer FALSE
pga_aggregate_target [10485760, 10995116277760] Integer FALSE
プロセスの自動化 [100, 20000] Integer TRUE
recyclebin オン、オフ 列挙型 TRUE
resource_limit TRUE、FALSE ブール値 FALSE
sec_max_failed_login_attempts [1, 2147483647] Integer TRUE
sga_max_size [377487360, 10995116277760] Integer TRUE
sga_target [377487360, 10995116277760] Integer FALSE
shared_pool_size [0, 10995116277760] Integer FALSE
undo_retention [0, 2147483647] Integer FALSE
global_names TRUE、FALSE ブール値 FALSE
DBFIPS_140 TRUE、FALSE ブール値 TRUE
parallel_max_servers [0, 32767] Integer FALSE
_fix_control 文字列 FALSE
_sql_plan_directive_mgmt_control [0, 65535] Integer FALSE
_optimizer_dsdir_usage_control [0, 126] Integer FALSE
skip_unusable_indexes TRUE、FALSE ブール値 FALSE

次の表に、ベンダーのデフォルトとは異なるフラグのデフォルト値を指定します。

フラグ 値/数式
sga_target 4/5*（totalMemory-1GiB）
pga_aggregate_target 1/5*（totalMemory-1GiB）
open_cursors 300
プロセスの自動化 300
DBFIPS_140 TRUE
global_names TRUE

AlloyDB Omni データベース フラグ

フラグ 範囲 タイプ 再起動が必要
google_columnar_engine.enabled オン、オフ ブール値 TRUE
google_columnar_engine.memory_size_in_mb [128, 2147483647] Integer TRUE
anon.algorithm 文字列 FALSE
anon.maskschema 文字列 FALSE
anon.restrict_to_trusted_schemas オン、オフ ブール値 FALSE
anon.salt 文字列 FALSE
anon.sourceschema 文字列 FALSE
dbs.enable_anon オン、オフ ブール値 TRUE
dbs.enable_pg_bigm オン、オフ ブール値 TRUE
dbs.enable_pg_cron オン、オフ ブール値 TRUE
dbs.enable_pg_hint_plan オン、オフ ブール値 TRUE
dbs.enable_pg_squeeze オン、オフ ブール値 TRUE
dbs.enable_pg_wait_sampling オン、オフ ブール値 TRUE
pg_bigm.enable_recheck オン、オフ ブール値 FALSE
pg_bigm.gin_key_limit [0, 2147483647] Integer FALSE
pg_bigm.similarity_limit [0, 1] 浮動小数点数 FALSE
pg_hint_plan.debug_print off、on、detailed、verbose、0、1、2、3、no、yes、false、true 列挙型 TRUE
pg_hint_plan.enable_hint オン、オフ ブール値 FALSE
pg_hint_plan.enable_hint_table オン、オフ ブール値 FALSE
pg_hint_plan.message_level debug5、debug4、debug3、debug2、debug1、debug、info、notice、warning、error、log 列挙型 FALSE
pg_hint_plan.parse_messages debug5、debug4、debug3、debug2、debug1、debug、info、notice、warning、error、log 列挙型 FALSE
pg_stat_statements.max [100, 2147483647] Integer TRUE
pg_stat_statements.save オン、オフ ブール値 FALSE
pg_stat_statements.track none、top、all 列挙型 FALSE
pg_stat_statements.track_utility オン、オフ ブール値 FALSE
pg_wait_sampling.history_period [1, 2147483647] Integer FALSE
pg_wait_sampling.history_size [1, 2147483647] Integer FALSE
pg_wait_sampling.profile_period [1, 2147483647] Integer FALSE
pg_wait_sampling.profile_pid オン、オフ ブール値 FALSE
pg_wait_sampling.profile_queries オン、オフ ブール値 FALSE
pgaudit.log read、write、function、role、ddl、misc、misc_set、
all、none、-read、-write、-function、-role、-ddl、
-misc、-misc_set、-all、-none		 繰り返しの文字列 FALSE
pgaudit.log_client オン、オフ ブール値 FALSE
pgaudit.log_parameter オン、オフ ブール値 FALSE
pgaudit.log_level debug5、debug4、debug3、debug2、debug1、info、
notice、warning、error、log		 列挙型 FALSE
pgaudit.log_relation オン、オフ ブール値 FALSE
pgaudit.log_catalog オン、オフ ブール値 FALSE
pgaudit.role 文字列 FALSE
pgaudit.log_statement_once オン、オフ ブール値 FALSE
pglogical.batch_inserts オン、オフ ブール値 TRUE
pglogical.conflict_log_level debug5、debug4、debug3、debug2、debug1、info、notice、warning、error、log、fatal、panic 列挙型 FALSE
pglogical.conflict_resolution error、apply_remote、keep_local、last_update_wins、first_update_wins 列挙型 FALSE
pglogical.extra_connection_options 文字列 FALSE
pglogical.synchronous_commit オン、オフ ブール値 TRUE
pglogical.use_spi オン、オフ ブール値 TRUE
pgtt.enabled オン、オフ ブール値 FALSE
plv8.execution_timeout [1, 65536] Integer FALSE
plv8.memory_limit [256, 3096] Integer FALSE
plv8.start_proc 文字列 FALSE