メインコンテンツまでスキップ
バージョン: 26.2 Preview

BE構成 - クエリとロード

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

  1. PhoenixAI Cloud コンソール にサインインします。
  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 をクリックしてクラスターを即座に再起動します。

PhoenixAI Cloud コンソールでウェアハウスの Compute ノードパラメータを設定するには、以下の手順に従ってください：

  1. PhoenixAI Cloud コンソール にサインインします。
  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 フィールドに入力します。
    注記

    PhoenixAI はパラメータキーと値の型に対する検証チェックを提供します。有効なパラメータキーと値のみが適用可能です。設定可能なパラメータの詳細については、Usage notes を参照してください。

  9. Value フィールドの隣にある保存ボタンをクリックして、パラメータ変更の記録を保存します。
  10. 変更したいすべてのパラメータを設定した後、Save changes をクリックして変更を保存します。
  11. 変更を有効にするには、適切なタイミングでウェアハウスを手動で一時停止して再開するか、Compute Node static configuration セクションで Apply to all nodes をクリックしてウェアハウスを即座に再起動します。default_warehouse の場合は、クラスターの再起動のみ可能です。

BE構成項目を表示​

以下のコマンドを使用してBE構成項目を表示できます。

SELECT * FROM information_schema.be_configs [WHERE NAME LIKE "%<name_pattern>%"]

BEパラメーターを設定​

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

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

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

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

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

このトピックでは、以下の種類のBE構成について説明します。

クエリ​

agg_hash_map_key_prefetch_dist​

  • デフォルト: 8
  • タイプ: Int
  • 単位: 行
  • 変更可能: はい
  • 説明: 複数列または非固定長のキー（シリアライズキー）で GROUP BY する集計における、第 2 段階のソフトウェアプリフェッチ距離（行単位）。このようなキーのハッシュテーブルスロットはキーのバイト列へのポインタのみを保持するため、ヒット時のキー比較は agg_hash_map_prefetch_dist では隠蔽できないキャッシュミスを待つことになります。現在の行からこの値分先の行について、ループは第 1 段階でプリフェッチ済みのスロットを読み、キーを比較せずにキャッシュされたハッシュ値が一致するエントリを見つけ、そのキーのバイト列をプリフェッチします。0 より大きく agg_hash_map_prefetch_dist より小さい場合にのみ有効で、それ以外の値では無効になります。また、ハッシュテーブル内のキーのバイト数の推定値（グループ数 × 平均キー長）が L3_size / 2 * agg_prefetch_l2_ratio に達した場合にのみ実行されます。それより小さいキーはすでにキャッシュに常駐しており、追加の段階はオーバーヘッドにしかならないためです。値はチャンクごとに 1 回読み込まれます。
  • 導入バージョン: -

agg_hash_map_prefetch_dist​

  • デフォルト: 16
  • タイプ: Int
  • 単位: 行
  • 変更可能: はい
  • 説明: 集計ハッシュマップ/ハッシュセットのプローブループにおけるソフトウェアプリフェッチ距離（行単位）。集計ハッシュテーブルの構築中、ループは現在処理中の行からこの値分先にあるバケットをプリフェッチし、大規模なテーブルにおけるメモリレイテンシを隠蔽します。0 に設定するとソフトウェアプリフェッチが無効になります。この値はチャンクごとに 1 回読み込まれるため、変更は次のチャンクから有効になります。デフォルト値の 16 は、L3 キャッシュに常駐するテーブルに対する経験値に基づいています。DRAM に常駐するワークロードではこの値を大きくし、キャッシュに常駐するワークロードでは小さくしてください。プリフェッチは agg_prefetch_l2_ratio によっても制御されます。この距離に関係なく、ハッシュテーブルが L2 キャッシュに収まっている間はプリフェッチは発行されません。
  • 導入バージョン: -

agg_prefetch_l2_ratio​

  • デフォルト: 1.0
  • タイプ: Double
  • 単位: -
  • 変更可能: はい
  • 説明: L2 レジデンシーに基づいて、集約ハッシュテーブルのソフトウェアプリフェッチを制御します。プリフェッチは、バケット配列が L2 から溢れ出した場合、つまり bucket_count * slot_bytes >= L2_size * agg_prefetch_l2_ratio となった場合にのみ有効になります。ここで、L2 サイズは実行時に検出されます（検出に失敗した場合は 1 MiB にフォールバックします）。この閾値未満の場合、テーブルは L2 に常駐しており、プリフェッチは実質的な損失となります。コアあたり多数のドライバを実行する競合の激しい環境では、テーブルあたりのL2占有率が名目上のコアあたりサイズよりも小さくなるため、この比率を下げてください。1.0 以上に設定すると、テーブルが L2 を大幅に超えるまでプリフェッチが遅延します。この比率は agg_hash_map_key_prefetch_dist のキーバイト閾値にも適用されます。agg_hash_map_prefetch_dist も参照してください。
  • 導入バージョン: -

clear_udf_cache_when_start​

  • デフォルト: false
  • タイプ: ブール
  • 単位: -
  • 変更可能: いいえ
  • 説明: 有効にすると、BEのUserFunctionCacheは起動時にローカルにキャッシュされたすべてのユーザー関数ライブラリをクリアします。UserFunctionCache::init中に、コードは_reset_cache_dir()を呼び出し、これにより設定されたUDFライブラリディレクトリ（kLibShardNumサブディレクトリに整理されている）からUDFファイルを削除し、Java/Python UDFサフィックス（.jar/.py）を持つファイルを削除します。無効の場合（デフォルト）、BEは既存のキャッシュされたUDFファイルを削除する代わりにロードします。これを有効にすると、再起動後の初回使用時にUDFバイナリが再ダウンロードされることになります（ネットワークトラフィックと初回使用時のレイテンシが増加します）。
  • 導入バージョン: v4.0.0

dictionary_speculate_min_chunk_size​

  • デフォルト: 10000
  • タイプ: 整数
  • 単位: 行
  • 変更可能: いいえ
  • 説明: StringColumnWriterとDictColumnWriterが辞書エンコーディングの推測をトリガーするために使用する最小行数（チャンクサイズ）。入力列（または蓄積されたバッファと入力行）のサイズがdictionary_speculate_min_chunk_size以上の場合、ライターはすぐに推測を実行し、より多くの行をバッファリングするのではなく、エンコーディング（DICT、PLAIN、またはBIT_SHUFFLE）を設定します。推測は、文字列列にはdictionary_encoding_ratioを、数値/非文字列列にはdictionary_encoding_ratio_for_non_string_columnを使用して、辞書エンコーディングが有益かどうかを判断します。1 MiB を超える文字列値も即座の推測をトリガーし、Plain Encoding を強制します。また、列の byte_size が UINT32_MAX 以上の場合も、BinaryColumn<uint32_t> のオーバーフローを避けるために即座の推測を強制します。
  • 導入バージョン: v3.2.0

disable_storage_page_cache​

  • デフォルト: false
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: PageCacheを無効にするかどうかを制御するブール値。
    • PageCacheが有効な場合、StarRocksは最近スキャンされたデータをキャッシュします。
    • PageCacheは、類似のクエリが頻繁に繰り返される場合に、クエリパフォーマンスを大幅に向上させることができます。
    • trueはPageCacheを無効にすることを示します。
    • この項目のデフォルト値は、StarRocks v2.4以降、trueからfalseに変更されました。
  • 導入バージョン: -

enable_glm_lookup_http_fallback​

  • デフォルト: true
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: GLM lookup 応答で HTTP fallback RPC を有効にするかどうかを制御します。ローリングアップグレードまたはダウングレード中は、すべての BE と CN ノードが lookup_via_http をサポートするまで無効のままにしてください。無効な場合、GLM lookup fetch は通常の lookup RPC を使用します。
  • 導入バージョン: -

enable_segment_replication_http_fallback​

  • デフォルト: true
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: Segment Replication で HTTP fallback RPC を有効にするかどうかを制御します。ローリングアップグレードまたはダウングレード中は、参加するすべての BE ノードが tablet_writer_add_segment_via_http をサポートするまで無効のままにしてください。無効な場合、Segment Replication は通常の tablet_writer_add_segment RPC を使用します。
  • 導入バージョン: -

enable_bitmap_index_memory_page_cache​

  • デフォルト: true
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: ビットマップインデックスのメモリキャッシュを有効にするかどうか。ポイントクエリを高速化するためにビットマップインデックスを使用したい場合は、メモリキャッシュを推奨します。
  • 導入バージョン: v3.1

フラットJSON圧縮有効化​

  • デフォルト: 真
  • 型: ブール
  • 単位:
  • 変更可能: はい
  • 説明: フラットJSONデータの圧縮を有効にするかどうか。
  • 導入バージョン: v3.3.3

JSONフラット化を有効にする​

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

遅延動的フラットJSONの有効化​

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

順序インデックスメモリページキャッシュの有効化​

  • デフォルト: true
  • 型: 真偽値
  • 単位: -
  • 可変: はい
  • 説明: 順序インデックスのメモリキャッシュを有効にするかどうか。順序インデックスは、行IDからデータページの位置へのマッピングであり、スキャンを高速化するために使用できます。
  • 導入日: -

文字列プレフィックスゾーンマップの有効化​

  • デフォルト: true
  • 型: 真偽値
  • 単位: -
  • 変更可能: はい
  • 説明: プレフィックスベースの最小/最大値を使用して、文字列 (CHAR/VARCHAR) 列にZoneMapを有効にするかどうか。非キー文字列列の場合、最小/最大値はstring_prefix_zonemap_prefix_lenで設定された固定プレフィックス長に切り詰められます。CHAR/VARCHAR 列に 1 MiB を超える値が 1 つでも存在する場合、この設定にかかわらず、StarRocks は Segment 全体のその列に ZoneMap を書き込みません。
  • 導入バージョン: -

