BE Configuration

一部の BE 構成項目は動的パラメータであり、BE ノードがオンラインのときに対話的に設定できます。それ以外は静的パラメータです。静的パラメータは、CelerData Cloud BYOC コンソールで変更することでのみ設定できます。

1. CelerData Cloud BYOC コンソール にサインインします。
2. Clusters ページで、構成したいクラシック クラスターをクリックします。
3. クラスターの詳細ページで、Cluster parameters タブをクリックします。
4. BE Node static configuration セクションで、View all parameter list をクリックします。
5. 表示されるダイアログ ボックスで、New parameter をクリックします。
6. Parameter key フィールドに構成したい静的パラメータの名前を入力し、Value フィールドに設定したいパラメータ値を入力します。構成可能なパラメータの詳細については、Usage notes を参照してください。
7. Value フィールドの横にある保存ボタンをクリックして、パラメータ変更の記録を保存します。
8. 変更したいすべてのパラメータを構成した後、Save changes をクリックして変更を保存します。
9. 変更を有効にするには、適切なタイミングでクラスターを手動で一時停止して再開するか、BE Node static configuration セクションで Apply to all nodes をクリックしてクラスターを即座に再起動します。

これらの手順に従って、弾力性のあるクラスターのウェアハウス内の CN ノードの静的パラメータを設定します。

1. CelerData Cloud BYOC コンソール にサインインします。
2. Clusters ページで、設定したい弾力性のあるクラスターをクリックします。
3. クラスターの詳細ページで、Warehouses タブをクリックします。
4. Warehouses タブで、設定したいウェアハウスをクリックします。
5. ウェアハウスの詳細ページで、Warehouse parameters タブをクリックします。
6. Compute node static configuration セクションで、View all parameter list をクリックします。
7. 表示されるダイアログボックスで、New parameter をクリックします。
8. 設定したい静的パラメータの名前を Parameter key フィールドに入力し、設定したいパラメータ値を Value フィールドに入力します。設定可能なパラメータの詳細については、Usage notes を参照してください。
9. Value フィールドの隣にある保存ボタンをクリックして、パラメータ変更の記録を保存します。
10. 変更したいすべてのパラメータを設定した後、Save changes をクリックして変更を保存します。
11. 変更を有効にするには、適切なタイミングでクラスターを手動で一時停止して再開するか、Compute node static configuration セクションで Apply to all nodes をクリックしてクラスターを即座に再起動します。

BE の設定項目を表示する

次のコマンドを使用して BE の設定項目を表示できます。

curl http://<BE_IP>:<BE_HTTP_PORT>/varz

BE パラメータを設定する

BE の動的パラメータを設定する

curl コマンドを使用して、BE ノードの動的パラメータを設定できます。

curl -XPOST http://be_host:http_port/api/update_config?<configuration_item>=<value>

BE の静的パラメータを設定する

BE の静的パラメータは、CelerData Cloud BYOC コンソールで変更し、BE を再起動して変更を有効にすることでのみ設定できます。

BE パラメータを理解する

サーバー

priority_networks

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 可変性: いいえ
• 説明: 複数の IP アドレスを持つサーバーの選択戦略を宣言します。このパラメータで指定されたリストと一致する IP アドレスは最大で 1 つである必要があります。このパラメータの値は CIDR 表記でセミコロン (;) で区切られたエントリからなるリストです。例: 10.10.10.0/24。このリストのエントリと一致する IP アドレスがない場合、サーバーの利用可能な IP アドレスがランダムに選択されます。v3.3.0 から、StarRocks は IPv6 に基づくデプロイをサポートしています。サーバーに IPv4 と IPv6 の両方のアドレスがある場合、このパラメータが指定されていないと、システムはデフォルトで IPv4 アドレスを使用します。この動作を変更するには、net_use_ipv6_when_priority_networks_empty を true に設定します。
• 導入バージョン: -

net_use_ipv6_when_priority_networks_empty

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 可変性: いいえ
• 説明: priority_networks が指定されていない場合に IPv6 アドレスを優先的に使用するかどうかを制御するブール値です。true は、ノードをホストするサーバーが IPv4 と IPv6 の両方のアドレスを持ち、priority_networks が指定されていない場合に、システムが IPv6 アドレスを優先的に使用することを許可することを示します。
• 導入バージョン: v3.3.0

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
• 単位: -
• 可変性: いいえ
• 説明: BE bRPC ポートで、bRPC のネットワーク統計を表示するために使用されます。
• 導入バージョン: -

