ALTER SYSTEM#

ALTER SYSTEM

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, вступят в силу после следующей перезагрузки конфигурации сервера или после следующей перезагрузки сервера в случае параметров, которые можно изменить только при запуске сервера. Перезагрузку конфигурации сервера можно выполнить, вызвав 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.

См. также

SET, SHOW