ゾーンマップインデックスメモリページキャッシュの有効化​

  • デフォルト：true
  • 型: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: ゾーンマップインデックスのメモリキャッシュを有効にするかどうか。スキャンを高速化するためにゾーンマップインデックスを使用したい場合は、メモリキャッシュを推奨します。
  • 導入バージョン: -

exchg_node_buffer_size_bytes​

  • デフォルト: 10485760
  • タイプ: Int
  • 単位: バイト
  • 変更可能: はい
  • 説明: 各クエリの交換ノードの受信側における最大バッファサイズ。この設定項目はソフトリミットです。データが過剰な速度で受信側に送信されると、バックプレッシャーがトリガーされます。
  • 導入バージョン: -

exec_state_report_max_threads​

  • デフォルト: 2
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: はい
  • 説明: exec-state-report スレッドプールの最大スレッド数。このプールは、ExecStateReporter によって、非優先度の実行ステータスレポート（フラグメント完了やエラー状態など）を BE から FE へ RPC 経由で非同期に送信するために使用されます。起動時の実際のプールサイズは max(1, exec_state_report_max_threads) です。実行時にこの設定を変更すると、すべてのエグゼキュータセット（共有および排他）のプールで update_max_threads がトリガーされます。このプールには固定のタスクキューサイズ 1000 があり、すべてのスレッドがビジーでキューが満杯の場合、レポートの送信はサイレントに破棄されます。高優先度プール用の priority_exec_state_report_max_threads と対になっています。高いクエリ同時実行下で遅延または破棄された実行状態レポートが観測された場合は、この値を増やしてください。
  • 導入バージョン: v4.1.0, v4.0.8, v3.5.15

file_descriptor_cache_capacity​

  • デフォルト: 16384
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: キャッシュできるファイルディスクリプタの数。
  • 導入バージョン: -

flamegraph_tool_dir​

  • デフォルト: ${STARROCKS_HOME}/bin/flamegraph
  • タイプ: String
  • 単位: -
  • 変更可能: いいえ
  • 説明: フレームグラフツールのディレクトリ。プロファイルデータからフレームグラフを生成するための pprof、stackcollapse-go.pl、および flamegraph.pl スクリプトが含まれている必要があります。
  • 導入バージョン: -

fragment_pool_queue_size​

  • デフォルト: 2048
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: 各 BE ノードで処理できるクエリ数の上限。
  • 導入バージョン: -

fragment_pool_thread_num_max​

  • デフォルト: 4096
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: クエリに使用されるスレッドの最大数。
  • 導入バージョン: -

fragment_pool_thread_num_min​

  • デフォルト: 64
  • 型: Int
  • 単位: 分 -
  • 変更可能: いいえ
  • 説明: クエリに使用されるスレッドの最小数。
  • 導入バージョン: -

hdfs_client_enable_hedged_read​

  • デフォルト: false
  • 型: Boolean
  • 単位: -
  • 変更可能: いいえ
  • 説明: ヘッジドリード機能を有効にするかどうかを指定します。
  • 導入バージョン: v3.0

hdfs_client_hedged_read_threadpool_size​

  • デフォルト: 128
  • 型: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: HDFS クライアント上のヘッジドリードスレッドプールのサイズを指定します。スレッドプールサイズは、HDFS クライアントでヘッジドリードの実行に割り当てるスレッドの数を制限します。これは、dfs.client.hedged.read.threadpool.size パラメーターに相当します。hdfs-site.xmlHDFS クラスターのファイル。
  • 導入バージョン: v3.0

hdfs_client_hedged_read_threshold_millis​

  • デフォルト: 2500
  • 型: Int
  • 単位: ミリ秒
  • 変更可能: いいえ
  • 説明: ヘッジドリードを開始する前に待機するミリ秒数を指定します。たとえば、このパラメーターを 30 に設定したとします。この状況で、ブロックからの読み取りが30ミリ秒以内に返されない場合、HDFS クライアントはすぐに別のブロックレプリカに対して新しい読み取りを開始します。これは、dfs.client.hedged.read.threshold.millis パラメーターに相当します。hdfs-site.xmlHDFS クラスターのファイル。
  • 導入バージョン: v3.0

io_coalesce_adaptive_lazy_active​

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

jit_lru_cache_size​

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

json_flat_column_max​

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

json_flat_create_zonemap​

  • デフォルト: true
  • 型: Boolean
  • 単位:
  • 変更可能: はい
  • 説明: 書き込み時にフラット化されたJSONサブカラムのZoneMapを作成するかどうか。このパラメータは、enable_json_flatがtrueに設定されている場合にのみ有効です。
  • 導入バージョン: -

json_flat_null_factor​

  • デフォルト: 0.3
  • 型: Double
  • 単位:
  • 変更可能: はい
  • 説明: Flat JSONで抽出するカラム内のNULL値の割合。NULL値の割合がこのしきい値より高い場合、カラムは抽出されません。このパラメータは、enable_json_flatがtrueに設定されている場合にのみ有効です。
  • 導入バージョン: v3.3.0

json_flat_sparsity_factor​

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

lake_tablet_ignore_invalid_delete_predicate​

  • デフォルト: false
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: カラム名変更後に重複キーテーブルへの論理削除によって導入される可能性のある、タブレットの行セットメタデータ内の無効な削除述語を無視するかどうかを制御するブール値。
  • 導入バージョン: v4.0

late_materialization_ratio​

  • デフォルト: 10
  • タイプ: 整数
  • 単位: -
  • 変更可能: いいえ
  • 説明: SegmentIterator (ベクトルクエリエンジン) での遅延具現化の使用を制御する [0-1000] の範囲の整数比率。0 (または ≤ 0) の値は遅延具現化を無効にします。1000 (または ≥ 1000) はすべての読み取りに対して遅延具現化を強制します。0 より大きく 1000 未満の値は、遅延具現化と早期具現化の両方のコンテキストが準備され、イテレータが述語フィルタ比率に基づいて動作を選択する条件付き戦略を有効にします (値が高いほど遅延具現化が優先されます)。セグメントに複雑なメトリックタイプが含まれている場合、StarRocks は代わりに metric_late_materialization_ratio を使用します。lake_io_opts.cache_file_only が設定されている場合、遅延具現化は無効になります。
  • 導入バージョン: v3.2.0

max_hdfs_file_handle​

  • デフォルト: 1000
  • タイプ: 整数
  • 単位: -
  • 変更可能: はい
  • 説明: 開くことができるHDFSファイルディスクリプタの最大数。
  • 導入バージョン: -

max_hdfs_scanner_num​

  • デフォルト: 50
  • タイプ: 整数
  • 単位: -
  • 変更可能: いいえ
  • 説明: ConnectorScanNodeが同時に実行できるリモートスキャナー（HDFS、オブジェクトストレージなど）の最大同時実行数。この値は、起動時の推定同時実行数を制限し、実行時の保留中のスキャナーのスケジューリングも制限し、スレッド、メモリ、ファイルハンドルの負荷を制御します。
  • 導入バージョン: v3.2.0

max_memory_sink_batch_count​

  • デフォルト: 20
  • タイプ: 整数
  • 単位: -
  • 変更可能: はい
  • 説明: スキャンキャッシュバッチの最大数。
  • 導入バージョン: -

max_pushdown_conditions_per_column​

  • デフォルト: 1024
  • タイプ: 整数
  • 単位: -
  • 変更可能: はい
  • 説明: 各カラムでプッシュダウンを許可する条件の最大数。条件の数がこの制限を超えると、述語はストレージ層にプッシュダウンされません。
  • 導入バージョン: -

max_scan_key_num​

  • デフォルト: 1024
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: 各クエリによってセグメント化されるスキャンキーの最大数。
  • 導入バージョン: -

metric_late_materialization_ratio​

  • デフォルト: 1000
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: 複雑なメトリック列を含む読み取りに対して、遅延具体化行アクセス戦略がいつ使用されるかを制御します。有効範囲: [0-1000]。0 は遅延具体化を無効にします。1000 は、該当するすべての読み取りに対して遅延具体化を強制します。1～999の値は、述語/選択性に基づいて、遅延具体化と早期具体化の両方のコンテキストが準備され、実行時に選択される条件付き戦略を有効にします。複雑なメトリックタイプが存在する場合、metric_late_materialization_ratio は一般的な late_materialization_ratio をオーバーライドします。注: cache_file_only I/Oモードでは、この設定に関わらず遅延具体化が無効になります。
  • 導入バージョン: v3.2.0

min_file_descriptor_number​

  • デフォルト: 60000
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: BEプロセスにおけるファイルディスクリプタの最小数。
  • 導入バージョン: -

object_storage_client_cache_size​

  • デフォルト: 8
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: クライアントファクトリーごとにキャッシュされるオブジェクトストレージクライアント（S3 互換および Azure Blob）の最大数。この値はクライアント作成のたびに読み取られるため、値を下げても即座には反映されず、以降の作成時にキャッシュされたクライアントが退避されるにつれて徐々に反映されます。1 未満の値は 1 として扱われます。
  • 導入バージョン: v4.1.4, v4.0.14

object_storage_connect_timeout_ms​

  • デフォルト: -1
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: いいえ
  • 説明: オブジェクトストレージとのソケット接続を確立するためのタイムアウト期間。-1 は、SDK構成のデフォルトのタイムアウト期間を使用することを示します。
  • 導入バージョン: v3.0.9

