PolarDB:パラメーターの概要

パラメーター名

スコープ

説明

implicit_primary_key

グローバル

テーブルが主キーなしで作成された場合に、暗黙の主キーを自動的に生成するかどうかを制御します。有効値：

• ON：暗黙の主キーを自動的に追加します。

• OFF：暗黙の主キーを追加しません。

パラメーター名

スコープ

説明

loose_allow_implicit_imci_alter_comment

セッション

テーブルレベルのコメントを変更することで IMCI を作成できるかどうかを指定します。有効値：

• ON (デフォルト)：コメントを変更して IMCI を作成します。

• OFF：コメントを変更せずに IMCI を作成します。

loose_imci_enable_pack_order_key

グローバル/セッション

IMCI を作成する際のデータソート機能を制御します。有効値：

• ON (デフォルト)：データソートを有効にします。

• OFF：データソートを無効にします。

loose_imci_enable_pack_order_key_changed_rebuild

グローバル

IMCI のソート順が変更されたときにテーブルを再構築するかどうかを指定します。有効値：

• ON：IMCI のオーダーキーが変更されると、テーブルを再構築する必要があります。

• OFF (デフォルト)：IMCI のオーダーキーが変更されても、テーブルを再構築する必要はありません。

loose_imci_parallel_build_threads_per_table

グローバル

IMCI のソートキーを設定する際の単一テーブルのスレッド数。

有効値：1～128。デフォルト値：8。

loose_imci_optimizer_switch

グローバル/セッション

条件を満たすワイドテーブルクエリをハイブリッドプランで高速化するかどうかを指定します。有効値：

• 'force_hybrid_index_search=OFF' (デフォルト)：ワイドテーブルクエリの高速化にハイブリッドプランを強制的に使用しません (オプティマイザーによって自動的に選択されます)。

• 'force_hybrid_index_search=ON'：ハイブリッドプランを強制的に使用します。

loose_imci_auto_update_statistic

グローバル/セッション

IMCI オプティマイザーの結合順序の並べ替えで、統計情報が古い場合に再収集するかどうかを指定します。有効値：

• ASYNC (デフォルト)：IMCI オプティマイザーは非同期で統計情報をサンプリングして再収集します。

• SYNC：IMCI オプティマイザーは同期的に統計情報をサンプリングして再収集します。

• OFF：IMCI オプティマイザーは統計情報を再収集しません。

loose_imci_max_enum_join_pairs

グローバル

IMCI が使用され、結合の並べ替えが有効になっている場合に、IMCI オプティマイザーが検索できる同等の実行計画の数。

有効値：0～4294967295。デフォルト値：2000。

loose_etl_from_imci

グローバル/セッション

ETL を使用して列ストアからデータを読み取ることを有効にするかどうかを指定します。有効値：

• ON：この機能を有効にします。

• OFF (デフォルト)：この機能を無効にします。

• FORCED：トランザクションの制限を解除します。

loose_etl_from_imci_compress

グローバル/セッション

読み取り専用の IMCI ノードからデータを読み取る際にファイルを圧縮するかどうかを指定します。有効値：

• ON：読み取り専用の IMCI ノードからデータを読み取る際にファイルを圧縮します。

• OFF (デフォルト)：読み取り専用の IMCI ノードからデータを読み取る際にファイルを圧縮しません。

loose_imci_enable_hybrid_plan

グローバル

ワイドテーブルクエリのハイブリッドプラン高速化機能を制御します。有効値：

• ON (デフォルト)：ワイドテーブルクエリのハイブリッドプラン高速化機能を有効にします。

• OFF：ハイブリッドプラン高速化を無効にします。

loose_imci_enable_window_function

グローバル

ウィンドウ関数を含む SQL ステートメントがインメモリ列指向インデックス機能を使用できるかどうかを指定します。有効値：

• 2 (デフォルト)：ウィンドウ関数を含む SQL ステートメントは IMCI を使用できます。

• 1：FRAME を指定しないウィンドウ関数を含む SQL ステートメントは IMCI を使用できます。

• 0：ウィンドウ関数を含む SQL ステートメントは IMCI を使用できません。

loose_imci_min_virtual_memory

グローバル

列ストアインデックスを使用するクエリに必要な最小メモリ。

有効値：1～9223372036854775807。デフォルト値：DBNodeClassMemory*3/20。単位：バイト。

loose_imci_max_virtual_memory

グローバル

列ストアインデックスを使用するクエリに許可される最大メモリ。

有効値：1～9223372036854775807。デフォルト値：9223372036854775807。単位：バイト。

loose_imci_ap_threshold

グローバル/セッション

SQL ステートメントを IMCI ノードに分散するかどうかを決定するしきい値。

有効値：1～18446744073709551615。デフォルト値：50000。

loose_cost_threshold_for_imci

セッション

IMCI ノード内の現在の SQL ステートメントの推定実行コストのしきい値IMCI 関連パラメーター。

有効値：1～18446744073709551615。デフォルト値：50000。

loose_imci_enable_query_trace

