このページでは、AlloyDB に固有のさまざまなサービス機能を有効にして管理するために AlloyDB for PostgreSQL が使用するデータベース フラグについて説明します。AlloyDB がサポートするすべてのデータベース フラグの一覧については、サポートされているデータベース フラグをご覧ください。
「インスタンスの再起動」が「あり」のフラグは、そのインスタンスでこのフラグを設定、削除、変更するたびに、AlloyDB がインスタンスを再起動することを意味します。フラグの値は、再度変更するまでインスタンスで保持されます。
alloydb.audit_log_line_prefix
| タイプ | string |
| デフォルト | "%m [%p]: [%l-1] db=%d,user=%u |
| インスタンスの再起動 | あり |
各監査ログ行の接頭辞に関する情報を制御します。空白のままにすると、接頭辞は使用されません。
alloydb.enable_pgaudit
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで pgaudit 拡張機能を使用できるかどうかを設定します。パラメータを on に設定してインスタンスを再起動します。次に、CREATE
EXTENSION コマンドを使用して、インスタンス内の個々のデータベースに pgaudit 拡張機能を追加します。
pgaudit 拡張機能は、PostgreSQL が提供する標準ロギング機能を使用して、詳細なセッションとオブジェクトの監査ロギングを提供します。
alloydb.enable_auto_explain
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで auto_explain 拡張機能を使用できるかどうかを設定します。パラメータを on に設定してインスタンスを再起動します。
auto_explain 拡張機能を使用すると、トラブルシューティングなどで、実行速度が遅いステートメントの実行プランを自動的にロギングできます。これは、EXPLAIN コマンドの機能を自動化する手段となります。
alloydb.enable_pg_bigm
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで pg_bigm 拡張機能を使用できるかどうかを設定します。パラメータを on に設定してインスタンスを再起動します。次に、CREATE
EXTENSION コマンドを使用して、インスタンス内の個々のデータベースに pg_bigm 拡張機能を追加します。
pg_bigm 拡張機能は、2 グラム（バイグラム）インデックスを使用して PostgreSQL で全文検索機能を提供します。これにより、全文検索の速度が向上します。
alloydb.enable_pg_cron
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで pg_cron 拡張機能を使用できるかどうかを設定します。パラメータを on に設定してインスタンスを再起動します。次に、CREATE
EXTENSION コマンドを使用して、インスタンス内の個々のデータベースに pg_cron 拡張機能を追加します。
pg_cron 拡張機能は、データベース内で拡張機能として実行される PostgreSQL 用の cron ベースのジョブ スケジューラを提供します。構文は通常の cron と同じですが、データベースから直接 PostgreSQL コマンドをスケジュールできます。
alloydb.enable_pg_hint_plan
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで pg_hint_plan 拡張機能を使用できるかどうかを設定します。パラメータを on に設定してインスタンスを再起動します。次に、CREATE EXTENSION コマンドを使用して、インスタンス内の個々のデータベースに pg_hint_plan 拡張機能を追加します。
pg_hint_plan 拡張機能を使用すると、SQL コメントの説明であるヒントを使用して PostgreSQL の実行プランを改善できます。
alloydb.enable_pg_wait_sampling
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB が待機イベントのサンプリング統計情報を収集できるようにします。パラメータを on に設定してインスタンスを再起動します。次に、CREATE EXTENSION コマンドを使用して、インスタンス内の個々のデータベースに pg_wait_sampling 拡張機能を追加します。
pg_wait_sampling 拡張機能は、待機イベントデータを集計して要約します。これらのビューに対してクエリを実行すると、さまざまな待機イベントの待ち時間、頻度、相対的な重要性に関する分析情報を取得できます。
alloydb.enable_pglogical
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで pglogical 拡張機能を使用できるかどうかを設定します。パラメータを on に設定してインスタンスを再起動します。次に、CREATE EXTENSION コマンドを使用して、インスタンス内の個々のデータベースに pglogical 拡張機能を追加します。
pglogical 拡張機能は、パブリッシュとサブスクライブに基づくモデルを使用して、PostgreSQL の論理ストリーミング レプリケーションを提供します。
alloydb.iam_authentication
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで Identity and Access Management（IAM）認証を使用できるようにします。
alloydb.logical_decoding
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
AlloyDB インスタンスで PostgreSQL 論理デコード インフラストラクチャを有効にします。
論理デコードは、データ変更を外部コンシューマーにストリーミングするために必要なインフラストラクチャを提供します。
alloydb.log_throttling_window
| タイプ | integer |
| デフォルト | 0 |
| インスタンスの再起動 | なし |
指定された期間中に受信した重複するログ メッセージを AlloyDB が記録するかどうかを制御します。
0 より大きい値に設定すると、AlloyDB はログ メッセージを記録するたびに、数秒間のタイマーを開始します。AlloyDB がタイマーの期限切れ前に同じログ メッセージを受信した場合、そのメッセージは記録されません。タイマーが期限切れになると、AlloyDB は、記録されたログ メッセージと同じメッセージが次に発生したときに、スキップしたメッセージの数を追加します。
0 に設定すると、AlloyDB は重複するログ メッセージをすべて記録します。
alloydb.promote_cancel_to_terminate
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | なし |
true に設定すると、AlloyDB で発生したロック タイムアウト、ステートメント タイムアウト、復元（リプレイ）競合などの問題が原因で発生したクエリのキャンセル リクエストが、バックエンド強制終了リクエストに昇格します。
AlloyDB は、キャンセル リクエストを昇格させることで、停止したバックエンドがログの再生や他のバックエンドを妨げないようにします。
alloydb.pg_shadow_select_role
| タイプ | string |
| デフォルト | 空の文字列 |
| インスタンスの再起動 | なし |
pg_shadow ビューのクエリ権限の付与に使用する PostgreSQL ロールの名前。
alloydb_password
| タイプ | string |
| デフォルト | 空の文字列 |
| インスタンスの再起動 | なし |
AlloyDB Omni のパスワード ポリシーを設定および管理するための関数を提供します。アプリケーションのデータベース ユーザーが、組み込みのパスワードベースの方法を使用して AlloyDB Omni で認証する場合は、安全なパスワードを適用することで認証をより安全にできます。
詳細については、パスワード ポリシーを使用して組み込み認証を管理するをご覧ください。
alloydb_scann
| タイプ | string |
| デフォルト | 空の文字列 |
| インスタンスの再起動 | なし |
AlloyDB Omni がベクトル検索ワークロードを高パフォーマンスかつ効率的に処理できるようにする機能を提供します。
詳細については、インデックスとクエリベクトルを作成するをご覧ください。
alloydb_ai_nl
| タイプ | string |
| デフォルト | 空の文字列 |
| インスタンスの再起動 | なし |
自然言語を使用して AlloyDB を安全にクエリできる機能を提供します。この拡張機能は、データにセキュリティ レイヤを適用する parameterized_views 拡張機能と連携して動作します。
詳細については、自然言語を使用して SQL クエリを生成するをご覧ください。
parameterized_views
| タイプ | string |
| デフォルト | 空の文字列 |
| インスタンスの再起動 | なし |
自然言語クエリが SQL クエリに変換されるときにセキュリティ レイヤを追加する機能を提供します。この拡張機能は、alloydb_ai_nl 拡張機能と連携して機能します。
詳細については、自然言語を使用して SQL クエリを生成するをご覧ください。
alloydb_ai_nl.enabled
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | ○ |
AlloyDB AI の自然言語機能が有効かどうかを制御します。
scann.enable_preview_features
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | あり |
プレビュー版で利用可能な次の機能を使用できるようになります。
* インデックスの自動メンテナンス: データセットが大きくなると、AlloyDB Omni は大きな外れ値のパーティションを分割し、より良い QPS と検索結果を提供できるように、インデックスを段階的に管理します。* 遅延インデックス作成: 空の行または行数が不十分なテーブルのインデックス作成を遅延させます。* 4 レベルのツリー インデックスは、10 億を超えるベクトル行を含むテーブルをサポートします。scann.enable_index_maintenance
| タイプ | boolean |
| デフォルト | on |
| インスタンスの再起動 | ○ |
自動ベクトル インデックス メンテナンス機能が有効かどうかを制御します。
scann.max_background_workers
| タイプ | integer |
| デフォルト | 1 |
| インスタンスの再起動 | ○ |
自動ベクトル インデックスのメンテナンスに使用されるバックグラウンド ワーカーの数を制御します。詳細については、自動メンテナンスのスループットを増やすをご覧ください。
scann.maintenance_background_naptime_s
| タイプ | integer |
| デフォルト | 1 |
| インスタンスの再起動 | ○ |
自動ベクトル インデックス メンテナンスのバックグラウンド ワーカー実行間の最小遅延を制御します。デフォルト値は 1 分です。
scann.max_allowed_num_levels
| タイプ | integer |
| デフォルト | 2 |
| 最小値 | 1 |
| 最大値 | 3 |
| インスタンスの再起動 | × |
ScaNN インデックスの作成時に max_num_levels に設定できる最大値を決定します。
parameterized_views.enabled
| タイプ | boolean |
| デフォルト | off |
| インスタンスの再起動 | ○ |
パラメータ化されたビュー機能が有効かどうかを制御します。
parameterized_views.enabled フラグの設定は自動的に複製されません。各インスタンスで手動で複製する必要があります。レプリカでパラメータ化されたビューをクエリする前に、各レプリカ インスタンスで parameterized_views.enabled フラグを有効にする必要があります。詳細については、AlloyDB Omni のパラメータ化されたセキュアビューを使用してアプリケーション データ セキュリティを管理するをご覧ください。
parameterized_views.json_results_max_rows
| タイプ | integer |
| デフォルト | 1,000,000 |
| インスタンスの再起動 | × |
execute_parameterized_query() 関数からの JSON 結果の最大行数を設定します。
parameterized_views.json_results_max_size
| タイプ | integer |
| デフォルト | 1,048,576 |
| インスタンスの再起動 | × |
execute_parameterized_query() 関数から最大 JSON 結果サイズを KB 単位で設定します。
parameterized_views.max_parallel_workers_per_gather
| タイプ | integer |
| デフォルト | -1 |
| インスタンスの再起動 | × |
パラメータ化されたビュー API を使用してクエリを実行するときに、エグゼキュータ ノードあたりの並列プロセス数の上限を設定します。-1 は、制限がないことを意味します。この上限は、max_parallel_workers_per_gather よりも制限が厳しい場合にのみ適用されます。
parameterized_views.statement_timeout
| タイプ | integer |
| デフォルト | 0 |
| インスタンスの再起動 | × |
パラメータ化されたビュー API を使用して実行されるステートメントの最大許容時間をミリ秒単位で設定します。0 は、制限がないことを意味します。この上限は、statement_timeout よりも制限が厳しい場合にのみ適用されます。
parameterized_views.temp_file_limit
| タイプ | integer |
| デフォルト | -1 |
| インスタンスの再起動 | × |
パラメータ化されたビュー API を使用して実行される各プロセスで使用されるすべての一時ファイルの合計サイズを kB 単位で制限します。-1 は、制限がないことを意味します。この上限は、temp_file_limit よりも制限が厳しい場合にのみ適用されます。
parameterized_views.work_mem
| タイプ | integer |
| デフォルト | 0 |
| インスタンスの再起動 | × |
パラメータ化されたビュー API を使用して実行されるクエリ ワークスペースで使用される最大メモリを kB 単位で設定します。0 は、制限がないことを意味します。この上限は、work_mem よりも制限が厳しい場合にのみ適用されます。
vector_assist.enabled
| タイプ | boolean |
| デフォルト | on |
| インスタンスの再起動 | いいえ |
ベクトル アシスト機能が有効かどうかを制御します。