PolarDB:PolarDB-X のコンピューティングレイヤーのパラメーターリファレンス

パラメーター

再起動の要否

デフォルト値

値の範囲

説明

PLAN_CACHE

不要

FALSE

[TRUE|FALSE]

プランキャッシュを有効にするかどうかを指定します。

ENABLE_RECYCLEBIN

不要

FALSE

[TRUE|FALSE]

ごみ箱を有効にするかどうかを指定します。

SHOW_TABLES_CACHE

不要

FALSE

[TRUE|FALSE]

SHOW TABLES の結果をキャッシュするかどうかを指定します。

MERGE_CONCURRENT

不要

FALSE

[TRUE|FALSE]

完全並列実行のスイッチです。このパラメーターは、主に DDL 文および完全にプッシュダウンされたシンプルクエリの並列度に影響します。

MERGE_UNION

不要

FALSE

[TRUE|FALSE]

デフォルトでは無効です。有効にすると、物理 SQL 文は UNION 最適化を実行せず、プッシュダウンされた物理 SQL 文はシリアルに実行されます。

MERGE_UNION_SIZE

不要

-1

[0-10000]

UNION によってマージされる物理 SQL 文の数です。デフォルト値は、コネクションプール内の利用可能なコネクション数に基づいて適応的に決定されます。

TABLE_META_CACHE_EXPIRE_TIME

不要

300

[0-180000]

メタデータキャッシュの有効期限 (単位：秒) です。

COLUMN_LABEL_INSENSITIVE

不要

TRUE

[FALSE|TRUE]

クエリ結果のカラム名が大文字と小文字を区別するかどうかを指定します。

RECORD_SQL

不要

TRUE

[FALSE|TRUE]

監査ログのスイッチです。

SOCKET_TIMEOUT

不要

900000

[0-3600000]

物理 SQL 文のタイムアウト期間 (単位：ミリ秒) です。

TRANSACTION_POLICY

不要

TSO

[XA|TSO|TSO_READONLY]

トランザクションポリシーです。

SHARE_READ_VIEW

不要

FALSE

[TRUE|FALSE]

共有 ReadView のスイッチです。

ENABLE_TRX_SINGLE_SHARD_OPTIMIZATION

不要

TRUE

[TRUE|FALSE]

単一シャードトランザクション最適化のスイッチです。

GET_TSO_TIMEOUT

不要

10

[1-1800]

TSO タイムスタンプを取得する際のタイムアウト期間 (単位：秒) です。

MAX_TRX_DURATION

不要

28800

[1-180000]

トランザクションの物理タイムアウト期間 (単位：秒) です。

TRANSACTION_ISOLATION

不要

REPEATABLE-READ

[READ-UNCOMMITTED|READ-COMMITTED|REPEATABLE-READ|SERIALIZABLE]

トランザクション分離レベルです。

GROUP_CONCURRENT_BLOCK

不要

TRUE

[TRUE|FALSE]

非 MPP モードにおけるデータベースレベルの実行ポリシーです。

SEQUENTIAL_CONCURRENT_POLICY

不要

FALSE

[TRUE|FALSE]

非 MPP モードにおける単一同時実行の実行ポリシーです。

DML_SKIP_DUPLICATE_CHECK_FOR_PK

不要

TRUE

[TRUE|FALSE]

DML 操作中にプライマリキーの競合チェックをスキップするかどうかを指定します。

DML_SKIP_CRUCIAL_ERR_CHECK

不要

FALSE

[TRUE|FALSE]

DML エラーが発生したトランザクションでもコミットを継続できるかどうかを指定します。

DML_USE_RETURNING

不要

TRUE

[TRUE|FALSE]

RETURNING 最適化を使用するかどうかを指定します。

BROADCAST_DML

不要

FALSE

[TRUE|FALSE]

分散トランザクションなしでブロードキャストテーブルへの書き込みを許可するかどうかを指定します。

SEQUENCE_STEP

不要

100000

[1-10000000]

SEQUENCE のステップです。デフォルト値は 100000 です。

