SHOW FLAGS
功能概述
列出 SQL 引擎的配置参数（flag），包括参数名、当前会话中的取值、默认值、类型和说明。用
SET
SET
调整参数前，可以先用
SHOW FLAGS
SHOW FLAGS
查找参数的准确名称和默认值；
SET
SET
之后，可以用它确认当前会话中是否已经生效。
语法
SHOW FLAGS [EXTENDED]
[ LIKE '<pattern>' | NOT LIKE '<pattern>' | WHERE <condition> ]
[ LIMIT <n> ]
参数说明
EXTENDED
EXTENDED
：不加时只列出可以在会话中用 SET
SET
修改的公开参数；加上后列出全部参数，包括系统级参数、内部参数和已废弃参数。日常排查用不加 EXTENDED
EXTENDED
的形式即可。LIKE '<pattern>'
LIKE '<pattern>'
/ NOT LIKE '<pattern>'
NOT LIKE '<pattern>'
：按参数名过滤，%
%
匹配任意字符，如 LIKE '%dry.run%'
LIKE '%dry.run%'
。WHERE <condition>
WHERE <condition>
：按任意输出列过滤，如 WHERE flag_name = 'cz.sql.dry.run'
WHERE flag_name = 'cz.sql.dry.run'
、WHERE component = 'Compiler'
WHERE component = 'Compiler'
。LIMIT <n>
LIMIT <n>
：只返回前 n 行。
输出列：
| 列名 | 说明 |
|---|
flag_name
flag_name | 参数名，即 SET <flag_name> = ...
SET <flag_name> = ... 中使用的名字 |
current_value
current_value | 当前会话中的取值；未修改时等于默认值 |
default_value
default_value | 默认值 |
component
component | 参数所属模块，如 Compiler
Compiler 、Runtime
Runtime |
type
type | 取值类型，如 bool
bool 、string
string 、int64
int64 |
scope
scope | session
session ：可按会话设置；system
system ：系统级 |
mutability
mutability | temporary
temporary ：可在会话中临时修改；permanent
permanent ：不能通过 SET
SET 修改 |
visibility
visibility | public
public 、internal
internal 或 deprecated
deprecated |
description
description | 参数说明 |
tags
tags | 标签，多个用逗号分隔 |
使用示例
按名称查找参数：
SHOW FLAGS LIKE '%dry.run%';
精确查看一个参数，并确认
SET
SET
后的当前值：
SET cz.sql.table.default.format = orc;
SELECT flag_name, current_value, default_value
FROM (SHOW FLAGS WHERE flag_name = 'cz.sql.table.default.format');
| flag_name | current_value | default_value |
|---|
| cz.sql.table.default.format | orc | parquet |
列出全部参数（包括系统级和内部参数）中名字含
parser
parser
的前 10 个：
SHOW FLAGS EXTENDED LIKE '%parser%' LIMIT 10;
注意事项
- 不加
EXTENDED
EXTENDED
时只显示 scope
scope
为 session
session
、mutability
mutability
为 temporary
temporary
、visibility
visibility
为 public
public
的参数，即普通用户可以用 SET
SET
修改的参数。
internal
internal
参数可能随版本变化，不建议在生产任务中依赖。
相关文档
