FE Configuration

FE parameters are classified into dynamic parameters and static parameters.

• Dynamic parameters can be configured and adjusted by running SQL commands, which is very convenient. But the configurations become invalid if you restart your FE. Therefore, we recommend that you also modify the configuration items in the fe.conf file to prevent the loss of modifications.

• Static parameters can only be configured and adjusted in the FE configuration file fe.conf. After you modify this file, you must restart your FE for the changes to take effect.

Whether a parameter is a dynamic parameter is indicated by the IsMutable column in the output of ADMIN SHOW CONFIG. TRUE indicates a dynamic parameter.

Note that both dynamic and static FE parameters can be configured in the fe.conf file.

FE の設定項目を表示する

FE が起動した後、MySQL クライアントで ADMIN SHOW FRONTEND CONFIG コマンドを実行して、パラメータ設定を確認できます。特定のパラメータの設定を確認したい場合は、次のコマンドを実行します。

ADMIN SHOW FRONTEND CONFIG [LIKE "pattern"];

返されるフィールドの詳細な説明については、 ADMIN SHOW CONFIG を参照してください。

注記

クラスタ管理関連のコマンドを実行するには、管理者権限が必要です。

FE パラメータを設定する

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

ADMIN SET FRONTEND CONFIG を使用して、FE 動的パラメータの設定を変更できます。

ADMIN SET FRONTEND CONFIG ("key" = "value");

注記

The configuration changes made with ADMIN SET FRONTEND will be restored to the default values in the fe.conf file after the FE restarts. Therefore, we recommend that you also modify the configuration items in fe.conf if you want the changes to be permanent.

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

注記

Static parameters of an FE are set by changing them in the configuration file fe.conf and restarting the FE to allow the changes to take effect.

FE パラメータを理解する

ロギング

log_roll_size_mb

• デフォルト: 1024
• タイプ: Int
• 単位: MB
• 変更可能: いいえ
• 説明: システムログファイルまたは監査ログファイルの最大サイズ。
• 導入バージョン: -

sys_log_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/log"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: システムログファイルを保存するディレクトリ。
• 導入バージョン: -

sys_log_level

• デフォルト: INFO
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: システムログエントリが分類される重大度レベル。 有効な値: INFO, WARN, ERROR, FATAL。
• 導入バージョン: -

sys_log_roll_num

• デフォルト: 10
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: sys_log_roll_interval パラメータで指定された保持期間内に保持できるシステムログファイルの最大数。
• 導入バージョン: -

sys_log_verbose_modules

• デフォルト: 空の文字列
• タイプ: String[]
• 単位: -
• 変更可能: いいえ
• 説明: StarRocks がシステムログを生成するモジュール。このパラメータが org.apache.starrocks.catalog に設定されている場合、StarRocks は catalog モジュールのシステムログのみを生成します。モジュール名はカンマ (,) とスペースで区切ります。
• 導入バージョン: -

sys_log_roll_interval

• デフォルト: DAY
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: StarRocks がシステムログエントリをローテーションする時間間隔。有効な値: DAY と HOUR。
  • このパラメータが DAY に設定されている場合、システムログファイルの名前に yyyyMMdd 形式のサフィックスが追加されます。
  • このパラメータが HOUR に設定されている場合、システムログファイルの名前に yyyyMMddHH 形式のサフィックスが追加されます。
• 導入バージョン: -

sys_log_delete_age

• デフォルト: 7d
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: システムログファイルの保持期間。デフォルト値 7d は、各システムログファイルが 7 日間保持されることを指定します。StarRocks は各システムログファイルをチェックし、7 日前に生成されたものを削除します。
• 導入バージョン: -

audit_log_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/log"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: 監査ログファイルを保存するディレクトリ。
• 導入バージョン: -

audit_log_roll_num

• デフォルト: 90
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: audit_log_roll_interval パラメータで指定された保持期間内に保持できる監査ログファイルの最大数。
• 導入バージョン: -

audit_log_modules

• デフォルト: slow_query, query
• タイプ: String[]
• 単位: -
• 変更可能: いいえ
• 説明: StarRocks が監査ログエントリを生成するモジュール。デフォルトでは、StarRocks は slow_query モジュールと query モジュールの監査ログを生成します。connection モジュールは v3.0 からサポートされています。モジュール名はカンマ (,) とスペースで区切ります。
• 導入バージョン: -

qe_slow_log_ms

• デフォルト: 5000
• タイプ: Long
• 単位: ミリ秒
• 変更可能: はい
• 説明: クエリがスロークエリであるかどうかを判断するために使用されるしきい値。クエリの応答時間がこのしきい値を超える場合、fe.audit.log にスロークエリとして記録されます。
• 導入バージョン: -

audit_log_roll_interval

• デフォルト: DAY
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: StarRocks が監査ログエントリをローテーションする時間間隔。有効な値: DAY と HOUR。
  • このパラメータが DAY に設定されている場合、監査ログファイルの名前に yyyyMMdd 形式のサフィックスが追加されます。
  • このパラメータが HOUR に設定されている場合、監査ログファイルの名前に yyyyMMddHH 形式のサフィックスが追加されます。
• 導入バージョン: -

audit_log_delete_age

• デフォルト: 30d
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: 監査ログファイルの保持期間。デフォルト値 30d は、各監査ログファイルが 30 日間保持されることを指定します。StarRocks は各監査ログファイルをチェックし、30 日前に生成されたものを削除します。
• 導入バージョン: -

dump_log_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/log"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: ダンプログファイルを保存するディレクトリ。
• 導入バージョン: -

dump_log_roll_num

• デフォルト: 10
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: dump_log_roll_interval パラメータで指定された保持期間内に保持できるダンプログファイルの最大数。
• 導入バージョン: -

dump_log_modules

• デフォルト: query
• タイプ: String[]
• 単位: -
• 変更可能: いいえ
• 説明: StarRocks がダンプログエントリを生成するモジュール。デフォルトでは、StarRocks は query モジュールのダンプログを生成します。モジュール名はカンマ (,) とスペースで区切ります。
• 導入バージョン: -

dump_log_roll_interval

• デフォルト: DAY
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: StarRocks がダンプログエントリをローテーションする時間間隔。有効な値: DAY と HOUR。
  • このパラメータが DAY に設定されている場合、ダンプログファイルの名前に yyyyMMdd 形式のサフィックスが追加されます。
  • このパラメータが HOUR に設定されている場合、ダンプログファイルの名前に yyyyMMddHH 形式のサフィックスが追加されます。
• 導入バージョン: -

dump_log_delete_age

• デフォルト: 7d
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: ダンプログファイルの保持期間。デフォルト値 7d は、各ダンプログファイルが 7 日間保持されることを指定します。StarRocks は各ダンプログファイルをチェックし、7 日前に生成されたものを削除します。
• 導入バージョン: -

サーバー

frontend_address

• デフォルト: 0.0.0.0
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: FE ノードの IP アドレス。
• 導入バージョン: -

priority_networks

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

http_port

• デフォルト: 8030
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の HTTP サーバーがリッスンするポート。
• 導入バージョン: -

http_worker_threads_num

• デフォルト: 0
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: HTTP リクエストを処理するための HTTP サーバーのワーカースレッド数。負の値または 0 の場合、スレッド数は CPU コア数の 2 倍になります。
• 導入バージョン: v2.5.18, v3.0.10, v3.1.7, v3.2.2

http_backlog_num

• デフォルト: 1024
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の HTTP サーバーが保持するバックログキューの長さ。
• 導入バージョン: -

cluster_name

• デフォルト: StarRocks Cluster
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: FE が所属する StarRocks クラスタの名前。クラスタ名はウェブページの Title に表示されます。
• 導入バージョン: -

rpc_port

• デフォルト: 9020
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の Thrift サーバーがリッスンするポート。
• 導入バージョン: -

thrift_server_max_worker_threads

• デフォルト: 4096
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: FE ノード内の Thrift サーバーがサポートする最大ワーカースレッド数。
• 導入バージョン: -

thrift_server_queue_size

• デフォルト: 4096
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: リクエストが保留されるキューの長さ。Thrift サーバーで処理中のスレッド数が thrift_server_max_worker_threads で指定された値を超える場合、新しいリクエストは保留キューに追加されます。
• 導入バージョン: -

thrift_client_timeout_ms

• デフォルト: 5000
• タイプ: Int
• 単位: ミリ秒
• 変更可能: いいえ
• 説明: アイドルクライアント接続がタイムアウトするまでの時間。
• 導入バージョン: -

thrift_backlog_num

• デフォルト: 1024
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の Thrift サーバーが保持するバックログキューの長さ。
• 導入バージョン: -

brpc_idle_wait_max_time

• デフォルト: 10000
• タイプ: Int
• 単位: ms
• 変更可能: いいえ
• 説明: bRPC クライアントがアイドル状態で待機する最大時間。
• 導入バージョン: -

