FE 設定
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_enabled
- デフォルト: true
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: FE ノードで非同期 I/O が有効かどうかを指定します。
- 導入バージョン: -
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 サーバーバージョン。このパラメータを変更すると、次の状況でバージョン情報に影響します:
select version();- ハンドシェイクパケットバージョン
- グローバル変数
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
- 単位: -
- 変更可能: いいえ
- 説明: 接続スケジューラがサポートする最大スレッド数。
- 導入バージョン: -