すべてのプロダクト
Search
ドキュメントセンター

PolarDB:PolarDB-X の計算レイヤーパラメーター

最終更新日:Nov 09, 2025

このトピックでは、PolarDB-X の計算レイヤーパラメーターについて説明します。

説明

PolarDB-X Enterprise インスタンスのみが計算レイヤーパラメーターをサポートします。

変数名

再起動が必要

デフォルト値

スコープ

説明

PLAN_CACHE

いいえ

FALSE

[TRUE|FALSE]

プランキャッシュを有効または無効にします。

ENABLE_RECYCLEBIN

いいえ

FALSE

[TRUE|FALSE]

ゴミ箱を有効または無効にします。

SHOW_TABLES_CACHE

いいえ

FALSE

[TRUE|FALSE]

SHOW TABLES 文の結果をキャッシュするかどうかを制御します。

MERGE_CONCURRENT

いいえ

FALSE

[TRUE|FALSE]

完全な並列実行を有効または無効にします。このパラメーターは主に、データ定義言語 (DDL) 文と完全にプッシュダウンされる単純なクエリの並列処理の次数 (DOP) に影響します。

MERGE_UNION

いいえ

FALSE

[TRUE|FALSE]

このパラメーターはデフォルトで無効になっています。有効にすると、物理 SQL 文に対して UNION 最適化は実行されず、プッシュダウンされた物理 SQL 文は順次実行されます。

MERGE_UNION_SIZE

いいえ

-1

[0-10000]

UNION を使用してマージする物理 SQL 文の数。デフォルトでは、システムは接続プール内の利用可能な接続数に基づいてこの値を自動的に決定します。

TABLE_META_CACHE_EXPIRE_TIME

いいえ

300

[0-180000]

メタデータキャッシュの生存時間 (TTL) です。

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]

Timestamp Oracle (TSO) タイムスタンプを取得するためのタイムアウトです。

MAX_TRX_DURATION

いいえ

28800

[1-180000]

トランザクションの物理的なタイムアウトです。

TRANSACTION_ISOLATION

いいえ

REPEATABLE-READ

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

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

GROUP_CONCURRENT_BLOCK

いいえ

TRUE

[TRUE|FALSE]

Massively Parallel Processing (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

いいえ

10000

[1-10000000]

シーケンスのステップサイズです。デフォルト値は 100,000 です。

MERGE_DDL_TIMEOUT

いいえ

0

[1-10000000]

物理 DDL 接続のタイムアウトです。デフォルト値は 0 で、タイムアウトがないことを意味します。

MERGE_DDL_CONCURRENT

いいえ

FALSE

[FALSE|TRUE]

DDL 文を完全な並列モードで実行するかどうかを制御します。デフォルトでは、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` 文のキャッシュバッファーサイズです。デフォルト値は 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]

全テーブルに対する `DELETE` および `UPDATE` 操作を禁止するかどうかを制御します。

GROUP_SEQ_CHECK_INTERVAL

はい

60

[1-36000]

明示的に挿入された値をチェックする間隔です。単位: 秒。

JOIN_BLOCK_SIZE

はい

300

[1-100000]

動的プルーニングが無効な場合の Batched Key Access (BKA) join の `IN` 値の数です。

LOOKUP_JOIN_MAX_BATCH_SIZE

はい

6400

[1-100000]

BKA join の `IN` 値の最大数です。

LOOKUP_JOIN_MIN_BATCH_SIZE

はい

100

[1-100000]

BKA join の `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 で、これは 1 秒あたり 10,000 行の制限を示します。

PARALLELISM

いいえ

-1

[1-1024]

シングルノードの DOP です。デフォルトでは、システムはノードの仕様に基づいてこの値を決定します。

LOGICAL_DB_TIME_ZONE

いいえ

SYSTEM

[SYSTEM|±HH:mm]

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

MPP_PARALLELISM

いいえ

-1

[1-1024]

MPP 実行モードの DOP です。デフォルトでは、システムはノードの仕様に基づいてこの値を決定します。

DATABASE_PARALLELISM

いいえ

0

[0-1024]

単一のクエリが 1 つのデータノード (DN) に同時に送信できる SQL 文の数です。この値は、スキャン操作の DOP を計算するために使用されます。

POLARDBX_PARALLELISM

いいえ

0

[0-1024]

1 つの計算ノード (CN) 上の単一クエリの最大 DOP です。デフォルト値は 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]

クエリレベルのメモリプールのメモリ制限です。デフォルト値は、グローバル接続プールサイズの 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]

ストレージノードあたりのキャッシュされたセッションの最大数です。これは、独自プロトコルを使用するセッションに適用されます。

XPROTO_MAX_DN_CONCURRENT

いいえ

500

[1-8192]

ストレージノードあたりの同時リクエストの最大数です。これは、独自プロトコルを使用するリクエストに適用されます。2023 年 10 月 23 日に、ほとんどの本番環境およびストレステストシナリオのニーズを満たすために、デフォルト値が 2000 に変更されました。

XPROTO_MAX_DN_WAIT_CONNECTION

いいえ

32

[1-8192]

ストレージノードあたりの待機リクエストの最大数です。これは、独自プロトコルを使用するリクエストに適用されます。2024 年 6 月 13 日に、ほとんどの本番環境およびストレステストシナリオのニーズを満たすために、デフォルト値が 2000 に変更されました。

MERGE_SORT_BUFFER_SIZE

いいえ

2048

[1024-81920]

TableScan レイヤーでのマージソート操作のバッファーサイズです。デフォルト値は 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]

プルーニングが有効な場合の BKA join のシャードあたりの `IN` 値の数です。

ENABLE_RUNTIME_FILTER

いいえ

TRUE