グローバル

列ストアインデックスのクエリ最適化プロセス中にカーネルエラーログを出力するかどうかを制御します。有効値：

• ON：列ストアインデックスのクエリ最適化プロセス中にカーネルエラーログを出力します。

• OFF (デフォルト)：列ストアインデックスのクエリ最適化プロセス中にカーネルエラーログを出力しません。

loose_polar_enable_implicit_imci_with_create_table

グローバル

すべての新しいテーブルにフルテーブルカバレッジ列インデックスを追加するかどうかを指定します。有効値：

• ON：すべての新しいテーブルにフルテーブルカバレッジ列インデックスを追加します。

• OFF (デフォルト)：すべての新しいテーブルにフルテーブルカバレッジ列インデックスを追加しません。

loose_imci_columnar_advise_buffer_size

グローバル

dbms_imci.columnar_advise(); ストアドプロシージャで使用可能なメモリサイズを設定します。

有効値：0～18446744073709551615。デフォルト値：8388608。単位：バイト。

loose_imci_default_pack_shift

グローバル

列ストアインデックスの行グループサイズを設定します。

有効値：7～18。デフォルト値：14。

loose_slow_log_record_imci

グローバル

列ストアインデックスに関連する情報をスローログに追加するかどうかを指定します。有効値：

• ON：列ストアインデックスに関連する情報をスローログに追加します。

• OFF (デフォルト)：列ストアインデックスに関連する情報をスローログに追加しません。

loose_imci_default_write_policy

グローバル

列ストアインデックスデータの書き込みポリシーを設定します。有効値：

• Tradeoff (デフォルト)：Skip4K に基づいて最適化します。書き込むデータが 1 MB 未満の場合は ForPerformance と同等です。1 MB 以上のデータを書き込む場合は、データを複数のファイルに分割しようとします。

• ForCapacity：内部断片化を最小限に抑えるために、可能な限りデータを複数のファイルに分割することで、ストレージスペースを優先します。各書き込み操作で生成される内部フラグメントは最大で 1 つの 4 KB です。

• ForPerformance：各書き込み操作に最も適した ExtentSize のファイルを選択することで、パフォーマンスを優先します。このポリシーは最高の I/O パフォーマンスを保証しますが、最大の断片化率と高いスペースの無駄を招きます。

• Skip4K：データ分割ロジックは ForCapacity に似ています。4 KB を超えるデータを書き込む場合、4 KB のエクステントは無視されます。各書き込みで最大 1 つの 16 KB のフラグメントが生成されます。

パラメーター名

スコープ

説明

loose_max_parallel_degree

グローバル/セッション

単一クエリの最大並列度。これは並列実行のためのワーカーの最大数です。

有効値：0～1024。デフォルト値：0。この値は、エラスティック並列クエリ機能が無効であることを示します。

loose_max_parallel_workers

グローバル

同時に実行できる並列ワーカースレッドの最大数。この値を超えると、パラレルクエリはタスクキューに入って待機する必要があります。

有効値：1～10000。デフォルト値：CPU コア数の 2 倍。

loose_queuing_parallel_degree_limit

グローバル

一度にキューに入ることができるパラレルクエリの DOP 値の最大合計。指定された値を超えると、パラレルクエリは禁止され、シーケンシャル実行が使用されます。

有効値：0～10000。デフォルト値：64。

loose_pq_max_queuing_time

グローバル/セッション

キュー内のパラレルクエリの最大待機時間。待機時間がこの値を超えると、クエリはシーケンシャル実行にフォールバックします。

有効値：0～18446744073709551615。デフォルト値：200。単位：ミリ秒。

loose_parallel_degree_policy

グローバル

単一クエリの並列度設定ポリシーを設定します。有効値：

• TYPICAL：PolarDB はクエリの並列度を選択する際にデータベースの負荷 (CPU 使用率など) を考慮せず、loose_max_parallel_degree で設定された並列度との一貫性を維持しようとします。

• AUTO：PolarDB はデータベースの負荷 (CPU 使用率など) に基づいてパラレルクエリプランを禁止するかどうかを決定し、クエリコストに基づいて並列度を選択します。

• REPLICA_AUTO (デフォルト)：読み取り専用ノードのみがデータベースの負荷 (CPU 使用率など) に基づいてパラレルクエリプランを禁止するかどうかを決定し、クエリコストに基づいて並列度を選択しますが、プライマリノードはパラレルクエリを有効にしません。

loose_records_threshold_for_parallelism

セッション

オプティマイザーが、ステートメント内のテーブルのスキャンレコード数がこのしきい値を超えると推定した場合、オプティマイザーは並列実行計画の選択を検討します。

有効値：0～18446744073709551615。デフォルト値：10000。

loose_cost_threshold_for_parallelism

オプティマイザーが、クエリのシーケンシャル実行コストがこのしきい値を超えると推定した場合、オプティマイザーは並列実行計画の選択を検討します。

有効値：0～18446744073709551615。デフォルト値：50000。

loose_records_threshold_for_mpp

