ALTER SYSTEM#
ALTER SYSTEM
ALTER SYSTEM — изменить параметр конфигурации сервера
Синтаксис
ALTER SYSTEM SETconfiguration_parameter
{ TO | = } {value
| 'value
' | DEFAULT } ALTER SYSTEM RESETconfiguration_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
, вступят в силу после следующей перезагрузки конфигурации сервера или после следующей перезагрузки сервера в случае параметров, которые можно изменить только при запуске сервера. Перезагрузку конфигурации сервера можно выполнить, вызвав SQL-функцию pg_reload_conf()
, запустив pg_ctl reload
или отправив сигнал SIGHUP процессу основного сервера.
Только суперпользователи и пользователи, которым предоставлено привилегия ALTER SYSTEM
, могут изменять параметры с помощью команды ALTER SYSTEM
. Кроме того, поскольку эта команда действует непосредственно на файловую систему и не может быть отменена, она не разрешена внутри блока транзакции или функции.
Параметры
configuration_parameter
Название настраиваемого параметра конфигурации. Доступные параметры документированы в Глава 19.
value
Новое значение параметра. Значения могут быть указаны в виде строковых констант, идентификаторов, чисел или списков, разделенных запятыми, в зависимости от конкретного параметра.
DEFAULT
может быть записано для удаления параметра и его значения изpostgresql.auto.conf
.
Примечания
Эта команда не может быть использована для установки data_directory,
а также параметров, которые не разрешены в postgresql.conf
(например, предустановленные опции).
См. Раздел 19.1 для других способов установки параметров.
Примеры
Установите значение wal_level
:
ALTER SYSTEM SET wal_level = replica;
Отмените это, восстановив любые настройки, которые были действительны в файле postgresql.conf
:
ALTER SYSTEM RESET wal_level;
Совместимость
ALTER SYSTEM
- это расширение Tantor SE.