enable_poco_client_for_aws_sdk​

  • デフォルト: false
  • タイプ: Boolean
  • 単位: -
  • 変更可能: いいえ
  • 説明: AWS SDK で Poco HTTP クライアントを使用するかどうかを指定します。true の場合、AWS SDK のデフォルトの curl HTTP クライアントを Poco に置き換えます。false の場合、デフォルトの curl クライアントを使用します。
  • 導入バージョン: -

object_storage_request_timeout_ms​

  • デフォルト: 10000
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: オブジェクトストレージへのリクエストが停滞してから、クライアントが中断して再試行するまでの時間。リクエスト全体の期限ではありません。curl クライアントでは低速時間 (転送速度が 1 バイト/秒を下回ったまま経過できる時間)、Poco クライアントではソケットの送受信タイムアウトを指します。転送が進行し続けている限り、どれだけ長くても中断されません。0 はこのチェックを無効にします。負の値はクライアント自身のデフォルト (Poco の場合は 60 秒) を使用します。
  • 導入バージョン: v3.0.9

parquet_late_materialization_enable​

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

parquet_page_index_enable​

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

parquet_reader_bloom_filter_enable​

  • デフォルト: true
  • 型: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: パフォーマンスを向上させるために、Parquetファイルのブルームフィルターを有効にするかどうかを制御するブール値です。true はブルームフィルターを有効にすることを示し、false は無効にすることを示します。この動作は、システム変数 enable_parquet_reader_bloom_filter を使用してセッションレベルで制御することもできます。Parquetのブルームフィルターは、各行グループ内の列レベルで。Parquetファイルが特定の列のブルームフィルターを含んでいる場合、クエリはそれらの列の述語を使用して行グループを効率的にスキップできます。
  • 導入バージョン: v3.5

parquet_runtime_filter_push_down_enable​

  • デフォルト: true
  • 型: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: Parquetリーダー内でデコード済みの行に対してJoin Runtime Filterを評価し、Lazy列がマテリアライズされる前に一致しない行を除外するかどうかを制御するブール値です。true はこの行レベルのプッシュダウンを有効にすることを示し、false は無効にすることを示します。無効にした場合、Runtime Filterはrow groupおよびpageの統計情報による絞り込みにのみ使用され、行レベルのフィルタリングは下流のScanオペレーターで行われます。
  • 導入バージョン: -

path_gc_check_step​

  • デフォルト: 1000
  • 型: 整数
  • 単位: -
  • 変更可能: はい
  • 説明: 毎回連続してスキャンできるファイルの最大数。
  • 導入バージョン: -

path_gc_check_step_interval_ms​

  • デフォルト: 10
  • 型: 整数
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: ファイルスキャン間の時間間隔。
  • 導入バージョン: -

path_scan_interval_second​

  • デフォルト: 86400
  • 型: 整数
  • 単位: 秒
  • 変更可能: はい
  • 説明: GCが期限切れのデータをクリーンアップする時間間隔。
  • 導入バージョン: -

pipeline_connector_scan_thread_num_per_cpu​

  • デフォルト: 8
  • タイプ: Double
  • 単位: -
  • 変更可能: はい
  • 説明: BEノードのCPUコアごとにPipeline Connectorに割り当てられるスキャン・スレッドの数。この設定はv3.1.7以降、動的に変更されます。
  • 導入バージョン: -

pipeline_poller_timeout_guard_ms​

  • デフォルト: -1
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: この項目が0より大きい値に設定されている場合、ポーラーでの単一ディスパッチにドライバーがpipeline_poller_timeout_guard_msより長くかかると、ドライバーとオペレーターの情報が出力されます。
  • 導入バージョン: -

pipeline_prepare_thread_pool_queue_size​

  • デフォルト: 102400
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: パイプライン実行エンジンのPREPAREフラグメントスレッドプールの最大キュー長。
  • 導入バージョン: -

pipeline_prepare_thread_pool_thread_num​

  • デフォルト: 0
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: パイプライン実行エンジンのPREPAREフラグメントスレッドプール内のスレッド数。0は、値がシステムVCPUコア数と等しいことを示します。
  • 導入バージョン: -

pipeline_prepare_timeout_guard_ms​

  • デフォルト: -1
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: この項目が0より大きい値に設定されている場合、PREPAREプロセス中にプランフラグメントがpipeline_prepare_timeout_guard_msを超えると、そのプランフラグメントのスタックトレースが出力されます。
  • 導入バージョン: -

pipeline_scan_thread_pool_queue_size​

  • デフォルト: 102400
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: パイプライン実行エンジンのSCANスレッドプールの最大タスクキュー長。
  • 導入バージョン: -

case_when_selective_eval_ratio​

  • デフォルト: 2
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: 検索 CASE WHEN の各 THEN 分岐を、チャンク全体で評価してから行を選び出すのではなく、その分岐が実際に所有する行だけで評価するかどうかを制御します。CASE がコレクション型 (ARRAY/MAP/STRUCT) または VARIANT 型を返す場合にのみ適用されます。これらの型は 1 行の実体化コストが高く、分岐の入力行をサブチャンクに圧縮するコストを回収できるためです。分岐が圧縮されるのは owned_rows * case_when_selective_eval_ratio < chunk_rows の場合、つまり分岐が所有する行がチャンクの 1 / case_when_selective_eval_ratio 未満の場合のみです。しきい値を超える分岐はチャンク全体で評価されます。入力の圧縮コストが省略できる評価コストを上回るためです。1 に設定すると、チャンク全体を占有しないすべての分岐が圧縮されます。0 または負の値に設定すると最適化が完全に無効になり、以前の動作に戻ります。これには、どの行も選択しない THEN や ELSE がエラーを発生させるものであっても評価されなくなるという動作の変更も含まれます。
  • 導入バージョン: -

enable_lock_free_scan_task_queue​

  • デフォルト: true
  • タイプ: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: ScanExecutor が OLAP スキャンおよびコネクタスキャンタスクのスケジューリングに LockFreeWorkGroupScanTaskQueue を使用するかどうかを制御します。有効にすると、スキャンタスクはロックフリーのワークグループごとのキューとワークグループレベルのコーディネーターを介してスケジュールされ、従来のミューテックスベースの WorkGroupScanTaskQueue と比較して競合が減少します。トラブルシューティングまたはロールバック中に従来のスキャンタスクキュー実装に戻すには、この項目を false に設定します。
  • 導入バージョン: v4.1.0

pk_index_parallel_get_threadpool_size​

  • デフォルト: 1048576
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: 共有データ (クラウドネイティブ/レイク) モードでの PK インデックス並列取得操作で使用される「cloud_native_pk_index_get」スレッドプールの最大キューサイズ (保留中のタスク数) を設定します。このプールの実際のスレッド数は pk_index_parallel_get_threadpool_max_threads によって制御されます。この設定は、実行を待機しているタスクの数を制限するだけです。非常に大きなデフォルト値 (2^20) は、キューを実質的に無制限にします。これを下げると、キューに入れられたタスクによる過剰なメモリ増加を防ぎますが、キューが満杯のときにタスクの送信がブロックされたり失敗したりする可能性があります。ワークロードの同時実行性とメモリ制約に基づいて pk_index_parallel_get_threadpool_max_threads とともに調整してください。
  • 導入バージョン: -

priority_exec_state_report_max_threads​

  • デフォルト: 2
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: はい
  • 説明: 高優先度 exec-state-report スレッドプールの最大スレッド数。このプールは、ExecStateReporter によって、高優先度の実行ステータスレポート (緊急のフラグメント障害など) を BE から FE へ RPC 経由で非同期に送信するために使用されます。通常の exec-state-report プールとは異なり、このプールには無制限のタスクキューがあります。起動時の実際のプールサイズは max(1, priority_exec_state_report_max_threads) です。実行時にこの設定を変更すると、すべてのエグゼキュータセット (共有および排他) の優先度プールで update_max_threads がトリガーされます。通常のプールには exec_state_report_max_threads と対になっています。高優先度レポートが大量の同時クエリ負荷の下で遅延する場合、この値を増やしてください。
  • 導入バージョン: v4.1.0, v4.0.8, v3.5.15

priority_queue_remaining_tasks_increased_frequency​

  • デフォルト: 512
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: BlockingPriorityQueue が、すべての残りのタスクの優先度を飢餓状態を避けるためにどれくらいの頻度で増加させるか (「エージング」するか) を制御します。get/pop が成功するたびに内部の _upgrade_counter がインクリメントされます。_upgrade_counter が priority_queue_remaining_tasks_increased_frequency を超えると、キューはすべての要素の優先度をインクリメントし、ヒープを再構築し、カウンターをリセットします。値を小さくすると、優先度エージングが頻繁に行われ (飢餓状態を減らすが、反復と再ヒープ化による CPU コストが増加する)、値を大きくすると、そのオーバーヘッドは減少しますが、優先度調整が遅延します。この値は単純な操作回数のしきい値であり、時間期間ではありません。
  • 導入バージョン: v3.2.0

query_cache_capacity​

  • デフォルト: 536870912
  • タイプ: Int
  • 単位: バイト
  • 変更可能: いいえ
  • 説明: BE のクエリキャッシュのサイズ。デフォルトサイズは 512 MB です。サイズは 4 MB 未満にすることはできません。BE のメモリ容量が、期待されるクエリキャッシュサイズをプロビジョニングするのに不十分な場合は、BE のメモリ容量を増やすことができます。
  • 導入バージョン: -

query_pool_spill_mem_limit_threshold​

  • デフォルト: 1.0
  • タイプ: Double
  • 単位: -
  • 変更可能: いいえ
  • 説明: 自動スピルが有効な場合、すべてのクエリのメモリ使用量がquery_pool memory limit * query_pool_spill_mem_limit_thresholdを超えると、中間結果のスピルがトリガーされます。
  • 導入バージョン: v3.2.7