クエリ文に関連するテーブルのスキャン行数がこのしきい値を超えた場合、オプティマイザーはマルチノード並列実行の使用を検討します。

有効値：0～18446744073709551615。デフォルト：0。これは、Loose_records_threshold_for_parallelism の値の N 倍を自動的に取得することを意味します。ここで、N は EPQ クラスター内のノード数です。

loose_cost_threshold_for_mpp

クエリ文のシーケンシャル実行コストがこのしきい値を超えた場合、オプティマイザーはマルチノード並列実行の使用を検討します。

有効値：0～18446744073709551615。デフォルト値：0。これは、Loose_cost_threshold_for_parallelism の値の N 倍を自動的に取得することを意味します。ここで、N はノード数です。

loose_auto_dop_cpu_pct_hwm

グローバル

CPU 使用率のしきい値。CPU 使用率がこのしきい値を超えると、PolarDB はパラレルクエリプランを禁止します。

有効値：0～100。デフォルト値：70。

loose_auto_dop_mem_pct_hwm

メモリ使用率のしきい値。メモリ使用率がこのしきい値を超えると、PolarDB はパラレルクエリプランを禁止します。

有効値：0～100。デフォルト値：90。

loose_auto_dop_iops_pct_hwm

IOPS 使用率のしきい値。IOPS 使用率がこのしきい値を超えると、PolarDB はパラレルクエリプランを禁止します。

有効値：0～100。デフォルト値：80。

パラメーター名

スコープ

説明

loose_polar_optimizer_switch

グローバル/セッション

サブクエリの折りたたみ機能のみを有効または無効にします。デフォルトでは、サブクエリはマージされません。

有効値：

• coalesce_subquery=ON：サブクエリの折りたたみ機能を有効にします。

• coalesce_subquery=OFF：サブクエリの折りたたみ機能を無効にします。

グローバル/セッション

クエリ最適化制御スイッチ。有効値：

• 'having_cond_pushdown=ON' (デフォルト)：条件プッシュダウン (HAVING から WHERE へ) 機能を有効にします。

• 'having_cond_pushdown=OFF'：条件プッシュダウン (HAVING から WHERE へ) 機能を無効にします。

グローバル/セッション

結合条件プッシュダウンスイッチ。有効値：

• 'join_predicate_pushdown=ON' (デフォルト)：結合条件プッシュダウン機能を有効にします。

• 'join_predicate_pushdown=OFF'：結合条件プッシュダウン機能を無効にします。

loose_in_predicate_conversion_threshold

グローバル

IN 述語から JOIN への変換機能を制御します。

SQL ステートメントの IN リスト内の要素数がこのパラメーター値以上の場合、SQL ステートメントは変換され、IN 述語は JOIN に変換されます。

有効値：0～999999。デフォルト値：5000。

loose_join_elimination_mode

グローバル

left join の削除機能を制御します。有効値：

• REPLICA_ON (デフォルト)：読み取り専用ノードでのみ left join の削除機能を有効にします。

• ON：left join の削除機能を有効にします。

• OFF：left join の削除機能を無効にします。

loose_join_predicate_pushdown_opt_mode

グローバル

結合条件プッシュダウン機能を有効にするノードを制御します。有効値：

• REPLICA_ON (デフォルト)：読み取り専用ノードでのみ結合条件プッシュダウン機能を有効にします。

• ON：すべてのノードで結合条件プッシュダウン機能を有効にします。

• OFF：すべてのノードで結合条件プッシュダウン機能を無効にします。

loose_having_cond_pushdown_mode

グローバル

条件プッシュダウン (HAVING から WHERE へ) 機能を有効にするノードを制御します。有効値：

• REPLICA_ON (デフォルト)：読み取り専用ノードでのみ条件プッシュダウン (HAVING から WHERE 句へ) 機能を有効にします。

• ON：すべてのノードで条件プッシュダウン (HAVING から WHERE 句へ) 機能を有効にします。

• OFF：すべてのノードで条件プッシュダウン (HAVING から WHERE 句へ) 機能を無効にします。

loose_derived_cond_pushdown_mode

グローバル

条件プッシュダウン (WHERE 条件から派生テーブルへ) スイッチを制御します。有効値：

• OFF：条件プッシュダウン (WHERE から派生テーブルへ) 機能を無効にします。

• ON：条件プッシュダウン (WHERE から派生テーブルへ) 機能を有効にします。

• REPLICA_ON (デフォルト)：読み取り専用ノードでのみ条件プッシュダウン (WHERE から派生テーブルへ) 機能を有効にします。

loose_subquery_cond_pushdown_mode

グローバル

条件プッシュダウン (WHERE 句から IN サブクエリへ) 機能を制御します。有効値：

• REPLICA_ON：読み取り専用ノードでのみこの条件プッシュダウン機能を有効にします。

• ON：この条件プッシュダウン機能を有効にします。

• OFF (デフォルト)：この条件プッシュダウン機能を無効にします。

loose_join_cond_push_into_derived_mode

グローバル

