选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4
历史版本PostgreSQL 9.4 已于 2020 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

ALTER SYSTEM

ALTER SYSTEM — 更改服务器配置参数

大纲

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

ALTER SYSTEM RESET configuration_parameter
ALTER SYSTEM RESET ALL

描述

ALTER SYSTEM用于更改整个数据库集簇范围内的服 务器配置参数。与传统的手工编辑 postgresql.conf文件相比,它可能更方便。 ALTER SYSTEM会把给定的参数设置写入 postgresql.auto.conf文件;除读取 postgresql.conf之外,系统还会读取该文件。把参数设置为 DEFAULT,或者使用RESET变体, 会从postgresql.auto.conf文件中移除相应的配置 项。使用RESET ALL可以移除所有这类配置项。

ALTER SYSTEM设置的值,会在下一次重新加载服务 器配置后生效;对于那些只能在服务器启动时更改的参数,则会在下一次服 务器重启后生效。重新加载服务器配置(SIGHUPpg_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语句是一种 PostgreSQL扩展。

另见

SET, SHOW

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。