KingbaseES中的参数查看与修改

KingbaseES数据库的配置参数都在kingbase.conf文件中，这些参数有些是直接修改就可以生效，有些需要重启数据库才能生效，而有些根本就不能修改。数据库把这些参数分为以下几类：

internal：这类参数为只读参数。有些是程序写死的，有些是在安装数据库时intdb时设置好的。
kingbase：这类参数需要重启数据库服务才能生效。
sighup：无需重启数据库，但要向kingbase进程发送sighup信号，即需要操作系统命令sys_ctl reload或进入ksql中， select sys_reload_conf();重新加载配置文件。
backend：无需重启数据库，只需向kingbase进程发送sighup信号。但新的配置参数只能在之后的新连接中生效，已有连接中这些参数值不会改变。
superuser：这类参数可以由超级用户使用set命令修改。参数设置后只会影响超级用户自身的session配置，不会影响其他用户。
user：普通用户使用set命令修改，这类参数修改后和superuser类参数一样，也是只影响自身session。

我们可以通过查询sys_settings表的context字段值来查看参数是否需要重启数据库生效。如下：

test=# select name,context,pending_restart from sys_settings where name like 'bgwriter%';
          name           | context | pending_restart
-------------------------+---------+-----------------
 bgwriter_delay          | sighup  | f
 bgwriter_flush_after    | sighup  | f
 bgwriter_lru_maxpages   | sighup  | f
 bgwriter_lru_multiplier | sighup  | f

可以通过查看sys_file_settings查看你设置的参数是否生效。例如如果你设置了⼀个参数需要重启数据库才能生效或者设置错误,那么在此字典中会出现报错。

1.全局参数修改：

使用alter system 命令修改参数.使用alter system命令将修改kingbase.auto.conf文件,而不是kingbase.conf文件,这样可以很好的保护kingbase.conf文件,不要手工对kingbase.auto.conf文件进行修改。该文件保存最新的配置，当数据库服务重启时，kingbase.auto.conf 里的修建项配置优先。当 kingbase.conf 和kingbase.auto.conf两个文件中都存在相同参数，kingbase.conf文件修改无效。

查看kingbase.auto.conf文件

[kingbase@localhost data]$ cat kingbase.auto.conf |grep 'work'
work_mem = '8MB'

使用sys_ctl reload命令重载配置文件，再查看参数值：

test=# show work_mem;
work_mem
----------
8MB
(1 row)

2.使用set命令,在会话层修改,修改之后将被用于未来的每个事务,但只对当前会话有效。

test=# set work_mem='20MB';
SET
test=#
test=# show work_mem;
 work_mem
----------
 20MB
(1 row)

这时候再打开一个会话看到work_mem还是4MB，因为只对当前会话有效。

3.set命令后添加 local关键字, 只在当前事务中修改,只在当前事务内有效:

test=# show work_mem;
 work_mem
----------
 20MB
(1 row)
test=#
test=# begin;
BEGIN
test=# set local work_mem='10MB';
SET
test=#
test=# show work_mem;
 work_mem
----------
 10MB
(1 row)
test=# commit;
COMMIT
test=# show work_mem;
 work_mem
----------
 20MB
(1 row)

4.使用 reset恢复参数的默认值

可以通过视图sys_settings里的字段reset_val字段中的值了解此参数恢复默认值的大小。使用reset all可以恢复所有参数值。

test=# select name , reset_val from sys_settings where name like 'work%';
   name   | reset_val
----------+-----------
 work_mem | 8192
(1 row)
test=# show work_mem;
 work_mem
----------
 20MB
(1 row)
test=# reset work_mem;
RESET
test=# show work_mem;
 work_mem
----------
 8MB
(1 row)

5.为特定的用户设置参数

5.1.为特定的数据库的所有用户设置参数.

单独为test数据库所有的连接设置work_mem为16MB:

test=#  alter database test set work_mem='16MB';
ALTER DATABASE
test=#

5.2.为数据库中的某个用户设置参数.

例如为bob用户,设置work_mem为4MB:

test=# alter role bob set work_mem='4MB';
ALTER ROLE

经过测试发现,如果你同时为数据库和用户设置了特定参数,那么以用户参数为准.例如上面,如果我用bob用户连接到test数据库,那么我的work_mem应该为4MB:

test=# \c test bob
You are now connected to database "test" as user "brent".
test=>
test=# show work_mem;
 work_mem
----------
 4MB
(1 row)

5.3.为某个用户连接到特定的数据库设置参数.

例如为用户ttname在数据库test中设置work_mem为8MB

test=> alter role ttname in database test set work_mem='8MB';
ALTER ROLE

上面说的三种设置,优先级递增,例如,如果1,2,3全部设置了那么就以第3个为准,如果设置了1,2那么就是以2为准。

KingbaseES对此的实现方法和当用户连接数据库的时候,手动执行set命令的效果完全相同

查看你当前的参数值是从何处指定,可以通过查询sys_setttings中的source字段获取,例如如果设置了database级别的参数.那么查询结果如下:source为database

test=# select name,setting,source from sys_settings where name='work_mem';
name  | setting | source
----------+---------+----------
work_mem | 16384  | database

例如设置了第三种:source为databae user

test=> \c test ttname
You are now connected to database "test" as user "ttname".
test=> select name,setting,source from sys_settings where name='work_mem';
   name   | setting |    source
----------+---------+---------------
 work_mem | 8192    | database user
(1 row)

总结：综上所述，如果通过数据字典视图查看参数生效条件。可从全局或session级更改参数等。