条件プッシュダウン (結合条件からマテリアライズド派生テーブルへ) 機能を制御します。有効値：

• REPLICA_ON (デフォルト)：読み取り専用ノードでのみこの条件プッシュダウン機能を有効にします。

• ON：この条件プッシュダウン機能を有効にします。

• OFF：この条件プッシュダウン機能を無効にします。

loose_predicate_deduce_mode

グローバル

推移的述語生成 (拡張条件プッシュダウン) 機能を制御します。有効値：

• REPLICA_ON：読み取り専用ノードでのみ推移的述語生成機能を有効にします。

• ON：推移的述語生成機能を有効にします。

• OFF (デフォルト)：推移的述語生成機能を無効にします。

loose_plan_cache_type

セッション

自動プランキャッシュモード。有効値：

• OFF (デフォルト)：自動プランキャッシュ機能を無効にします。

• AUTO：キャッシュ条件を満たす SQL ステートメントの実行計画をプランキャッシュに自動的にキャッシュします。

  説明

  キャッシュ条件：

  SQL ステートメントの全体的な実行時間が loose_auto_plan_cache_time_threshold パラメーターの値以上で、全体的な実行時間における最適化時間の割合が loose_auto_plan_cache_pct_threshold パラメーターの値以上の場合、その SQL ステートメントの実行計画はプランキャッシュにキャッシュされます。

• DEMAND：指定された SQL ステートメントの実行計画をプランキャッシュにキャッシュします。

• ENFORCE：すべての SQL ステートメントの実行計画をプランキャッシュに強制的にキャッシュします。

loose_plan_cache_expire_time

セッション

自動プランキャッシュ内の実行計画がこの期間ヒットしなかった場合、メモリは再利用されます。単位：秒。

有効値：0～4294967295。デフォルト値：1800。

loose_auto_plan_cache_pct_threshold

セッション

SQL ステートメントの最適化時間と全体的な実行時間の指定された比率。

有効値：0～100。デフォルト値：20。

loose_auto_plan_cache_time_threshold

セッション

SQL ステートメントの総実行時間の上限。単位：マイクロ秒。

有効値：0～18446744073709551615。デフォルト値：400。

loose_auto_plan_cache_count_threshold

セッション

loose_plan_cache_type パラメーターが AUTO に設定されている場合、このパラメーターはキャッシュ条件を満たす SQL ステートメントの実行計画がプランキャッシュにキャッシュされる回数のしきい値を指定します。

有効値：0～18446744073709551615。デフォルト値：512。

loose_adaptive_plans_switch

グローバル/セッション

適応実行計画の切り替え機能を制御します。有効値：

• imci_chosen：行と列のルーティングで適応実行を使用するかどうかを制御します。

  • ON (デフォルト)：行と列のルーティングで適応実行を有効にしますが、これが有効になるには IMCI ノードが正しく設定されている必要があります。

  • OFF：行と列のルーティングでの適応実行を禁止します。

• ordering_index：行と列のルーティングで順序付きインデックスの適応選択を使用するかどうかを制御します。

  • ON：順序付きインデックス選択の適応調整を有効にします。

  • OFF (デフォルト)：順序付きインデックス選択結果の適応調整を禁止します。

loose_adaptive_cost_threshold_for_imci

グローバル/セッション

行と列の適応実行計画の切り替え分散のコストしきい値を設定します。

有効値：1～18446744073709551615。デフォルト値：50000。

loose_adaptive_plans_max_time

グローバル/セッション

SQL ステートメントが適応実行計画を切り替えるために許可される最大実行時間。SQL ステートメントの実行時間がこの値を超えた場合、実行計画の切り替えのしきい値に達しても実行計画は切り替えられません。

有効値：0～1800000。デフォルト値：500。単位：ミリ秒。

loose_adaptive_ordering_rows_threshold

グローバル/セッション

順序付きインデックスの適応選択のチェックポイントを設定します。有効なインデックス値が小さいほど、適応チェックと調整が早く実行されます。

有効値：0～4294967295。デフォルト値：50000。

loose_optimizer_switch

グローバル/セッション

Limit Offset プッシュダウンのメイン制御スイッチ。LIMIT OFFSET プッシュダウン機能に関連する変数：

• limit_offset_pushdown：Limit Offset プッシュダウン最適化スイッチ。

  • ON (デフォルト)：Limit Offset プッシュダウン最適化スイッチを有効にします。

  • OFF：Limit Offset プッシュダウン最適化スイッチを無効にします。

• detach_range_condition：完全述語プッシュダウン最適化スイッチ。

  • ON (デフォルト)：完全述語プッシュダウン最適化スイッチを有効にします。

  • OFF：完全述語プッシュダウン最適化スイッチを無効にします。

loose_bloom_filter_enabled

グローバル/セッション

ブルームフィルター最適化スイッチ。有効値：

• ON (デフォルト)：ブルームフィルター最適化スイッチを有効にします。

• OFF：ブルームフィルター最適化スイッチを無効にします。

パラメーター名

スコープ

