FE Configuration

FE パラメータは、動的パラメータと静的パラメータに分類されます。

• 動的パラメータは、SQL コマンドを実行することで設定および調整でき、非常に便利です。ただし、FE を再起動すると設定が無効になります。そのため、fe.conf ファイルの設定項目も変更して、変更が失われないようにすることをお勧めします。

• 静的パラメータは、FE の設定ファイル fe.conf でのみ設定および調整できます。このファイルを変更した後、変更を有効にするには FE を再起動する必要があります。

パラメータが動的パラメータであるかどうかは、ADMIN SHOW CONFIG の出力の IsMutable 列で示されます。TRUE は動的パラメータを示します。

動的および静的 FE パラメータの両方が fe.conf ファイルで設定できることに注意してください。

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");

注記

ADMIN SET FRONTEND で行った設定変更は、FE が再起動すると fe.conf ファイルのデフォルト値に戻ります。したがって、変更を永続的にしたい場合は、fe.conf の設定項目も変更することをお勧めします。

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

注記

FE の静的パラメータは、設定ファイル fe.conf を変更し、FE を再起動して変更を反映させることで設定されます。

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

net_use_ipv6_when_priority_networks_empty

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

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 クラスタの名前。クラスタ名は、Web ページの 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_enable_keep_alive

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: MySQL 接続の TCP Keep-Alive を有効にします。ロードバランサーの背後で長時間アイドル状態の接続に役立ちます。
• 導入バージョン: -

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 に変更されました。
• 導入バージョン: -

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

cluster_id

• デフォルト: -1
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: FE が属する StarRocks クラスタの ID。同じクラスタ ID を持つ FEs または BEs は同じ StarRocks クラスタに属します。有効な値: 任意の正の整数。デフォルト値 -1 は、クラスタの Leader FE が初めて起動されたときに StarRocks が 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 データベースに書き込まれます。
• 導入バージョン: -

metadata_ignore_unknown_operation_type

• デフォルト: 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 タイムアウトが発生します。この状況を防ぐために、このパラメータの値を増やすことをお勧めします。
• 導入バージョン: -

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

black_host_history_sec

• デフォルト: 2 * 60
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: BE ブラックリスト内の BE ノードの過去の接続失敗を保持する時間。BE ノードが自動的に BE ブラックリストに追加されると、StarRocks はその接続性を評価し、BE ブラックリストから削除できるかどうかを判断します。black_host_history_sec 内で、ブラックリストに登録された BE ノードが black_host_connect_failures_within_time に設定されたしきい値よりも少ない接続失敗を持っている場合にのみ、BE ブラックリストから削除できます。
• 導入バージョン: v3.3.0

black_host_connect_failures_within_time

• デフォルト: 5
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: ブラックリストに登録された BE ノードに許可される接続失敗のしきい値。BE ノードが自動的に BE ブラックリストに追加されると、StarRocks はその接続性を評価し、BE ブラックリストから削除できるかどうかを判断します。black_host_history_sec 内で、ブラックリストに登録された BE ノードが black_host_connect_failures_within_time に設定されたしきい値よりも少ない接続失敗を持っている場合にのみ、BE ブラックリストから削除できます。
• 導入バージョン: v3.3.0

lock_manager_enabled

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: ロックマネージャーを有効にするかどうか。ロックマネージャーはロックの集中管理を行います。たとえば、メタデータロックの粒度をデータベースレベルからテーブルレベルに細分化するかどうかを制御できます。
• 導入バージョン: v3.3.0

lock_manager_enable_using_fine_granularity_lock

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: メタデータロックの粒度をデータベースレベルからテーブルレベルに細分化するかどうか。メタデータロックがテーブルレベルに細分化されると、ロックの競合と競争が減少し、ロードとクエリの同時実行性が向上します。このパラメータは lock_manager_enabled が有効な場合にのみ有効です。
• 導入バージョン: v3.3.0

enable_legacy_compatibility_for_replication

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

automated_cluster_snapshot_interval_seconds

• デフォルト: 600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: 自動クラスタスナップショットのタスクがトリガされる間隔。
• 導入バージョン: v3.4.2

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

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

• デフォルト: false
• タイプ: 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_active_materialized_view_schema_strict_check

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 非アクティブなマテリアライズドビューをアクティブ化する際に、データ型の長さの一貫性を厳密にチェックするかどうか。この項目が false に設定されている場合、ベーステーブルでデータ型の長さが変更されても、マテリアライズドビューのアクティブ化には影響しません。
• 導入バージョン: v3.3.4

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
• 単位: -
• 変更可能: はい
• 説明: ヒストグラムのために収集する最大行数。
• 導入バージョン: -