query_scratch_dirs​

  • デフォルト: ${STARROCKS_HOME}
  • タイプ: string
  • 単位: -
  • 変更可能: いいえ
  • 説明: クエリ実行が中間データ（外部ソート、ハッシュ結合、その他の演算子など）をスピルするために使用する、書き込み可能なスクラッチディレクトリのコンマ区切りリスト。;で区切られた1つ以上のパスを指定します（例: /mnt/ssd1/tmp;/mnt/ssd2/tmp）。ディレクトリはBEプロセスからアクセス可能で書き込み可能であり、十分な空き容量が必要です。StarRocksはそれらの中から選択してスピルI/Oを分散します。変更を有効にするには再起動が必要です。ディレクトリが見つからない、書き込み可能でない、または満杯の場合、スピルが失敗したり、クエリパフォーマンスが低下したりする可能性があります。
  • 導入バージョン: v3.2.0

result_buffer_cancelled_interval_time​

  • デフォルト: 300
  • タイプ: Int
  • 単位: 秒
  • 変更可能: はい
  • 説明: BufferControlBlockがデータを解放するまでの待機時間。
  • 導入バージョン: -

scan_context_gc_interval_min​

  • デフォルト: 5
  • タイプ: Int
  • 単位: 分
  • 変更可能: はい
  • 説明: スキャンコンテキストをクリーンアップする時間間隔。
  • 導入バージョン: -

scanner_row_num​

  • デフォルト: 16384
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: スキャンにおいて、各スキャンスレッドが返す最大行数。
  • 導入バージョン: -

scanner_thread_pool_queue_size​

  • デフォルト: 102400
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: ストレージエンジンがサポートするスキャンタスクの数。
  • 導入バージョン: -

scanner_thread_pool_thread_num​

  • デフォルト: 48
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: ストレージエンジンが並行ストレージボリュームスキャンに使用するスレッドの数。すべてのスレッドはスレッドプールで管理されます。
  • 導入バージョン: -

string_prefix_zonemap_prefix_len​

  • デフォルト: 16
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: enable_string_prefix_zonemap が有効な場合に、文字列のZoneMapの最小/最大に使用されるプレフィックス長。
  • 導入バージョン: -

jvm_call_thread_pool_size​

  • デフォルト: 4
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: いいえ
  • 説明: pthread上で実行する必要がある内部JNI処理（HDFS/libhdfsのcloseおよびstat操作、JNIグローバル参照の解放など）に使用されるJVM呼び出しPriorityThreadPoolのサイズを設定します。このプールはudf_thread_pool_sizeとは独立しており、一般的なJVM処理がJava UDFの実行と競合しないようにします。
  • 導入バージョン: -

udf_thread_pool_size​

  • デフォルト: 1
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: いいえ
  • 説明: JavaEnvが所有するJava UDF呼び出しPriorityThreadPoolのサイズを設定します（Java UDF関連タスクの実行に使用されます）。この値は、スレッドプール（PriorityThreadPool("udf", thread_num, queue_size)）を構築する際、プールスレッド数およびプールキュー容量として使用されます。より多くのJava UDF同時実行を許可するには増やし、過剰なCPUおよびメモリ競合を避けるには小さく保ちます。
  • 導入バージョン: v3.2.0

update_memory_limit_percent​

  • デフォルト: 60
  • タイプ: Int
  • 単位: パーセント
  • 変更可能: いいえ
  • 説明: BEプロセスメモリのうち、更新関連のメモリとキャッシュに予約される割合。起動時に RuntimeEnv は、更新用の MemTracker を process_mem_limit * clamp(update_memory_limit_percent, 0, 100) / 100 として計算します。UpdateManager もこの割合を使用して、プライマリインデックス/インデックスキャッシュの容量を決定します（インデックスキャッシュ容量 = RuntimeEnv::process_mem_limit * update_memory_limit_percent / 100）。HTTP設定更新ロジックは、更新マネージャーで update_primary_index_memory_limit を呼び出すコールバックを登録するため、設定が変更された場合、更新サブシステムに変更が適用されます。この値を増やすと、更新/プライマリインデックスパスにより多くのメモリが割り当てられ（他のプールで利用可能なメモリが減少します）、減らすと更新メモリとキャッシュ容量が減少します。値は0〜100の範囲にクランプされます。
  • 導入バージョン: v3.2.0

enable_vector_index_block_cache​

  • デフォルト: true
  • タイプ: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: IVFPQ インデックスをインバーテッドリストの Block 単位でキャッシュするかどうかを指定します。有効にすると、StarRocks はクエリに必要な IVFPQ Block のみをロードしてキャッシュします。無効にすると、IVFPQ インデックスファイル全体をキャッシュします。HNSW のキャッシュ方式には影響しません。
  • 導入バージョン: -

config_vector_index_build_concurrency​

  • デフォルト: 8
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: はい
  • 説明: 各ベクターインデックス構築で使用する OpenMP スレッド数です。StarRocks は実効値を少なくとも 1 に調整します。vector_index_build_max_cpu_ratio とともに、非同期ベクターインデックス構築スレッドプールのサイズも決定します。
  • 導入バージョン: -

config_vector_index_default_build_threshold​

  • デフォルト: 10000
  • タイプ: Int
  • 単位: 行
  • 変更可能: はい
  • 説明: ベクターインデックスを構築するために必要な Segment のデフォルト最小行数です。インデックスプロパティ index_build_threshold はこの値を上書きします。IVFPQ では、トレーニングに十分な行数を確保するため、実効しきい値は少なくとも nlist になります。
  • 導入バージョン: -

vector_index_build_max_cpu_ratio​

  • デフォルト: 0.5
  • タイプ: Double
  • 単位: 比率
  • 変更可能: はい
  • 説明: 非同期ベクターインデックス構築で使用できる BE/CN CPU コアの目標比率です。構築 CPU 予算は max(2, floor(cpu_cores * value)) で、構築プールのサイズはこの予算と config_vector_index_build_concurrency から決まります。最小予算が 2 のため、小規模なマシンや小さい比率では実効値が設定比率を超える場合があります。
  • 導入バージョン: -
  • デフォルト: true
  • タイプ: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: HNSW ベクターインデックスの適応型 ef_search スケーリングを有効にするマスタースイッチです。有効にすると、BE は Segment の行数に基づいて実効 ef_search を調整し、Compaction により Segment が大きくなった場合の再現率低下を抑えます。false にすると、ユーザーが指定した ef_search をそのまま使用します。
  • 導入バージョン: -

vector_query_cache_capacity​

  • デフォルト: 20%
  • タイプ: String
  • 単位: バイト、単位サフィックス（K/M/G/T）または BE mem_limit に対する割合（%）
  • 変更可能: はい
  • 説明: StarRocks が管理するベクターインデックスキャッシュの総容量です。同じ LRU で HNSW のインデックス全体と、enable_vector_index_block_cache=true の場合の IVF-PQ のリスト単位 Block を管理します。絶対バイト数（4294967296）、単位付きの値（4G、512M）、または BE プロセスメモリ上限に対する割合（20%）を指定できます。BE 起動時と HTTP /api/update_config による更新時に適用されます。v4.2.0 での動作変更： 以前のバージョンは絶対バイト数のみを受け付け、デフォルトは 512 MB でした。この設定を明示的に上書きせずにアップグレードすると、キャッシュサイズは BE メモリの 20% に変更されます。
  • 導入バージョン: v3.4.0

enable_vector_index_cache_on_build​

  • デフォルト: false
  • タイプ: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: ベクターインデックスの構築時に、構築したばかりのインデックスを vector_query_cache_capacity で制御されるベクターインデックスキャッシュにも挿入するかどうかを指定します。デフォルトでは無効です。このキャッシュはクエリのワーキングセットを想定したサイズに設定されているため、ロードや Compaction が新しく構築したインデックスを次々と押し込むと、実行中のクエリが依存しているエントリが追い出され、その代償として一度もクエリされないかもしれないインデックスがウォームアップされるだけになります。クエリパスは、インデックスを最初に読み込む際に引き続きオンデマンドでキャッシュを埋めます。インデックスの構築とクエリが同じノードで実行され、かつ新しく書き込まれたデータがすぐにクエリされる場合にのみ、インデックスファイルの初回読み戻しを省くために有効化してください。変更は、その後に開始されるインデックス構築から反映されます。
  • 導入バージョン: v4.2.0

vector_index_cache_expire_sec​

  • デフォルト: 900
  • タイプ: Int
  • 単位: 秒
  • 変更可能: はい
  • 説明: 使用されていないベクターインデックスキャッシュエントリが期限切れになるまでのアイドル時間です。最後のキャッシュハンドルが解放された時点から計測を開始し、キャッシュヒット後はそのハンドルが解放された時点で期限を更新します。実行中のクエリによって pin されているエントリは削除されません。IVF-PQ の list block は所有元のインデックスエントリとまとめて解放され、独立した TTL は持ちません。0 以下に設定すると期限切れによる削除を無効にします。実行時の変更は、その後に解放されるハンドルに適用され、既存エントリの期限は書き換えられません。
  • 導入バージョン: v4.2.0

enable_vector_index_cache_async_load_on_miss​

  • デフォルト: false
  • タイプ: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: トップレベルのベクターインデックスキャッシュミスが発生したとき、現在のクエリをブルートフォース検索にフォールバックさせ、同時にバックグラウンドでインデックスをキャッシュへロードするかどうかを指定します。同じインデックスに対する同時ミスは 1 つのバックグラウンドロードを共有し、インデックスの準備が完了するまではブルートフォース検索を使用します。false の場合、キャッシュミス時にインデックスを同期的にロードします。予想されるコールドロード遅延がブルートフォース検索のコストより大きく、キャッシュにクエリワーキングセットを保持できる場合にのみ有効にしてください。実行時の変更は、その後に初期化されるベクターインデックス reader に適用されます。
  • 導入バージョン: v4.2.0