説明

loose_innodb_support_instant_add_column

グローバル

列の即時追加機能のスイッチ。有効値：

• ON：列の即時追加機能を有効にします。

• OFF (デフォルト)：列の即時追加機能を無効にします。

loose_innodb_polar_instant_modify_column_enable

グローバル

列の即時変更機能を制御します。有効値：

• ON：列の即時変更機能を有効にします。

• OFF (デフォルト)：列の即時変更機能を無効にします。

loose_innodb_polar_instant_modify_column_max_times

グローバル

単一テーブルで許可される列の即時変更操作の最大回数を設定します。

有効値：1～64。デフォルト値：16。

loose_innodb_support_instant_modify_charset

グローバル

列の文字セットの即時変更機能を制御します。有効値：

• OFF (デフォルト)：列の文字セットの即時変更機能を無効にします。

• ON：列の文字セットの即時変更機能を有効にします。

loose_innodb_polar_parallel_ddl_threads

セッション

各 DDL 操作の並列スレッド数を制御します。有効値：1～16。デフォルト値：1。これは、シングルスレッド DDL を実行することを意味します。

セカンダリインデックスを作成する際にこのパラメーターの値が 1 でない場合、並列 DDL 機能が自動的に有効になります。

innodb_parallel_build_primary_index

グローバル

プライマリキーインデックスを作成する際に並列 DDL機能の使用を許可するかどうかを制御します。有効値：

• ON：プライマリキーインデックスを作成する際に並列 DDL 機能の使用を許可します。

• OFF (デフォルト)：プライマリキーインデックスを作成する際に並列 DDL 機能の使用を許可しません。

loose_innodb_polar_use_sample_sort

セッション

サンプルソート最適化機能のスイッチ。有効値：

• ON：サンプルソート最適化機能のスイッチを有効にします。

• OFF (デフォルト)：サンプルソート最適化機能のスイッチを無効にします。

loose_innodb_polar_use_parallel_bulk_load

セッション

並列バルクロード最適化機能のスイッチ。有効値：

• ON：並列バルクロード最適化機能のスイッチを有効にします。

• OFF (デフォルト)：並列バルクロード最適化機能のスイッチを無効にします。

loose_innodb_polar_ddl_build_index_readahead

グローバル

DDL 先読み機能のスイッチ。有効値：

• ON：DDL 先読み機能を有効にします。

• OFF (デフォルト)：DDL 先読み機能を無効にします。

loose_innodb_polar_ddl_build_index_readahead_page_num

グローバル

DDL 先読みのページ数。1 ページのサイズは 16 KB です。

有効値：32～256。デフォルト値：64。

loose_innodb_polar_ddl_async_io

グローバル

DDL の非同期 I/O 機能のスイッチ。有効値：

• ON：DDL 非同期 I/O 機能を有効にします。

• OFF (デフォルト)：DDL 非同期 I/O 機能を無効にします。

loose_innodb_polar_parallel_merge_ways

セッション

マージソートの方法の数。

有効値：2～16。デフォルト値：2。この値は、データベースがデフォルトで 2 ウェイマージソートを使用することを示します。2 より大きい値を指定すると、マルチウェイマージソート機能が有効になります。

loose_innodb_flush_pages_using_space_id

グローバル

高速な TRUNCATE/DROP TABLE 機能のスイッチ。有効値：

• ON (デフォルト)：高速な TRUNCATE/DROP TABLE 機能を有効にします。

• OFF：高速な TRUNCATE/DROP TABLE 機能を無効にします。

loose_polar_nonblock_ddl_mode

セッション

非ブロック DDL 機能のスイッチ。有効値：

• ON：非ブロック DDL 機能を有効にします。

• OFF (デフォルト)：非ブロック DDL 機能を無効にします。

loose_polar_nonblock_ddl_retry_times

セッション

MDL-X ロックの取得がタイムアウトしたときのリトライ試行回数を設定します。有効値：0～31536000。デフォルト値：0 (lock_wait_timeout パラメーターから計算された値)。

loose_polar_nonblock_ddl_retry_interval

セッション

タイムアウト後に MDL-X ロックを再試行する時間間隔を設定します。

有効値：0～31536000。単位：秒。デフォルト値：6。

loose_polar_nonblock_ddl_lock_wait_timeout

セッション

MDL-X ロックを取得するためのタイムアウト期間を設定します。

有効値：1～31536000。単位：秒。デフォルト値：1。

loose_innodb_bulk_load_page_grained_redo_enable

グローバル

DDL 物理レプリケーション最適化機能のスイッチ。有効値：

• ON：DDL 物理レプリケーション最適化を有効にします。

• OFF (デフォルト)：DDL 物理レプリケーション最適化を無効にします。

loose_polar_support_mdl_sync_preemption

セッション

プリエンプティブ DDL 機能のスイッチ。有効値：

• ON：プリエンプティブ DDL 機能を有効にします。

• OFF (デフォルト)：プリエンプティブ DDL 機能を無効にします。

loose_polar_mdl_sync_preempt_after_wait_second

