StarRocks 配置查询指南：ADMIN SHOW FRONTEND CONFIG 命令详解与 FE 参数实践-平芜编程栈

StarRocks 配置查询指南：ADMIN SHOW FRONTEND CONFIG 命令详解与 FE 参数实践

【免费下载链接】starrocksThe world's fastest open query engine for sub-second analytics both on and off the data lakehouse. With the flexibility to support nearly any scenario, StarRocks provides best-in-class performance for multi-dimensional analytics, real-time analytics, and ad-hoc queries. A Linux Foundation project.项目地址: https://gitcode.com/GitHub_Trending/st/starrocks

本文以 StarRocks 官方文档中的ADMIN SHOW CONFIG章节为核心，系统讲解如何通过 SQL 命令查看当前集群（目前仅支持 FE）的配置项，并结合仓库源码（FE 端实现）剖析命令的语法解析、权限校验、结果集字段与底层取值逻辑，帮助 DBA 与开发者在排查集群问题时快速定位参数当前值、判断参数是否可在线修改，并与ADMIN SET CONFIG配合完成参数变更的查询闭环。

命令概览与适用场景

ADMIN SHOW CONFIG用于展示当前集群的配置信息。当前版本中，该命令仅支持展示 FE（Frontend，前端节点）的配置项，BE（Backend，后端节点）等组件的配置不在其展示范围内。它适合在以下场景中使用：

排查集群行为异常时，确认某个 FE 配置项的当前生效值；
修改参数前，先查询参数的类型与IsMutable标记，判断能否用ADMIN SET CONFIG在线变更；
集群维护时批量核对 FE 节点的参数基线，确保多节点配置一致。

FE 配置项的完整说明可参考 FE 参数配置文档；若需要在查看之后修改某项配置，可参考 ADMIN SET CONFIG。

注意：该命令的查询结果反映的是 FE 进程内存中当前生效的配置值，它既可以来自启动时加载的fe.conf配置文件，也可能来自之前通过ADMIN SET CONFIG动态修改的值。

权限要求

执行ADMIN SHOW CONFIG需要SYSTEM 级别的 OPERATE 权限。该权限可以通过 GRANT 语句授予，示例：

-- 将 SYSTEM 级 OPERATE 权限授予用户 GRANT OPERATE ON SYSTEM TO USER 'admin_user';

这一权限要求有明确的源码依据。在 FE 的权限校验器中，AdminShowConfigStmt语句的处理逻辑会调用Authorizer.checkSystemAction(context, PrivilegeType.OPERATE)进行校验，未授权访问会被报告为访问拒绝（见 AuthorizerStmtVisitor.java）。

语法

ADMIN SHOW FRONTEND CONFIG [LIKE "pattern"]

语法要点：

ADMIN SHOW FRONTEND CONFIG是完整命令形式，FRONTEND关键字不可省略；
LIKE "pattern"为可选子句，用于按模式过滤配置项，pattern 中支持使用通配符%和_；
该语句不区分大小写（admin show frontend config同样合法）。

从语法定义看，StarRocks 的 ANTLR 语法文件在adminShowConfigStatement规则中定义了ADMIN SHOW FRONTEND CONFIG (LIKE pattern=string)?的形式（见 StarRocks.g4）。FE 的分析器测试用例中也覆盖了带与不带 LIKE 子句两种写法（见 AdminShowTest.java）：

analyzeSuccess("admin show frontend config;"); analyzeSuccess("admin show frontend config like '%parallel%';");

返回字段说明

命令返回的每一行对应一个配置项，结果集共 6 列，字段语义如下：

字段	说明
`Key`	配置项名称，即`fe.conf`中使用的参数名
`AliasNames`	该配置项的别名列表（JSON 数组形式），别名可同时用于匹配和设置
`Value`	配置项的当前值
`Type`	配置项的数据类型（如`boolean`、`int`、`long`、`double`、`String`及各类数组类型）
`IsMutable`	是否可以通过`ADMIN SET CONFIG`命令在线修改（`true`/`false`）
`Comment`	配置项的描述信息

这 6 列的定义与仓库源码完全对应。结果集元数据在 ShowResultMetaFactory.java 中依次注册了Key、AliasNames、Value、Type、IsMutable、Comment六个列。

底层取值逻辑（源码解析）