vector_index_cache_async_load_threads​

  • デフォルト: 8
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: いいえ
  • 説明: ベクターインデックスキャッシュのバックグラウンドロードスレッドプールで使用する worker の最大数です。worker はオンデマンドで作成され、60 秒間アイドル状態が続くと終了します。0 以下の値は 1 に調整されます。この項目は StorageEnv の初期化時に読み取られるため、変更を反映するには BE/CN の再起動が必要です。
  • 導入バージョン: v4.2.0

vector_index_cache_loading_wait_timeout_ms​

  • デフォルト: 5000
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: 各同期キャッシュ呼び出し元が、進行中のベクターインデックスロードの完了を待機する最大時間です。待機がタイムアウトすると、呼び出し元にはキャッシュミスが返され、クエリパスはブルートフォース検索にフォールバックできます。すでに開始されているローダーはキャンセルされず、バックグラウンドでロードを続行します。後続の各呼び出し元は、設定されたタイムアウトで個別に待機を開始します。0 以下に設定すると待機しません。実行時の変更は、その後に開始される待機に適用されます。
  • 導入バージョン: v4.2.0

vector_adaptive_ef_alpha​

  • デフォルト: 1.0
  • タイプ: Double
  • 単位: -
  • 変更可能: はい
  • 説明: 適応型 ef_search の増加率です。スケーリング係数は 1 + alpha * log2(segment_rows / vector_adaptive_ef_baseline_rows) です。値を大きくすると再現率をより積極的に高めますが、クエリごとの CPU コストが増加します。enable_vector_adaptive_search=true かつ segment_rows > vector_adaptive_ef_baseline_rows の場合のみ有効です。
  • 導入バージョン: -

vector_adaptive_ef_baseline_rows​

  • デフォルト: 300000
  • タイプ: Int
  • 単位: 行
  • 変更可能: はい
  • 説明: 適応型 ef_search を拡大しない Segment 行数の基準値です。この値以下の Segment は指定された ef_search を使用し、この値を超える Segment は大きな HNSW グラフを補うため実効 ef_search が増加します。enable_vector_adaptive_search=true の場合のみ有効です。
  • 導入バージョン: -

vector_adaptive_ef_cap​

  • デフォルト: 8.0
  • タイプ: Double
  • 単位: -
  • 変更可能: はい
  • 説明: 適応型 ef_search の倍率上限です。非常に大きな Segment でもスケーリング係数をこの値以下に抑え、CPU とレイテンシーの増加を制限します。enable_vector_adaptive_search=true の場合のみ有効です。
  • 導入バージョン: -

vector_index_brute_selectivity_threshold​

  • デフォルト: 0.01
  • タイプ: Double
  • 単位: 比率
  • 変更可能: はい
  • 説明: 残余スカラーフィルターを持つベクタークエリを、フィルター付き HNSW 探索から正確なスコア計算へ切り替える選択率しきい値です。一致行数が Segment 全体のこの割合以下の場合、StarRocks はフィルター後の候補を直接スコアリングします。0 に設定すると比率判定を無効にします。候補数がクエリの k 以下の場合の独立したショートサーキットは引き続き有効です。
  • 導入バージョン: -

enable_vector_index_topk_underfill_fallback​

  • デフォルト: false
  • タイプ: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: 事前フィルター付き top-k ベクターインデックス検索の返却行数が min(k, 一致候補数) より少ない場合に、正確なブルートフォース計算へフォールバックするかどうかを指定します。true の場合、StarRocks は一致候補を正確に再計算し、結果を可能な限り k 件まで補います。false の場合、この件数ベースのフォールバックを行わず、ベクターインデックスの結果をそのまま返します。このパラメータは事前フィルター付き top-k 検索にのみ適用されます。範囲検索では、指定した半径を満たす候補がそれ以上存在しないことで結果が少なくなる場合があるため、適用されません。
  • 導入バージョン: -

vector_index_build_flush_threshold_rows​

  • デフォルト: 262144
  • タイプ: Int
  • 単位: 行
  • 変更可能: はい
  • 説明: 各ベクターインデックスビルダーのステージングバッファが、行をメモリ内インデックスへ追加する前に保持する最大行数です。HNSW Flat 構築時のステージングバッファメモリを制限しますが、トレーニング済みインデックス自体のサイズは制限しません。0 に設定すると中間 Flush を無効にし、Segment 全体をバッファします。
  • 導入バージョン: -

vector_chunk_size​

  • デフォルト: 4096
  • タイプ: Int
  • 単位: 行
  • 変更可能: いいえ
  • 説明: 実行およびストレージのコードパス全体で使用される、ベクトル化されたチャンク（バッチ）あたりの行数。この値は、ChunkおよびRuntimeStateのbatch_size作成を制御し、オペレータのスループット、オペレータあたりのメモリフットプリント、スピルおよびソートバッファのサイズ設定、I/Oヒューリスティック（例：ORCライターの自然な書き込みサイズ）に影響します。これを増やすと、広範囲/CPUバウンドのワークロードでCPUおよびI/O効率が向上する可能性がありますが、ピークメモリ使用量が増加し、結果の小さいクエリのレイテンシが増加する可能性があります。バッチサイズがボトルネックであることがプロファイリングで示された場合にのみ調整し、それ以外の場合はメモリとパフォーマンスのバランスのためにデフォルトを維持してください。
  • 導入バージョン: v3.2.0

ロードとアンロード​

clear_transaction_task_worker_count​

  • デフォルト: 1
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: トランザクションのクリアに使用されるスレッドの数。
  • 導入バージョン: -

column_mode_partial_update_insert_batch_size​

  • デフォルト: 4096
  • 型: Int
  • 単位: -
  • 変更可能: はい
  • 説明: 挿入された行を処理する際の、カラムモードの部分更新のバッチサイズ。この項目が0または負の値に設定されている場合、無限ループを避けるために1にクランプされます。この項目は、各バッチで処理される新規挿入行の数を制御します。値が大きいほど書き込みパフォーマンスが向上しますが、より多くのメモリを消費します。
  • 導入バージョン: v3.5.10, v4.0.2

partial_update_memory_limit_per_worker​

  • デフォルト: 2147483648
  • 型: Int
  • 単位: バイト
  • 変更可能: はい
  • 説明: 部分更新操作におけるワーカー スレッドあたりの最大メモリ。部分更新を処理する際の個々のワーカー スレッドのメモリ使用量を制御します。
  • 導入バージョン: -

enable_load_spill_parallel_merge​

  • デフォルト: true
  • 型: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: 単一のタブレット内で並列スピルマージを有効にするかどうかを指定します。これを有効にすると、データロード中のスピルマージのパフォーマンスが向上する可能性があります。
  • 導入バージョン: -

enable_parallel_memtable_finalize​

  • デフォルト: true
  • 型: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: レイクテーブル (共有データモード) にデータをロードする際に、並列メンテーブルファイナライズを有効にするかどうかを指定します。有効にすると、メンテーブルファイナライズ操作 (ソート/集計) が書き込みスレッドからフラッシュスレッドに移動され、前のメンテーブルが並行してファイナライズおよびフラッシュされている間に、書き込みスレッドが新しいメンテーブルへのデータ挿入を続行できるようになります。これにより、CPU負荷の高いファイナライズ操作とI/Oバウンドのフラッシュ操作をオーバーラップさせることで、ロードスループットを大幅に向上させることができます。この最適化は、自動インクリメント列を埋める必要がある場合には自動的に無効になることに注意してください。これは、自動インクリメントIDの割り当てがメンテーブルがフラッシュのために送信される前に発生する必要があるためです。
  • 導入バージョン: -

allow_list_object_for_random_bucketing_on_cache_miss​

  • デフォルト: true
  • 型: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: ランダムバケットサイズチェック中にレイクメタデータキャッシュがミスした場合に、オブジェクトストレージのLISTフォールバックを許可するかどうかを制御します。trueは、ベースサイズを計算するためにLISTメタデータファイルにフォールバックすることを意味します（従来の動作で、より正確なサイズ見積もり）。falseはLISTをスキップし、base_size = 0を使用することを意味します。これにより、LISTオブジェクトのリクエストは減少しますが、サイズ見積もりの精度が低いため、不変マーキングが遅れる可能性があります。
  • 導入バージョン: 4.1.0, 4.0.7, 3.5.15

enable_spill_sort_events​

  • デフォルト: false
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: スピルするソートオペレーターを、ポーリングスピンの代わりにパイプラインイベントスケジューラーで駆動します。
  • 導入バージョン: -

enable_stream_load_verbose_log​

  • デフォルト: false
  • 型: Boolean
  • 単位: -
  • 変更可能: はい
  • 説明: Stream LoadジョブのHTTPリクエストとレスポンスをログに記録するかどうかを指定します。
  • 導入バージョン: v2.5.17, v3.0.9, v3.1.6, v3.2.1

flush_thread_num_per_store​

  • デフォルト: 2
  • 型: Int
  • 単位: -
  • 変更可能: はい
  • 説明: 各ストアでMemTableをフラッシュするために使用されるスレッドの数。
  • 導入バージョン: -