query_port

• デフォルト: 9030
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の MySQL サーバーがリッスンするポート。
• 導入バージョン: -

mysql_nio_backlog_num

• デフォルト: 1024
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の MySQL サーバーが保持するバックログキューの長さ。
• 導入バージョン: -

mysql_service_nio_enabled

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: FE ノードで非同期 I/O が有効かどうかを指定します。
• 導入バージョン: -

mysql_service_io_threads_num

• デフォルト: 4
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の MySQL サーバーが I/O イベントを処理するために実行できる最大スレッド数。
• 導入バージョン: -

max_mysql_service_task_threads_num

• デフォルト: 4096
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE ノード内の MySQL サーバーがタスクを処理するために実行できる最大スレッド数。
• 導入バージョン: -

mysql_server_version

• デフォルト: 5.1.0
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: クライアントに返される MySQL サーバーバージョン。このパラメータを変更すると、次の状況でバージョン情報に影響します。
  1. select version();
  2. ハンドシェイクパケットバージョン
  3. グローバル変数 version の値 (show variables like 'version';)
• 導入バージョン: -

qe_max_connection

• デフォルト: 4096
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: すべてのユーザーが FE ノードに確立できる最大接続数。v3.1.12 および v3.2.7 以降、デフォルト値は 1024 から 4096 に変更されました。
• 導入バージョン: -

max_connection_scheduler_threads_num

• デフォルト: 4096
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: 接続スケジューラがサポートする最大スレッド数。
• 導入バージョン: -

メタデータとクラスタ管理

cluster_id

• デフォルト: -1
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE が所属する StarRocks クラスタの ID。同じクラスタ ID を持つ FEs または BEs は同じ StarRocks クラスタに属します。有効な値: 正の整数。デフォルト値 -1 は、クラスタの Leader FE が初めて起動されたときに StarRocks がランダムなクラスタ ID を生成することを指定します。
• 導入バージョン: -

meta_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/meta"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: メタデータを保存するディレクトリ。
• 導入バージョン: -

edit_log_type

• デフォルト: BDB
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: 生成できる編集ログのタイプ。値を BDB に設定します。
• 導入バージョン: -

edit_log_port

• デフォルト: 9010
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: クラスタ内の Leader、Follower、Observer FEs 間の通信に使用されるポート。
• 導入バージョン: -

edit_log_roll_num

• デフォルト: 50000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: ログファイルがこれらのログエントリのために作成される前に書き込むことができるメタデータログエントリの最大数。このパラメータはログファイルのサイズを制御するために使用されます。新しいログファイルは BDBJE データベースに書き込まれます。
• 導入バージョン: -

ignore_unknown_log_id

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 不明なログ ID を無視するかどうか。FE がロールバックされると、以前のバージョンの FEs は一部のログ ID を認識できない場合があります。値が TRUE の場合、FE は不明なログ ID を無視します。値が FALSE の場合、FE は終了します。
• 導入バージョン: -

meta_delay_toleration_second

• デフォルト: 300
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: フォロワーおよびオブザーバー FEs のメタデータがリーダー FE のメタデータに遅れることができる最大期間。単位: 秒。この期間を超えると、非リーダー FEs はサービスの提供を停止します。
• 導入バージョン: -

master_sync_policy

• デフォルト: SYNC

• タイプ: String

• 単位: -

• 変更可能: いいえ

• 説明: リーダー FE がログをディスクにフラッシュするポリシー。このパラメータは、現在の FE がリーダー FE の場合にのみ有効です。有効な値:

  • SYNC: トランザクションがコミットされると、ログエントリが生成され、同時にディスクにフラッシュされます。
  • NO_SYNC: トランザクションがコミットされるとき、ログエントリの生成とフラッシュは同時に行われません。
  • WRITE_NO_SYNC: トランザクションがコミットされると、ログエントリが同時に生成されますが、ディスクにフラッシュされません。

  フォロワー FE を 1 つだけデプロイした場合、このパラメータを SYNC に設定することをお勧めします。フォロワー FE を 3 つ以上デプロイした場合、このパラメータと replica_sync_policy の両方を WRITE_NO_SYNC に設定することをお勧めします。

• 導入バージョン: -

replica_sync_policy

• デフォルト: SYNC
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: フォロワー FE がログをディスクにフラッシュするポリシー。このパラメータは、現在の FE がフォロワー FE の場合にのみ有効です。有効な値:
  • SYNC: トランザクションがコミットされると、ログエントリが生成され、同時にディスクにフラッシュされます。
  • NO_SYNC: トランザクションがコミットされるとき、ログエントリの生成とフラッシュは同時に行われません。
  • WRITE_NO_SYNC: トランザクションがコミットされると、ログエントリが同時に生成されますが、ディスクにフラッシュされません。
• 導入バージョン: -

replica_ack_policy

• デフォルト: SIMPLE_MAJORITY
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: ログエントリが有効と見なされるポリシー。デフォルト値 SIMPLE_MAJORITY は、フォロワー FEs の過半数が ACK メッセージを返すとログエントリが有効と見なされることを指定します。
• 導入バージョン: -

bdbje_heartbeat_timeout_second

• デフォルト: 30
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: StarRocks クラスタ内のリーダー、フォロワー、およびオブザーバー FEs 間のハートビートがタイムアウトするまでの時間。
• 導入バージョン: -

bdbje_replica_ack_timeout_second

• デフォルト: 10
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: メタデータがリーダー FE からフォロワー FEs に書き込まれるとき、リーダー FE が指定された数のフォロワー FEs からの ACK メッセージを待機できる最大時間。単位: 秒。大量のメタデータが書き込まれている場合、フォロワー FEs はリーダー FE に ACK メッセージを返すまでに長い時間がかかり、ACK タイムアウトが発生します。この状況では、メタデータの書き込みが失敗し、FE プロセスが終了します。この状況を防ぐために、このパラメータの値を増やすことをお勧めします。
• 導入バージョン: -

bdbje_lock_timeout_second

• デフォルト: 1
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: BDB JE ベースの FE 内のロックがタイムアウトするまでの時間。
• 導入バージョン: -

bdbje_reset_election_group

• デフォルト: false
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: BDBJE レプリケーショングループをリセットするかどうか。このパラメータが TRUE に設定されている場合、FE は BDBJE レプリケーショングループ (つまり、選出可能な FE ノードの情報を削除) をリセットし、リーダー FE として開始します。リセット後、この FE はクラスタ内の唯一のメンバーとなり、他の FEs は ALTER SYSTEM ADD/DROP FOLLOWER/OBSERVER 'xxx' を使用してこのクラスタに再参加できます。フォロワー FEs のデータの大部分が破損しているためにリーダー FE を選出できない場合にのみ、この設定を使用します。reset_election_group は metadata_failure_recovery を置き換えるために使用されます。
• 導入バージョン: -

max_bdbje_clock_delta_ms

• デフォルト: 5000
• タイプ: Long
• 単位: ミリ秒
• 変更可能: いいえ
• 説明: StarRocks クラスタ内のリーダー FE とフォロワーまたはオブザーバー FEs 間で許可される最大クロックオフセット。
• 導入バージョン: -

txn_rollback_limit

• デフォルト: 100
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: ロールバックできるトランザクションの最大数。
• 導入バージョン: -

heartbeat_mgr_threads_num

• デフォルト: 8
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: ハートビートタスクを実行するためにハートビートマネージャーが実行できるスレッド数。
• 導入バージョン: -

heartbeat_mgr_blocking_queue_size

• デフォルト: 1024
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: ハートビートマネージャーによって実行されるハートビートタスクを保存するブロッキングキューのサイズ。
• 導入バージョン: -

catalog_try_lock_timeout_ms

• デフォルト: 5000
• タイプ: Long
• 単位: ミリ秒
• 変更可能: はい
• 説明: グローバルロックを取得するためのタイムアウト期間。
• 導入バージョン: -

ignore_materialized_view_error

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: FE がマテリアライズドビューエラーによって引き起こされたメタデータ例外を無視するかどうか。FE がマテリアライズドビューエラーによって引き起こされたメタデータ例外のために起動に失敗した場合、このパラメータを true に設定して FE が例外を無視できるようにします。
• 導入バージョン: v2.5.10

ignore_meta_check

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 非リーダー FEs がリーダー FE からのメタデータギャップを無視するかどうか。値が TRUE の場合、非リーダー FEs はリーダー FE からのメタデータギャップを無視し、データ読み取りサービスの提供を続けます。このパラメータは、リーダー FE を長時間停止してもデータ読み取りサービスを継続できるようにします。値が FALSE の場合、非リーダー FEs はリーダー FE からのメタデータギャップを無視せず、データ読み取りサービスの提供を停止します。
• 導入バージョン: -

