文档

ALTER SYSTEM

更新时间:

ALTER SYSTEM被用来在整个数据库集簇范围内更改服务器配置参数。

简介

ALTER SYSTEM被用来在整个数据库集簇范围内更改服务器配置参数。

ALTER SYSTEM设置的值将在下一次重载服务器配置后生效,那些只能在服务器启动时更改的参数则会在下一次服务器重启后生效。 重载服务器配置可以通过以下做法实现:调用 SQL 函数pg_reload_conf(), 运行pg_ctl reload或者向主服务器进程发送一个SIGHUP信号。

只有超级用户能够使用ALTER SYSTEM。还有,由于这个命令直接作用于文件系统并且不能被回滚,不允许在一个事务块或者函数中使用它。

语法

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

    ALTER SYSTEM RESET configuration_parameter
    ALTER SYSTEM RESET ALL

参数

  • configuration_parameter一个可设置配置参数的名称。

  • value该参数的新值。值可以被指定为字符串常量、标识符、数字或者以上这些构成的逗号分隔的列表,值的具体形式取决于特定的参数。写上 DEFAULT可以用来把该参数及其值从 postgresql.auto.conf中移除。

示例

设置wal_level

    ALTER SYSTEM SET wal_level = replica;

撤销以上的设置,恢复设置:

    ALTER SYSTEM RESET wal_level;