ALTER SYSTEM

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

Синтаксис

ALTER SYSTEM SET параметр_конфигурации { TO | = } { значение | 'значение' | DEFAULT }

ALTER SYSTEM RESET параметр_конфигурации
ALTER SYSTEM RESET ALL

Описание

Команда ALTER SYSTEM используется для изменения параметров конфигурации сервера во всем кластере баз данных. Это может быть более удобным, чем традиционный метод ручного редактирования файла qhb.conf. ALTER SYSTEM записывает заданную настройку параметра в файл qhb.auto.conf, который считывается в дополнение к qhb.conf. При указании в качестве значения параметра DEFAULT или применении варианта RESET соответствующий элемент конфигурации удаляется из файла qhb.auto.conf. Указание RESET ALL удаляет все настроенные таким способом параметры.

Значения, установленные с помощью ALTER SYSTEM, будут действовать после следующей перезагрузки конфигурации сервера или после перезагрузки сервера (в случае, если параметры можно изменить только при запуске сервера). Дать команду на перезагрузку конфигурации сервера можно путем вызова SQL-функции pg\_reload\_conf(), выполнения qhb_ctl reload или отправки главному серверному процессу сигнала SIGHUP.

Использовать команду ALTER SYSTEM могут только суперпользователи. Кроме того, поскольку эта команда действует непосредственно на файловую систему и не может быть отменена, ее нельзя помещать в блок транзакций или в функцию.

Параметры

параметр_конфигурации

Имя настраиваемого параметра конфигурации. Доступные параметры описаны в главе Конфигурация сервера.

значение

Новое значение параметра. Значения могут быть указаны в виде строковых констант, идентификаторов, чисел или разделенных запятыми списков из них, в зависимости от конкретного параметра. Если в качестве значения указать DEFAULT, параметр и его значение удаляется из qhb.auto.conf.

Примечания

Эту команду нельзя использовать для установки [data_directory] или параметров, которые не допустимы в qhb.conf (например, Предустановленные параметры).

Другие способы задания параметров см. в разделе Настройка параметров.

Примеры

Установка уровня ведения журнала транзакций (wal_level):

ALTER SYSTEM SET wal_level = replica;

Отмена этого изменения, восстановление значения, заданного в qhb.conf:

ALTER SYSTEM RESET wal_level;

Совместимость

Команда ALTER SYSTEM является расширением QHB.

См. также

SET, SHOW