KingbaseES 服务器运行参数配置

Kingbase 服务器运行参数配置

说明：

KingbaseES 数据库中，服务器运行参数配和需改有多种方式和注意事项，根据不同的分类配置，修改配置方式不同。关于服务器参数分类请参照【Kingbase 服务器运行参数分类】介绍。

系统配置参数修改：

Kingbase中参数名大小写是不敏感的。可以通过以下方式修改设置。

1.系统参数可以直接编辑【kingbase.conf】文件，是设置配置参数的最基本的方式。

可以设置除internal配置类型之外的全部参数类型(kingbase， sighup， user， superuser， backend， superuser-backend)。

2.还可以通过系统命令方式进行配置修改。

ALTER SYSTEM 命令提供了一种改变全局默认值的从SQL可访问的方法，等效于直接编辑kingbase.conf。

test=# show work_mem ;
 work_mem 
----------
 4MB
(1 行记录)

test=#  alter system set work_mem = 10240;
ALTER SYSTEM
test=# select sys_reload_conf(); 
 sys_reload_conf 
-----------------
 t
(1 行记录)

test=# show work_mem ;
 work_mem 
----------
 10MB
(1 行记录)

ALTER DATABASE 命令允许针对一个数据库覆盖其全局设置。

test=# show work_mem ;                       
 work_mem 
----------
 1MB
(1 行记录)

test=# alter database test set work_mem = 4096 ;  
ALTER DATABASE
test=# show work_mem ;                           
 work_mem 
----------
 1MB
(1 行记录)

test=# \q
[kingbase@node128 ~]$ ksql -Usystem -dtest
ksql (V8.0)
输入 "help" 来获取帮助信息.

test=# show work_mem ;
 work_mem 
----------
 4MB
(1 行记录)

ALTER ROLE 命令允许用用户指定的值来覆盖全局设置和数据库设置。

demo=# show work_mem;
 work_mem 
----------
 10MB
(1 行记录)

demo=# alter role system in database demo set work_mem = 4096;
ALTER ROLE
demo=# show work_mem;
 work_mem 
----------
 10MB
(1 行记录)

demo=# \q
[kingbase@node128 ~]$ ksql -Usystem -ddemo
ksql (V8.0)
输入 "help" 来获取帮助信息.

demo=# show work_mem ;
 work_mem 
----------
 4MB
(1 行记录)

可以设置除internal和kingbase配置类型之外的全部参数类型(sighup， user， superuser， backend， superuser-backend)。

3.通过set命令或者set_config函数方式修改会话本地配置项。

可以设置除internal和kingbase配置类型之外的全部参数类型(sighup， user， superuser， backend， superuser-backend)。

[kingbase@node128 ~]$ ksql -Usystem -dtest
ksql (V8.0)
输入 "help" 来获取帮助信息.

test=#  show work_mem ;
work_mem 
----------
4MB
(1 行记录)

test=#  set work_mem = 10240;
SET
test=#  show work_mem ;      
work_mem 
----------
10MB
(1 行记录)

test=# select  set_config('work_mem', 20480 ,false);
set_config 
------------
20MB
(1 行记录)

test=#  show work_mem ;                             
work_mem 
----------
20MB
(1 行记录)

系统配置参数查看：

Kingbase提供sys_file_settings表，提供了服务器配置文件内容的概要。

test=# select  * from sys_file_settings where applied = true ; 
               sourcefile                | sourceline | seqno |            name            |      setting      | applied | error 
-----------------------------------------+------------+-------+----------------------------+-------------------+---------+-------
 /home/kingbase/ES/V8/data/kingbase.conf |         59 |     1 | listen_addresses           | *                 | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |         63 |     2 | port                       | 54321             | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |         64 |     3 | max_connections            | 100               | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |         91 |     4 | password_encryption        | scram-sha-256     | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        121 |     5 | shared_buffers             | 128MB             | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        140 |     6 | dynamic_shared_memory_type | posix             | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        224 |     7 | max_wal_size               | 1GB               | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        225 |     8 | min_wal_size               | 80MB              | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        420 |     9 | log_destination            | stderr            | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        426 |    10 | logging_collector          | on                | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        432 |    11 | log_directory              | sys_log           | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        540 |    12 | log_timezone               | Asia/Shanghai     | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        652 |    13 | datestyle                  | iso, ymd          | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        653 |    14 | intervalstyle              | sql_standard      | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        654 |    15 | timezone                   | Asia/Shanghai     | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        668 |    16 | lc_messages                | zh_CN.UTF-8       | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        670 |    17 | lc_monetary                | zh_CN.UTF-8       | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        671 |    18 | lc_numeric                 | zh_CN.UTF-8       | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        672 |    19 | lc_time                    | zh_CN.UTF-8       | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        675 |    20 | default_text_search_config | pg_catalog.simple | t       | 
 /home/kingbase/ES/V8/data/kingbase.conf |        766 |    22 | ora_input_emptystr_isnull  | on                | t       |

Kingbase提供sys_settings表，提供系统参数配置的全部参数(或者使用 show all命令查看全部参数)。其中包含sys_file_settings表中已经设置的系统参数值，其他配置项为系统默认配置项和默认值。
例如：

test=# select * from sys_settings where name = 'port';
-[ RECORD 1 ]---+----------------------------------------
name            | port
setting         | 54321
unit            | 
category        | 联接和认证 / 联接设置
short_desc      | 设置服务器监听的 TCP 端口号.
extra_desc      | 
context         | kingbase
vartype         | integer
source          | configuration file
min_val         | 1
max_val         | 65535
enumvals        | 
boot_val        | 54321
reset_val       | 54321
sourcefile      | /home/kingbase/ES/V8/data/kingbase.conf
sourceline      | 63
pending_restart | f

Kingbase系统中，可以使用show命令或current_setting函数查看具体参数的当前配置值：

test=# show database_mode ;
 database_mode 
---------------
 oracle
(1 行记录)

test=# select current_setting('database_mode');
 current_setting 
-----------------
 oracle
(1 行记录)

不同模式下参数差异

KingbaseES 在pg模式下，以下参数默认为off状态，且禁止将其打开。

ora_forbid_func_polymorphism 同模式下不能创建同名的函数或存储过程

ora_input_emptystr_isnull 将空字符串转换为null。

ora_numop_style 数字和字符串的操作符兼容oracle关于整数和字符串的操作符。

ora_statement_level_rollback 指定了plsql中是否启用语句级回滚

ora_style_nls_date_format 日期时间的隐式输入与输出字符串格式是否使用参数NLS_DATE_FORMAT、NLS_TIMESTAMP_FORMAT和NLS_TIMESTAMP_TZ_FORMAT的配置。