ДОКУМЕНТАЦИЯ

Выберите версию, форк и язык для СУБД Digital Q.DataBase, чтобы прочитать или скачать всю документацию.

Новости

01.09.2026

СУБД Digital Q.DataBase можно развернуть из готового Docker-образа

25.08.2026

СУБД Digital Q.DataBase: 8 ядер бесплатно — до 1 сентября!

Документация

Диасофт
Авторские права © 2016–2025 ООО "Диасофт Экосистема"

Скачать всю документацию:

pdf (13 mБ) EPUB (13 mБ) CHM (14 МБ)

6.1.32. ALTER SYSTEM

Содержание

6.1.32. 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

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

value

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

Для некоторых параметров, принимающих списки, значения в кавычках приведут к выводу в двойных кавычках для сохранения пробелов и запятых; для других двойные кавычки должны использоваться внутри строк в одинарных кавычках, чтобы добиться этого эффекта.

Замечания

Эту команду нельзя использовать для установки data_directory, allow_alter_system, а также параметров, которые не разрешены в postgresql.conf (например, предустановленных опций).

См. Раздел 3.4.1 для других способов установки параметров.

ALTER SYSTEM можно отключить, установив параметр allow_alter_system в значение off, но это не механизм безопасности (как подробно объясняется в документации по этому параметру).

Примеры

Установить параметр wal_level:

ALTER SYSTEM SET wal_level = replica;

Отменить это, восстановив настройку, действовавшую в postgresql.conf:

ALTER SYSTEM RESET wal_level;

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

Оператор ALTER SYSTEM является расширением Digital Q.DataBase.

См. также

SET, SHOW

Наверх