drop_backend_after_decommission

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: BE が退役した後に削除するかどうか。TRUE は、BE が退役した直後に削除されることを示します。FALSE は、BE が退役した後に削除されないことを示します。
• 導入バージョン: -

enable_collect_query_detail_info

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: クエリのプロファイルを収集するかどうか。このパラメータが TRUE に設定されている場合、システムはクエリのプロファイルを収集します。このパラメータが FALSE に設定されている場合、システムはクエリのプロファイルを収集しません。
• 導入バージョン: -

enable_background_refresh_connector_metadata

• デフォルト: v3.0 以降では true、v2.5 では false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 定期的な Hive メタデータキャッシュの更新を有効にするかどうか。有効にすると、StarRocks は Hive クラスタのメタストア (Hive Metastore または AWS Glue) をポーリングし、頻繁にアクセスされる Hive catalogs のキャッシュされたメタデータを更新してデータの変更を認識します。true は Hive メタデータキャッシュの更新を有効にすることを示し、false は無効にすることを示します。
• 導入バージョン: v2.5.5

background_refresh_metadata_interval_millis

• デフォルト: 600000
• タイプ: Int
• 単位: ミリ秒
• 変更可能: はい
• 説明: 2 回の連続した Hive メタデータキャッシュ更新の間隔。
• 導入バージョン: v2.5.5

background_refresh_metadata_time_secs_since_last_access_secs

• デフォルト: 3600 * 24
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: Hive メタデータキャッシュ更新タスクの有効期限。アクセスされた Hive catalog に対して、指定された時間を超えてアクセスされていない場合、StarRocks はそのキャッシュされたメタデータの更新を停止します。アクセスされていない Hive catalog に対して、StarRocks はそのキャッシュされたメタデータを更新しません。
• 導入バージョン: v2.5.5

enable_statistics_collect_profile

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 統計クエリのプロファイルを生成するかどうか。この項目を true に設定すると、StarRocks はシステム統計に関するクエリのプロファイルを生成します。
• 導入バージョン: v3.1.5

metadata_enable_recovery_mode

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: メタデータリカバリモードを有効にするかどうか。このモードが有効になると、クラスタメタデータの一部が失われた場合、BE の情報に基づいて復元できます。現在、パーティションのバージョン情報のみが復元可能です。
• 導入バージョン: v3.3.0

enable_legacy_compatibility_for_replication

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: レプリケーションのレガシー互換性を有効にするかどうか。StarRocks は古いバージョンと新しいバージョンの間で異なる動作をする可能性があり、クロスクラスタデータ移行中に問題が発生する可能性があります。したがって、データ移行の前にターゲットクラスタでレガシー互換性を有効にし、データ移行が完了した後に無効にする必要があります。true はこのモードを有効にすることを示します。
• 導入バージョン: v3.1.10, v3.2.6

ユーザー、ロール、および権限

privilege_max_total_roles_per_user

• デフォルト: 64
• タイプ: Int
• 単位:
• 変更可能: はい
• 説明: ユーザーが持つことができる最大ロール数。
• 導入バージョン: v3.0.0

privilege_max_role_depth

• デフォルト: 16
• タイプ: Int
• 単位:
• 変更可能: はい
• 説明: ロールの最大ロール深度 (継承レベル)。
• 導入バージョン: v3.0.0

クエリエンジン

publish_version_interval_ms

• デフォルト: 10
• タイプ: Int
• 単位: ミリ秒
• 変更可能: いいえ
• 説明: リリース検証タスクが発行される時間間隔。
• 導入バージョン: -

statistic_cache_columns

• デフォルト: 100000
• タイプ: Long
• 単位: -
• 変更可能: いいえ
• 説明: 統計テーブルにキャッシュできる行数。
• 導入バージョン: -

statistic_cache_thread_pool_size

• デフォルト: 10
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: 統計キャッシュを更新するために使用されるスレッドプールのサイズ。
• 導入バージョン: -

max_allowed_in_element_num_of_delete

• デフォルト: 10000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: DELETE ステートメント内の IN 述語に許可される要素の最大数。
• 導入バージョン: -

enable_materialized_view

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: マテリアライズドビューの作成を有効にするかどうか。
• 導入バージョン: -

enable_materialized_view_spill

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: マテリアライズドビューのリフレッシュタスクに対する中間結果のスピリングを有効にするかどうか。
• 導入バージョン: v3.1.1

enable_backup_materialized_view

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 特定のデータベースをバックアップまたは復元する際に、非同期マテリアライズドビューのバックアップと復元を有効にするかどうか。この項目が false に設定されている場合、StarRocks は非同期マテリアライズドビューのバックアップをスキップします。
• 導入バージョン: v3.2.0

enable_experimental_mv

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 非同期マテリアライズドビュー機能を有効にするかどうか。TRUE はこの機能が有効であることを示します。v2.5.2 以降、この機能はデフォルトで有効です。v2.5.2 より前のバージョンでは、この機能はデフォルトで無効です。
• 導入バージョン: v2.4

enable_colocate_mv_index

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 同期マテリアライズドビューを作成する際に、同期マテリアライズドビューインデックスをベーステーブルとコロケートすることをサポートするかどうか。この項目が true に設定されている場合、tablet sink は同期マテリアライズドビューの書き込みパフォーマンスを向上させます。
• 導入バージョン: v3.2.0

default_mv_refresh_immediate

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 非同期マテリアライズドビューを作成直後にリフレッシュするかどうか。この項目が true に設定されている場合、新しく作成されたマテリアライズドビューは直ちにリフレッシュされます。
• 導入バージョン: v3.2.3

enable_materialized_view_metrics_collect

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 非同期マテリアライズドビューの監視メトリクスをデフォルトで収集するかどうか。
• 導入バージョン: v3.1.11, v3.2.5

enable_materialized_view_text_based_rewrite

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: テキストベースのクエリの書き換えをデフォルトで有効にするかどうか。この項目が true に設定されている場合、システムは非同期マテリアライズドビューを作成する際に抽象構文ツリーを構築します。
• 導入バージョン: v3.2.5

enable_mv_automatic_active_check

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: ベーステーブル (ビュー) がスキーマ変更を受けたか、削除されて再作成されたために非アクティブに設定された非同期マテリアライズドビューをシステムが自動的にチェックして再アクティブ化するかどうか。この機能は、ユーザーによって手動で非アクティブに設定されたマテリアライズドビューを再アクティブ化しません。
• 導入バージョン: v3.1.6

enable_udf

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: UDF を有効にするかどうか。
• 導入バージョン: -

enable_decimal_v3

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: DECIMAL V3 データ型をサポートするかどうか。
• 導入バージョン: -

enable_sql_blacklist

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: SQL クエリのブラックリストチェックを有効にするかどうか。この機能が有効な場合、ブラックリストにあるクエリは実行できません。
• 導入バージョン: -

dynamic_partition_enable

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 動的パーティション化機能を有効にするかどうか。この機能が有効な場合、StarRocks は新しいデータに対して動的にパーティションを作成し、データの新鮮さを確保するために期限切れのパーティションを自動的に削除します。
• 導入バージョン: -

dynamic_partition_check_interval_seconds

• デフォルト: 600
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: 新しいデータがチェックされる間隔。新しいデータが検出されると、StarRocks は自動的にデータのパーティションを作成します。
• 導入バージョン: -

max_query_retry_time

• デフォルト: 2
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: FE でのクエリの最大再試行回数。
• 導入バージョン: -

max_create_table_timeout_second

• デフォルト: 600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: テーブル作成の最大タイムアウト期間。
• 導入バージョン: -

create_table_max_serial_replicas

• デフォルト: 128
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 直列に作成されるレプリカの最大数。実際のレプリカ数がこの値を超える場合、レプリカは並行して作成されます。テーブル作成に時間がかかる場合、この値を減らすことをお勧めします。
• 導入バージョン: -

http_slow_request_threshold_ms

• デフォルト: 5000
• タイプ: Int
• 単位: ミリ秒
• 変更可能: はい
• 説明: HTTP リクエストの応答時間がこのパラメータで指定された値を超える場合、このリクエストを追跡するためのログが生成されます。
• 導入バージョン: v2.5.15, v3.1.5

max_partitions_in_one_batch

• デフォルト: 4096
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: 一括でパーティションを作成する際に作成できる最大パーティション数。
• 導入バージョン: -

max_running_rollup_job_num_per_table

• デフォルト: 1
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: テーブルに対して並行して実行できるロールアップジョブの最大数。
• 導入バージョン: -

expr_children_limit

• デフォルト: 10000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 式内で許可される子式の最大数。
• 導入バージョン: -

max_planner_scalar_rewrite_num

• デフォルト: 100000
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: オプティマイザがスカラ演算子を書き換えることができる最大回数。
• 導入バージョン: -

enable_statistic_collect

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: CBO の統計を収集するかどうか。この機能はデフォルトで有効です。
• 導入バージョン: -

