ALTER SYSTEM
Синтаксис
ALTER SYSTEM SET параметр_конфигурации { TO | = } { значение | 'значение' | DEFAULT }
ALTER SYSTEM RESET параметр_конфигурации
ALTER SYSTEM RESET ALLОписание
Оператор ALTER SYSTEM применяется для изменения параметров конфигурации сервера, распространяющихся на весь кластер баз данных. Пользоваться им может быть удобнее, чем вручную редактировать файл postgresql.conf. ALTER SYSTEM записывает заданное значение параметра в файл postgresql.auto.conf, который считывается сервером в дополнение к postgresql.conf. При указании в качестве значения параметра DEFAULT или применении формы RESET соответствующий элемент конфигурации удаляется из postgresql.auto.conf. Удалить все настроенные таким способом параметры позволяет предложение RESET ALL.
Значения, установленные командой ALTER SYSTEM, вступают в силу только после следующей перезагрузки сервера (SIGHUP или pg_ctl reload), либо после следующего перезапуска, если эти параметры устанавливаются только при запуске сервера.
Выполнить ALTER SYSTEM могут только суперпользователи. А так как эта команда работает непосредственно с файловой системой и не может быть отменена, её нельзя поместить в блок транзакции или функцию.
Параметры
- параметр_конфигурации
Имя устанавливаемого параметра конфигурации. Список доступных параметров приведён в Главе 18.
- значение
Новое значение параметра. Значениями могут быть строковые константы, идентификаторы, числа или списки таких элементов через запятую, в зависимости от конкретного параметра. Если в качестве значения указать DEFAULT, параметр и его значение удаляется из postgresql.auto.conf.
Замечания
С помощью этой команды нельзя задать data_directory, равно как и другие параметры, недопустимые в postgresql.conf (например, предустановленные параметры).
Другие способы настройки параметров описаны в Разделе 18.1.
Примеры
Установка уровня ведения журнала транзакций (wal_level):
ALTER SYSTEM SET wal_level = hot_standby;
Отмена изменения, восстановление значения, заданного в postgresql.conf:
ALTER SYSTEM RESET wal_level;
| Пред. | Начало | След. |
| ALTER SERVER | Уровень выше | ALTER TABLE |