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级更改参数等。