enable_statistic_collect_on_first_load

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: テーブルにデータが初めてロードされるときに統計を自動的に収集するかどうか。テーブルに複数のパーティションがある場合、このテーブルの空のパーティションにデータがロードされると、そのパーティションで自動統計収集がトリガーされます。新しいテーブルが頻繁に作成され、データが頻繁にロードされる場合、メモリと CPU のオーバーヘッドが増加します。
• 導入バージョン: v3.1

statistic_auto_analyze_start_time

• デフォルト: 00:00:00
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: 自動収集の開始時間。値の範囲: 00:00:00 - 23:59:59。
• 導入バージョン: -

statistic_auto_analyze_end_time

• デフォルト: 23:59:59
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: 自動収集の終了時間。値の範囲: 00:00:00 - 23:59:59。
• 導入バージョン: -

statistic_analyze_status_keep_second

• デフォルト: 3 * 24 * 3600
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: 収集タスクの履歴を保持する期間。デフォルト値は 3 日です。
• 導入バージョン: -

statistic_collect_interval_sec

• デフォルト: 5 * 60
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: 自動収集中にデータの更新をチェックする間隔。
• 導入バージョン: -

statistic_update_interval_sec

• デフォルト: 24 * 60 * 60
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: 統計情報のキャッシュが更新される間隔。
• 導入バージョン: -

enable_collect_full_statistic

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 自動フル統計収集を有効にするかどうか。この機能はデフォルトで有効です。
• 導入バージョン: -

statistic_auto_collect_ratio

• デフォルト: 0.8
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: 自動収集の統計が健全かどうかを判断するためのしきい値。統計の健全性がこのしきい値を下回る場合、自動収集がトリガーされます。
• 導入バージョン: -

statistic_auto_collect_small_table_rows

• デフォルト: 10000000
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: 自動収集中に外部データソース (Hive, Iceberg, Hudi) のテーブルが小さいテーブルであるかどうかを判断するためのしきい値。テーブルの行数がこの値を下回る場合、そのテーブルは小さいテーブルと見なされます。
• 導入バージョン: v3.2

statistic_max_full_collect_data_size

• デフォルト: 100 * 1024 * 1024 * 1024
• タイプ: Long
• 単位: バイト
• 変更可能: はい
• 説明: 統計の自動収集のデータサイズしきい値。合計サイズがこの値を超える場合、フル収集の代わりにサンプル収集が実行されます。
• 導入バージョン: -

statistic_collect_max_row_count_per_query

• デフォルト: 5000000000
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: 単一の分析タスクでクエリできる最大行数。この値を超えると、分析タスクは複数のクエリに分割されます。
• 導入バージョン: -

statistic_sample_collect_rows

• デフォルト: 200000
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: サンプル収集のために収集する最小行数。パラメータ値がテーブル内の実際の行数を超える場合、フル収集が実行されます。
• 導入バージョン: -

histogram_buckets_size

• デフォルト: 64
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: ヒストグラムのデフォルトバケット数。
• 導入バージョン: -

histogram_mcv_size

• デフォルト: 100
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: ヒストグラムの最も一般的な値 (MCV) の数。
• 導入バージョン: -

histogram_sample_ratio

• デフォルト: 0.1
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: ヒストグラムのサンプリング比率。
• 導入バージョン: -

histogram_max_sample_row_count

• デフォルト: 10000000
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: ヒストグラムのために収集する最大行数。
• 導入バージョン: -

enable_local_replica_selection

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: クエリに対してローカルレプリカを選択するかどうか。ローカルレプリカはネットワーク伝送コストを削減します。このパラメータが TRUE に設定されている場合、CBO は現在の FE と同じ IP アドレスを持つ BEs 上の tablet レプリカを優先的に選択します。このパラメータが FALSE に設定されている場合、ローカルレプリカと非ローカルレプリカの両方が選択される可能性があります。
• 導入バージョン: -

max_distribution_pruner_recursion_depth

• デフォルト: 100
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: パーティションプルーナーが許可する最大再帰深度。再帰深度を増やすと、より多くの要素をプルーニングできますが、CPU 消費も増加します。
• 導入バージョン: -

ロードとアンロード

load_straggler_wait_second

• デフォルト: 300
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: BE レプリカが許容できる最大ロード遅延。この値を超えると、他のレプリカからデータをクローンするためにクローンが実行されます。
• 導入バージョン: -

load_checker_interval_second

• デフォルト: 5
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: ロードジョブがローリングベースで処理される時間間隔。
• 導入バージョン: -

broker_load_default_timeout_second

• デフォルト: 14400
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: Broker Load ジョブのタイムアウト期間。
• 導入バージョン: -

min_bytes_per_broker_scanner

• デフォルト: 67108864
• タイプ: Long
• 単位: バイト
• 変更可能: はい
• 説明: Broker Load インスタンスが処理できるデータの最小許容量。
• 導入バージョン: -

insert_load_default_timeout_second

• デフォルト: 3600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: データをロードするために使用される INSERT INTO ステートメントのタイムアウト期間。
• 導入バージョン: -

stream_load_default_timeout_second

• デフォルト: 600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: 各 Stream Load ジョブのデフォルトタイムアウト期間。
• 導入バージョン: -

max_stream_load_timeout_second

• デフォルト: 259200
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: Stream Load ジョブの最大許容タイムアウト期間。
• 導入バージョン: -

max_load_timeout_second

• デフォルト: 259200
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: ロードジョブに許可される最大タイムアウト期間。この制限を超えると、ロードジョブは失敗します。この制限はすべてのタイプのロードジョブに適用されます。
• 導入バージョン: -

min_load_timeout_second

• デフォルト: 1
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: ロードジョブに許可される最小タイムアウト期間。この制限はすべてのタイプのロードジョブに適用されます。
• 導入バージョン: -

spark_dpp_version

• デフォルト: 1.0.0
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: 使用される Spark Dynamic Partition Pruning (DPP) のバージョン。
• 導入バージョン: -

spark_load_default_timeout_second

• デフォルト: 86400
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: 各 Spark Load ジョブのタイムアウト期間。
• 導入バージョン: -

spark_home_default_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/lib/spark2x"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Spark クライアントのルートディレクトリ。
• 導入バージョン: -

spark_resource_path

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Spark 依存パッケージのルートディレクトリ。
• 導入バージョン: -

spark_launcher_log_dir

• デフォルト: sys_log_dir + "/spark_launcher_log"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Spark ログファイルを保存するディレクトリ。
• 導入バージョン: -

yarn_client_path

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/lib/yarn-client/hadoop/bin/yarn"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Yarn クライアントパッケージのルートディレクトリ。
• 導入バージョン: -

yarn_config_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/lib/yarn-config"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Yarn 設定ファイルを保存するディレクトリ。
• 導入バージョン: -

desired_max_waiting_jobs

• デフォルト: 1024
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: FE 内の保留中ジョブの最大数。この数は、テーブル作成、ロード、スキーマ変更ジョブなど、すべてのジョブを指します。FE 内の保留中ジョブの数がこの値に達すると、FE は新しいロードリクエストを拒否します。このパラメータは非同期ロードにのみ有効です。v2.5 以降、デフォルト値は 100 から 1024 に変更されました。
• 導入バージョン: -

max_running_txn_num_per_db

• デフォルト: 1000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: StarRocks クラスタ内の各データベースで実行中のロードトランザクションの最大数。デフォルト値は 1000 です。v3.1 以降、デフォルト値は 100 から 1000 に変更されました。データベースで実行中のロードトランザクションの実際の数がこのパラメータの値を超えると、新しいロードリクエストは処理されません。同期ロードジョブの新しいリクエストは拒否され、非同期ロードジョブの新しいリクエストはキューに入れられます。このパラメータの値を増やすことはお勧めしません。システムの負荷が増加するためです。
• 導入バージョン: -

max_broker_load_job_concurrency

• デフォルト: 5
• 別名: async_load_task_pool_size
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: StarRocks クラスタ内で許可される同時 Broker Load ジョブの最大数。このパラメータは Broker Load にのみ有効です。このパラメータの値は max_running_txn_num_per_db の値より小さくなければなりません。v2.5 以降、デフォルト値は 10 から 5 に変更されました。
• 導入バージョン: -

load_parallel_instance_num (廃止予定)

• デフォルト: 1
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: BE 上の各ロードジョブに対する同時ロードインスタンスの最大数。この項目は v3.1 以降廃止されました。
• 導入バージョン: -

disable_load_job

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: クラスタがエラーに遭遇したときにロードを無効にするかどうか。これにより、クラスタエラーによる損失を防ぎます。デフォルト値は FALSE で、ロードが無効になっていないことを示します。TRUE はロードが無効であり、クラスタが読み取り専用状態であることを示します。
• 導入バージョン: -

history_job_keep_max_second