connector_table_query_trigger_task_schedule_interval

• デフォルト: 30
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: Scheduler スレッドがクエリトリガーのバックグラウンドタスクをスケジュールする間隔。この項目は v3.4.0 で導入された connector_table_query_trigger_analyze_schedule_interval を置き換えるものである。ここで、バックグラウンドタスクとは、v3.4 では ANALYZE タスク、v3.4 より後のバージョンでは低カーディナリティ列の辞書のコレクションタスクを指す。
• 導入バージョン: v3.4.2

connector_table_query_trigger_analyze_small_table_rows

• デフォルト: 10000000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: クエリトリガー分析タスクのためにテーブルが小さなテーブルであるかどうかを判断するためのしきい値。
• 導入バージョン: v3.4.0

connector_table_query_trigger_analyze_small_table_interval

• デフォルト: 2 * 3600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: 小さなテーブルのクエリトリガー分析タスクの間隔。
• 導入バージョン: v3.4.0

connector_table_query_trigger_analyze_large_table_interval

• デフォルト: 12 * 3600
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: 大きなテーブルのクエリトリガー分析タスクの間隔。
• 導入バージョン: v3.4.0

connector_table_query_trigger_analyze_max_pending_task_num

• デフォルト: 100
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: FE 上で保留状態のクエリトリガー分析タスクの最大数。
• 導入バージョン: v3.4.0

connector_table_query_trigger_analyze_max_running_task_num

• デフォルト: 2
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: FE 上で実行中のクエリトリガー分析タスクの最大数。
• 導入バージョン: v3.4.0

enable_local_replica_selection

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

max_distribution_pruner_recursion_depth

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

slow_query_analyze_threshold

• デフォルト: 5
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: クエリフィードバックの分析をトリガーするクエリの実行時間しきい値。
• 導入バージョン: v3.4.0

ロードとアンロード

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
• 単位: 秒
• 変更可能: はい
• 説明: 完了したロードジョブのラベルを保持する最大期間（FINISHED または CANCELLED 状態）。デフォルト値は 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
• 単位: -
• 変更可能: はい
• 説明: データがロードされていない場合に「すべてのパーティションにロードデータがありません」というエラーメッセージを返すかどうか。有効な値:
  • true: データがロードされていない場合、システムは失敗メッセージを表示し、「すべてのパーティションにロードデータがありません」というエラーを返します。
  • false: データがロードされていない場合、システムは成功メッセージを表示し、エラーの代わりに OK を返します。
• 導入バージョン: -

external_table_commit_timeout_ms

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

enable_sync_publish

• デフォルト: true
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: ロードトランザクションの公開フェーズで適用タスクを同期的に実行するかどうか。このパラメータは主キーテーブルにのみ適用されます。有効な値:
  • 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
• 単位: -
• 変更可能: はい
• 説明: 行と列のハイブリッドストレージ 機能を有効にするかどうか。
• 導入バージョン: v3.2.3

enable_experimental_gin

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 全文逆インデックス 機能を有効にするかどうか。
• 導入バージョン: v3.3.0

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

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

NOTE

• StarRocks 共有データクラスタは v3.3.0 からこのパラメータをサポートしています。
• 特定のテーブルに対して高速スキーマ進化を設定する必要がある場合、たとえば特定のテーブルに対して高速スキーマ進化を無効にする場合、テーブル作成時にテーブルプロパティ 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
• 単位: -
• 変更可能: はい
• 説明: 同時にスケジュールできる tablet の最大数。この値を超えると、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
• 単位: -
• 変更可能: はい
• 説明: 同時にバランスを取ることができる tablet の最大数。この値を超えると、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 を超えることはできません。クラスタ内の tablets が A から B に、B から A に絶えずバランスを取っている場合、この値を減らしてください。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

auto_partition_max_creation_number_per_load

• デフォルト: 4096
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: ロードタスクによってテーブル（式に基づくパーティション化戦略）に作成できる最大パーティション数。
• 導入バージョン: v3.3.2

max_partition_number_per_table

• デフォルト: 100000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: テーブルに作成できる最大パーティション数。
• 導入バージョン: v3.3.2

max_bucket_number_per_partition

• デフォルト: 1024
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: パーティションに作成できる最大バケット数。
• 導入バージョン: v3.3.2