グローバル

MDL ロックがブロックされたときに同期するためのタイムアウト期間を設定します。指定されたタイムアウト期間が終了しても MDL ロックが同期されない場合、プリエンプションスレッドが開始されます。

有効値：1～31536000。デフォルト値：10。

loose_polar_enable_explain_ddl

グローバル

EXPLAIN DDL 機能のスイッチ。有効値：

• ON (デフォルト)：EXPLAIN DDL 機能を有効にします。

• OFF：EXPLAIN DDL 機能を無効にします。

loose_polar_max_collect_thd_num_in_explain_ddl

グローバル

収集する潜在的な MDL ブロッキングスレッドの数を制御します。

有効値：1～512。デフォルト値：16。

loose_polar_performance_schema

グローバル

Polar Performance Schema 機能を有効にするかどうかを制御します。有効値：

• ON：Polar Performance Schema を有効にします。

• OFF：Polar Performance Schema を無効にします。

performance_schema_max_thread_instances

グローバル

Polar Performance Schema が監視できるスレッドの最大数を設定します。有効値：-1～65536。値 -1 は、スレッド数がビジネスの変更に適応するために自動的に調整されることを示します。

performance_schema_max_metadata_locks

グローバル

Polar Performance Schema が監視できる MDL の最大数を設定します。有効値：-1～1048576。値 -1 は、MDL の数がビジネスの変更に適応するために自動的に調整されることを示します。

loose_recycle_bin

グローバル/セッション

テーブルごみ箱機能のスイッチ。有効値：

• ON：テーブルごみ箱機能のスイッチを有効にします。

• OFF (デフォルト)：テーブルごみ箱機能のスイッチを無効にします。

loose_recycle_scheduler

グローバル

ごみ箱の非同期クリーンアップタスクスレッドのスイッチ。有効値：

• ON：ごみ箱の非同期クリーンアップタスクスレッドのスイッチを有効にします。

• OFF (デフォルト)：ごみ箱の非同期クリーンアップタスクスレッドのスイッチを無効にします。

loose_recycle_bin_retention

グローバル

ごみ箱内のデータの最大保持期間。有効値：86400～1209600 (14 日)。単位：秒。デフォルト値：604800 (7 日)。

パラメーター名

スコープ

説明

loose_enable_large_trx_optimization

グローバル

バイナリロギング大規模トランザクション最適化メカニズムを有効または無効にします。有効値：

• OFF (デフォルト)：バイナリロギング大規模トランザクション最適化メカニズムを無効にします。

• ON：バイナリロギング大規模トランザクション最適化メカニズムを有効にします。

loose_binlog_large_trx_threshold_up

グローバル

バイナリロギング大規模トランザクション最適化のしきい値。大規模トランザクションの最適化されたバイナリログ書き込みが有効になった後、トランザクションによって生成されたバイナリログのサイズがしきい値を超えると、最適化されたバイナリログ書き込みがトリガーされます。

有効値：10 MB～300 GB。デフォルト値：1 GB。

パラメーター名

スコープ

説明

loose_ccl_mode

グローバル

同時実行数制限を超えた場合の SQL ステートメントの動作。有効値：

• WAIT (デフォルト)：SQL ステートメントは、他の SQL ステートメントが実行されるまでキューで待機します。

• REFUSE：エラーが返されます。

loose_ccl_max_waiting_count

グローバル

loose_ccl_mode パラメーターが WAIT に設定されている場合、このパラメーターは単一の CCL ルールに一致し、キューで待機できる SQL ステートメントの最大数を指定します。この値を超えると、エラーが返されます。

有効値：0～65536。デフォルト値：0。

loose_hotspot

グローバル

ホット行最適化機能のメインスイッチ。有効値：

• ON：この機能を有効にします。

• OFF (デフォルト)：この機能を無効にします。

loose_thread_pool_enabled

グローバル

スレッドプール機能を有効にするかどうかを指定します。有効値：

• ON：この機能を有効にします。

• OFF (デフォルト)：この機能を無効にします。

loose_thread_pool_size

グローバル

スレッドプール内のスレッドグループの数。有効な値は、プライマリノードの CPU コア数によって異なります。

有効値：DBNodeClassCPU～DBNodeClassCPU*10。デフォルト値：DBNodeClassCPU*2。

例：

• 4 コア 8 GB のプライマリノードを持つデータベースエンジン MySQL 8.0.1 クラスター版の場合、有効な値の範囲は 4～40 で、デフォルト値は 8 です。

• それぞれ 4 コア 8 GB の 2 つのプライマリノードを持つデータベースエンジン MySQL 8.0.1 マルチマスタークラスター (データベース/テーブル) の場合、有効な値の範囲は 8～80 で、デフォルト値は 16 です。

• 4 コア 8 GB のプライマリノードを持つデータベースエンジン MySQL 5.7 クラスター版の場合、有効な値の範囲は 4～40 で、デフォルト値は 4 です。

loose_thread_pool_high_prio_mode

グローバル