• デフォルト: 7 * 24 * 3600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: スキーマ変更ジョブなど、履歴ジョブが保持される最大期間。
• 導入バージョン: -

label_keep_max_second

• デフォルト: 3 * 24 * 3600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: 完了したロードジョブのラベルを保持する最大期間 (秒単位)。デフォルト値は 3 日です。この期間が経過すると、ラベルは削除されます。このパラメータはすべてのタイプのロードジョブに適用されます。値が大きすぎると、多くのメモリを消費します。
• 導入バージョン: -

label_keep_max_num

• デフォルト: 1000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 一定期間内に保持できるロードジョブの最大数。この数を超えると、履歴ジョブの情報が削除されます。
• 導入バージョン: -

max_routine_load_task_concurrent_num

• デフォルト: 5
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 各 Routine Load ジョブに対する同時タスクの最大数。
• 導入バージョン: -

max_routine_load_task_num_per_be

• デフォルト: 16
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 各 BE 上の同時 Routine Load タスクの最大数。v3.1.0 以降、このパラメータのデフォルト値は 5 から 16 に増加し、BE 静的パラメータ routine_load_thread_pool_size (廃止予定) の値以下である必要がなくなりました。
• 導入バージョン: -

max_routine_load_batch_size

• デフォルト: 4294967296
• タイプ: Long
• 単位: バイト
• 変更可能: はい
• 説明: Routine Load タスクがロードできるデータの最大量。
• 導入バージョン: -

routine_load_task_consume_second

• デフォルト: 15
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: クラスタ内の各 Routine Load タスクがデータを消費する最大時間。v3.1.0 以降、Routine Load ジョブは job_properties に新しいパラメータ task_consume_second をサポートしています。このパラメータは Routine Load ジョブ内の個々のロードタスクに適用され、より柔軟です。
• 導入バージョン: -

routine_load_task_timeout_second

• デフォルト: 60
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: クラスタ内の各 Routine Load タスクのタイムアウト期間。v3.1.0 以降、Routine Load ジョブは job_properties に新しいパラメータ task_timeout_second をサポートしています。このパラメータは Routine Load ジョブ内の個々のロードタスクに適用され、より柔軟です。
• 導入バージョン: -

routine_load_unstable_threshold_second

• デフォルト: 3600
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: Routine Load ジョブ内のタスクが遅延すると、Routine Load ジョブは UNSTABLE 状態に設定されます。具体的には、消費されているメッセージのタイムスタンプと現在の時間の差がこのしきい値を超え、データソースに未消費のメッセージが存在する場合です。
• 導入バージョン: -

max_tolerable_backend_down_num

• デフォルト: 0
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 許容される故障 BE ノードの最大数。この数を超えると、Routine Load ジョブは自動的に回復できません。
• 導入バージョン: -

period_of_auto_resume_min

• デフォルト: 5
• タイプ: Int
• 単位: 分
• 変更可能: はい
• 説明: Routine Load ジョブが自動的に回復される間隔。
• 導入バージョン: -

export_task_default_timeout_second

• デフォルト: 2 * 3600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: データエクスポートタスクのタイムアウト期間。
• 導入バージョン: -

export_max_bytes_per_be_per_task

• デフォルト: 268435456
• タイプ: Long
• 単位: バイト
• 変更可能: はい
• 説明: 単一の BE から単一のデータアンロードタスクによってエクスポートできるデータの最大量。
• 導入バージョン: -

export_task_pool_size

• デフォルト: 5
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: アンロードタスクスレッドプールのサイズ。
• 導入バージョン: -

export_checker_interval_second

• デフォルト: 5
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: ロードジョブがスケジュールされる時間間隔。
• 導入バージョン: -

export_running_job_num_limit

• デフォルト: 5
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 並行して実行できるデータエクスポートタスクの最大数。
• 導入バージョン: -

empty_load_as_error

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: データがロードされていない場合にエラーメッセージ "all partitions have no load data" を返すかどうか。有効な値:
  • true: データがロードされていない場合、システムは失敗メッセージを表示し、エラー "all partitions have no load data" を返します。
  • false: データがロードされていない場合、システムは成功メッセージを表示し、エラーではなく OK を返します。
• 導入バージョン: -

external_table_commit_timeout_ms

• デフォルト: 10000
• タイプ: Int
• 単位: ミリ秒
• 変更可能: はい
• 説明: StarRocks 外部テーブルへの書き込みトランザクションをコミット (公開) するためのタイムアウト期間。デフォルト値 10000 は 10 秒のタイムアウト期間を示します。
• 導入バージョン: -

enable_sync_publish

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: ロードトランザクションの公開フェーズで適用タスクを同期的に実行するかどうか。このパラメータは Primary Key テーブルにのみ適用されます。有効な値:
  • TRUE (デフォルト): ロードトランザクションの公開フェーズで適用タスクが同期的に実行されます。これは、適用タスクが完了した後にロードトランザクションが成功として報告され、ロードされたデータが実際にクエリ可能であることを意味します。タスクが一度に大量のデータをロードするか、頻繁にデータをロードする場合、このパラメータを true に設定すると、クエリパフォーマンスと安定性が向上しますが、ロードレイテンシが増加する可能性があります。
  • FALSE: ロードトランザクションの公開フェーズで適用タスクが非同期的に実行されます。これは、適用タスクが送信された後にロードトランザクションが成功として報告されますが、ロードされたデータはすぐにクエリできないことを意味します。この場合、同時クエリは適用タスクが完了するかタイムアウトするまで待機する必要があります。タスクが一度に大量のデータをロードするか、頻繁にデータをロードする場合、このパラメータを false に設定すると、クエリパフォーマンスと安定性に影響を与える可能性があります。
• 導入バージョン: v3.2.0

label_clean_interval_second

• デフォルト: 4 * 3600
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: ラベルがクリーンアップされる時間間隔。単位: 秒。履歴ラベルがタイムリーにクリーンアップされるように、短い時間間隔を指定することをお勧めします。
• 導入バージョン: -

transaction_clean_interval_second

• デフォルト: 30
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: 完了したトランザクションがクリーンアップされる時間間隔。単位: 秒。完了したトランザクションがタイムリーにクリーンアップされるように、短い時間間隔を指定することをお勧めします。
• 導入バージョン: -

ストレージ

default_replication_num

• デフォルト: 3
• タイプ: Short
• 単位: -
• 変更可能: はい
• 説明: StarRocks でテーブルを作成する際に各データパーティションのデフォルトのレプリカ数を設定します。この設定は、CREATE TABLE DDL で replication_num=x を指定することで上書きできます。
• 導入バージョン: -

enable_strict_storage_medium_check

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: ユーザーがテーブルを作成する際に、FE が BEs の記憶媒体を厳密にチェックするかどうか。このパラメータが TRUE に設定されている場合、ユーザーがテーブルを作成する際に FE は BEs の記憶媒体をチェックし、CREATE TABLE ステートメントで指定された storage_medium パラメータと異なる場合はエラーを返します。たとえば、CREATE TABLE ステートメントで指定された記憶媒体が SSD であるが、BEs の実際の記憶媒体が HDD である場合、テーブル作成は失敗します。このパラメータが FALSE の場合、ユーザーがテーブルを作成する際に FE は BEs の記憶媒体をチェックしません。
• 導入バージョン: -

catalog_trash_expire_second

• デフォルト: 86400
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: データベース、テーブル、またはパーティションが削除された後にメタデータが保持される最長期間。この期間が経過すると、データは削除され、RECOVER コマンドを使用して復元することはできません。
• 導入バージョン: -

enable_auto_tablet_distribution

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: バケット数を自動的に設定するかどうか。
  • このパラメータが TRUE に設定されている場合、テーブルを作成する際やパーティションを追加する際にバケット数を指定する必要はありません。StarRocks はバケット数を自動的に決定します。
  • このパラメータが FALSE に設定されている場合、テーブルを作成する際やパーティションを追加する際にバケット数を手動で指定する必要があります。テーブルに新しいパーティションを追加する際にバケット数を指定しない場合、新しいパーティションはテーブル作成時に設定されたバケット数を継承します。ただし、新しいパーティションのバケット数を手動で指定することもできます。
• 導入バージョン: v2.5.7

enable_experimental_rowstore

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: hybrid row-column storage を有効にするかどうか。
• 導入バージョン: v3.2.3

storage_usage_soft_limit_percent

• デフォルト: 90
• 別名: storage_high_watermark_usage_percent
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: BE ディレクトリ内のストレージ使用率のソフトリミット。BE ストレージディレクトリのストレージ使用率 (パーセンテージ) がこの値を超え、残りのストレージスペースが storage_usage_soft_limit_reserve_bytes より少ない場合、tablets はこのディレクトリにクローンできません。
• 導入バージョン: -

storage_usage_soft_limit_reserve_bytes

