PostgreSQL 9.4 文档: ALTER SYSTEM

PostgreSQL 9.4.4 文档
上一页	上一级		下一页

大纲

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

ALTER SYSTEM RESET configuration_parameter
ALTER SYSTEM RESET ALL

描述

ALTER SYSTEM用于在整个数据库cluster中修改服务器配置参数。比传统的手动编辑postgresql.conf文件更加方便。 ALTER SYSTEM将给出的参数设置写到postgresql.auto.conf文件中，除了读取postgresql.conf文件外还要读取该文件。将一个参数设置为DEFAULT，或使用RESET变体，从postgresql.auto.conf文件中删除该配置项。使用RESET ALL删除所有这样的配置项。

使用ALTER SYSTEM设置的值将在下一次服务器配置重启之后生效（SIGHUP或pg_ctl reload），或者在下一次服务器重启之后生效（参数只能在服务器启动时改变的情况）。

只有超级用户可以使用ALTER SYSTEM。还有，因为这个命令直接作用于文件系统，并且不能回滚，所以不允许它在一个事务块或者函数内部。

参数

configuration_parameter: 可设置的配置参数名。可用的参数在第 18 章中记录。
value: 该参数的新值。值可以被指定为字符串常量、标识符、数字或这些值的逗号分隔的列表，根据特定的参数而定。DEFAULT可以用来指定从 postgresql.auto.conf中删除该参数和它的值。

注意

这个命令不能用来设置data_directory，也不能用来设置 postgresql.conf中不允许的参数（如预设选项）。

参阅第 18.1 节获取设置参数的其他方式。

例子

设置wal_level：

ALTER SYSTEM SET wal_level = hot_standby;

取消设置，恢复在postgresql.conf中的有效设置：

ALTER SYSTEM RESET wal_level;

ALTER SYSTEM

名称

大纲

描述

参数

注意

例子

兼容性

又见