brpc_num_threads

• デフォルト: -1
• タイプ: Int
• 単位: -
• 可変性: いいえ
• 説明: bRPC の bthreads の数。値 -1 は CPU スレッドと同じ数を示します。
• 導入バージョン: -

brpc_max_body_size

• デフォルト: 2147483648
• タイプ: Int
• 単位: バイト
• 可変性: いいえ
• 説明: bRPC の最大ボディサイズ。
• 導入バージョン: -

Heartbeat

heartbeat_service_port

• デフォルト: 9050
• タイプ: Int
• 単位: -
• 可変性: いいえ
• 説明: BE ハートビートサービスポートで、FE からのハートビートを受信するために使用されます。
• 導入バージョン: -

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 で指定されます。
• 導入バージョン: -

download_low_speed_time

• デフォルト: 300
• タイプ: Int
• 単位: 秒
• 可変性: はい
• 説明: ダウンロード速度が下限を下回る状態で HTTP リクエストが実行できる最大時間。この設定項目で指定された時間内に download_low_speed_limit_kbps の値よりも低速で動作し続ける場合、HTTP リクエストは中止されます。
• 導入バージョン: -

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
• 単位: 秒
• 可変性: はい
• 説明: ディスクの健康状態を監視する時間間隔。
• 導入バージョン: -

replication_threads

• デフォルト: 0
• タイプ: Int
• 単位: -
• 可変性: はい
• 説明: レプリケーションに使用される最大スレッド数。0 は、スレッド数を BE CPU コア数の 4 倍に設定することを示します。
• 導入バージョン: v3.3.5

replication_max_speed_limit_kbps

• デフォルト: 50000
• タイプ: Int
• 単位: KB/s
• 可変性: はい
• 説明: 各レプリケーションスレッドの最大速度。
• 導入バージョン: v3.3.5

replication_min_speed_limit_kbps

• デフォルト: 50
• タイプ: Int
• 単位: KB/s
• 可変性: はい
• 説明: 各レプリケーションスレッドの最小速度。
• 導入バージョン: v3.3.5

replication_min_speed_time_seconds

• デフォルト: 300
• タイプ: Int
• 単位: 秒
• 可変性: はい
• 説明: レプリケーションスレッドが最小速度を下回ることが許可される時間。実際の速度が replication_min_speed_limit_kbps を下回る時間がこの値を超えると、レプリケーションは失敗します。
• 導入バージョン: v3.3.5

clear_expired_replication_snapshots_interval_seconds

• デフォルト: 3600
• タイプ: Int
• 単位: 秒
• 可変性: はい
• 説明: 異常なレプリケーションによって残された期限切れのスナップショットをシステムがクリアする時間間隔。
• 導入バージョン: v3.3.5

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 ノード上のすべてのロードプロセスが占有できるメモリリソースのソフトリミット (パーセンテージ)。
• 導入バージョン: -

load_process_max_memory_hard_limit_ratio

• デフォルト: 2
• タイプ: Int
• 単位: -
• 可変性: はい
• 説明: BE ノード上のすべてのロードプロセスが占有できるメモリリソースのハードリミット (比率)。enable_new_load_on_memory_limit_exceeded が false に設定されている場合、すべてのロードプロセスのメモリ消費が load_process_max_memory_limit_percent * load_process_max_memory_hard_limit_ratio を超えると、新しいロードプロセスは拒否されます。
• 導入バージョン: v3.3.2

enable_new_load_on_memory_limit_exceeded

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 可変性: はい
• 説明: ハードメモリリソース制限に達した場合に新しいロードプロセスを許可するかどうか。true は新しいロードプロセスが許可されることを示し、false は拒否されることを示します。
• 導入バージョン: v3.3.2

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 ノード上のすべてのロードプロセスが占有できるメモリリソースの最大サイズ制限。
• 導入バージョン: -

txn_commit_rpc_timeout_ms (廃止)

• デフォルト: 60000
• タイプ: Int
• 単位: ミリ秒
• 可変性: はい
• 説明: トランザクションコミット RPC のタイムアウト。v3.2.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 メモリリミット * 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