lake_flush_thread_num_per_store​

  • デフォルト: 0
  • 型: Int
  • 単位: -
  • 変更可能: はい
  • 説明: 共有データクラスターの各ストアでMemTableをフラッシュするために使用されるスレッドの数。 この値が0に設定されている場合、システムはCPUコア数の2倍の値を設定します。 この値が0未満に設定されている場合、システムはその絶対値とCPUコア数の積を値として使用します。
  • 導入バージョン: v3.1.12, 3.2.7

load_data_reserve_hours​

  • デフォルト: 4
  • 型: Int
  • 単位: 時間
  • 変更可能: いいえ
  • 説明: 小規模なロードによって生成されたファイルの予約時間。
  • 導入バージョン: -

load_error_log_reserve_hours​

  • デフォルト: 48
  • 型: Int
  • 単位: 時間
  • 変更可能: はい
  • 説明: データロードログが予約される時間。
  • 導入バージョン: -

load_process_max_memory_limit_bytes​

  • デフォルト: 107374182400
  • 型: Int
  • 単位: バイト
  • 変更可能: いいえ
  • 説明: BEノード上のすべてのロードプロセスが占有できるメモリリソースの最大サイズ制限。
  • 導入バージョン: -

load_spill_memory_usage_per_merge​

  • デフォルト: 1073741824
  • タイプ: Int
  • 単位: バイト
  • 変更可能: はい
  • 説明: スピルマージ中のマージ操作あたりの最大メモリ使用量。デフォルトは1 GB (1073741824バイト) です。このパラメータは、データロードのスピルマージ中の個々のマージタスクのメモリ消費を制御し、過剰なメモリ使用を防ぎます。
  • 導入バージョン: -

max_consumer_num_per_group​

  • デフォルト: 3
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: ルーチンロードのコンシューマーグループにおけるコンシューマーの最大数。
  • 導入バージョン: -

max_runnings_transactions_per_txn_map​

  • デフォルト: 100
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: 各パーティションで同時に実行できるトランザクションの最大数。
  • 導入バージョン: -

number_tablet_writer_threads​

  • デフォルト: 0
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: Stream Load、Broker Load、Insertなどの取り込みで使用されるタブレットライタースレッドの数。パラメータが0以下に設定されている場合、システムはCPUコア数の半分を使用し、最小値は16です。パラメータが0より大きい値に設定されている場合、システムはその値を使用します。この設定はv3.1.7以降、動的に変更されました。
  • 導入バージョン: -

push_worker_count_high_priority​

  • デフォルト: 3
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: HIGH優先度のロードタスクを処理するために使用されるスレッドの数。
  • 導入バージョン: -

push_worker_count_normal_priority​

  • デフォルト: 3
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: NORMAL優先度のロードタスクを処理するために使用されるスレッドの数。
  • 導入バージョン: -

streaming_load_max_batch_size_mb​

  • デフォルト: 100
  • タイプ: Int
  • 単位: MB
  • 変更可能: はい
  • 説明: StarRocksにストリーミングできるJSONファイルの最大サイズ。
  • 導入バージョン: -

streaming_load_max_mb​

  • デフォルト: 102400
  • タイプ: Int
  • 単位: MB
  • 変更可能: はい
  • 説明: StarRocksにストリーミングできるファイルの最大サイズ。v3.0以降、デフォルト値は10240から102400に変更されました。
  • 導入バージョン: -

streaming_load_rpc_max_alive_time_sec​

  • デフォルト: 1200
  • タイプ: Int
  • 単位: 秒
  • 変更可能: いいえ
  • 説明: ストリームロードのRPCタイムアウト。
  • 導入バージョン: -

transaction_publish_version_thread_pool_num_min​

  • デフォルト: 0
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: はい
  • 説明: パブリッシュバージョン・スレッドプール内の最小スレッド数。アイドル時にプールはこの値まで縮小できます。0は固定の下限がないことを意味します。
  • 導入バージョン: -

transaction_publish_version_thread_pool_idle_time_ms​

  • デフォルト: 60000
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: いいえ
  • 説明: パブリッシュバージョン・スレッドプールによってスレッドが再利用されるまでのアイドル時間。
  • 導入バージョン: -

transaction_publish_version_worker_count​

  • デフォルト: 0
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • 説明: バージョンを公開するために使用されるスレッドの最大数。この値が0以下に設定されている場合、システムはCPUコア数を値として使用します。これにより、インポートの同時実行性が高いにもかかわらず固定数のスレッドしか使用されない場合に、スレッドリソースの不足を回避します。v2.5以降、デフォルト値は8から0に変更されました。
  • 導入バージョン: -

use_mmap_allocate_chunk​

  • デフォルト: false
  • タイプ: ブール
  • 単位: -
  • 変更可能: いいえ
  • 説明: チャンク割り当てに匿名mmap (MAP_ANONYMOUS | MAP_PRIVATE) を使用するかどうか。有効にすると、多くのVMマッピングが作成されます。vm.max_map_count (例: echo 262144 > /proc/sys/vm/max_map_count) を増やし、大きなchunk_reserved_bytes_limitを設定する必要があります。そうしないと、頻繁なマップ/アンマップ操作により深刻なパフォーマンス低下が発生します。
  • 導入バージョン: v3.2.0

write_buffer_size​

  • デフォルト: 104857600
  • タイプ: 整数
  • 単位: バイト
  • 変更可能: はい
  • 説明: メモリ内のMemTableのバッファサイズ。この設定項目は、フラッシュをトリガーするしきい値です。
  • 導入バージョン: -

broker_write_timeout_seconds​

  • デフォルト: 30
  • タイプ: 整数
  • 単位: 秒
  • 変更可能: いいえ
  • 説明: バックエンドブローカー操作が書き込み/IO RPCに使用するタイムアウト（秒単位）。この値は1000倍されてミリ秒単位のタイムアウトとなり、BrokerFileSystemおよびBrokerServiceConnectionインスタンス（例: ファイルのエクスポート、スナップショットのアップロード/ダウンロード）にデフォルトのtimeout_msとして渡されます。ブローカーまたはネットワークが遅い場合、または大きなファイルを転送する際に、時期尚早なタイムアウトを避けるためにこの値を増やしてください。値を減らすと、ブローカーRPCがより早く失敗する可能性があります。この値はcommon/configで定義されており、プロセス開始時に適用されます（動的にリロード可能ではありません）。
  • 導入バージョン: v3.2.0

enable_load_channel_rpc_async​

  • デフォルト: true
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: 有効にすると、ロードチャネルオープンRPC（例: PTabletWriterOpen）の処理がBRPCワーカーから専用のスレッドプールにオフロードされます。リクエストハンドラはChannelOpenTaskを作成し、LoadChannelMgr::_openをインラインで実行する代わりに、内部の_async_rpc_poolに送信します。これにより、BRPCスレッド内の作業とブロッキングが減少し、load_channel_rpc_thread_pool_numとload_channel_rpc_thread_pool_queue_sizeを介して同時実行性を調整できます。スレッドプールの送信が失敗した場合（プールが満杯またはシャットダウンされている場合）、リクエストはキャンセルされ、エラー状態が返されます。プールはLoadChannelMgr::close()でシャットダウンされるため、この機能を有効にする場合は、リクエストの拒否や処理の遅延を避けるために、容量とライフサイクルを考慮してください。
  • 導入バージョン: v3.5.0

enable_load_chunk_all_null_encoding​

  • デフォルト: true
  • タイプ: ブール
  • 単位: -
  • 変更可能: いいえ
  • 説明: この BE が、ロード時に行を対象 tablet を保持する BE へルーティングするホップ（tablet sink RPC）において、全行が NULL である列のコンパクトなエンコーディングに参加するかどうかを制御します。有効にすると、受信側の BE は tablet writer の open レスポンスでこのエンコーディングへの対応を通知し、その通知を受け取った送信側の BE は、全行が NULL の列について、行ごとの NULL フラグとオフセットの代わりに行数のみを送信します。列数が多く、その大半にデータが入っていないワイドテーブルで特に効果が大きく、このホップの転送バイト数と送受信両側のシリアライズ処理がいずれも削減されます。このエンコーディングは RPC の両端が対応している場合にのみ使用されるため、バージョンが混在するクラスタやダウングレード後は自動的に従来のレイアウトにフォールバックします。送信側または受信側のいずれかの BE でこの項目を false に設定すると、そのノードを経由するロードではエンコーディングが無効になります。この項目は動的に変更できません。受信側の BE はこの値を、対応の通知と、送信側が宣言したエンコーディングを適用するかどうかの判断の両方に使用するため、実行中に変更すると両者が一致しなくなります。
  • 導入バージョン: v4.2.0

enable_load_diagnose​

  • デフォルト: true
  • タイプ: ブール
  • 単位: -
  • 変更可能: はい
  • 説明: 有効にすると、StarRocksは「[E1008]Reached timeout」に一致するbrpcタイムアウトの後、BE OlapTableSink/NodeChannelから自動ロード診断を試行します。コードはPLoadDiagnoseRequestを作成し、リモートのLoadChannelにRPCを送信してプロファイルやスタックトレースを収集します（load_diagnose_rpc_timeout_profile_threshold_msとload_diagnose_rpc_timeout_stack_trace_threshold_msで制御）。診断RPCはload_diagnose_send_rpc_timeout_msをタイムアウトとして使用します。診断リクエストがすでに進行中の場合、診断はスキップされます。これを有効にすると、ターゲットノードで追加のRPCとプロファイリング作業が発生します。追加のオーバーヘッドを避けるため、機密性の高い本番ワークロードでは無効にしてください。
  • 導入バージョン: v3.5.0