MERGE_DDL_TIMEOUT

不要

0

[1-10000000]

DDL 実行時の物理コネクションのタイムアウト期間 (単位：ミリ秒) です。デフォルト値の 0 は、タイムアウトなしを意味します。

MERGE_DDL_CONCURRENT

不要

FALSE

[FALSE|TRUE]

DDL 文が完全並列モードを使用するかどうかを指定します。デフォルトでは、データベースレベルの同時実行が使用されます。

SLOW_SQL_TIME

不要

1000

[1-180000]

スロー SQL のしきい値 (単位：ミリ秒) です。

LOAD_DATA_BATCH_INSERT_SIZE

不要

1024

[1-180000]

LOAD DATA でのバッチ挿入あたりのレコード数です。

LOAD_DATA_CACHE_BUFFER_SIZE

不要

60

[1-180000]

LOAD DATA のキャッシュサイズ (単位：MB) です。デフォルト値は 60 MB です。主にフロー制御に使用されます。

MAX_ALLOWED_PACKET

不要

16777216

[4194304-33554432]

最大パケットサイズ (単位：バイト) です。

KILL_CLOSE_STREAM

不要

FALSE

[FALSE|TRUE]

物理コネクションの早期ストリーム終了を有効にするかどうかを指定します。

ALLOW_SIMPLE_SEQUENCE

不要

FALSE

[FALSE|TRUE]

シンプルシーケンスを許可するかどうかを指定します。

MAX_PARAMETERIZED_SQL_LOG_LENGTH

不要

5000

[1-1000000]

ログに記録するパラメータ化 SQL の最大長です。

FORBID_EXECUTE_DML_ALL

不要

TRUE

[TRUE|FALSE]

全テーブルの削除または更新を禁止するかどうかを指定します。

GROUP_SEQ_CHECK_INTERVAL

必要

60

[1-36000]

明示的な値挿入をチェックする間隔 (単位：秒) です。

JOIN_BLOCK_SIZE

必要

300

[1-100000]

動的プルーニングを使用しない場合の、BKAJOIN 実行時の IN 値の数です。

LOOKUP_JOIN_MAX_BATCH_SIZE

必要

6400

[1-100000]

BKAJOIN 実行時の IN 値の最大数です。

LOOKUP_JOIN_MIN_BATCH_SIZE

必要

100

[1-100000]

BKAJOIN 実行時の IN 値の最小数です。

PURGE_TRANS_INTERVAL

必要

300

[1-180000]

トランザクションログのクリーンアップ間隔 (単位：秒) です。

PURGE_TRANS_BEFORE

必要

1800

[1-180000]

クリーンアップするトランザクションログの経過時間 (単位：秒) です。

ENABLE_BACKGROUND_STATISTIC_COLLECTION

不要

TRUE

[TRUE|FALSE]

統計情報の収集を許可するかどうかを指定します。

GENERAL_DYNAMIC_SPEED_LIMITATION

不要

-1

[-1-10000000]

データバックフィルおよび検証のレート制限です。デフォルト値の -1 は、毎秒 10,000 行の制限値を意味します。

PARALLELISM

不要

-1

[1-1024]

単一ノード並列実行の並列度です。デフォルト値はインスタンス仕様から導出されます。

LOGICAL_DB_TIME_ZONE

不要

SYSTEM

[SYSTEM|±HH:mm]

データベースのタイムゾーンです。

MPP_PARALLELISM

不要

-1

[1-1024]

MPP 実行モードの同時実行数です。デフォルト値はインスタンス仕様から導出されます。

DATABASE_PARALLELISM

不要

0

[0-1024]

クエリごとに単一のストレージノード (DN) へ同時にプッシュダウンできる SQL 文の数です。スキャン同時実行数の計算に使用されます。

POLARDBX_PARALLELISM

不要

0

[0-1024]

単一のコンピュートノード (CN) 上でのクエリごとの最大同時実行数。デフォルト値の 0 は、CPU コア数を使用することを意味します。

MPP_METRIC_LEVEL