スレッドプールの高優先度キューモード。

有効値：

• transactions (デフォルト)：トランザクションを持つ SQL ステートメントは高優先度キューに追加され、thread_pool_high_prio_tickets で指定されたチケットが割り当てられます。後続の SQL ステートメントは、チケットが使い果たされるまで高優先度キューに追加されます。

• statements：すべての SQL ステートメントが高優先度キューに追加されます。

• none：高優先度キューに SQL ステートメントは追加されません。

loose_thread_pool_high_prio_tickets

グローバル

高優先度キューのチケットの最大数。

有効値：0～4294967295。デフォルト値：4294967295。

loose_thread_pool_idle_timeout

グローバル

スレッドプール内のアイドルスレッドを解放するための時間しきい値。このしきい値より長くリクエストを処理していないアイドルスレッドは解放されます。

有効値：0～31536000。デフォルト値：60。単位：秒。

loose_thread_pool_oversubscribe

グローバル

各スレッドグループで許可されるアクティブスレッドの最大数。

有効値：1～1000。デフォルト値：20。

アクティブスレッドとは、SQL ステートメントを実行しているスレッドです。スレッドが実行しているステートメントが次のステータスにある場合、スレッドはアクティブではありません：

• SQL ステートメントがディスク I/O を待機しています。

• SQL ステートメントがトランザクションのコミットを待機しています。

loose_thread_pool_stall_limit

グローバル

スレッドプールが輻輳状態に入るかどうかを判断するための時間しきい値。

スレッドプールが輻輳状態に入ると、システムは新しいスレッドを作成して SQL ステートメントを実行します。

有効値：1～18446744073709551615。デフォルト値：10。単位：ミリ秒。

loose_bypass_thread_pool_ips

グローバル

スレッドプールによってブロックされないクライアント IP アドレス。スレッドプールがいっぱいであっても、これらの IP アドレスからの SQL ステートメントは管理操作のために実行できます。

10.69.96.16,10.69.96.17

loose_bypass_thread_pool_check_ignore_proxy

グローバル

高優先度を持つデータベースアカウント。これらのアカウントからのリクエストは、スレッドプールの高優先度キューに配置され、優先的に処理されます。

user1, user2

loose_thread_pool_high_priority_users

グローバル

スレッドプール内の DDL 操作のタイムアウトしきい値。しきい値に達すると、DDL ステートメントはタイムアウトとしてマークされ、システムは自動的に新しいスレッドを作成してステートメントを実行します。

有効値：0～864000。デフォルト値：600。単位：秒。

loose_thread_pool_mark_ddl_thread_timeout_sec

グローバル

スレッドプール内の DDL 操作のタイムアウトしきい値。しきい値に達すると、DDL 操作はタイムアウトとしてラベル付けされ、システムは自動的に新しいスレッドを作成して操作を実行します。

有効値：0～864000。デフォルト値：600。単位：秒。

loose_thread_pool_mark_ddl_thread_timeout_immediately

グローバル

スレッドプールが高負荷で低優先度キューが積み上げられている場合に、DDL 操作をすぐにタイムアウトとしてマークするかどうかを指定します。この場合、システムは新しいスレッドを作成してリクエストを実行します。このパラメーターは、多くの DDL ステートメントが実行されるシナリオに適用されます。

有効値：

• ON：この機能を有効にします。

• OFF (デフォルト)：この機能を無効にします。

loose_innodb_polar_blink_tree

グローバル

B-tree 同時実行制御最適化メカニズムを制御します。有効値：

• OFF (デフォルト)：B-tree 同時実行制御最適化メカニズムを無効にします。

• ON：B-tree 同時実行制御最適化メカニズムを有効にします。

パラメーター

スコープ

説明

loose_partition_level_mdl_enabled

グローバル

オンラインパーティションメンテナンス機能のスイッチ。有効値：

• ON：PARTITION レベル MDL 機能を有効にします。

• OFF：PARTITION レベル MDL 機能を無効にします。

loose_hybrid_partition_query_mix_engine_enabled

グローバル

ハイブリッドパーティションテーブルをクエリする際に、非 InnoDB ストレージエンジンのパーティションデータをクエリするかどうかを指定します。有効値：

• ON (デフォルト)：非 InnoDB ストレージエンジンのパーティションデータをクエリします。

• OFF：非 InnoDB ストレージエンジンのパーティションデータをクエリしません。

パラメーター

スコープ

説明

loose_innodb_backquery_enable

グローバル

フラッシュバッククエリ機能を有効または無効にします。有効値：

• ON：この機能を有効にします。

• OFF：この機能を無効にします (デフォルト)。

loose_innodb_backquery_window

グローバル

フラッシュバッククエリでサポートされている期間。

有効値: 1～604800。デフォルト値: 86400。単位: 秒。

loose_innodb_backquery_capacity_limit

グローバル

フラッシュバッククエリでサポートされる undo ログの容量。undo ログの容量がこの値以上になると、フラッシュバッククエリでサポートされる時間が短縮されます。