• デフォルト: 200 * 1024 * 1024 * 1024
• 別名: storage_min_left_capacity_bytes
• タイプ: Long
• 単位: バイト
• 変更可能: はい
• 説明: BE ディレクトリ内の残りストレージスペースのソフトリミット。BE ストレージディレクトリの残りストレージスペースがこの値より少なく、ストレージ使用率 (パーセンテージ) が storage_usage_soft_limit_percent を超える場合、tablets はこのディレクトリにクローンできません。
• 導入バージョン: -

storage_usage_hard_limit_percent

• デフォルト: 95
• 別名: storage_flood_stage_usage_percent
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: BE ディレクトリ内のストレージ使用率のハードリミット。BE ストレージディレクトリのストレージ使用率 (パーセンテージ) がこの値を超え、残りのストレージスペースが storage_usage_hard_limit_reserve_bytes より少ない場合、Load および Restore ジョブは拒否されます。この項目を BE 設定項目 storage_flood_stage_usage_percent と一緒に設定して、設定が有効になるようにする必要があります。
• 導入バージョン: -

storage_usage_hard_limit_reserve_bytes

• デフォルト: 100 * 1024 * 1024 * 1024
• 別名: storage_flood_stage_left_capacity_bytes
• タイプ: Long
• 単位: バイト
• 変更可能: はい
• 説明: BE ディレクトリ内の残りストレージスペースのハードリミット。BE ストレージディレクトリの残りストレージスペースがこの値より少なく、ストレージ使用率 (パーセンテージ) が storage_usage_hard_limit_percent を超える場合、Load および Restore ジョブは拒否されます。この項目を BE 設定項目 storage_flood_stage_left_capacity_bytes と一緒に設定して、設定が有効になるようにする必要があります。
• 導入バージョン: -

alter_table_timeout_second

• デフォルト: 86400
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: スキーマ変更操作 (ALTER TABLE) のタイムアウト期間。
• 導入バージョン: -

enable_fast_schema_evolution

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: StarRocks クラスタ内のすべてのテーブルに対して高速スキーマ進化を有効にするかどうか。有効な値は TRUE と FALSE (デフォルト) です。高速スキーマ進化を有効にすると、スキーマ変更の速度が向上し、列の追加や削除時のリソース使用量が削減されます。
• 導入バージョン: v3.2.0

NOTE

• StarRocks 共有データクラスタはこのパラメータをサポートしていません。
• 特定のテーブルに対して高速スキーマ進化を設定する必要がある場合、たとえば特定のテーブルに対して高速スキーマ進化を無効にする場合、テーブル作成時にテーブルプロパティ fast_schema_evolution を設定できます。

recover_with_empty_tablet

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 失われたまたは破損した tablet レプリカを空のものに置き換えるかどうか。tablet レプリカが失われたまたは破損した場合、この tablet または他の健康な tablets 上のデータクエリが失敗する可能性があります。失われたまたは破損した tablet レプリカを空の tablet に置き換えることで、クエリが引き続き実行されることを保証します。ただし、データが失われているため、結果が正しくない可能性があります。デフォルト値は FALSE で、失われたまたは破損した tablet レプリカは空のものに置き換えられず、クエリが失敗することを意味します。
• 導入バージョン: -

tablet_create_timeout_second

• デフォルト: 10
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: tablet 作成のタイムアウト期間。デフォルト値は v3.1 以降、1 から 10 に変更されました。
• 導入バージョン: -

tablet_delete_timeout_second

• デフォルト: 2
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: tablet 削除のタイムアウト期間。
• 導入バージョン: -

check_consistency_default_timeout_second

• デフォルト: 600
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: レプリカ整合性チェックのタイムアウト期間。tablet のサイズに基づいてこのパラメータを設定できます。
• 導入バージョン: -

tablet_sched_slot_num_per_path

• デフォルト: 8
• 別名: schedule_slot_num_per_path
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: BE ストレージディレクトリ内で同時に実行できる tablet 関連タスクの最大数。v2.5 以降、このパラメータのデフォルト値は 4 から 8 に変更されました。
• 導入バージョン: -

tablet_sched_max_scheduling_tablets

• デフォルト: 10000
• 別名: max_scheduling_tablets
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 同時にスケジュールできる tablets の最大数。この値を超えると、tablet バランシングと修復チェックがスキップされます。
• 導入バージョン: -

tablet_sched_disable_balance

• デフォルト: false
• 別名: disable_balance
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: tablet バランシングを無効にするかどうか。TRUE は tablet バランシングが無効であることを示します。FALSE は tablet バランシングが有効であることを示します。
• 導入バージョン: -

tablet_sched_disable_colocate_balance

• デフォルト: false
• 別名: disable_colocate_balance
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: Colocate Table のレプリカバランシングを無効にするかどうか。TRUE はレプリカバランシングが無効であることを示します。FALSE はレプリカバランシングが有効であることを示します。
• 導入バージョン: -

tablet_sched_be_down_tolerate_time_s

• デフォルト: 900
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: スケジューラが BE ノードの非アクティブ状態を許容する最大期間。時間しきい値に達すると、その BE ノード上の tablets は他のアクティブな BE ノードに移行されます。
• 導入バージョン: v2.5.7

tablet_sched_max_balancing_tablets

• デフォルト: 500
• 別名: max_balancing_tablets
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 同時にバランスを取ることができる tablets の最大数。この値を超えると、tablet の再バランスがスキップされます。
• 導入バージョン: -

tablet_sched_storage_cooldown_second

• デフォルト: -1
• 別名: storage_cooldown_second
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: テーブル作成時から自動冷却が開始されるまでの遅延。デフォルト値 -1 は自動冷却が無効であることを指定します。自動冷却を有効にしたい場合、このパラメータを -1 より大きい値に設定します。
• 導入バージョン: -

tablet_sched_max_not_being_scheduled_interval_ms

• デフォルト: 15 * 60 * 1000
• タイプ: Long
• 単位: ミリ秒
• 変更可能: はい
• 説明: tablet クローンタスクがスケジュールされている場合、このパラメータで指定された時間内にスケジュールされていない tablet がある場合、StarRocks はそれを優先的にスケジュールしてできるだけ早くスケジュールします。
• 導入バージョン: -

tablet_sched_balance_load_score_threshold

• デフォルト: 0.1
• 別名: balance_load_score_threshold
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: BE の負荷がバランスが取れているかどうかを判断するためのパーセンテージしきい値。BE の負荷がすべての BEs の平均負荷より低く、その差がこの値を超える場合、この BE は低負荷状態にあります。逆に、BE の負荷が平均負荷より高く、その差がこの値を超える場合、この BE は高負荷状態にあります。
• 導入バージョン: -

tablet_sched_num_based_balance_threshold_ratio

• デフォルト: 0.5
• 別名: -
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: 数に基づくバランスを行うと、ディスクサイズのバランスが崩れる可能性がありますが、ディスク間の最大ギャップは tablet_sched_num_based_balance_threshold_ratio * tablet_sched_balance_load_score_threshold を超えてはなりません。クラスタ内で A から B へ、B から A への tablet が常にバランスを取っている場合、この値を減らしてください。tablet の分布をより均等にしたい場合、この値を増やしてください。
• 導入バージョン: - 3.1

tablet_sched_balance_load_disk_safe_threshold

• デフォルト: 0.5
• 別名: balance_load_disk_safe_threshold
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: BEs のディスク使用率がバランスが取れているかどうかを判断するためのパーセンテージしきい値。すべての BEs のディスク使用率がこの値より低い場合、バランスが取れていると見なされます。ディスク使用率がこの値を超え、最高と最低の BE ディスク使用率の差が 10% を超える場合、ディスク使用率はバランスが取れていないと見なされ、tablet の再バランスがトリガーされます。
• 導入バージョン: -

tablet_sched_repair_delay_factor_second

• デフォルト: 60
• 別名: tablet_repair_delay_factor_second
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: レプリカが修復される間隔 (秒単位)。
• 導入バージョン: -

tablet_sched_min_clone_task_timeout_sec

• デフォルト: 3 * 60
• 別名: min_clone_task_timeout_sec
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: tablet クローンの最小タイムアウト期間。
• 導入バージョン: -

tablet_sched_max_clone_task_timeout_sec

• デフォルト: 2 * 60 * 60
• 別名: max_clone_task_timeout_sec
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: tablet クローンの最大タイムアウト期間。
• 導入バージョン: -

tablet_stat_update_interval_second

• デフォルト: 300
• タイプ: Int
• 単位: 秒
• 変更可能: いいえ
• 説明: FE が各 BE から tablet 統計情報を取得する時間間隔。
• 導入バージョン: -

max_automatic_partition_number

• デフォルト: 4096
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 自動的に作成されるパーティションの最大数。
• 導入バージョン: v3.1

共有データ

run_mode

• デフォルト: shared_nothing