enable_load_segment_parallel​

  • デフォルト: false
  • タイプ: ブール
  • 単位: -
  • 変更可能: いいえ
  • Description: 有効にすると、StarRocksのバックグラウンドスレッドプール（ExecEnv::load_segment_thread_poolとExecEnv::load_rowset_thread_pool）を使用して、rowsetセグメントのロードとrowsetレベルの読み取りが並行して実行されます。Rowset::load_segmentsとTabletReader::get_segment_iteratorsは、セグメントごとまたはrowsetごとのタスクをこれらのプールに送信し、送信が失敗した場合はシリアルロードにフォールバックして警告をログに記録します。これを有効にすると、CPU/IOの並行性とメモリ負荷が増加する代わりに、大規模なrowsetの読み取り/ロードレイテンシを削減できます。注：並行ロードはセグメントのロード完了順序を変更する可能性があり、部分的なコンパクションを妨げます（コードは_parallel_loadをチェックし、有効な場合は部分的なコンパクションを無効にします）。セグメントの順序に依存する操作への影響を考慮してください。
  • 導入バージョン: v3.3.0, v3.4.0, v3.5.0

enable_streaming_load_thread_pool​

  • デフォルト: true
  • タイプ: Boolean
  • 単位: -
  • 変更可能: はい
  • Description: ストリーミングロードスキャナーが専用のストリーミングロードスレッドプールに送信されるかどうかを制御します。有効で、クエリがTLoadJobType::STREAM_LOADを持つLOADである場合、ConnectorScanNodeはスキャナータスクをstreaming_load_thread_pool（INT32_MAXスレッドとキューサイズ、つまり実質的に無制限に設定されています）に送信します。無効の場合、スキャナーは一般的なthread_poolとそのPriorityThreadPoolの送信ロジック（優先度計算、try_offer/offer動作）を使用します。有効にすると、ストリーミングロードの作業が通常のクエリ実行から分離され、干渉が減少します。ただし、専用プールは実質的に無制限であるため、有効にすると、大量のストリーミングロードトラフィック下で同時実行スレッドとリソース使用量が増加する可能性があります。このオプションはデフォルトでオンになっており、通常は変更する必要はありません。
  • 導入バージョン: v3.2.0

es_http_timeout_ms​

  • デフォルト: 5000
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: いいえ
  • Description: ESScanReaderのESネットワーククライアントがElasticsearchのスクロールリクエストに使用するHTTP接続タイムアウト（ミリ秒単位）です。この値は、後続のスクロールPOSTを送信する前にnetwork_client.set_timeout_ms()を介して適用され、スクロール中にクライアントがES応答を待つ時間を制御します。遅いネットワークや大規模なクエリの場合、早すぎるタイムアウトを避けるためにこの値を増やしてください。応答しないESノードでより早く失敗させるには減らしてください。この設定は、スクロールコンテキストのキープアライブ期間を制御するes_scroll_keepaliveを補完します。
  • 導入バージョン: v3.2.0

es_index_max_result_window​

  • デフォルト: 10000
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • Description: StarRocksがElasticsearchから単一バッチでリクエストするドキュメントの最大数を制限します。StarRocksは、ESリーダーのKEY_BATCH_SIZEを構築する際に、ESリクエストバッチサイズをmin(es_index_max_result_window, chunk_size)に設定します。ESリクエストがElasticsearchインデックス設定index.max_result_windowを超えると、ElasticsearchはHTTP 400 (Bad Request) を返します。大規模なインデックスをスキャンする場合、この値を調整するか、Elasticsearch側でES index.max_result_windowを増やして、より大きな単一リクエストを許可してください。
  • 導入バージョン: v3.2.0

ignore_load_tablet_failure​

  • デフォルト: false
  • タイプ: Boolean
  • 単位: -
  • 変更可能: いいえ
  • Description: この項目がfalseに設定されている場合、システムはタブレットヘッダーのロード失敗（NotFoundおよびAlreadyExist以外のエラー）を致命的と見なします。コードはエラーをログに記録し、LOG(FATAL)を呼び出してBEプロセスを停止します。trueに設定されている場合、BEは個々のタブレットのロードエラーにもかかわらず起動を続行します。失敗したタブレットIDは記録されスキップされますが、成功したタブレットは引き続きロードされます。このパラメータは、RocksDBメタスキャン自体からの致命的なエラーを抑制するものではないことに注意してください。RocksDBメタスキャンからの致命的なエラーは常にプロセスを終了させます。
  • 導入バージョン: v3.2.0

load_channel_abort_clean_up_delay_seconds​

  • デフォルト: 600
  • タイプ: Int
  • 単位: 秒
  • 変更可能: はい
  • Description: システムが中止されたロードチャネルのロードIDを_aborted_load_channelsから削除するまでの期間（秒単位）を制御します。ロードジョブがキャンセルまたは失敗した場合、ロードIDは記録されたままになり、遅れて到着するロードRPCをすぐに拒否できます。遅延期間が経過すると、定期的なバックグラウンドスイープ中にエントリがクリーンアップされます（最小スイープ間隔は60秒）。遅延を短くしすぎると、中止後に迷子のRPCを受け入れるリスクがあり、長すぎると、必要以上に状態を保持し、リソースを消費する可能性があります。遅延リクエスト拒否の正確性と、中止されたロードのリソース保持のバランスを取るために、これを調整してください。
  • 導入バージョン: v3.5.11, v4.0.4

load_channel_rpc_thread_pool_num​

  • デフォルト: -1
  • タイプ: Int
  • 単位: スレッド
  • 変更可能: はい
  • 説明: ロードチャネル非同期RPCスレッドプール用の最大スレッド数。0以下（デフォルト -1）に設定すると、プールサイズはCPUコア数（CpuInfo::num_cores()）に自動設定されます。設定された値はThreadPoolBuilderの最大スレッドとして使用され、プールの最小スレッドはmin(5, max_threads)に設定されます。プールキューサイズは load_channel_rpc_thread_pool_queue_size によって個別に制御されます。この設定は、非同期RPCプールサイズをbrpcワーカーのデフォルト（brpc_num_threads）に合わせるために導入され、ロードRPC処理を同期から非同期に切り替えた後も動作の互換性を維持します。実行時にこの設定を変更すると ExecEnv::GetInstance()->load_channel_mgr()->async_rpc_pool()->update_max_threads(...) がトリガーされます。
  • 導入バージョン: v3.5.0

load_channel_rpc_thread_pool_queue_size​

  • デフォルト: 1024000
  • タイプ: int
  • 単位: 数
  • 変更可能: いいえ
  • 説明: LoadChannelMgrによって作成されるロードチャネルRPCスレッドプールの、保留中のタスクキューの最大サイズを設定します。このスレッドプールは、enable_load_channel_rpc_async が有効な場合に非同期 open リクエストを実行します。プールサイズは load_channel_rpc_thread_pool_num と対になっています。大きなデフォルト値（1024000）は、同期から非同期処理への切り替え後も動作を維持するために、brpcワーカーのデフォルトと一致しています。キューが満杯の場合、ThreadPool::submit() は失敗し、受信したオープンRPCはエラーでキャンセルされ、呼び出し元は拒否を受け取ります。この値を増やすと、より大きな同時 open リクエストのバーストをバッファリングできます。値を減らすとバックプレッシャーが厳しくなりますが、負荷がかかったときに拒否が増える可能性があります。
  • 導入バージョン: v3.5.0

load_diagnose_rpc_timeout_profile_threshold_ms​

  • デフォルト: 60000
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: ロードRPCがタイムアウトし（エラーに「[E1008]Reached timeout」が含まれる）、enable_load_diagnose がtrueの場合、このしきい値は完全なプロファイリング診断が要求されるかどうかを制御します。リクエストレベルのRPCタイムアウト _rpc_timeout_ms が load_diagnose_rpc_timeout_profile_threshold_ms より大きい場合、その診断に対してプロファイリングが有効になります。_rpc_timeout_ms の値が小さい場合、リアルタイム/短時間タイムアウトの負荷に対する頻繁な重い診断を避けるため、プロファイリングは20回のタイムアウトごとに1回サンプリングされます。この値は、送信される PLoadDiagnoseRequest 内の profile フラグに影響します。スタックトレースの動作は load_diagnose_rpc_timeout_stack_trace_threshold_ms によって、送信タイムアウトは load_diagnose_send_rpc_timeout_ms によって個別に制御されます。
  • 導入バージョン: v3.5.0

load_diagnose_rpc_timeout_stack_trace_threshold_ms​

  • デフォルト: 600000
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: 長時間実行されるロードRPCのリモートスタックトレースをいつ要求するかを決定するために使用されるしきい値（ミリ秒単位）。ロードRPCがタイムアウトエラーでタイムアウトし、実効RPCタイムアウト（_rpc_timeout_ms）がこの値を超えると、OlapTableSink/NodeChannel は、ターゲットBEへの load_diagnose RPCに stack_trace=true を含め、BEがデバッグ用のスタックトレースを返せるようにします。LocalTabletsChannel::SecondaryReplicasWaiter は、セカンダリレプリカの待機がこの間隔を超えた場合、プライマリからのベストエフォートのスタックトレース診断もトリガーします。この動作には enable_load_diagnose が必要で、診断RPCタイムアウトには load_diagnose_send_rpc_timeout_ms を使用します。プロファイリングは load_diagnose_rpc_timeout_profile_threshold_ms によって個別に制御されます。この値を下げると、スタックトレースが要求される頻度が高まります。
  • 導入バージョン: v3.5.0