max_column_number_per_table

• デフォルト: 10000
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: テーブルに作成できる最大列数。
• 導入バージョン: v3.3.2

共有データ

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 リッスンポート。
• 導入バージョン: -

enable_load_volume_from_conf

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: いいえ
• 説明: StarRocks が FE 設定ファイルに指定されたオブジェクトストレージ関連のプロパティを使用して組み込みストレージボリュームを作成できるかどうか。デフォルト値は v3.4.1 以降、true から false に変更されました。
• 導入バージョン: v3.1.0

cloud_native_storage_type

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

cloud_native_hdfs_url

• デフォルト: 空の文字列
• タイプ: String
• 単位: -
• 変更可能か：いいえ
• 説明: HDFS ストレージの URL。例: hdfs://127.0.0.1:9000/user/xxx/starrocks/。
• 導入バージョン: -

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 Score のしきい値。パーティションの Compaction Score がこの値以上の場合、システムはそのパーティションで 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

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

lake_ingest_slowdown_threshold

• デフォルト: 100
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタでデータ取り込みのスローダウンをトリガーする Compaction Score のしきい値。この設定は 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 Score が lake_ingest_slowdown_threshold より 10 高い場合、データコミット時間の遅延は 5 * 10 * 0.1 = 5 分であり、平均ロード速度が半分になります。

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

NOTE

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

lake_compaction_score_upper_bound

• デフォルト: 2000
• タイプ: Long
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタでのパーティションの Compaction Score の上限。0 は上限がないことを示します。この項目は lake_enable_ingest_slowdown が true に設定されている場合にのみ有効です。パーティションの Compaction Score がこの上限に達するか超えると、受信するロードタスクは拒否されます。v3.3.6 以降、デフォルト値は 0 から 2000 に変更されました。
• 導入バージョン: v3.2.0

lake_compaction_disable_tables

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

lake_enable_balance_tablets_between_workers

• デフォルト: false
• タイプ: Boolean
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタでクラウドネイティブテーブルの tablet 移行中に Compute Nodes 間で tablet の数をバランスさせるかどうか。true は Compute Nodes 間で tablet をバランスさせることを示し、false はこの機能を無効にすることを示します。
• 導入バージョン: v3.3.4

lake_balance_tablets_threshold

• デフォルト: 0.15
• タイプ: Double
• 単位: -
• 変更可能: はい
• 説明: 共有データクラスタでのワーカー間の tablet バランスを判断するためにシステムが使用するしきい値。アンバランスファクターは次のように計算されます: f = (MAX(tablets) - MIN(tablets)) / AVERAGE(tablets)。ファクターが lake_balance_tablets_threshold を超える場合、tablet バランスがトリガーされます。この項目は lake_enable_balance_tablets_between_workers が true に設定されている場合にのみ有効です。
• 導入バージョン: v3.3.4

その他

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
• 単位: -
• 変更可能: はい
• 説明: レポートキューで待機できるジョブの最大数。レポートは BE のディスク、タスク、および 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 クラスタ内での ID 認証に使用されるトークン。このパラメータが指定されていない場合、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

replication_interval_ms

• デフォルト: 100
• タイプ: Int
• 単位: -
• 変更可能: いいえ
• 説明: レプリケーションタスクがスケジュールされる最小時間間隔。
• 導入バージョン: v3.3.5

replication_max_parallel_table_count

• デフォルト: 100
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 許可される最大同時データ同期タスク数。StarRocks は各テーブルに対して 1 つの同期タスクを作成します。
• 導入バージョン: v3.3.5

replication_max_parallel_replica_count

• デフォルト: 10240
• タイプ: Int
• 単位: -
• 変更可能: はい
• 説明: 許可される最大同時同期タブレットレプリカ数。
• 導入バージョン: v3.3.5

replication_max_parallel_data_size_mb

• デフォルト: 1048576
• タイプ: Int
• 単位: MB
• 変更可能: はい
• 説明: 許可される最大同時同期データサイズ。
• 導入バージョン: v3.3.5

replication_transaction_timeout_sec

• デフォルト: 86400
• タイプ: Int
• 単位: 秒
• 変更可能: はい
• 説明: 同期タスクのタイムアウト期間。
• 導入バージョン: v3.3.5

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
• 単位: -
• 変更可能: はい
• 説明: EXPLAIN ステートメントによって返されるクエリプランの詳細レベル。有効な値: COSTS, NORMAL, VERBOSE。
• 導入バージョン: v3.2.12, v3.3.5