[TRUE|FALSE]

ランタイムフィルターを有効または無効にします。

FEEDBACK_WORKLOAD_AP_THRESHOLD

いいえ

FALSE

[TRUE|FALSE]

分析処理 (AP) クエリに対するハイブリッドトランザクション/分析処理 (HTAP) フィードバックを有効または無効にします。

FEEDBACK_WORKLOAD_TP_THRESHOLD

いいえ

FALSE

[TRUE|FALSE]

トランザクション処理 (TP) クエリに対する HTAP フィードバックを有効または無効にします。

MASTER_READ_WEIGHT

いいえ

-1

[0-100]

読み取りトラフィックの分散を決定する値です。読み取り専用データノードにルーティングされるトラフィックの割合は、`(100 - MASTER_READ_WEIGHT)` として計算されます。残りはプライマリインスタンスのデータノードにルーティングされます。

SHOW_ALL_PARAMS

いいえ

FALSE

[TRUE|FALSE]

`SHOW VARIABLES` がすべてのパラメーターを表示するかどうかを制御します。

FORCE_READ_OUTSIDE_TX

いいえ

FALSE

[TRUE|FALSE]

トランザクション内で単一のデータベースシャードへの複数の接続を強制的に開くかどうかを制御します。

ENABLE_COROUTINE

はい

FALSE

[TRUE|FALSE]

Wisp コルーチンを有効または無効にします。

TRUNCATE_TABLE_WITH_GSI

いいえ

FALSE

[TRUE|FALSE]

グローバルセカンダリインデックス (GSI) を持つテーブルで `TRUNCATE TABLE` を許可するかどうかを制御します。

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]

オプティマイザーがコストベースオプティマイザー (CBO) の並べ替えに SemiJoin を含めることができるかどうかを制御します。

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]

オプティマイザーが Project プッシュダウンを実行できるかどうかを制御します。

ENABLE_PUSH_JOIN

いいえ

TRUE

[TRUE|FALSE]

オプティマイザーが Join プッシュダウンを実行できるかどうかを制御します。

ENABLE_PUSH_AGG

いいえ

TRUE

[TRUE|FALSE]

オプティマイザーが集約プッシュダウンを実行できるかどうかを制御します。

ENABLE_CBO_PUSH_AGG

いいえ

TRUE

[TRUE|FALSE]

オプティマイザーが join を介して集約をプッシュできるかどうかを制御します。

ENABLE_PUSH_SORT

いいえ

TRUE

[TRUE|FALSE]

オプティマイザーが Sort プッシュダウンを実行できるかどうかを制御します。

ENABLE_STATISTIC_FEEDBACK

いいえ

TRUE

[TRUE|FALSE]

フィードバックベースの統計修正を有効にするかどうかを制御します。

ENABLE_CBO_PUSH_JOIN

いいえ

TRUE

[TRUE|FALSE]

オプティマイザーが join パススルー最適化を実行できるかどうかを制御します。

ENABLE_SORT_JOIN_TRANSPOSE

いいえ

TRUE

[TRUE|FALSE]

オプティマイザーが join を介してソートをプッシュできるかどうかを制御します。

CHUNK_SIZE

いいえ

1024

[1-10240]

エグゼキュータのバッチサイズです。エグゼキュータは、このサイズのバッチでデータを処理します。

ENABLE_SORT_MERGE_JOIN

いいえ

TRUE

[TRUE|FALSE]

クエリプランの最適化中にオプティマイザーが SortMergeJoin ノードを生成できるかどうかを制御します。

ENABLE_BKA_PRUNING

いいえ

TRUE

[TRUE|FALSE]

BKA join のプルーニング機能を有効または無効にします。

ENABLE_SPM

いいえ

TRUE

[TRUE|FALSE]

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

ENABLE_EXPRESSION_VECTORIZATION

いいえ

TRUE

[TRUE|FALSE]

式のベクトル化を有効または無効にします。

FORCE_DDL_ON_LEGACY_ENGINE

いいえ

TRUE

[TRUE|FALSE]

新しい DDL エンジンが有効になっているかどうかを指定します。

PURE_ASYNC_DDL_MODE

いいえ

FALSE

[TRUE|FALSE]

DDL タスクを非ブロッキング (非同期) モードで実行するかどうかを制御します。有効にすると、クライアントは DDL 文を送信した直後に戻ります。実行ステータスは `SHOW [FULL] DDL` を実行して確認できます。

DDL_JOB_REQUEST_TIMEOUT

いいえ

90000

[1-9223372036854775807]

DDL ジョブの最大タイムアウトです。デフォルト値は 25 日です。

LOGICAL_DDL_PARALLELISM

いいえ

1

[1-10240]

論理 DDL 実行の DOP です。値が 1 の場合、DDL タスクは順次実行されます。

ENABLE_BROADCAST_RANDOM_READ

いいえ

TRUE

[TRUE|FALSE]

ブロードキャストテーブルのランダム読み取り最適化を有効または無効にします。

STORAGE_DELAY_THRESHOLD

いいえ

16777216s

[0-16777216]

CN が認識する DN の同期遅延のしきい値です。読み取り専用 DN の遅延がこのしきい値を超えた場合、読み取りトラフィックは `DELAY_EXECUTION_STRATEGY` ポリシーに基づいて処理されます。

DELAY_EXECUTION_STRATEGY

いいえ

CONTINUE_TO_SLAVE

[CONTINUE_TO_SLAVE | CHANGE_TO_MASTER | THROW_EXCEPTION]

読み取り専用 DN の遅延が `STORAGE_DELAY_THRESHOLD` を超えた場合に使用するポリシーです。有効な値:

  • 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 にルーティングされます。

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 文の割合です。