@@ -3,11 +3,11 @@ title: SHOW SETTINGS
33---
44import FunctionDescription from '@site/src /components/FunctionDescription';
55
6- <FunctionDescription description =" 引入或更新: v1.2.314" />
6+ <FunctionDescription description =" 引入或更新于: v1.2.314" />
77
88Databend 提供了多种系统设置,使您能够控制 Databend 的工作方式。此命令显示可用系统设置的当前值和默认值,以及[ 设置级别] ( #setting-levels ) 。要更新设置,请使用 [ SET] ( 02-set-global.md ) 或 [ UNSET] ( 02-unset.md ) 命令。
99
10- - 某些 Databend 行为无法通过系统设置进行更改 ;您在使用 Databend 时必须考虑这些行为。例如,
10+ - 某些 Databend 行为无法通过系统设置更改 ;您在使用 Databend 时必须考虑这些行为。例如,
1111 - Databend 将字符串编码为 UTF-8 字符集。
1212 - Databend 使用基于 1 的数组编号约定。
1313- Databend 将系统设置存储在系统表 [ system.settings] ( ../../00-sql-reference/20-system-tables/system-settings.md ) 中。
@@ -20,30 +20,30 @@ SHOW SETTINGS [LIKE '<pattern>' | WHERE <expr>] | [LIMIT <limit>]
2020
2121## 设置级别
2222
23- 每个 Databend 设置都有一个级别,可以是 Global、Default 或 Session。下表说明了每个级别的区别 :
23+ 每个 Databend 设置都有一个级别,可以是 Global、Default 或 Session。下表说明了每个级别之间的区别 :
2424
25- | 级别 | 描述 |
26- | -----------| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
27- | Global | 具有此级别的设置会写入元服务,并影响同一租户中的所有计算集群 。此级别的更改具有全局影响,适用于由多个计算集群共享的整个数据库环境。 |
28- | Default | 具有此级别的设置通过 ` databend-query.toml ` 配置文件进行配置。此级别的更改仅影响单个查询实例,并且特定于配置文件。此级别为单个查询实例提供默认设置。 |
29- | Session | 具有此级别的设置仅限于单个请求或会话。它们的作用范围最窄,仅适用于正在进行的特定会话或请求 ,提供了一种按会话自定义设置的方式。 |
25+ | 级别 | 描述 |
26+ | ------------ | --- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
27+ | Global | 具有此级别的设置会写入元数据服务,并影响同一租户中的所有集群 。此级别的更改具有全局影响,适用于由多个集群共享的整个数据库环境。 |
28+ | Default | 具有此级别的设置通过 ` databend-query.toml ` 配置文件进行配置。此级别的更改仅影响单个查询实例,并且特定于配置文件。此级别为单个查询实例提供默认设置。 |
29+ | Session | 具有此级别的设置仅限于单个请求或会话。它们的范围最窄,仅适用于当前正在进行的特定会话或请求 ,提供了一种按会话自定义设置的方式。 |
3030
3131## 示例
3232
3333::: note
34- 由于 Databend 不时更新系统设置,此示例可能不会显示最新的结果 。要查看 Databend 中的最新系统设置,请在您的 Databend 实例中执行 ` SHOW SETTINGS; ` 。
34+ 由于 Databend 会不时更新系统设置,此示例可能无法显示最新的结果 。要查看 Databend 中的最新系统设置,请在您的 Databend 实例中执行 ` SHOW SETTINGS; ` 。
3535:::
3636
3737``` sql
3838SHOW SETTINGS LIMIT 5 ;
3939
4040┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
41- │ name │ value │ default │ range │ level │ description │ type │
42- ├─────────────────────────────────────────────┼──────── ┼───────── ┼──────────┼─────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼────────┤
43- │ acquire_lock_timeout │ 15 │ 15 │ None │ DEFAULT │ 设置获取锁的最大超时时间(以秒为单位)。 │ UInt64 │
44- │ aggregate_spilling_bytes_threshold_per_proc │ 0 │ 0 │ None │ DEFAULT │ 设置聚合器在查询执行期间溢出数据到存储之前可以使用的最大内存量(以字节为单位)。 │ UInt64 │
45- │ aggregate_spilling_memory_ratio │ 0 │ 0 │ [0 , 100 ] │ DEFAULT │ 设置聚合器在查询执行期间溢出数据到存储之前可以使用的最大内存比率(以字节为单位)。 │ UInt64 │
46- │ auto_compaction_imperfect_blocks_threshold │ 50 │ 50 │ None │ DEFAULT │ 触发自动压缩的阈值。在写操作后,当快照中的不完美块数量超过此值时,将发生自动压缩。 │ UInt64 │
47- │ collation │ utf8 │ utf8 │ [" utf8" ] │ DEFAULT │ 设置字符排序规则。可用值包括 " utf8" 。 │ String │
41+ │ 名称 │ 值 │ 默认值 │ 范围 │ 级别 │ 描述 │ 类型 │
42+ ├─────────────────────────────────────────────┼──────┼────────┼──────────┼─ ─────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼────────┤
43+ │ acquire_lock_timeout │ 15 │ 15 │ None │ DEFAULT │ 设置获取锁的最大超时时间(秒)。 │ UInt64 │
44+ │ aggregate_spilling_bytes_threshold_per_proc │ 0 │ 0 │ None │ DEFAULT │ 设置聚合器在执行查询期间在将数据溢出到存储之前可以使用的最大内存量(字节)。 │ UInt64 │
45+ │ aggregate_spilling_memory_ratio │ 0 │ 0 │ [0 , 100 ] │ DEFAULT │ 设置聚合器在执行查询期间在将数据溢出到存储之前可以使用的最大内存比例(字节)。 │ UInt64 │
46+ │ auto_compaction_imperfect_blocks_threshold │ 50 │ 50 │ None │ DEFAULT │ 触发自动压缩的阈值。当写入操作后快照中的不完美块数量超过此值时,将触发自动压缩。 │ UInt64 │
47+ │ collation │ utf8 │ utf8 │ [" utf8" ] │ DEFAULT │ 设置字符排序规则。可用值包括 " utf8" 。 │ String │
4848└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
4949```
0 commit comments