load_diagnose_send_rpc_timeout_ms​

  • デフォルト: 2000
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: BEロードパスによって開始される診断関連のbrpc呼び出しに適用されるタイムアウト（ミリ秒単位）。これは、load_diagnose RPC（LoadChannel brpc呼び出しがタイムアウトしたときにNodeChannel/OlapTableSinkによって送信される）およびレプリカステータスクエリ（プライマリレプリカの状態を確認するときにSecondaryReplicasWaiter / LocalTabletsChannelによって使用される）のコントローラタイムアウトを設定するために使用されます。リモート側がプロファイルまたはスタックトレースデータで応答できる十分な高さの値を選択しますが、障害処理が遅延するほど高くしないようにします。このパラメータは、診断情報がいつ、どのようなものが要求されるかを制御する enable_load_diagnose、load_diagnose_rpc_timeout_profile_threshold_ms、および load_diagnose_rpc_timeout_stack_trace_threshold_ms と連携して機能します。
  • 導入バージョン: v3.5.0

load_fp_brpc_timeout_ms​

  • デフォルト: -1
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • 説明: node_channel_set_brpc_timeout 障害点がトリガーされたときにOlapTableSinkが使用するチャネルごとのbrpc RPCタイムアウトを上書きします。正の値に設定すると、NodeChannelはその内部 _rpc_timeout_ms をこの値（ミリ秒単位）に設定し、open/add-chunk/cancel RPCがより短いタイムアウトを使用するようにし、「[E1008]Reached timeout」エラーを生成するbrpcタイムアウトのシミュレーションを可能にします。デフォルト（-1）では上書きが無効になります。この値の変更はテストおよび障害注入を目的としています。小さい値は誤ったタイムアウトを生成し、ロード診断をトリガーする可能性があります（enable_load_diagnose、load_diagnose_rpc_timeout_profile_threshold_ms、load_diagnose_rpc_timeout_stack_trace_threshold_ms、および load_diagnose_send_rpc_timeout_ms を参照）。
  • 導入バージョン: v3.5.0

load_fp_tablets_channel_add_chunk_block_ms​

  • デフォルト: -1
  • タイプ: Int
  • 単位: ミリ秒
  • 変更可能: はい
  • Description: 有効にすると（正のミリ秒値に設定すると）、このフェイルポイント設定により、ロード処理中にTabletsChannel::add_chunkが指定された時間スリープします。これは、BRPCタイムアウトエラー（例：「[E1008]Reached timeout」）をシミュレートし、ロードレイテンシを増加させる高コストなadd_chunk操作をエミュレートするために使用されます。0以下の値（デフォルト -1）はインジェクションを無効にします。障害処理、タイムアウト、レプリカ同期動作のテストを目的としています。書き込み完了を遅延させ、アップストリームのタイムアウトやレプリカの中止を引き起こす可能性があるため、通常のプロダクションワークロードでは有効にしないでください。
  • 導入バージョン: v3.5.0

load_segment_thread_pool_num_max​

  • デフォルト: 128
  • タイプ: Int
  • 単位: -
  • 変更可能: いいえ
  • Description: BEのロード関連スレッドプールの最大ワーカー数を設定します。この値はThreadPoolBuilderによって、exec_env.cpp内のload_rowset_poolとload_segment_poolの両方のスレッドを制限するために使用され、ストリーミングおよびバッチロード中のロードされたrowsetとセグメントの処理（例：デコード、インデックス作成、書き込み）の並行性を制御します。この値を増やすと並列性が向上し、ロードスループットが改善される可能性がありますが、CPU、メモリ使用量、および潜在的な競合も増加します。減らすと、同時ロード処理が制限され、スループットが低下する可能性があります。load_segment_thread_pool_queue_sizeおよびstreaming_load_thread_pool_idle_time_msと合わせて調整してください。変更にはBEの再起動が必要です。
  • 導入バージョン: v3.3.0, v3.4.0, v3.5.0

load_segment_thread_pool_queue_size​

  • デフォルト: 10240
  • タイプ: Int
  • 単位: タスク
  • 変更可能: いいえ
  • Description: 「load_rowset_pool」および「load_segment_pool」として作成されたロード関連スレッドプールの最大キュー長（保留中のタスク数）を設定します。これらのプールは最大スレッド数にload_segment_thread_pool_num_maxを使用し、この設定は、ThreadPoolのオーバーフローポリシーが適用される前に、いくつのロードセグメント/rowsetタスクをバッファリングできるかを制御します（ThreadPoolの実装に応じて、それ以上の送信は拒否またはブロックされる場合があります）。保留中のロード作業を増やすには値を増やします（メモリ使用量が増え、レイテンシが上昇する可能性があります）。バッファリングされたロードの並行性を制限し、メモリ使用量を減らすには値を減らします。
  • 導入バージョン: v3.3.0, v3.4.0, v3.5.0

max_pulsar_consumer_num_per_group​

  • デフォルト: 10
  • タイプ: Int
  • 単位: -
  • 変更可能: はい
  • Description: BE上のルーチンロードのために、単一のデータコンシューマグループで作成できるPulsarコンシューマの最大数を制御します。複数トピックのサブスクリプションでは累積確認応答がサポートされていないため、各コンシューマは正確に1つのトピック/パーティションをサブスクライブします。pulsar_info->partitions内のパーティション数がこの値を超えると、グループ作成は失敗し、BE上でmax_pulsar_consumer_num_per_groupを増やすか、BEを追加するよう促すエラーが表示されます。この制限はPulsarDataConsumerGroupを構築する際に適用され、BEが1つのルーチンロードグループに対してこれ以上の数のコンシューマをホストすることを防ぎます。Kafkaルーチンロードの場合、代わりにmax_consumer_num_per_groupが使用されます。
  • 導入バージョン: v3.2.0

pull_load_task_dir​

  • デフォルト: ${STARROCKS_HOME}/var/pull_load
  • タイプ: string
  • 単位: -
  • 変更可能: いいえ
  • Description: BEが「プルロード」タスク（ダウンロードされたソースファイル、タスク状態、一時出力など）のデータと作業ファイルを保存するファイルシステムパス。このディレクトリはBEプロセスによって書き込み可能であり、受信するロードのために十分なディスクスペースが必要です。デフォルトはSTARROCKS_HOMEからの相対パスです。テストはこのディレクトリが作成され、存在することを期待します（テスト設定を参照）。
  • 導入バージョン: v3.2.0

routine_load_kafka_timeout_second​

  • デフォルト: 10
  • タイプ: Int
  • 単位: 秒
  • 変更可能: いいえ
  • 説明: Kafka関連のルーチンロード操作に使用されるタイムアウト（秒）。クライアントリクエストがタイムアウトを指定しない場合、get_infoのデフォルトRPCタイムアウトとしてroutine_load_kafka_timeout_secondが使用されます（ミリ秒に変換）。また、librdkafkaコンシューマの呼び出しごとのコンシュームポーリングタイムアウトとしても使用されます（ミリ秒に変換され、残りの実行時間で上限が設定されます）。注: 内部のget_infoパスは、FE側のタイムアウト競合を避けるため、librdkafkaに渡す前にこの値を80%に減らします。この値を、タイムリーな障害報告とネットワーク/ブローカー応答に十分な時間のバランスが取れるように設定してください。この設定は変更できないため、変更には再起動が必要です。
  • 導入バージョン: v3.2.0

routine_load_pulsar_timeout_second​

  • デフォルト: 10
  • 型: Int
  • 単位: 秒
  • 変更可能: いいえ
  • 説明: リクエストが明示的なタイムアウトを提供しない場合に、BEがPulsar関連のルーチンロード操作に使用するデフォルトのタイムアウト（秒）。具体的には、PInternalServiceImplBase::get_pulsar_infoはこの値を1000倍して、Pulsarパーティションメタデータとバックログを取得するルーチンロードタスクエグゼキュータメソッドに渡されるミリ秒単位のタイムアウトを形成します。Pulsarの応答が遅いことを許容する代わりに障害検出が長くなる場合は値を増やし、遅いブローカーでより早く失敗させる場合は値を減らしてください。Kafkaに使用されるroutine_load_kafka_timeout_secondに類似しています。
  • 導入バージョン: v3.2.0

streaming_load_thread_pool_idle_time_ms​

  • デフォルト: 2000
  • 型: Int
  • 単位: ミリ秒
  • 変更可能: いいえ
  • 説明: ストリーミングロード関連のスレッドプールに対するスレッドアイドルタイムアウト（ミリ秒）を設定します。この値は、stream_load_ioプール、load_rowset_pool、およびload_segment_poolのThreadPoolBuilderに渡されるアイドルタイムアウトとして使用されます。これらのプール内のスレッドは、この期間アイドル状態になると解放されます。値が低いとアイドルリソースの使用量が減りますが、スレッド作成のオーバーヘッドが増加し、値が高いとスレッドがより長くアクティブな状態を保ちます。enable_streaming_load_thread_poolが有効な場合、stream_load_ioプールが使用されます。
  • 導入バージョン: v3.2.0

streaming_load_thread_pool_num_min​

  • デフォルト: 0
  • 型: Int
  • 単位: -
  • 変更可能: いいえ
  • 説明: ExecEnv初期化中に作成されるストリーミングロードIOスレッドプール（"stream_load_io"）の最小スレッド数。このプールはset_max_threads(INT32_MAX)とset_max_queue_size(INT32_MAX)で構築されるため、同時ストリーミングロードでのデッドロックを避けるために実質的に無制限です。値が0の場合、プールはスレッドなしで開始し、オンデマンドで増加します。正の値を設定すると、起動時にその数のスレッドが予約されます。このプールはenable_streaming_load_thread_poolがtrueの場合に使用され、そのアイドルタイムアウトはstreaming_load_thread_pool_idle_time_msによって制御されます。全体的な並行性は依然としてfragment_pool_thread_num_maxとwebserver_num_workersによって制約されます。この値を変更する必要があることはめったになく、高すぎるとリソース使用量が増加する可能性があります。
  • 導入バージョン: v3.2.0