openGauss5.1插件参考：重设参数

背景信息

openGauss提供了多种修改GUC参数的方法，用户可以方便的针对数据库、用户、会话进行设置。

• 参数名称不区分大小写。

• 参数取值有整型、浮点型、字符串、布尔型和枚举型五类。

  • 布尔值可以是（on，off）、（true，false）、（yes，no）或者（1，0），且不区分大小写。
  • 枚举类型的取值是在系统表pg_settings的enumvals字段取值定义的。

• 对于有单位的参数，在设置时请指定单位，否则将使用默认的单位。

  • 参数的默认单位在系统表pg_settings的unit字段定义的。
  • 内存单位有：KB（千字节）、MB（兆字节）和GB（吉字节）。
  • 时间单位：ms（毫秒）、s（秒）、min（分钟）、h（小时）和d（天）。

• 使用 SET paraname = value 方式设置GUC参数时，支持设置value为NULL，效果为设置对应的参数值为空字符串（并非NULL）。

具体参数说明请参见dolphin-GUC参数说明。

GUC参数设置

openGauss提供了六类GUC参数，具体分类和设置方式请参考表1：

表 1 GUC参数分类

openGauss提供了四种方式来修改GUC参数，具体操作请参考表2：

表 2 GUC参数设置方式

操作步骤

使用方式一设置参数，以设置explain_perf_mode参数为例。

1. 以操作系统用户omm登录数据库主节点。

2. 使用如下命令连接数据库。

   gsql -d postgres -p 8000


   postgres为需要连接的数据库名称，8000为数据库主节点的端口号。

   连接成功后，系统显示类似如下信息：

   gsql((openGauss x.x.x build f521c606) compiled at 2021-09-16 14:55:22 commit 2935 last mr 6385 release)
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.

   openGauss=#


3. 查看explain_perf_mode参数。

   openGauss=# SHOW explain_perf_mode;
explain_perf_mode
-------------------
normal
(1 row)


4. 设置explain_perf_mode参数。

   使用以下任意方式进行设置：

   • 设置数据库级别的参数

     openGauss=# ALTER DATABASE postgres SET explain_perf_mode TO pretty;


     当结果显示为如下信息，则表示设置成功。

     ALTER DATABASE


     在下次会话中生效。

   • 设置用户级别的参数

     openGauss=# ALTER USER omm SET explain_perf_mode TO pretty;


     当结果显示为如下信息，则表示设置成功。

     ALTER ROLE


     在下次会话中生效。

   • 设置会话级别的参数

     openGauss=# SET explain_perf_mode TO pretty;


     当结果显示为如下信息，则表示设置成功。

     SET


5. 检查参数设置的正确性。

   openGauss=# SHOW explain_perf_mode;
explain_perf_mode
--------------
pretty
(1 row)


示例

--创建表test1。
openGauss=# CREATE TABLE test1
(
a1 smallint not null,
a2 int not null,
a3 bigint not null,
a4 float not null,
a5 double not null,
a6 numeric not null,
a7 varchar(5) not null
);

--删除表
openGauss=# DROP TABLE test1;