BE Configuration
Some BE configuration items are dynamic parameters which you can set interactively when BE nodes are online. The rest of them are static parameters. You can only set the static parameters of a BE node by changing them in the corresponding configuration file be.conf and restarting the BE node to allow the change to take effect.
BE 設定項目の表示
次のコマンドを使用して BE 設定項目を表示できます。
curl http://<BE_IP>:<BE_HTTP_PORT>/varz
BE パラメータの設定
Configure BE dynamic parameters
You can configure a dynamic parameter of a BE node by using the curl command.
curl -XPOST http://be_host:http_port/api/update_config?<configuration_item>=<value>
Configure BE static parameters
You can only set the static parameters of a BE by changing them in the corresponding configuration file be.conf, and restarting the BE to allow the changes to take effect.
BE パラメータの理解
サーバー
priority_networks
- デフォルト: 空文字列
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: BE ノードがホストされているマシンに複数の IP アドレスがある場合に、BE ノードの優先 IP アドレスを指定するために使用される CIDR 形式の IP アドレス。
- 導入バージョン: -
mem_limit
- デフォルト: 90%
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: BE プロセスのメモリ上限。パーセンテージ ("80%") または物理的な制限 ("100G") として設定できます。デフォルトのハードリミットはサーバーのメモリサイズの 90%、ソフトリミットは 80% です。同じサーバーで他のメモリ集約型サービスと一緒に StarRocks をデプロイする場合、このパラメータを設定する必要があります。
- 導入バージョン: -
num_threads_per_core
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 各 CPU コアで開始されるスレッドの数。
- 導入バージョン: -
be_http_port
- デフォルト: 8040
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: BE HTTP サーバーのポート。
- 導入バージョン: -
be_http_num_workers
- デフォルト: 48
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: HTTP サーバーが使用するスレッドの数。
- 導入バージョン: -
be_exit_after_disk_write_hang_second
- デフォルト: 60
- タイプ: Int
- 単位: 秒
- 変 更可能: いいえ
- 説明: ディスクがハングした後、BE が終了するまでの待機時間。
- 導入バージョン: -
compress_rowbatches
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: BE 間の RPC で行バッチを圧縮するかどうかを制御するブール値。
trueは行バッチを圧縮することを示し、falseは圧縮しないことを示します。 - 導入バージョン: -
serialize_batch
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: BE 間の RPC で行バッチをシリアライズするかどうかを制御するブール値。
trueは行バッチをシリアライズすることを示し、falseはシリアライズしないことを示します。 - 導入バージョン: -
Thrift
be_port
- デフォルト: 9060
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: BE の thrift サーバーポートで、FE からのリクエストを受信するために使用されます。
- 導入バージョン: -
thrift_client_retry_interval_ms
- デフォルト: 100
- タイプ: Int
- 単位: ミリ秒
- 変更可能: はい
- 説明: thrift クライアントが再試行する時間間隔。
- 導入バージョン: -
thrift_rpc_timeout_ms
- デフォルト: 5000
- タイプ: Int
- 単位: ミリ秒
- 変更可能: はい
- 説明: thrift RPC のタイムアウト。
- 導入バージョン: -
bRPC
brpc_port
- デフォルト: 8060
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: bRPC のネットワーク統計を表示するために使用される BE の bRPC ポート。
- 導入バージョン: -
brpc_num_threads
- デフォルト: -1
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: bRPC の bthreads の数。値
-1は CPU スレッドと同じ数を示します。 - 導入バージョン: -
brpc_max_body_size
- デフォルト: 2147483648
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: bRPC の最大ボディサイズ。
- 導入バージョン: -
ハートビート
heartbeat_service_port
- デフォルト: 9050
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: FE からのハートビートを受信するために使用される BE のハートビートサービスポート。
- 導入バージョン: -
heartbeat_service_thread_count
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: BE ハートビートサービスのスレッド数。
- 導入バージョン: -
ロギング
sys_log_dir
- デフォルト:
${STARROCKS_HOME}/log - タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: システムログ (INFO、WARNING、ERROR、FATAL を含む) を保存するディレクトリ。
- 導入バージョン: -
sys_log_level
- デフォルト: INFO
- タイプ: String
- 単位: -
- 変更可能: はい (v3.3.0、v3.2.7、v3.1.12 から)
- 説明: システムログエントリが分類される重大度レベル。 有効な値: INFO、WARN、ERROR、FATAL。この項目は v3.3.0、v3.2.7、v3.1.12 以降、動的設定に変更されました。
- 導入バージョン: -
sys_log_roll_mode
- デフォルト: SIZE-MB-1024
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: システムログがログロールに分割されるモード。 有効な値には
TIME-DAY、TIME-HOUR、およびSIZE-MB-サイズが含まれます。デフォルト値は、各ログが 1 GB のロールに分割されることを示します。 - 導入バージョン: -
sys_log_roll_num
- デフォルト: 10
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 保留されるログロールの数。
- 導入バージョン: -
sys_log_verbose_modules
- デフォルト:
- タイプ: Strings
- 単位: -
- 変更可能: いいえ
- 説明: 印刷されるログのモジュール。たとえば、この設定項目を OLAP に設定すると、StarRocks は OLAP モジュールのログのみを印刷します。有効な値は BE の名前空間であり、
starrocks、starrocks::debug、starrocks::fs、starrocks::io、starrocks::lake、starrocks::pipeline、starrocks::query_cache、starrocks::stream、およびstarrocks::workgroupを含みます。 - 導入バージョン: -
sys_log_verbose_level
- デフォルト: 10
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 印刷されるログのレベル。この設定項目は、コード内で VLOG で開始されたログの出力を制御するために使用されます。
- 導入バージョン: -
log_buffer_level
- デフォルト: 空文字列
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: ログをフラッシュする戦略。デフォルト値は、ログがメモリにバッファリングされることを示します。有効な値は
-1と0です。-1は、ログがメモリにバッファリングされないことを示します。 - 導入バージョン: -
統計レポート
report_task_interval_seconds
- デフォルト: 10
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: タスクの状態を報告する時間間隔。タスクはテーブルの作成、テーブルの削除、データのロード、またはテーブルスキーマの変更を行うことができます。
- 導入バージョン: -
report_disk_state_interval_seconds
- デフォルト: 60
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ストレージボリュームの状態を報告する時間間隔。これには、ボリューム内のデータのサイズが含まれます。
- 導入バージョン: -
report_tablet_interval_seconds
- デフォルト: 60
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: すべてのタブレットの最新バージョンを報告する時間間隔。
- 導入バージョン: -
report_workgroup_interval_seconds
- デフォルト: 5
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: すべてのワークグループの最新バージョンを報告する時間間隔。
- 導入バージョン: -
status_report_interval
- デフォルト: 5
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: クエリがプロファイルを報告する時間間隔。これは、FE によるクエリ統計収集に使用できます。
- 導入バージョン: -
periodic_counter_update_period_ms
- デフォルト: 500
- タイプ: Int
- 単位: ミリ秒
- 変更可能: はい
- 説明: カウンター統計を収集する時間間隔。
- 導入バージョン: -
ストレージ
primary_key_limit_size
- デフォルト: 128
- タイプ: Int
- 単位: バイト
- 変更可能: はい
- 説明: 主キーテーブルのキー列の最大サイズ。
- 導入バージョン: v2.5
drop_tablet_worker_count
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: タブレットを削除するために使用されるスレッドの数。
- 導入バージョン: -
alter_tablet_worker_count
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更 可能: はい
- 説明: スキーマ変更のために使用されるスレッドの数。
- 導入バージョン: -
clone_worker_count
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: クローンのために使用されるスレッドの数。
- 導入バージョン: -
storage_medium_migrate_count
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 記憶媒体の移行 (SATA から SSD への移行) のために使用されるスレッドの数。
- 導入バージョン: -
check_consistency_worker_count
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: タブレットの一貫性をチェックするために使用されるスレッドの数。
- 導入バージョン: -
upload_worker_count
- デフォルト: 0
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: BE ノード上のバックアップジョブのアップロードタスクの最大スレッド数。
0は、BE が存在するマシンの CPU コア数を値として設定することを示します。 - 導入バージョン: -
download_worker_count
- デフォルト: 0
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: BE ノード上のリストアジョブのダウンロードタスクの最大スレッド数。
0は、BE が存在するマシンの CPU コア数を値として設定することを示します。 - 導入バージョン: -
make_snapshot_worker_count
- デフォルト: 5
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: BE ノード上のスナップショット作成タスクの最大スレッド数。
- 導入バージョン: -
release_snapshot_worker_count
- デフォルト: 5
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: BE ノード上のスナップショットリリースタスクの最大スレッド数。
- 導入バージョン: -
max_download_speed_kbps
- デフォルト: 50000
- タイプ: Int
- 単位: KB/秒
- 変更可能: はい
- 説明: 各 HTTP リクエストの最大ダウンロード速度。この値は、BE ノード間のデータレプリカ同期のパフォーマンスに影響を与えます。
- 導入バージョン: -
download_low_speed_limit_kbps
- デフォルト: 50
- タイプ: Int
- 単位: KB/秒
- 変更可能: はい
- 説明: 各 HTTP リクエストのダウンロード速度の下限。HTTP リクエストがこの値より低い速度で指定された時間内に継続的に実行されると、リクエストが中止されます。
- 導入バージョン: -
download_low_speed_time
- デフォルト: 300
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: HTTP リクエストが指定された時間内にダウンロード速度の下限より低い速度で実行される最大時間。HTTP リクエストがこの設定項目で指定された時間内に
download_low_speed_limit_kbpsの値より低い速度で継続的に実行されると、リクエストが中止されます。 - 導入バージョン: -
memory_limitation_per_thread_for_schema_change
- デフォルト: 2
- タイプ: Int
- 単位: GB
- 変更可能: はい
- 説明: 各スキーマ変更タスクに許可される最大メモリサイズ。
- 導入バージョン: -
update_cache_expire_sec
- デフォルト: 360
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: Update Cache の有効期限。
- 導入バージョン: -
file_descriptor_cache_clean_interval
- デフォルト: 3600
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 一定期間使用されていないファイルディスクリプタをクリーンアップする時間間隔。
- 導入バージョン: -
disk_stat_monitor_interval
- デフォルト: 5
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ディスクの健康状態を監視する時間間隔。
- 導入バージョン: -
unused_rowset_monitor_interval
- デフォルト: 30
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 期限切れの rowset をクリーンアップする時間間隔。
- 導入バージョン: -
storage_root_path
- デフォルト:
${STARROCKS_HOME}/storage - タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: ストレージボリュームのディレクトリと媒体。例:
/data1,medium:hdd;/data2,medium:ssd。- 複数のボリュームはセミコロン (
;) で区切られます。 - ストレージ媒体が SSD の場合、ディレクトリの末尾に
,medium:ssdを追加します。 - ストレージ媒体が HDD の場合、ディレクトリの末尾に
,medium:hddを追加します。
- 複数のボリュームはセミコロン (
- 導入バージョン: -
max_percentage_of_error_disk
- デフォルト: 0
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 対応する BE ノードが終了する前にストレージボリュームで許容されるエラーの最大パーセンテージ。
- 導入バージョン: -
default_num_rows_per_column_file_block
- デフォルト: 1024
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 各行ブロックに格納できる最大行数。
- 導入バージョン: -
max_tablet_num_per_shard
- デフォルト: 1024
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 各シャードの最大タブレット数。この設定項目は、各ストレージディレクトリの下にあるタブレット子ディレクトリの数を制限するために使用されます。
- 導入バージョン: -
pending_data_expire_time_sec
- デフォルト: 1800
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ストレージエンジン内の保留データの有効期限。
- 導入バージョン: -
inc_rowset_expired_sec
- デフォルト: 1800
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 受信データの有効期限。この設定項目はインクリメンタルクローンで使用されます。
- 導入バージョン: -
tablet_rowset_stale_sweep_time_sec
- デフォルト: 1800
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: タブレット内の古い rowset をスイープする時間間隔。
- 導入バージョン: -
max_garbage_sweep_interval
- デフォルト: 3600
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ストレージボリュームのガーベジコレクションの最大時間間隔。この設定は v3.0 以降、動的に変更されました。
- 導入バージョン: -
min_garbage_sweep_interval
- デフォルト: 180
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ストレージボリュームのガーベジコレクションの最小時間間隔。この設定は v3.0 以降、動的に変更されました。
- 導入バージョン: -
snapshot_expire_time_sec
- デフォルト: 172800
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: スナップショットファイルの有効期限。
- 導入バージョン: -
trash_file_expire_time_sec
- デフォルト: 86400
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ゴミファイルをクリーンアップする時間間隔。デフォルト値は v2.5.17、v3.0.9、v3.1.6 以降、259,200 から 86,400 に変更されました。
- 導入バージョン: -
compact_threads
- デフォルト: 4
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 同時コンパクションタスクに使用される最大スレッド数。この設定は v3.1.7 および v3.2.2 以降、動的に変更されました。
- 導入バージョン: v3.0.0
base_compaction_check_interval_seconds
- デフォルト: 60
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ベースコンパクションのスレッドポーリングの時間間隔。
- 導入バージョン: -
min_base_compaction_num_singleton_deltas
- デフォルト: 5
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: ベースコンパクションをトリガーする最小セグメント数。
- 導入バージョン: -
max_base_compaction_num_singleton_deltas
- デフォルト: 100
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 各ベースコンパクションでコンパクト化できる最大セグメント数。
- 導入バージョン: -
base_compaction_num_threads_per_disk
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 各ストレージボリュームでのベースコンパクションに使用されるスレッド数。
- 導入バージョン: -
base_cumulative_delta_ratio
- デフォルト: 0.3
- タイプ: Double
- 単位: -
- 変更可能: はい
- 説明: 累積ファイルサイズとベースファイルサイズの比率。この比率に達することがベースコンパクションをトリガーする条件の一つです。
- 導入バージョン: -
base_compaction_interval_seconds_since_last_operation
- デフォルト: 86400
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 最後のベースコンパクションからの時間間隔。この設 定項目はベースコンパクションをトリガーする条件の一つです。
- 導入バージョン: -
cumulative_compaction_check_interval_seconds
- デフォルト: 1
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 累積コンパクションのスレッドポーリングの時間間隔。
- 導入バージョン: -
min_cumulative_compaction_num_singleton_deltas
- デフォルト: 5
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 累積コンパクションをトリガーする最小セグメント数。
- 導入バージョン: -
max_cumulative_compaction_num_singleton_deltas
- デフォルト: 1000
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 単一の累積コンパクションでマージできる最大セグメント数。コンパクション中に OOM が発生した場合、この値を減らすことができます。
- 導入バージョン: -
cumulative_compaction_num_threads_per_disk
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 各ディスクの累積コンパクションスレッド数。
- 導入バージョン: -
max_compaction_candidate_num
- デフォルト: 40960
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: コンパクションの候補タブレットの最大数。値が大きすぎると、高いメモリ使用量と高い CPU 負荷を引き起こします。
- 導入バージョン: -
update_compaction_check_interval_seconds
- デフォルト: 10
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 主キーテーブルのコンパクションをチェックする時間間隔。
- 導入バージョン: -
update_compaction_num_threads_per_disk
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 主キーテーブルのコンパクションスレッド数。
- 導入バージョン: -
update_compaction_per_tablet_min_interval_seconds
- デフォルト: 120
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 主キーテーブルの各タブレットでコンパクションがトリガーされる最小時間間隔。
- 導入バージョン: -
max_update_compaction_num_singleton_deltas
- デフォルト: 1000
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 主キーテーブルの単一コンパクションでマージできる最大 rowset 数。
- 導入バージョン: -
update_compaction_size_threshold
- デフォルト: 268435456
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 主キーテーブルのコンパクションスコアはファイルサイズに基づいて計算され、他のテーブルタイプとは異なります。このパラメータは、主キーテーブルのコンパクションスコアを他のテーブルタイプのものと類似させるために使用できます。
- 導入バージョン: -
update_compaction_result_bytes
- デフォルト: 1073741824
- タイプ: Int
- 単位: バイト
- 変更可能: はい
- 説明: 主キーテーブルの単一コンパクションの最大結果サイズ。
- 導入バージョン: -
update_compaction_delvec_file_io_amp_ratio
- デフォルト: 2
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 主キーテーブルの Delvec ファイルを含む rowset のコンパクションの優先度を制御するために使用されます。値が大きいほど優先度が高くなります。
- 導入バージョン: -
update_compaction_ratio_threshold
- デフォルト: 0.5
- タイプ: Double
- 単位: -
- 変更可能: はい
- 説明: 共有データクラスタ内の主キーテーブルのコンパクションがマージできるデータの最大割合。単一のタブレットが過度に大きくなる場合、この値を縮小することをお勧めします。
- 導入バージョン: v3.1.5
repair_compaction_interval_seconds
- デフォルト: 600
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 修復コンパクションスレッドをポ ーリングする時間間隔。
- 導入バージョン: -
manual_compaction_threads
- デフォルト: 4
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 手動コンパクションのスレッド数。
- 導入バージョン: -
min_compaction_failure_interval_sec
- デフォルト: 120
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 前回のコンパクション失敗からタブレットコンパクションがスケジュールされるまでの最小時間間隔。
- 導入バージョン: -
min_cumulative_compaction_failure_interval_sec
- デフォルト: 30
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 累積コンパクションが失敗時に再試行される最小時間間隔。
- 導入バージョン: -
max_compaction_concurrency
- デフォルト: -1
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: コンパクションの最大同時実行数 (ベースコンパクションと累積コンパクションの両方を含む)。値
-1は同時実行数に制限がないことを示します。0はコンパクションを無効にすることを示します。このパラメータは、イベントベースのコンパクションフレームワークが有効になっている場合に変更可能です。 - 導入バージョン: -
compaction_trace_threshold
- デフォルト: 60
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: 各コンパクションの時間しきい値。コンパクションが時間しきい値を超えて時間がかかる場合、StarRocks は対応するトレースを出力します。
- 導入バージョン: -
compaction_memory_limit_per_worker
- デフォルト: 2147483648
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: 各コンパクションスレッドに許可される最大メモリサイズ。
- 導入バージョン: -
enable_rowset_verify
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: 生成された rowset の正確性を確認するかどうか。 有効にすると、コンパクションとスキーマ変更後に生成された rowset の正確性がチェックされます。
- 導入バージョン: -
vertical_compaction_max_columns_per_group
- デフォルト: 5
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 垂直コンパクションの各グループの最大列数。
- 導入バージョン: -
enable_event_based_compaction_framework
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: イベントベースのコンパクションフレームワークを有効にするかどうか。
trueはイベントベースのコンパクションフレームワークが有効であることを示し、falseは無効であることを示します。イベントベースのコンパクションフレームワークを有効にすると、多くのタブレットがある場合や単一のタブレットに大量のデータがある場合にコンパクションのオーバーヘッドを大幅に削減できます。 - 導入バージョン: -
enable_size_tiered_compaction_strategy
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: サイズ階層型コンパクションポリシー (主キーテーブルを除く) を有効にするかどうか。
trueはサイズ階層型コンパクション戦略が有効であることを示し、falseは無効であることを示します。 - 導入バージョン: -
enable_pk_size_tiered_compaction_strategy
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: 主キーテーブルのサイズ階層型コンパクションポリシーを有効にするかどうか。
trueはサイズ階層型コンパクション戦略が有効であることを示し、falseは無効であることを示します。この項目は、共有データクラスタでは v3.2.4 および v3.1.10 以降、共有なしクラスタでは v3.2.5 および v3.1.10 以降で有効です。 - 導入バージョン: -
size_tiered_min_level_size
- デフォルト: 131072
- タイプ: Int
- 単位: バイト
- 変更可能: はい
- 説明: サイズ階層型コンパクションポリシーの最小レベルのデータサイズ。この値より小さい rowset は即座にデータコンパクションをトリガーします。
- 導入バージョン: -
size_tiered_level_multiple
- デフォルト: 5
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: サイズ階層型コンパクションポリシーにおける、2 つの連続するレベル間のデータサイズの 倍数。
- 導入バージョン: -
size_tiered_level_multiple_dupkey
- デフォルト: 10
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: サイズ階層型コンパクションポリシーにおける、重複キーテーブルの 2 つの隣接するレベル間のデータ量の差の倍数。
- 導入バージョン: -
size_tiered_level_num
- デフォルト: 7
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: サイズ階層型コンパクションポリシーのレベル数。各レベルには最大で 1 つの rowset が保持されます。したがって、安定した状態では、この設定項目で指定されたレベル数と同じ数の rowset が存在する可能性があります。
- 導入バージョン: -
enable_check_string_lengths
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: ロード中にデータの長さをチェックして、範囲外の VARCHAR データによるコンパクション失敗を解決するかどうか。
- 導入バージョン: -
max_row_source_mask_memory_bytes
- デフォルト: 209715200
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: 行ソースマスクバッファの最大メモリサイズ。バッファがこの値を超えると、データはディスク上の一時ファイルに保存されます。この値は
compaction_mem_limitの値より低く設定する必要があります。 - 導入バージョン: -
memory_maintenance_sleep_time_s
- デフォルト: 10
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: ColumnPool GC がトリガーされる時間間隔。StarRocks は定期的に GC を実行し、解放されたメモリをオペレーティングシステムに返します。
- 導入バージョン: -
load_process_max_memory_limit_bytes
- デフォルト: 107374182400
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: BE ノード上のすべてのロードプロセスが使用できるメモリリソースの最大サイズ制限。
- 導入バージョン: -
load_process_max_memory_limit_percent
- デフォルト: 30
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: BE ノード上のすべてのロードプロセスが使用できるメモリリソースの最大パーセンテージ制限。
- 導入バージョン: -
sync_tablet_meta
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: タブレットメタデータの同期を有効にするかどうかを制御するブール値。
trueは同期を有効にすることを示し、falseは無効にすることを示します。 - 導入バージョン: -
storage_flood_stage_usage_percent
- デフォルト: 95
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: すべての BE ディレクトリのストレージ使用率のハードリミット。BE ストレージディレクトリのストレージ使用率 (パーセンテージ) がこの値を超え、残りのストレージスペースが
storage_flood_stage_left_capacity_bytesより少ない場合、ロードおよびリストアジョブは拒否されます。この項目を FE 設定項目storage_usage_hard_limit_percentと一緒に設定する必要があります。 - 導入バージョン: -
storage_flood_stage_left_capacity_bytes
- デフォルト: 107374182400
- タイプ: Int
- 単位: バイト
- 変更可能: はい
- 説明: すべての BE ディレクトリの残りストレージスペースのハードリミット。BE ストレージディレクトリの残りストレージスペースがこの値より少なく、ストレージ使用率 (パーセンテージ) が
storage_flood_stage_usage_percentを超える場合、ロードおよびリストアジョブは拒否されます。この項目を FE 設定項目storage_usage_hard_limit_reserve_bytesと一緒に設定する必要があります。 - 導入バージョン: -
tablet_meta_checkpoint_min_new_rowsets_num
- デフォルト: 10
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 最後の TabletMeta チェックポイント以降に作成される最小 rowset 数。
- 導入バージョン: -
tablet_meta_checkpoint_min_interval_secs
- デフォルト: 600
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: TabletMeta チェックポイントのスレッドポーリングの時間間隔。
- 導入バージョン: -
tablet_map_shard_size
- デフォルト: 32
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: タブレットマップシャードサイズ。値は 2 の累乗でなければなりません。
- 導入バージョン: -
tablet_max_versions
- デフォルト: 1000
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: タブレットで許可される最大バージョン数。バージョン数がこの値を超えると、新しい書き込みリクエストは失敗します。
- 導入バージョン: -
tablet_max_pending_versions
- デフォルト: 1000
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 主キータブレットで許容される最大保留バージョン数。保留バージョンとは、コミットされているがまだ適用されていないバージョンを指します。
- 導入バージョン: -
tablet_stat_cache_update_interval_second
- デフォルト: 300
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: タブレット統計キャッシュが更新される時間間隔。
- 導入バージョン: -
enable_bitmap_union_disk_format_with_set
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: BITMAP タイプの新しいストレージ形式を有効にするかどうかを制御するブール値。これにより、bitmap_union のパフォーマンスが向上します。
trueは新しいストレージ形式を有効にすることを示し、falseは無効にすることを示します。 - 導入バージョン: -
pindex_major_compaction_limit_per_disk
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: ディスク上のコンパクションの最大同時実行数。これは、コンパクションによるディスク間の不均一な I/O の問題に対処します。この問題は、特定のディスクに対して過度に高い I/O を引き起こす可能性があります。
- 導入バージョン: v3.0.9
ローディング
push_worker_count_normal_priority
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: NORMAL 優先度のロードタスクを処理するために使用されるスレッドの数。
- 導入バージョン: -
push_worker_count_high_priority
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: HIGH 優先度のロードタスクを処理するために使用されるスレッドの数。
- 導入バージョン: -
transaction_publish_version_worker_count
- デフォルト: 0
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: バージョンを公開するために使用される最大スレッド数。この値が
0以下に設定されている場合、システムは CPU コア数を値として使用し、インポートの同時実行が高いが固定スレッド数しか使用されない場合にスレッドリソースが不足するのを避けます。v2.5 から、デフォルト値は8から0に変更されました。 - 導入バージョン: -
clear_transaction_task_worker_count
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: トランザクションをクリアするために使用されるスレッドの数。
- 導入バージョン: -
load_data_reserve_hours
- デフォルト: 4
- タイプ: Int
- 単位: 時間
- 変更可能: いいえ
- 説明: 小規模なロードによって生成されたファイルの予約時間。
- 導入バージョン: -
load_error_log_reserve_hours
- デフォルト: 48
- タイプ: Int
- 単位: 時間
- 変更可能: はい
- 説明: データロードログが保持される時間。
- 導入バージョン: -
number_tablet_writer_threads
- デフォルト: 16
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: Stream Load に使用されるスレッドの数。この設定は v3.1.7 以降、動的に変更されました。
- 導入バージョン: -
streaming_load_max_mb
- デフォルト: 102400
- タイプ: Int
- 単位: MB
- 変更可能: はい
- 説明: StarRocks にストリーミングできるファイルの最大サイズ。v3.0 から、デフォルト値は
10240から102400に変更されました。 - 導入バージョン: -
streaming_load_max_batch_size_mb
- デフォルト: 100
- タイプ: Int
- 単位: MB
- 変更可能: はい
- 説明: StarRocks にストリーミングできる JSON ファイルの最大サイズ。
- 導入バージョン: -
streaming_load_rpc_max_alive_time_sec
- デフォルト: 1200
- タイプ: Int
- 単位: 秒
- 変更可能: いいえ
- 説明: Stream Load の RPC タイムアウト。
- 導入バージョン: -
write_buffer_size
- デフォルト: 104857600
- タイプ: Int
- 単位: バイト
- 変更可能: はい
- 説明: メモリ内の MemTable のバッファサイズ。この設定項目はフラッシュをトリガーするしきい値です。
- 導入バージョン: -
load_process_max_memory_limit_bytes
- デフォルト: 107374182400
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: BE ノード上のすべてのロードプロセスが使用できるメモリリソースの最大サイズ制限。
- 導入バージョ ン: -
load_process_max_memory_limit_percent
- デフォルト: 30
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: BE ノード上のすべてのロードプロセスが使用できるメモリリソースの最大パーセンテージ制限。
- 導入バージョン: -
txn_commit_rpc_timeout_ms (非推奨)
- デフォルト: 60000
- タイプ: Int
- 単位: ミリ秒
- 変更可能: はい
- 説明: トランザクションコミット RPC のタイムアウト。v3.1.0 以降、このパラメータは非推奨です。
- 導入バージョン: -
max_consumer_num_per_group
- デフォルト: 3
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: Routine Load のコンシューマーグループ内の最大コンシューマー数。
- 導入バージ ョン: -
flush_thread_num_per_store
- デフォルト: 2
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 各ストアで MemTable をフラッシュするために使用されるスレッドの数。
- 導入バージョン: -
lake_flush_thread_num_per_store
- デフォルト: 0
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 共有データモードで各ストアで MemTable をフラッシュするために使用されるスレッドの数。この値が
0に設定されている場合、システムは CPU コア数の 2 倍を値として使用します。この値が0未満に設定されている場合、システムはその絶対値と CPU コア数の積を値として使用します。 - 導入バージョン: 3.1.12, 3.2.7
max_runnings_transactions_per_txn_map
- デフォルト: 100
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 各パーティションで同時に実行できるトランザクションの最大数。
- 導入バージョン: -
enable_stream_load_verbose_log
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: Stream Load ジョブの HTTP リクエストとレスポンスをログに記録するかどうかを指定します。
- 導入バージョン: v2.5.17, v3.0.9, v3.1.6, v3.2.1
クエリエンジン
scanner_thread_pool_thread_num
- デフォルト: 48
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: ストレージエンジンが同時ストレージボリュームスキャンに使用するスレッドの数。すべてのスレッドはスレッドプールで管理されます。
- 導入バージョン: -
scanner_thread_pool_queue_size
- デフォルト: 102400
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: ストレージエンジンがサポートするスキャンタスクの数。
- 導入バージョン: -
scanner_row_num
- デフォルト: 16384
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 各スキャンでスキャンスレッドが返す最大行数。
- 導入バージョン: -
max_scan_key_num
- デフォルト: 1024
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 各クエリによってセグメント化されるスキャンキーの最大数。
- 導入バージョン: -
max_pushdown_conditions_per_column
- デフォルト: 1024
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 各列でプッシュダウンを許可する条件の最大数。条件の数がこの制限を超えると、述語はストレージ層にプッシュダウンされません。
- 導入バージョン: -
exchg_node_buffer_size_bytes
- デフォルト: 10485760
- タイプ: Int
- 単位: バイト
- 変更可能: はい
- 説明: 各クエリの交換ノードの受信側の最大バッファサイズ。この設定項目はソフトリミットです。データが過剰な速度で受信側に送信されると、バックプレッシャーがトリガーされます。
- 導入バージョン: -
file_descriptor_cache_capacity
- デフォルト: 16384
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: キャッシュできるファイルディスクリプタの数。
- 導入バージョン: -