• タイプ: String

• 単位: -

• 変更可能: いいえ

• 説明: StarRocks クラスタの実行モード。有効な値: shared_data と shared_nothing (デフォルト)。

  • shared_data は StarRocks を共有データモードで実行することを示します。
  • shared_nothing は StarRocks を共有なしモードで実行することを示します。

  CAUTION

  • StarRocks クラスタに対して shared_data と shared_nothing モードを同時に採用することはできません。混合デプロイメントはサポートされていません。
  • クラスタがデプロイされた後に run_mode を変更しないでください。そうしないと、クラスタが再起動に失敗します。共有なしクラスタから共有データクラスタへの変換、またはその逆はサポートされていません。

• 導入バージョン: -

cloud_native_meta_port

• デフォルト: 6090
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE クラウドネイティブメタデータサーバー RPC リッスンポート。
• 導入バージョン: -

cloud_native_storage_type

• デフォルト: S3
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: 使用するオブジェクトストレージのタイプ。共有データモードでは、StarRocks は Azure Blob (v3.1.1 以降でサポート) と S3 プロトコルと互換性のあるオブジェクトストレージ (AWS S3、Google GCP、MinIO など) にデータを保存することをサポートします。有効な値: S3 (デフォルト) と AZBLOB。このパラメータを S3 に指定する場合、aws_s3 で始まるパラメータを追加する必要があります。このパラメータを AZBLOB に指定する場合、azure_blob で始まるパラメータを追加する必要があります。
• 導入バージョン: -

aws_s3_path

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: データを保存するために使用される S3 パス。S3 バケットの名前とその下のサブパス (存在する場合) で構成されます。例: testbucket/subpath。
• 導入バージョン: v3.0

aws_s3_region

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: S3 バケットが存在するリージョン。例: us-west-2。
• 導入バージョン: v3.0

aws_s3_endpoint

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: S3 バケットにアクセスするために使用されるエンドポイント。例: https://s3.us-west-2.amazonaws.com。
• 導入バージョン: v3.0

aws_s3_use_aws_sdk_default_behavior

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: AWS SDK のデフォルト認証資格情報を使用するかどうか。有効な値: true と false (デフォルト)。
• 導入バージョン: v3.0

aws_s3_use_instance_profile

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: S3 にアクセスするための資格情報メソッドとしてインスタンスプロファイルとアサインドロールを使用するかどうか。有効な値: true と false (デフォルト)。
  • IAM ユーザーに基づく資格情報 (アクセスキーとシークレットキー) を使用して S3 にアクセスする場合、この項目を false に指定し、aws_s3_access_key と aws_s3_secret_key を指定する必要があります。
  • インスタンスプロファイルを使用して S3 にアクセスする場合、この項目を true に指定する必要があります。
  • アサインドロールを使用して S3 にアクセスする場合、この項目を true に指定し、aws_s3_iam_role_arn を指定する必要があります。
  • 外部 AWS アカウントを使用する場合、aws_s3_external_id も指定する必要があります。
• 導入バージョン: v3.0

aws_s3_access_key

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: S3 バケットにアクセスするために使用されるアクセスキー ID。
• 導入バージョン: v3.0

aws_s3_secret_key

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: S3 バケットにアクセスするために使用されるシークレットアクセスキー。
• 導入バージョン: v3.0

aws_s3_iam_role_arn

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: データファイルが保存されている S3 バケットに対する権限を持つ IAM ロールの ARN。
• 導入バージョン: v3.0

aws_s3_external_id

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: S3 バケットへのクロスアカウントアクセスに使用される AWS アカウントの外部 ID。
• 導入バージョン: v3.0

azure_blob_endpoint

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Azure Blob Storage アカウントのエンドポイント。例: https://test.blob.core.windows.net。
• 導入バージョン: v3.1

azure_blob_path

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: データを保存するために使用される Azure Blob Storage パス。ストレージアカウント内のコンテナの名前とその下のサブパス (存在する場合) で構成されます。例: testcontainer/subpath。
• 導入バージョン: v3.1

azure_blob_shared_key

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Azure Blob Storage のリクエストを承認するために使用される共有キー。
• 導入バージョン: v3.1

azure_blob_sas_token

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: Azure Blob Storage のリクエストを承認するために使用される共有アクセス署名 (SAS)。
• 導入バージョン: v3.1

lake_compaction_score_selector_min_score

• デフォルト: 10.0
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタで Compaction 操作をトリガーする Compaction スコアのしきい値。パーティションの Compaction スコアがこの値以上の場合、システムはそのパーティションで Compaction を実行します。
• 導入バージョン: v3.1.0

lake_compaction_max_tasks

• デフォルト: -1
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタで許可される同時 Compaction タスクの最大数。この項目を -1 に設定すると、同時タスク数が適応的に計算されます。この値を 0 に設定すると、Compaction が無効になります。
• 導入バージョン: v3.1.0

lake_compaction_history_size

• デフォルト: 20
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタ内の Leader FE ノードのメモリに保持される最近の成功した Compaction タスク記録の数。SHOW PROC '/compactions' コマンドを使用して、最近の成功した Compaction タスク記録を表示できます。Compaction 履歴は FE プロセスメモリに保存され、FE プロセスが再起動されると失われます。
• 導入バージョン: v3.1.0

lake_publish_version_max_threads

• デフォルト: 512
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタでのバージョン公開タスクの最大スレッド数。
• 導入バージョン: v3.2.0

lake_autovacuum_parallel_partitions

• デフォルト: 8
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: 共有データクラスタで同時に AutoVacuum を受けることができるパーティションの最大数。AutoVacuum は Compactions 後のガーベジコレクションです。
• 導入バージョン: v3.1.0

lake_autovacuum_partition_naptime_seconds

• デフォルト: 180
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: 共有データクラスタで同じパーティションに対して AutoVacuum 操作を行う間の最小間隔。
• 導入バージョン: v3.1.0

lake_autovacuum_grace_period_minutes

• デフォルト: 30
• タイプ: Long
• 単位: 分
• 変更可能: はい
• 説明: 共有データクラスタで履歴データバージョンを保持する時間範囲。この時間範囲内の履歴データバージョンは、Compactions 後に AutoVacuum によって自動的にクリーンアップされません。実行中のクエリが終了する前にアクセスされるデータが削除されないように、この値を最大クエリ時間より大きく設定する必要があります。デフォルト値は v3.3.0、v3.2.5、および v3.1.10 以降、5 から 30 に変更されました。
• 導入バージョン: v3.1.0

lake_autovacuum_stale_partition_threshold

• デフォルト: 12
• タイプ: Long
• 単位: 時間
• 変更可能: はい
• 説明: パーティションがこの時間範囲内で更新 (ロード、DELETE、Compactions) されていない場合、システムはそのパーティションで AutoVacuum を実行しません。
• 導入バージョン: v3.1.0

lake_enable_ingest_slowdown

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタでデータ取り込みのスローダウンを有効にするかどうか。データ取り込みのスローダウンが有効な場合、パーティションの Compaction スコアが lake_ingest_slowdown_threshold を超えると、そのパーティションでのロードタスクがスローダウンされます。この設定は run_mode が shared_data に設定されている場合にのみ有効です。
• 導入バージョン: v3.2.0

lake_ingest_slowdown_threshold

• デフォルト: 100
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタでデータ取り込みのスローダウンをトリガーする Compaction スコアのしきい値。この設定は lake_enable_ingest_slowdown が true に設定されている場合にのみ有効です。
• 導入バージョン: v3.2.0

lake_ingest_slowdown_ratio

• デフォルト: 0.1
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: データ取り込みのスローダウンがトリガーされたときのロード速度のスローダウン比率。

データロードタスクは、データ書き込みフェーズとデータコミット (COMMIT) の 2 つのフェーズで構成されます。データ取り込みのスローダウンは、データコミットを遅延させることで実現されます。遅延比率は次の式で計算されます: (compaction_score - lake_ingest_slowdown_threshold) * lake_ingest_slowdown_ratio。たとえば、データ書き込みフェーズが 5 分かかり、lake_ingest_slowdown_ratio が 0.1 で、Compaction スコアが lake_ingest_slowdown_threshold より 10 高い場合、データコミット時間の遅延は 5 * 10 * 0.1 = 5 分であり、平均ロード速度が半分になります。

• 導入バージョン: v3.2.0

NOTE

• ロードタスクが複数のパーティションに同時に書き込む場合、すべてのパーティションの中で最大の Compaction スコアがコミット時間の遅延を計算するために使用されます。
• コミット時間の遅延は、最初のコミット試行時に計算されます。一度設定されると、変更されません。遅延時間が経過すると、Compaction スコアが lake_compaction_score_upper_bound を超えない限り、システムはデータコミット操作を実行します。
• コミット時間の遅延がロードタスクのタイムアウトを超える場合、タスクは直接失敗します。

