ALTER SYSTEM SET

功能描述

ALTER SYSTEM SET命令用于设置POSTMASTER、SIGHUP、BACKEND级别的GUC参数。此命令会将参数写入配置文件，不同级别生效方式有所不同。

注意事项

• 此命令仅限初始用户和拥有sysadmin权限的用户才可使用。

• 不同级别GUC参数生效时间如下：

  • POSTMASTER级别的GUC参数需要重启后才生效。
  • BACKEND级别的GUC参数需要会话重新连接后才生效。
  • SIGHUP级别的GUC参数立即生效（需要等待线程重新加载参数，实际略微有延迟）。

• 通过配置audit_set_parameter参数，可以配置此操作是否被审计。

• 操作可被备机同步。

• 同vb_guc一致，并不关注数据库是主或备节点、是否只读。

• 不可在事务中执行，因为此操作无法被回滚。

• 部分参数只能由初始用户修改，具体如下：

  audit_copy_exec, audit_data_format, audit_database_process, audit_directory, audit_dml_state,
  audit_dml_state_select, audit_enabled, audit_file_remain_threshold, audit_file_remain_time,
  audit_function_exec, audit_grant_revoke, audit_login_logout, audit_resource_policy,
  audit_rotation_interval, audit_rotation_size, audit_set_parameter, audit_space_limit,
  audit_system_object, audit_user_locked, audit_user_violation,enable_access_server_directory,
  enable_copy_server_files,modify_initial_password
  

语法格式

ALTER SYSTEM SET configuration_parameter { TO | = } { value | 'value' | DEFAULT }

参数说明

• configuration_parameter

  GUC参数名称。

• value

  GUC参数值。当设置为DEFAULT时GUC参数被设置为该参数的默认值。

示例

示例1：设置SIGHUP级别参数audit_enabled。

alter system set audit_enabled to off;
show audit_enabled;

返回结果为：

 audit_enabled
---------------
 off
(1 row)

示例2：设置POSTMASTER级别参数 enable_thread_pool，将在重启之后生效。

alter system set enable_thread_pool to on;

返回结果为：

NOTICE:  please restart the database for the POSTMASTER level parameter to take effect.
ALTER SYSTEM SET