执行ADMIN SHOW FRONTEND CONFIG时，FE 的实际处理流程如下：

语法解析阶段，AstBuilder.java 根据是否带 LIKE 子句构造AdminShowConfigStmt（带 pattern 或 pattern 为null），语句类型统一为ConfigType.FRONTEND；
语句执行阶段，ShowExecutor.java 先将 LIKE 模式编译为 MySQL 风格的PatternMatcher（按配置项大小写敏感性匹配），再调用ConfigBase.getConfigInfo(matcher)取出全部配置，最后按 Key 升序排序后返回；
配置枚举阶段，ConfigBase.java 通过反射遍历 FE 启动时扫描到的所有@ConfField注解字段，逐项输出参数名、别名数组、当前值、类型、mutable标记与注释；若matcher不为空，还会用别名参与匹配（isAliasesMatch），因此用别名也能命中并显示对应配置。

由此可以推断并确认几个行为特征：

无 LIKE 子句时输出当前 FE 节点的全部配置项，并按 Key 字典序排列；
结果中的Value是配置字段的实时值，数组类型参数会以Arrays.toString形式展示；
IsMutable字段直接来自@ConfField注解的mutable()属性，它决定该参数是否允许通过ADMIN SET CONFIG动态修改，也即是否支持热更新。

使用示例

示例 1：查看当前 FE 节点的全部配置

ADMIN SHOW FRONTEND CONFIG;

执行后会返回当前 FE 节点所有配置项，输出按 Key 排序。当结果集较大时，建议结合 LIKE 过滤使用，或在 mysql 客户端中使用分页查看。

示例 2：使用 LIKE 过滤查找指定配置

mysql> ADMIN SHOW FRONTEND CONFIG LIKE '%vectorized_load_enable%'; +------------------------+------------+-------+---------+-----------+---------+ | Key | AliasNames | Value | Type | IsMutable | Comment | +------------------------+------------+-------+---------+-----------+---------+ | vectorized_load_enable | [] | true | boolean | true | | +------------------------+------------+-------+---------+-----------+---------+ 1 row in set (0.00 sec)

可以看到：

Key为vectorized_load_enable，表示向量化导入开关；
AliasNames为空数组[]，说明该参数没有别名；
Value为true，即当前生效值为开启；
Type为boolean；
IsMutable为true，说明该参数可以通过ADMIN SET CONFIG在线修改。

示例 3：查找与内存、并行度相关的配置

-- 匹配参数名中包含 parallel 的配置 ADMIN SHOW FRONTEND CONFIG LIKE '%parallel%'; -- 匹配参数名中包含 memory 的配置 ADMIN SHOW FRONTEND CONFIG LIKE '%memory%';

LIKE中的%匹配任意数量字符，_匹配单个字符。若未找到任何匹配项，则返回空结果集。

与 ADMIN SET CONFIG 配合使用

ADMIN SHOW CONFIG与 ADMIN SET CONFIG 是配置管理的一对命令：前者负责“查”，后者负责“改”。推荐的参数运维流程如下：

先用ADMIN SHOW FRONTEND CONFIG LIKE '%参数名%'查询参数当前值，并确认IsMutable是否为true（只有为true的参数才能在线修改）；
若参数不可变（IsMutable为false），则需要修改 FE 的fe.conf配置文件并重启 FE 节点使其生效；
若参数可变，使用ADMIN SET FRONTEND CONFIG ("参数名" = "新值")在线变更；
变更后再次执行ADMIN SHOW FRONTEND CONFIG LIKE '%参数名%'验证新值已生效。

常见问题与注意事项

为什么只能看到 FE 配置，看不到 BE 配置？这是当前版本的既定能力边界，文档与源码实现均表明该命令只面向 FE 配置项（ConfigType.FRONTEND）。BE 参数需通过其自身的配置与监控体系查看。
LIKE 模式区分大小写吗？LIKE 匹配遵循配置项本身的CaseSensibility.CONFIG大小写敏感性规则，建议按参数名原样（小写）编写模式以规避大小写差异。
结果顺序是固定的吗？是的，FE 在返回前会按Key升序排序，方便人工比对与脚本解析。
没有权限时怎么办？执行会报权限拒绝错误，需由管理员通过GRANT OPERATE ON SYSTEM TO ...授予 SYSTEM 级 OPERATE 权限。