不要

3

[0|1|2|3]

計算時の統計情報収集のレベルです。レベルが高いほど粒度が細かくなります。

ENABLE_COMPLEX_DML_CROSS_DB

不要

TRUE

[TRUE|FALSE]

データベース間の複雑な DML をサポートするかどうかを指定します。

PER_QUERY_MEMORY_LIMIT

必要

-1

[-1-9223372036854775807]

クエリレベルのメモリプールサイズ制限 (単位：バイト) 。デフォルト値の -1 は、グローバルコネクションプールの 3 分の 1 を使用することを意味します。

ENABLE_SPILL

不要

FALSE

[FALSE|TRUE]

一時テーブルをディスクに永続化するためのスイッチです。

CONN_POOL_MIN_POOL_SIZE

不要

20

[0-60]

物理データベースコネクションの最小数です。

CONN_POOL_MAX_POOL_SIZE

不要

60

[1-1600]

物理データベースコネクションの最大数です。

CONN_POOL_MAX_WAIT_THREAD_COUNT

不要

0

[-1-8192]

データベースシャードあたりの保留中のコネクションの最大数 (Druid) です。

CONN_POOL_IDLE_TIMEOUT

不要

30

[1-60]

アイドル状態の物理コネクションのタイムアウト期間 (単位：秒) です。

CONN_POOL_BLOCK_TIMEOUT

不要

5000

[1000-60000]

物理コネクションプールからコネクションを取得する際の最大待機時間 (単位：ミリ秒) です。

CONN_POOL_XPROTO_MAX_POOLED_SESSION_PER_INST

不要

512

[1-8192]

ストレージノード (DN) あたりのキャッシュされたセッションの最大数 (プライベートプロトコル) です。

XPROTO_MAX_DN_CONCURRENT

不要

2000

[1-8192]

ストレージノード (DN) あたりの同時リクエストの最大数 (プライベートプロトコル) 。デフォルト値は、ほとんどの本番環境およびストレステストのシナリオに対応するため、2023 年 10 月 23 日に 2000 に変更されました。

XPROTO_MAX_DN_WAIT_CONNECTION

不要

2000

[1-8192]

ストレージノード (DN) あたりの保留中のリクエストの最大数 (プライベートプロトコル) 。デフォルト値は、ほとんどの本番環境およびストレステストのシナリオに対応するため、2024 年 6 月 13 日に 2000 に変更されました。

MERGE_SORT_BUFFER_SIZE

不要

2048

[1024-81920]

TableScan レイヤーでのマージソートに使用するキャッシュサイズ。デフォルト値は 2048 KB (2 MB) です。

WORKLOAD_TYPE

不要

[AP|TP]

クエリのワークロードタイプを指定します。デフォルトでは、ワークロードはコストに基づいてインテリジェントに識別されます。

EXECUTOR_MODE

不要

[MPP|TP_LOCAL|AP_LOCAL]

実行モードを指定します。デフォルトでは、実行モードはワークロードに基づいて選択されます。

ENABLE_MASTER_MPP

不要

FALSE

[TRUE|FALSE]

プライマリインスタンスで MPP を有効にするかどうかを指定します。

LOOKUP_JOIN_BLOCK_SIZE_PER_SHARD

必要

50

[1-100000]

BKAJOIN 実行時にプルーニングを使用する場合の、シャードあたりの IN 値の数です。

ENABLE_RUNTIME_FILTER

不要

TRUE

[TRUE|FALSE]

ランタイムフィルターのスイッチです。

FEEDBACK_WORKLOAD_AP_THRESHOLD

不要

FALSE

[TRUE|FALSE]

AP クエリの HTAP FEEDBACK スイッチです。

FEEDBACK_WORKLOAD_TP_THRESHOLD

不要

FALSE

[TRUE|FALSE]

TP クエリの HTAP FEEDBACK スイッチです。

MASTER_READ_WEIGHT

不要

-1

[0-100]

クエリトラフィックは、(100 - MASTER_READ_WEIGHT) の比率で読み取り専用 DN にルーティングされます。

