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
参数可能随版本变化，不建议在生产任务中依赖。

SHOW FLAGS

功能概述

语法

参数说明

使用示例

注意事项

相关文档