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
- 単位: -
- 変更可能: いいえ
- 説明: キャッシュできるファイルディスクリプタの数。
- 導入バージョン: -
min_file_descriptor_number
- デフォルト: 60000
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: BE プロセスの最小ファイルディスクリプタ数。
- 導入バージョン: -
index_stream_cache_capacity
- デフォルト: 10737418240
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: BloomFilter、Min、Max の統計情報のキャッシュ容量。
- 導入バージョン: -
storage_page_cache_limit
- デフォルト: 20%
- タイプ: String
- 単位: -
- 変更可能: はい
- 説明: PageCache サイズ。サイズとして指定できます。例:
20G
、20,480M
、20,971,520K
、21,474,836,480B
。または、メモリサイズに対する比率 (パーセンテージ) として指定できます。例:20%
。disable_storage_page_cache
がfalse
に設定されている場合にのみ有効です。 - 導入バージョン: -
disable_storage_page_cache
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: PageCache を無効にするかどうかを制御するブール値。
- PageCache が有効な場合、StarRocks は最近スキャンされたデータをキャッシュします。
- PageCache は、類似のクエリが頻繁に繰り返される場合にクエリパフォーマンスを大幅に向上させることができます。
true
は PageCache を無効にすることを示します。- この項目のデフォルト値は StarRocks v2.4 以降、
true
からfalse
に変更されました。
- 導入バージョン: -
fragment_pool_thread_num_min
- デフォルト: 64
- タイプ: Int
- 単位: 分
- 変更可能: いいえ
- 説明: クエリに使用される最小スレッド数。
- 導入バージョン: -
fragment_pool_thread_num_max
- デフォルト: 4096
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: クエリに使用される最大スレッド数。
- 導入バージョン: -
fragment_pool_queue_size
- デフォルト: 2048
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 各 BE ノードで処理できるクエリ数の上限。
- 導入バージョン: -
enable_prefetch
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: クエリのプリフェッチを有効にするかどうかを制御するブール値。
true
はプリフェッチを有効にすることを示し、false
は無効にすることを示します。 - 導入バージョン: -
query_pool_spill_mem_limit_threshold
- デフォルト: 1.0
- タイプ: Double
- 単位: -
- 変更可能: いいえ
- 説明: 自動スピリングが有効な場合、すべてのクエリのメモリ使用量が
query_pool memory limit * query_pool_spill_mem_limit_threshold
を超えると、中間結果のスピリングがトリガーされます。 - 導入バージョン: v3.2.7
result_buffer_cancelled_interval_time
- デフォルト: 300
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: BufferControlBlock がデータを解放する前の待機時間。
- 導入バージョン: -
max_memory_sink_batch_count
- デフォルト: 20
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: スキャンキャッシュバッチの最大数。
- 導入バージョン: -
scan_context_gc_interval_min
- デフォルト: 5
- タイプ: Int
- 単位: 分
- 変更可能: はい
- 説明: スキャンコンテキストをクリーンアップする時間間隔。
- 導入バージョン: -
path_gc_check_step
- デフォルト: 1000
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 連続してスキャンできる最大ファイル数。
- 導入バージョン: -
path_gc_check_step_interval_ms
- デフォルト: 10
- タイプ: Int
- 単位: ミリ秒
- 変更可能: はい
- 説明: ファイルスキャン間の時間間隔。
- 導入バージョン: -
path_scan_interval_second
- デフォルト: 86400
- タイプ: Int
- 単位: 秒
- 変更可能: はい
- 説明: GC が期限切れデータをクリーンアップする時間間隔。
- 導入バージョン: -
pipeline_connector_scan_thread_num_per_cpu
- デフォルト: 8
- タイプ: Double
- 単位: -
- 変更可能: はい
- 説明: BE ノードの各 CPU コアに割り当てられた Pipeline Connector のスキャンスレッド数。この設定は v3.1.7 以降、動的に変更されました。
- 導入バージョン: -
max_hdfs_file_handle
- デフォルト: 1000
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 開くことができる HDFS ファイルディスクリプタの最大数。
- 導入バージョン: -
object_storage_connect_timeout_ms
- デフォルト: -1
- タイプ: Int
- 単位: ミリ秒
- 変更可能: いいえ
- 説明: オブジェクトストレージとのソケット接続を確立するためのタイムアウト期間。
-1
は SDK 設定のデフォルトのタイムアウト期間を使用することを示します。 - 導入バージョン: v3.0.9
object_storage_request_timeout_ms
- デフォルト: -1
- タイプ: Int
- 単位: ミリ秒
- 変更可能: いいえ
- 説明: オブジェクトストレージとの HTTP 接続を確立するためのタイムアウト期間。
-1
は SDK 設定のデフォルトのタイムアウト期間を使用することを示します。 - 導入バージョン: v3.0.9
hdfs_client_enable_hedged_read
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: ヘッジドリード機能を有効にするかどうかを指定します。
- 導入バージョン: v3.0
hdfs_client_hedged_read_threadpool_size
- デフォルト: 128
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: HDFS クライアントのヘッジドリードスレッドプールのサイズを指定します。スレッドプールのサイズは、HDFS クライアントでヘッジドリードを実行するために専用のスレッド数を制限します。これは、HDFS クラスタの hdfs-site.xml ファイルの
dfs.client.hedged.read.threadpool.size
パラメータに相当します。 - 導入バージョン: v3.0
hdfs_client_hedged_read_threshold_millis
- デフォルト: 2500
- タイプ: Int
- 単位: ミリ秒
- 変更可能: いいえ
- 説明: ヘッジドリードを開始するまでの待機時間をミリ秒単位で指定します。たとえば、このパラメータを
30
に設定した場合、この状況では、ブロックからの読み取りが 30 ミリ秒以内に返されない場合、HDFS クライアントは直ちに別のブロックレプリカに対して新しい読み取りを開始します。これは、HDFS クラスタの hdfs-site.xml ファイルのdfs.client.hedged.read.threshold.millis
パラメータに相当します。 - 導入バージョン: v3.0
query_cache_capacity
- デフォルト: 536870912
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: BE のクエリキャッシュのサイズ。デフォルトサイズは 512 MB です。サイズは 4 MB 未満にすることはできません。BE のメモリ容量が期待するクエリキャッシュサイズを提供するのに不十分な場合、BE のメモリ容量を増やすことができます。
- 導入バージョン: -
共有データ
starlet_port
- デフォルト: 9070
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: BE および CN のための追加のエージェントサービスポート。
- 導入バージョン: -
starlet_use_star_cache
- デフォルト: v3.1 では false、v3.2.3 以降は true
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: 共有データクラスタで Data Cache を有効にするかどうか。
true
はこの機能を有効にすることを示し、false
は無効にすることを示します。デフォルト値は v3.2.3 以降、false
からtrue
に設定されました。 - 導入バージョン: v3.1
starlet_star_cache_disk_size_percent
- デフォルト: 80
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 共有データクラスタで Data Cache が使用できるディスク容量の割合。
- 導入バージョン: v3.1
lake_compaction_stream_buffer_size_bytes
- デフォルト: 1048576
- タイプ: Int
- 単位: バイト
- 変更可能: はい
- 説明: 共有データクラスタでのクラウドネイティブテーブルコンパクションのリーダーのリモート I/O バッファサイズ。デフォルト値は 1MB です。この値を増やすことでコンパクションプロセスを加速できます。
- 導入バージョン: v3.2.3
lake_pk_compaction_max_input_rowsets
- デフォルト: 500
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: 共有データクラスタでの主キーテーブルコンパクションタスクで許可される最大入力 rowset 数。このパラメータのデフォルト値は v3.2.4 および v3.1.10 以降
5
から1000
に、v3.3.1 および v3.2.9 以降500
に変更されました。主キーテーブルのサイズ階層型コンパクションポリシーが有効になった後 (enable_pk_size_tiered_compaction_strategy
をtrue
に設定することで)、StarRocks は各コンパクションの rowset 数を制限して書き込み増幅を減らす必要がなくなります。したがって、このパラメータのデフォルト値が増加しました。 - 導入バージョン: v3.1.8, v3.2.3
データレイク
jdbc_connection_pool_size
- デフォルト: 8
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: JDBC 接続プールのサイズ。各 BE ノードで、同じ
jdbc_url
を持つ外部テーブルにアクセスするクエリは同じ接続プールを共有します。 - 導入バージョン: -
jdbc_minimum_idle_connections
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: JDBC 接続プール内の最小アイドル接続数。
- 導入バージョン: -
jdbc_connection_idle_timeout_ms
- デフォルト: 600000
- タイプ: Int
- 単位: ミリ秒
- 変更可能: いいえ
- 説明: JDBC 接続プール内のアイドル接続が期限切れになるまでの時間。JDBC 接続プール内の接続アイドル時間がこの値を超えると、接続プールは設定項目
jdbc_minimum_idle_connections
で指定された数を超えるアイドル接続を閉じます。 - 導入バージョン: -
datacache_enable
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: Data Cache を有効にするかどうか。
true
は Data Cache が有効であることを示し、false
は無効であることを示します。 - 導入バージョン: -
datacache_mem_size
- デフォルト: 10%
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: メモリにキャッシュできるデータの最大量。パーセンテージ (例:
10%
) または物理的な制限 (例:10G
、21474836480
) として設定できます。このパラメータの値を少なくとも 10 GB に設定することをお勧めします。 - 導入バージョン: -
datacache_disk_size
- デフォルト: 0
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: 単一のディスクにキャッシュできるデータの最大量。パーセンテージ (例:
80%
) または物理的な制限 (例:2T
、500G
) として設定できます。たとえば、datacache_disk_path
パラメータに 2 つのディスクパスを設定し、datacache_disk_size
パラメータの値を21474836480
(20 GB) に設定した場合、これらの 2 つのディスクに最大 40 GB のデータをキャッシュできます。デフォルト値は0
で、これはメモリのみを使用してデータをキャッシュすることを示します。 - 導入バージョン: -
datacache_disk_path
- デフォルト:
${STARROCKS_HOME}/datacache/
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: ディスクのパス。このパラメータに設定するパスの数は、BE マシン上のディスクの数と同じであることをお勧めします。複数のパスはセミコロン (;) で区切る必要があります。
- 導入バージョン: -
datacache_meta_path
- デフォルト:
${STARROCKS_HOME}/datacache/
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: ブロックメタデータのストレージパス。ストレージパスをカスタマイズできます。メタデータを
$STARROCKS_HOME
パスの下に保存することをお勧めします。 - 導入バージョン: -
datacache_block_buffer_enable
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: Data Cache の効率を最適化するために Block Buffer を有効にするかどうか。Block Buffer が有効な場合、システムは Data Cache から Block データを読み取り、一時バッファにキャッシュすることで、頻繁なキャッシュ読み取りによる余分なオーバーヘッドを削減します。
- 導入バージョン: v3.2.0
datacache_tiered_cache_enable
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: Data Cache の階層型キャッシュモードを有効にするかどうか。階層型キャッシュモードが有効な場合、Data Cache はメモリとディスクの 2 層のキャッシュを構成します。ディスクデータがホットデータになると、自動的にメモリキャッシュにロードされ、メモリキャッシュ内のデータがコールドになると、自動的にディスクにフラッシュされます。階層型キャッシュモードが有効でない場合、Data Cache に設定されたメモリとディスクは 2 つの独立したキャッシュスペースを形成し、異なるタイプのデータをキャッシュし、データの流れはありません。
- 導入バージョン: v3.2.5
query_max_memory_limit_percent
- デフォルト: 90
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: Query Pool が使用できる最大メモリ。プロセスメモリ制限のパーセンテージとして表現されます。
- 導入バージョン: v3.1.0
lake_service_max_concurrency
- デフォルト: 0
- タイプ: Int
- 単位: -
- 変更可能: いいえ
- 説明: 共有データクラスタでの RPC リクエストの最大同時実行数。このしきい値に達すると、受信リクエストは拒否されます。この項目が
0
に設定されている場合、同時実行数に制限はありません。 - 導入バージョン: -
lake_enable_vertical_compaction_fill_data_cache
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: 共有データクラスタでコンパクションタスクがローカルディスクにデータをキャッシュすることを許可するかどうか。
- 導入バージョン: v3.1.7, v3.2.3
その他
user_function_dir
- デフォルト:
${STARROCKS_HOME}/lib/udf
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: ユーザー定義関数 (UDF) を保存するためのディレクトリ。
- 導入バージョン: -
default_mv_resource_group_memory_limit
- デフォルト: 0.8
- タイプ: Double
- 単位: -
- 変更可能: はい
- 説明: リソースグループ
default_mv_wg
のマテリアライズドビューリフレッシュタスクが使用できる最大メモリ割合 (BE ノードごと)。デフォルト値はメモリの 80% を示します。 - 導入バージョン: v3.1
default_mv_resource_group_cpu_limit
- デフォルト: 1
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: リソースグループ
default_mv_wg
のマテリアライズドビューリフレッシュタスクが使用できる最大 CPU コア数 (BE ノードごと)。 - 導入バージョン: v3.1
default_mv_resource_group_concurrency_limit
- デフォルト: 0
- タイプ: Int
- 単位: -
- 変更可能: はい
- 説明: リソースグループ
default_mv_wg
のマテリアライズドビューリフレッシュタスクの最大同時実行数 (BE ノードごと)。デフォルト値0
は制限がないことを示します。 - 導入バージョン: v3.1
default_mv_resource_group_spill_mem_limit_threshold
- デフォルト: 0.8
- タイプ: Double
- 単位: -
- 変更可能: はい
- 説明: リソースグループ
default_mv_wg
のマテリアライズドビューリフレッシュタスクが中間結果のスピリングをトリガーする前のメモリ使用量しきい値。デフォルト値はメモリの 80% を示します。 - 導入バージョン: v3.1
enable_token_check
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: はい
- 説明: トークンチェックを有効にするかどうかを制御するブール値。
true
はトークンチェックを有効にすることを示し、false
は無効にすることを示します。 - 導入バージョン: -
small_file_dir
- デフォルト:
${STARROCKS_HOME}/lib/small_file/
- タイプ: String
- 単位: -
- 変更可能: いいえ
- 説明: ファイルマネージャーによってダウンロードされたファイルを保存するためのディレクトリ。
- 導入バージョン: -
max_length_for_to_base64
- デフォルト: 200000
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: to_base64() 関数の入力値の最大長。
- 導入バージョン: -
max_length_for_bitmap_function
- デフォルト: 1000000
- タイプ: Int
- 単位: バイト
- 変更可能: いいえ
- 説明: ビットマップ関数の入力値の最大長。
- 導入バージョン: -