SHOW_ALL_PARAMS

不要

FALSE

[TRUE|FALSE]

すべての SHOW 変数を表示するかどうかを指定します。

FORCE_READ_OUTSIDE_TX

不要

FALSE

[TRUE|FALSE]

トランザクション内の単一データベースシャードで複数のコネクションを強制するかどうかを指定します。

ENABLE_COROUTINE

必要

FALSE

[TRUE|FALSE]

wisp コルーチンを有効にするかどうかを指定します。

TRUNCATE_TABLE_WITH_GSI

不要

FALSE

[TRUE|FALSE]

GSI を持つテーブルで TRUNCATE を許可するかどうかを指定します。

DDL_ON_GSI

不要

FALSE

[TRUE|FALSE]

GSI テーブルに対して直接 DDL 操作を許可するかどうかを指定します。

DML_ON_GSI

不要

FALSE

[TRUE|FALSE]

GSI テーブルに対して直接 DML 操作を許可するかどうかを指定します。

ENABLE_HASH_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に HashJoin ノードの生成を許可するかどうかを指定します。

ENABLE_BKA_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に BKAJoin ノードの生成を許可するかどうかを指定します。

ENABLE_NL_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に NLJoin ノードの生成を許可するかどうかを指定します。

ENABLE_SEMI_NL_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に SemiJoin を NLJoin に変換することを許可するかどうかを指定します。

ENABLE_SEMI_HASH_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に SemiJoin を HashJoin に変換することを許可するかどうかを指定します。

ENABLE_SEMI_BKA_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に SemiJoin を BKAJoin に変換することを許可するかどうかを指定します。

ENABLE_SEMI_SORT_MERGE_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に SemiJoin を MergeJoin に変換することを許可するかどうかを指定します。

ENABLE_MATERIALIZED_SEMI_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に SemiJoin を MaterializedJoin に変換することを許可するかどうかを指定します。

ENABLE_SEMI_JOIN_REORDER

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に SemiJoin が CBO 並べ替え最適化に参加することを許可するかどうかを指定します。

ENABLE_HASH_AGG

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に HashAgg ノードの生成を許可するかどうかを指定します。

ENABLE_PARTIAL_AGG

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に集計を 2 つのフェーズに分割することを許可するかどうかを指定します。

ENABLE_SORT_AGG

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に SortAgg ノードの生成を許可するかどうかを指定します。

ENABLE_PUSH_PROJECT

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に射影のプッシュダウンを許可するかどうかを指定します。

ENABLE_PUSH_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に結合のプッシュダウンを許可するかどうかを指定します。

ENABLE_PUSH_AGG

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に集計のプッシュダウンを許可するかどうかを指定します。

ENABLE_CBO_PUSH_AGG

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に結合の集計パススルーを許可するかどうかを指定します。

ENABLE_PUSH_SORT

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際にソートのプッシュダウンを許可するかどうかを指定します。

ENABLE_STATISTIC_FEEDBACK

不要

TRUE

[TRUE|FALSE]

フィードバックに基づく統計補正をサポートするかどうかを指定します。

ENABLE_CBO_PUSH_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に結合パススルー最適化を許可するかどうかを指定します。

ENABLE_SORT_JOIN_TRANSPOSE

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に結合のソートパススルーを許可するかどうかを指定します。

CHUNK_SIZE

不要

1024

[1-10240]

各エグゼキュータでの計算のバッチサイズです。

ENABLE_SORT_MERGE_JOIN

不要

TRUE

[TRUE|FALSE]

クエリ最適化の際に MergeJoin ノードの生成を禁止するかどうかを指定します。

ENABLE_BKA_PRUNING

不要

TRUE

[TRUE|FALSE]

BKAJoin プルーニングを有効にするかどうかを指定します。

ENABLE_SPM

不要

TRUE

[TRUE|FALSE]

実行計画管理を有効にするかどうかを指定します。

ENABLE_EXPRESSION_VECTORIZATION

不要

TRUE

[TRUE|FALSE]

