参数设置
openGauss提供了多种修改GUC参数的方法,用户可以方便的针对数据库、用户、会话进行设置。
-
参数名称不区分大小写。
-
参数取值有整型、浮点型、字符串、布尔型和枚举型五类。
- 布尔值可以是(on,off)、(true,false)、(yes,no)或者(1,0),且不区分大小写。
- 枚举类型的取值是在系统表pg_settings的enumvals字段取值定义的。
-
对于有单位的参数,在设置时请指定单位,否则将使用默认的单位。
- 参数的默认单位在系统表pg_settings的unit字段定义的。
- 内存单位有:kB(千字节)、MB(兆字节)和GB(吉字节)。
- 时间单位:ms(毫秒)、s(秒)、min(分钟)、h(小时)和d(天)。
具体参数说明请参见GUC参数说明。
GUC参数设置
openGauss提供了六类GUC参数,具体分类和设置方式请参考表1:
表 1 GUC参数分类
支持表2中的方式一、方式四。 |
||
支持表2中的方式一、方式二、方式四。 |
||
支持表2中的方式一、方式二、方式四。 说明: |
||
支持表2中的方式一、方式二或由数据库管理员通过方式三设置。 |
||
支持表2中的方式一、方式二或方式三设置。 |
openGauss提供了四种方式来修改GUC参数,具体操作请参考表2:
表 2 GUC参数设置方式
gs_guc reload -D datadir -c "paraname=value" |
|
使用ALTER SYSTEM SET修改数据库参数。 |
注意:
使用方式一和方式二设置参数时,若所设参数不属于当前环境,数据库会提示参数不在支持范围内的相关信息。
操作步骤
使用方式一设置数据库参数,以在数据库主节点设置archive_mode参数为例。
-
以操作系统用户omm登录数据库主节点。
-
查看archive_mode参数。
cat /gaussdb/data/dbnode/postgresql.conf | grep archive_mode
archive_mode = on
on表示日志要进行归档操作。
-
设置archive_mode参数为off,关闭日志的归档操作。
gs_guc set -D /gaussdb/data/dbnode -c "archive_mode=off"
-
重启数据库使参数生效。
gs_ctl restart -D /gaussdb/data/dbnode
-
使用如下命令连接数据库。
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=#
-
检查参数设置的正确性。
openGauss=# SHOW archive_mode; archive_mode -------------- off (1 row)
使用方式二设置参数,以在数据库主节点设置authentication_timeout参数为例。
-
以操作系统用户omm登录数据库主节点。
-
查看authentication_timeout参数。
cat /gaussdb/data/dbnode/postgresql.conf | grep authentication_timeout
authentication_timeout = 1min
-
设置authentication_timeout参数为59s。
gs_guc reload -D /gaussdb/data/dbnode -c "authentication_timeout = 59s" Total instances: 2. Failed instances: 0. Success to perform gs_guc!
-
使用如下命令连接数据库。
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=#
-
检查参数设置的正确性。
openGauss=# SHOW authentication_timeout; authentication_timeout ------------------------ 59s (1 row)
使用方式三设置参数,以设置explain_perf_mode参数为例。
-
以操作系统用户omm登录数据库主节点。
-
使用如下命令连接数据库。
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=#
-
查看explain_perf_mode参数。
openGauss=# SHOW explain_perf_mode; explain_perf_mode ------------------- normal (1 row)
-
设置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
-
-
检查参数设置的正确性。
openGauss=# SHOW explain_perf_mode; explain_perf_mode -------------- pretty (1 row)
示例
-
示例1:使用方式一修改openGauss数据库主节点的最大连接数。
-
以操作系统用户omm登录数据库主节点。
-
使用如下命令连接数据库。
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=#
-
查看最大连接数。
openGauss=# SHOW max_connections; max_connections ----------------- 200 (1 row)
-
使用如下命令退出数据库。
openGauss=# \q
-
修改openGauss数据库主节点的最大连接数。
gs_guc set -D /gaussdb/data/dbnode -c "max_connections = 800"
-
重启openGauss。
gs_ctl restart -D /gaussdb/data/dbnode
-
使用如下命令连接数据库。
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=#
-
查看最大连接数。
openGauss=# SHOW max_connections; max_connections ----------------- 800 (1 row)
-
-
示例2:使用方式二设置数据库主节点的客户端认证最长时间参数“authentication_timeout”
-
以操作系统用户omm登录数据库主节点。
-
使用如下命令连接数据库。
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=#
-
查看客户端认证的最长时间。
openGauss=# SHOW authentication_timeout; authentication_timeout ------------------------ 1min (1 row)
-
使用如下命令退出数据库。
openGauss=# \q
-
修改数据库主节点的客户端认证最长时间。
gs_guc reload -D /gaussdb/data/dbnode -c "authentication_timeout = 59s"
-
使用如下命令连接数据库。
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=#
-
查看客户端认证的最长时间。
openGauss=# SHOW authentication_timeout; authentication_timeout ------------------------ 59s (1 row)
-
-
示例3:修改openGauss数据库节点的最大连接数。
-
以操作系统用户omm登录数据库主节点。
-
使用如下命令连接数据库。
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=#
-
查看最大连接数。
openGauss=# SHOW max_connections; max_connections ----------------- 200 (1 row)
-
使用如下命令退出数据库。
openGauss=# \q
-
修改openGauss数据库节点的最大连接数。
gs_guc set -D /gaussdb/data/dbnode -c "max_connections = 500"
-
重启openGauss。
gs_ctl restart -D /gaussdb/data/dbnode
-
使用如下命令连接数据库。
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=#
-
查看最大连接数。
openGauss=# SHOW max_connections; max_connections ----------------- 500 (1 row)
-
-
示例4:设置数据库节点的客户端认证最长时间参数“authentication_timeout”
-
以操作系统用户omm登录数据库主节点。
-
使用如下命令连接数据库。
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=#
-
查看客户端认证的最长时间。
openGauss=# SHOW authentication_timeout; authentication_timeout ------------------------ 1min (1 row)
-
使用如下命令退出数据库。
openGauss=# \q
-
修改openGauss数据库节点的客户端认证最长时间。
gs_guc reload -D /gaussdb/data/dbnode -c "authentication_timeout = 30s"
-
使用如下命令连接数据库。
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=#
-
查看客户端认证的最长时间。
openGauss=# SHOW authentication_timeout; authentication_timeout ------------------------ 30s (1 row)
-