有効値：100～200000000。デフォルト値：100000000。単位：MB。

パラメーター

スコープ

説明

loose_csv_oss_buff_size

セッション

単一の OSS スレッドが占有するメモリサイズ。デフォルト値：134217728。単位：バイト。

有効値：4096～134217728。

loose_csv_max_oss_threads

グローバル

現在実行が許可されている OSS スレッドの数。

有効値：1～100。デフォルト値：1。単位：スレッド。

loose_max_oss_outfile_threads

セッション

PolarDB が同時に開始できる OSS OUTFILE スレッドの数。有効値：1～100。デフォルト値：1。単位：スレッド。

SHOW STATUS LIKE "oss_outfile_threads_running"; コマンドを使用して、クラスターで現在実行中の OSS OUTFILE スレッドの数を表示します。

loose_oss_outfile_buffer_size

グローバル

単一の OSS OUTFILE スレッドが使用できるメモリサイズ。ほとんどの場合、スレッドがより多くのメモリを使用できると、エクスポート速度が向上します。

有効値：102400～536870912。デフォルト値：134217728。単位：バイト。

パラメーター名

スコープ

説明

loose_innodb_enable_ttl_purge

グローバル

有効期間 (TTL) 機能を有効にするかどうかを指定します。

有効値：

• OFF (デフォルト)：この機能を無効にします。

• ON：この機能を有効にします。

loose_innodb_ttl_min_interval

グローバル

最小 TTL 値。

有効値：0～4294967295。デフォルト値：100。デフォルト単位：秒。

loose_innodb_ttl_purge_thread

グローバル

データクリーンアップ (TTL) で期限切れのデータをパージするためのスレッド数。変更後、変更を有効にするには innodb_enable_ttl_purge パラメーターをリセットします。

有効値：2～32。デフォルト値：4。単位：スレッド。

loose_innodb_ttl_cluster_index_purge_batch_size

グローバル

データクリーンアップ (TTL) 中にスキャンされる主キーの数。

有効値：10000～1000000。デフォルト値：10000。単位：キー。

loose_innodb_ttl_index_purge_batch_size

グローバル

データクリーンアップ (TTL) 中に TTL 列インデックスからスキャンされるデータ。

有効値：500～1000000。デフォルト値：500。単位：行。

loose_innodb_ttl_purge_start_hour

グローバル

データクリーンアップ (TTL) の開始時刻。この値は innodb_ttl_purge_end_hour を超えてはなりません。

有効値：0～23。デフォルト値：0。単位：秒。

loose_innodb_ttl_purge_end_hour

グローバル

データクリーンアップ (TTL) の終了時刻。この値は innodb_ttl_purge_start_hour 未満であってはなりません。

有効値：0～23。デフォルト値：0。単位：秒。

パラメーター名

スコープ

説明

loose_innodb_polar_log_rdma_transfer

グローバル

RDMA ログ転送機能のスイッチ。有効値：

• ON：RDMA ログ転送機能を有効にします。

• OFF (デフォルト)：RDMA ログ転送機能を無効にします。

loose_partial_result_cache_enabled

グローバル/セッション

部分結果キャッシュ (PTRC) 機能のスイッチ。有効値：

• ON (デフォルト)：部分結果キャッシュ機能を有効にします。

• OFF：部分結果キャッシュ機能を無効にします。

loose_partial_result_cache_cost_threshold

グローバル/セッション

部分結果キャッシュ (PTRC) のコストしきい値。PTRC は、クエリ全体のコストがこのしきい値を超えた場合にのみトリガーされます。

有効値：0～18446744073709551615。デフォルト値：10000。

loose_partial_result_cache_check_frequency

グローバル/セッション

部分結果キャッシュ (PTRC) の動的フィードバック検出をトリガーする頻度。キャッシュミスの累積数がこの値に達すると、検出がトリガーされます。

有効値：0～18446744073709551615。デフォルト値：200。

loose_partial_result_cache_low_hit_rate

グローバル/セッション

部分結果キャッシュ (PTRC) のヒット率の低ウォーターマークしきい値。システムは、推定ヒット率がこの値より高い場合にのみ PTRC を使用し、クエリの実行中に実際のヒット率がこの値より低くなった場合は PTRC の使用を停止します。

有効値：0～100。デフォルト値：20。

loose_partial_result_cache_high_hit_rate

グローバル/セッション

部分結果キャッシュ (PTRC) のヒット率の高ウォーターマークしきい値。PTRC で使用される最大メモリ量に達し、ヒット率がこの値より高い場合、キャッシュされた結果はメモリからディスクにダンプされ、新しいキャッシュがディスクに保存されます。

有効値：0～100。デフォルト値：70。

loose_partial_result_cache_max_mem_size

グローバル/セッション

単一クエリにおける 部分結果キャッシュ (PTRC) の累積メモリ使用量。クエリには複数の PTRC がある場合があります。複数の PTRC で使用される合計メモリは、この値を超えることはできません。

有効値：0～18446744073709551615。デフォルト値：67108864。単位：バイト。