ベクトル化式評価を有効にするかどうかを指定します。

FORCE_DDL_ON_LEGACY_ENGINE

不要

TRUE

[TRUE|FALSE]

新しい DDL エンジンを有効にするかどうかを指定します。デフォルトでは TRUE であり、新しい DDL エンジンが使用されます。

PURE_ASYNC_DDL_MODE

不要

FALSE

[TRUE|FALSE]

DDL タスクを非ブロッキング方式で実行するかどうかを指定します。有効にすると、クライアントは DDL 実行後すぐに戻り、SHOW [FULL] DDL を実行して実行ステータスを確認できます。

DDL_JOB_REQUEST_TIMEOUT

不要

2160000000

[1-9223372036854775807]

DDL 実行の最大タイムアウト期間 (単位：ミリ秒) 。デフォルト値は 2160000000 (25 日) です。

LOGICAL_DDL_PARALLELISM

不要

1

[1-10240]

論理 DDL 実行の同時実行数です。1 に設定すると、DDL が逐次実行されることを意味します。

ENABLE_BROADCAST_RANDOM_READ

不要

TRUE

[TRUE|FALSE]

ブロードキャストテーブルのランダム読み取り最適化を有効にするかどうかを指定します。

STORAGE_DELAY_THRESHOLD

不要

16777216 s

[0-16777216]

クエリ中にコンピュートノード (CN) がストレージノード (DN) のレイテンシーを認識するためのしきい値です。レイテンシーがしきい値を超えると、読み取り専用 DN にルーティングされた読み取り専用トラフィックは、DELAY_EXECUTION_STRATEGY パラメーターに基づいて処理されます。

DELAY_EXECUTION_STRATEGY

不要

CONTINUE_TO_SLAVE

[CONTINUE_TO_SLAVE | CHANGE_TO_MASTER | THROW_EXCEPTION]

読み取り専用 DN のレイテンシーがしきい値を超えた場合に、次の 3 つの値を設定できます：

• CONTINUE_TO_SLAVE：読み取り専用 DN にルーティングされた読み取り専用トラフィックは、レイテンシーがしきい値を超えた読み取り専用 DN に引き続きルーティングできます。

• CHANGE_TO_MASTER：読み取り専用トラフィックは、レイテンシーが正常な読み取り専用 DN に優先的にルーティングされます。すべての読み取り専用 DN がレイテンシーしきい値を超えている場合、トラフィックはプライマリインスタンスの DN にルーティングされます。

• THROW_EXCEPTION：すべての読み取り専用 DN がレイテンシーしきい値を超えている場合、読み取り専用 DN にルーティングされたクエリはエラーを返します。

STORAGE_BUSY_THRESHOLD

不要

100

[0-16777216]

複数の読み取り専用 DN が存在する場合、読み取り専用 DN のアクティブスレッド数がしきい値を超えると、その DN はビジー状態と見なされ、読み取り専用トラフィックはその DN にはルーティングされません。すべての読み取り専用 DN がビジー状態の場合、読み取り専用トラフィックはそのうちの 1 つにランダムにルーティングされます。

ENABLE_CONSISTENT_REPLICA_READ

不要

TRUE

[TRUE|FALSE]

一貫性読み取り要件のスイッチです。

TRUE：読み取り専用 DN にルーティングされたトラフィックは一貫性読み取り要件を満たし、最新のコミット済みデータを読み取ることができます。

FALSE：読み取り専用 DN にルーティングされたトラフィックのデータの鮮度は、プライマリインスタンスとセカンダリインスタンス間の同期レイテンシーに依存します。

SUPPORT_INSTANT_ADD_COLUMN

不要

OFF

[ON|OFF]

カラム即時追加機能のスイッチです。SET GLOBAL 文を使用して有効にします。

ENABLE_STATEMENTS_SUMMARY

不要

TRUE

[TRUE|FALSE]

SQL 集計のスイッチです。

STATEMENTS_SUMMARY_PERCENT

不要

1

[0-100]

SQL 集計のパーセンテージです。