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 могут только суперпользователи. Кроме того,
поскольку эта команда действует непосредственно на файловую систему и не может
быть отменена, ее нельзя помещать в блок транзакции или в функцию.
Параметры
параметр_конфигурации
Имя настраиваемого параметра конфигурации. Доступные параметры описаны в главе Конфигурация сервера.
значение
Новое значение параметра. Значения могут быть указаны в виде строковых констант, идентификаторов, чисел или разделенных запятыми списков таковых, в зависимости от конкретного параметра. Чтобы удалить параметр и его значение из qhb.auto.conf, можно написать DEFAULT.
Примечания
Эту команду нельзя использовать для установки каталога данных (data_directory) или параметров, которые не допустимы в qhb.conf (например, Предустановленные параметры).
Другие способы установки параметров см. в разделе Настройка параметров.
Примеры
Установка уровня ведения журнала транзакций (wal_level):
ALTER SYSTEM SET wal_level = replica;
Отмена этого изменения, восстановление значения, заданного в qhb.conf:
ALTER SYSTEM RESET wal_level;
Совместимость
Команда ALTER SYSTEM является расширением QHB.