ALTER SYSTEM#

ALTER SYSTEM
ALTER SYSTEM
Назад НаверхSQL КомандыНачало Далее

ALTER SYSTEM

ALTER SYSTEM — изменить параметр конфигурации сервера

Синтаксис

ALTER SYSTEM SET configuration_parameter { TO | = } { 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
Назад Наверх Далее
ALTER SUBSCRIPTION Начало ALTER TABLE