parquet_late_materialization_enable

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 可変性: いいえ
• 説明: パフォーマンスを向上させるために Parquet リーダーの後期実体化を有効にするかどうかを制御するブール値。true は後期実体化を有効にすることを示し、false は無効にすることを示します。
• 導入バージョン: -

parquet_late_materialization_v2_enable

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 可変性: いいえ
• 説明: パフォーマンスを向上させるために Parquet リーダーの後期実体化 v2 を有効にするかどうかを制御するブール値。true は後期実体化 v2 を有効にすることを示し、false は無効にすることを示します。v3.3 では、parquet_late_materialization_enable のみが使用され、この変数は廃止されました。
• 導入バージョン: v3.2

parquet_page_index_enable

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 可変性: いいえ
• 説明: パフォーマンスを向上させるために Parquet ファイルのページインデックスを有効にするかどうかを制御するブール値。true はページインデックスを有効にすることを示し、false は無効にすることを示します。
• 導入バージョン: v3.3

io_coalesce_adaptive_lazy_active

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 可変性: はい
• 説明: 述語の選択性に基づいて、述語列と非述語列の I/O を結合するかどうかを適応的に決定します。
• 導入バージョン: v3.2

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 のメモリ容量を増やすことができます。
• 導入バージョン: -

enable_json_flat

• デフォルト: false
• タイプ: Boolean
• 単位:
• 可変性: はい
• 説明: Flat JSON 機能を有効にするかどうか。 この機能を有効にすると、新しくロードされた JSON データが自動的にフラット化され、JSON クエリパフォーマンスが向上します。
• 導入バージョン: v3.3.0

json_flat_null_factor

• デフォルト: 0.3
• タイプ: Double
• 単位:
• 可変性: はい
• 説明: Flat JSON の列から抽出する NULL 値の割合。列の NULL 値の割合がこのしきい値を超える場合、その列は抽出されません。このパラメータは enable_json_flat が true に設定されている場合にのみ有効です。
• 導入バージョン: v3.3.0

json_flat_sparsity_factor

• デフォルト: 0.9
• タイプ: Double
• 単位:
• 可変性: はい
• 説明: Flat JSON の同じ名前の列の割合。この値より低い場合、抽出は行われません。このパラメータは enable_json_flat が true に設定されている場合にのみ有効です。
• 導入バージョン: v3.3.0

json_flat_column_max

• デフォルト: 100
• タイプ: Int
• 単位:
• 可変性: はい
• 説明: Flat JSON によって抽出できるサブフィールドの最大数。このパラメータは enable_json_flat が true に設定されている場合にのみ有効です。
• 導入バージョン: v3.3.0

enable_compaction_flat_json

• デフォルト: True
• タイプ: Boolean
• 単位:
• 可変性: はい
• 説明: Flat JSON データのコンパクションを有効にするかどうか。
• 導入バージョン: v3.3.3

enable_lazy_dynamic_flat_json

• デフォルト: True
• タイプ: Boolean
• 単位:
• 可変性: はい
• 説明: クエリが読み取りプロセスで Flat JSON スキーマを見逃した場合に Lazy Dynamic Flat JSON を有効にするかどうか。この項目が true に設定されている場合、StarRocks は Flat JSON 操作を読み取りプロセスではなく計算プロセスに延期します。
• 導入バージョン: v3.3.3

jit_lru_cache_size

• デフォルト: 0
• タイプ: Int
• 単位: GB
• 可変性: はい
• 説明: JIT コンパイルの LRU キャッシュサイズ。0 より大きい場合はキャッシュの実際のサイズを表します。0 以下に設定されている場合、システムは jit_lru_cache_size = min(mem_limit*0.01, 1GB) の式を使用してキャッシュを適応的に設定します (ノードの mem_limit は 16 GB 以上である必要があります)。
• 導入バージョン: -

Shared-data

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

starlet_fslib_s3client_request_timeout_ms

• デフォルト: -1
• タイプ: Int
• 単位: ミリ秒
• 可変性: いいえ
• 説明: object_storage_request_timeout_ms のエイリアス。詳細は object_storage_request_timeout_ms を参照してください。
• 導入バージョン: v3.3.9

starlet_filesystem_instance_cache_capacity

• デフォルト: 10000
• タイプ: Int
• 単位: 秒
• 可変: はい
• 説明: starlet filesystem インスタンスのキャッシュ容量。
• 導入バージョン: v3.2.16, v3.3.11, v3.4.1

