SHOW SETTINGS
引入或更新: v1.2.314
Databend提供了多种系统设置,使您能够控制Databend的工作方式。此命令显示可用系统设置的当前值和默认值,以及设置级别。要更新设置,请使用SET或UNSET命令。
- 某些Databend行为无法通过系统设置进行更改;您必须在处理Databend时考虑这些行为。例如,
- Databend将字符串编码为UTF-8字符集。
- Databend对数组使用基于1的编号约定。
- Databend将系统设置存储在系统表system.settings中。
语法
SHOW SETTINGS [LIKE '<pattern>' | WHERE <expr>] | [LIMIT <limit>]
设置级别
每个Databend设置都有一个级别,可以是Global、Default或Session。下表说明了每个级别之间的区别:
级别 | 描述 |
---|---|
Global | 具有此级别的设置会写入元服务,并影响同一租户中的所有集群。此级别的更改具有全局影响,并适用于由多个集群共享的整个数据库环境。 |
Default | 具有此级别的设置通过databend-query.toml 配置文件进行配置。此级别的更改仅影响单个查询实例,并且特定于配置文件。此级别为单个查询实例提供默认设置。 |
Session | 具有此级别的设置仅限于单个请求或会话。它们的作用域最窄,仅适用于正在进行的特定会话或请求,提供了一种按会话自定义设置的方法。 |
示例
备注
由于Databend不断更新系统设置,此示例可能不会显示最新的结果。要查看Databend中的最新系统设置,请在您的Databend实例中执行SHOW SETTINGS;
。
SHOW SETTINGS LIMIT 5;
┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ name │ value │ default │ range │ level │ description │ type │
├─────────────────────────────────────────────┼────────┼─────────┼──────────┼─────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼────────┤
│ acquire_lock_timeout │ 15 │ 15 │ None │ DEFAULT │ 设置获取锁的最大超时时间(以秒为单位)。 │ UInt64 │
│ aggregate_spilling_bytes_threshold_per_proc │ 0 │ 0 │ None │ DEFAULT │ 设置聚合器在查询执行期间可以使用的最大内存量(以字节为单位),超过此值将数据溢出到存储。 | UInt64 │
│ aggregate_spilling_memory_ratio │ 0 │ 0 │ [0, 100] │ DEFAULT │ 设置聚合器在查询执行期间可以使用的最大内存比率(以字节为单位),超过此值将数据溢出到存储。 | UInt64 │
│ auto_compaction_imperfect_blocks_threshold │ 50 │ 50 │ None │ DEFAULT │ 触发自动压缩的阈值。在写操作后,当快照中的不完美块数量超过此值时,将发生自动压缩。 | UInt64 │
│ collation │ utf8 │ utf8 │ ["utf8"] │ DEFAULT │ 设置字符排序规则。可用值包括"utf8"。 | String │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