lake_compaction_score_upper_bound

• デフォルト: 0
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタ内のパーティションの Compaction スコアの上限。0 は上限がないことを示します。この項目は lake_enable_ingest_slowdown が true に設定されている場合にのみ有効です。パーティションの Compaction スコアがこの上限に達するか超えると、そのパーティションのすべてのロードタスクは、Compaction スコアがこの値を下回るか、タスクがタイムアウトするまで無期限に遅延されます。
• 導入バージョン: v3.2.0

lake_compaction_disable_tables

• デフォルト: ""
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: 共有データモードで Compaction が無効になっているテーブルのリスト。形式は tableId1;tableId2 で、セミコロンで区切ります。例: 12345;98765。
• 導入バージョン: v3.1.11

その他

tmp_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/temp_dir"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: バックアップおよび復元手順中に生成されたファイルなどの一時ファイルを保存するディレクトリ。これらの手順が終了すると、生成された一時ファイルは削除されます。
• 導入バージョン: -

plugin_dir

• デフォルト: System.getenv("STARROCKS_HOME") + "/plugins"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: プラグインインストールパッケージを保存するディレクトリ。
• 導入バージョン: -

plugin_enable

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: FEs にプラグインをインストールできるかどうか。プラグインは Leader FE のみでインストールまたはアンインストールできます。
• 導入バージョン: -

max_agent_task_threads_num

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

agent_task_resend_wait_time_ms

• デフォルト: 5000
• タイプ: Long
• 単位: ミリ秒
• 変更可能: はい
• 説明: エージェントタスクを再送信する前に FE が待機する必要がある期間。エージェントタスクは、タスク作成時間と現在の時間のギャップがこのパラメータの値を超える場合にのみ再送信できます。このパラメータは、エージェントタスクの繰り返し送信を防ぐために使用されます。
• 導入バージョン: -

backup_job_default_timeout_ms

• デフォルト: 86400 * 1000
• タイプ: Int
• 単位: ミリ秒
• 変更可能: はい
• 説明: バックアップジョブのタイムアウト期間。この値を超えると、バックアップジョブは失敗します。
• 導入バージョン: -

locale

• デフォルト: zh_CN.UTF-8
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: FE が使用する文字セット。
• 導入バージョン: -

report_queue_size (廃止予定)

• デフォルト: 100
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: レポートキューで待機できるジョブの最大数。レポートは、BEs のディスク、タスク、および tablet 情報に関するものです。キューにレポートジョブが多く積み上がると、OOM が発生します。
• 導入バージョン: -

enable_metric_calculator

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: メトリクスを定期的に収集するための機能を有効にするかどうかを指定します。有効な値: TRUE と FALSE。TRUE はこの機能を有効にすることを指定し、FALSE はこの機能を無効にすることを指定します。
• 導入バージョン: -

max_small_file_number

• デフォルト: 100
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: FE ディレクトリに保存できる小さなファイルの最大数。
• 導入バージョン: -

max_small_file_size_bytes

• デフォルト: 1024 * 1024
• タイプ: Int
• 単位: バイト
• 変更可能: はい
• 説明: 小さなファイルの最大サイズ。
• 導入バージョン: -

small_file_dir

• デフォルト: StarRocksFE.STARROCKS_HOME_DIR + "/small_files"
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: 小さなファイルのルートディレクトリ。
• 導入バージョン: -

enable_auth_check

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: 認証チェック機能を有効にするかどうかを指定します。有効な値: TRUE と FALSE。TRUE はこの機能を有効にすることを指定し、FALSE はこの機能を無効にすることを指定します。
• 導入バージョン: -

authentication_ldap_simple_server_host

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: LDAP サーバーが実行されているホスト。
• 導入バージョン: -

authentication_ldap_simple_server_port

• デフォルト: 389
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: LDAP サーバーのポート。
• 導入バージョン: -

authentication_ldap_simple_bind_base_dn

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: LDAP サーバーがユーザーの認証情報を検索する開始点であるベース DN。
• 導入バージョン: -

authentication_ldap_simple_user_search_attr

• デフォルト: uid
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: LDAP オブジェクト内でユーザーを識別する属性の名前。
• 導入バージョン: -

authentication_ldap_simple_bind_root_dn

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: ユーザーの認証情報を検索するために使用される管理者 DN。
• 導入バージョン: -

authentication_ldap_simple_bind_root_pwd

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: はい
• 説明: ユーザーの認証情報を検索するために使用される管理者のパスワード。
• 導入バージョン: -

auth_token

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能: いいえ
• 説明: FE が所属する StarRocks クラスタ内でのアイデンティティ認証に使用されるトークン。このパラメータが指定されていない場合、StarRocks はクラスタの Leader FE が初めて起動されたときにランダムなトークンを生成します。
• 導入バージョン: -

hive_meta_load_concurrency

• デフォルト: 4
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: Hive メタデータに対してサポートされる同時スレッドの最大数。
• 導入バージョン: -

hive_meta_cache_refresh_interval_s

• デフォルト: 3600 * 2
• タイプ: Long
• 単位: 秒
• 変更可能: いいえ
• 説明: Hive 外部テーブルのキャッシュされたメタデータが更新される時間間隔。
• 導入バージョン: -

hive_meta_cache_ttl_s

• デフォルト: 3600 * 24
• タイプ: Long
• 単位: 秒
• 変更可能: いいえ
• 説明: Hive 外部テーブルのキャッシュされたメタデータが期限切れになるまでの時間。
• 導入バージョン: -

hive_meta_store_timeout_s

• デフォルト: 10
• タイプ: Long
• 単位: 秒
• 変更可能: いいえ
• 説明: Hive メタストアへの接続がタイムアウトするまでの時間。
• 導入バージョン: -

es_state_sync_interval_second

• デフォルト: 10
• タイプ: Long
• 単位: 秒
• 変更可能: いいえ
• 説明: FE が Elasticsearch インデックスを取得し、StarRocks 外部テーブルのメタデータを同期する時間間隔。
• 導入バージョン: -

max_upload_task_per_be

• デフォルト: 0
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 各 BACKUP 操作で、StarRocks が BE ノードに割り当てるアップロードタスクの最大数。この項目が 0 以下に設定されている場合、タスク数に制限はありません。
• 導入バージョン: v3.1.0

max_download_task_per_be

• デフォルト: 0
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 各 RESTORE 操作で、StarRocks が BE ノードに割り当てるダウンロードタスクの最大数。この項目が 0 以下に設定されている場合、タスク数に制限はありません。
• 導入バージョン: v3.1.0

enable_colocate_restore

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: Colocate Tables のバックアップとリストアを有効にするかどうか。true は Colocate Tables のバックアップとリストアを有効にすることを示し、false は無効にすることを示します。
• 導入バージョン: v3.2.10, v3.3.3

allow_system_reserved_names

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: ユーザーが __op および __row で始まる名前の列を作成できるかどうか。この機能を有効にするには、このパラメータを TRUE に設定します。これらの名前形式は StarRocks で特別な目的のために予約されており、そのような列を作成すると未定義の動作が発生する可能性があるため、この機能はデフォルトで無効になっています。
• 導入バージョン: v3.2.0

jdbc_meta_default_cache_enable

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: JDBC Catalog メタデータキャッシュが有効かどうかのデフォルト値。True に設定すると、新しく作成された JDBC Catalogs はデフォルトでメタデータキャッシュが有効になります。
• 導入バージョン: -

jdbc_meta_default_cache_expire_sec

• デフォルト: 600
• タイプ: Long
• 単位: 秒
• 変更可能: はい
• 説明: JDBC Catalog メタデータキャッシュのデフォルトの有効期限時間。jdbc_meta_default_cache_enable が true に設定されている場合、新しく作成された JDBC Catalogs はデフォルトでメタデータキャッシュの有効期限を設定します。
• 導入バージョン: -

jdbc_connection_pool_size

• デフォルト: 8
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: JDBC catalogs にアクセスするための JDBC 接続プールの最大容量。
• 導入バージョン: -

jdbc_minimum_idle_connections

• デフォルト: 1
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: JDBC catalogs にアクセスするための JDBC 接続プール内の最小アイドル接続数。
• 導入バージョン: -

jdbc_connection_idle_timeout_ms

• デフォルト: 600000
• タイプ: Int
• 単位: ミリ秒
• 変更可能: はい
• 説明: JDBC catalog にアクセスするための接続がタイムアウトするまでの最大時間。タイムアウトした接続はアイドルと見なされます。
• 導入バージョン: -

query_detail_explain_level

• デフォルト: COSTS
• タイプ: String
• 単位: -
• 変更可能: true
• 説明: EXPLAIN ステートメントによって返されるクエリプランの詳細レベル。有効な値: COSTS, NORMAL, VERBOSE。
• 導入バージョン: v3.2.12, v3.3.5