starlet_filesystem_instance_cache_ttl_sec

• デフォルト: 86400
• タイプ: Int
• 単位: 秒
• 可変: はい
• 説明: starlet filesystem インスタンス キャッシュの有効期限。
• 導入バージョン: v3.3.15, 3.4.5

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

Data Lake

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

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 可変性: いいえ
• 説明: Data Cache を有効にするかどうか。true は Data Cache が有効であることを示し、false は無効であることを示します。デフォルト値は v3.3 から true に変更されました。
• 導入バージョン: -

datacache_mem_size

• デフォルト: 0
• タイプ: String
• 単位: -
• 可変性: いいえ
• 説明: メモリにキャッシュできるデータの最大量。パーセンテージ (例: 10%) または物理的な制限 (例: 10G、21474836480) として設定できます。
• 導入バージョン: -

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_auto_adjust_enable

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 可変性: はい
• 説明: Data Cache ディスク容量の自動スケーリングを有効にするかどうか。これを有効にすると、システムは現在のディスク使用率に基づいてキャッシュ容量を動的に調整します。
• 導入バージョン: v3.3.0

datacache_disk_high_level

• デフォルト: 80
• タイプ: Int
• 単位: -
• 可変性: はい
• 説明: キャッシュ容量の自動スケーリングをトリガーするディスク使用率 (パーセンテージ) の上限。この値を超えると、システムは Data Cache からキャッシュデータを自動的に削除します。
• 導入バージョン: v3.3.0

datacache_disk_safe_level

• デフォルト: 70
• タイプ: Int
• 単位: -
• 可変性: はい
• 説明: Data Cache のディスク使用率 (パーセンテージ) の安全レベル。Data Cache が自動スケーリングを実行する際、システムはディスク使用率をこの値にできるだけ近づけることを目指してキャッシュ容量を調整します。
• 導入バージョン: v3.3.0

datacache_disk_low_level

• デフォルト: 60
• タイプ: Int
• 単位: -
• 可変性: はい
• 説明: キャッシュ容量の自動スケーリングをトリガーするディスク使用率 (パーセンテージ) の下限。この値を下回る状態が datacache_disk_idle_seconds_for_expansion で指定された期間続き、Data Cache に割り当てられたスペースが完全に利用されている場合、システムは上限を増やしてキャッシュ容量を自動的に拡張します。
• 導入バージョン: v3.3.0

datacache_disk_adjust_interval_seconds

• デフォルト: 10
• タイプ: Int
• 単位: 秒
• 可変性: はい
• 説明: Data Cache 自動容量スケーリングの間隔。定期的に、システムはキャッシュディスクの使用状況をチェックし、必要に応じて自動スケーリングをトリガーします。
• 導入バージョン: v3.3.0

datacache_disk_idle_seconds_for_expansion

• デフォルト: 7200
• タイプ: Int
• 単位: 秒
• 可変性: はい
• 説明: Data Cache 自動拡張の最小待機時間。ディスク使用率が datacache_disk_low_level を下回る状態がこの期間を超えた場合にのみ、自動スケーリングアップがトリガーされます。
• 導入バージョン: v3.3.0

datacache_min_disk_quota_for_adjustment

• デフォルト: 107374182400
• タイプ: Int
• 単位: バイト
• 可変性: はい
• 説明: Data Cache 自動スケーリングの最小有効容量。システムがキャッシュ容量をこの値よりも少なく調整しようとする場合、キャッシュ容量は直接 0 に設定され、キャッシュ容量が不十分なために頻繁なキャッシュの充填と削除によって引き起こされるパフォーマンスの低下を防ぎます。
• 導入バージョン: v3.3.0

datacache_block_buffer_enable

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 可変性: いいえ
• 説明: Data Cache の効率を最適化するためにブロックバッファを有効にするかどうか。ブロックバッファが有効な場合、システムは Data Cache からブロックデータを読み取り、一時バッファにキャッシュすることで、頻繁なキャッシュ読み取りによる余分なオーバーヘッドを削減します。
• 導入バージョン: 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
• 単位: -
• 可変性: いいえ
• 説明: クエリプールが使用できる最大メモリ。プロセスメモリリミットのパーセンテージとして表されます。
• 導入バージョン: 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
• 単位: バイト
• 可変性: いいえ
• 説明: ビットマップ関数の入力値の最大長。
• 導入バージョン: -