ALTER SYSTEM — cambiar un parámetro de configuración del servidor
ALTER SYSTEM SETconfiguration_parameter{ TO | = } {value[, ...] | DEFAULT } ALTER SYSTEM RESETconfiguration_parameterALTER SYSTEM RESET ALL
ALTER SYSTEM se utiliza para cambiar los parámetros de configuración
del servidor en todo el clúster de bases de datos. Puede ser más conveniente
que el método tradicional de editar manualmente el archivo postgresql.conf.
ALTER SYSTEM escribe la configuración del parámetro dado en el
archivo postgresql.auto.conf, que se lee además de
postgresql.conf. Establecer un parámetro en DEFAULT,
o usar la variante RESET, elimina esa entrada de configuración del
archivo postgresql.auto.conf. Usa RESET
ALL para eliminar todas estas entradas de configuración.
Los valores establecidos con ALTER SYSTEM serán efectivos después
de la siguiente recarga de la configuración del servidor, o después del siguiente reinicio del servidor
en el caso de parámetros que solo se pueden cambiar al iniciar el servidor.
Se puede ordenar una recarga de la configuración del servidor llamando a la función SQL
pg_reload_conf(), ejecutando pg_ctl reload o
enviando una señal SIGHUP al proceso principal del servidor.
Solo los superusuarios y los usuarios a los que se les haya otorgado el privilegio ALTER SYSTEM
sobre un parámetro pueden cambiarlo usando ALTER SYSTEM. Además, dado que
este comando actúa directamente sobre el sistema de archivos y no se puede revertir,
no se permite dentro de un bloque de transacción o función.
configuration_parameterEl nombre de un parámetro de configuración configurable. Los parámetros disponibles están documentados en Chapter 19.
value
El nuevo valor del parámetro. Los valores se pueden especificar como constantes de cadena,
identificadores, números o listas separadas por comas de estos, según sea apropiado
para el parámetro en particular. Los valores que no sean números ni identificadores
válidos deben ir entre comillas. Se puede escribir DEFAULT
para especificar la eliminación del parámetro y su valor de postgresql.auto.conf.
Para algunos parámetros que aceptan listas, los valores entre comillas producirán una salida con comillas dobles para preservar los espacios en blanco y las comas; para otros, se deben usar comillas dobles dentro de cadenas con comillas simples para obtener este efecto.
Este comando no se puede usar para establecer data_directory,
allow_alter_system,
ni los parámetros que no están permitidos en postgresql.conf
(por ejemplo, opciones preestablecidas).
Consulta Section 19.1 para ver otras formas de establecer los parámetros.
ALTER SYSTEM se puede deshabilitar estableciendo
allow_alter_system en off, pero este
no es un mecanismo de seguridad (como se explica en detalle en la documentación de
este parámetro).
Establecer el wal_level:
ALTER SYSTEM SET wal_level = replica;
Deshacer eso, restaurando cualquier configuración que fuera efectiva
en postgresql.conf:
ALTER SYSTEM RESET wal_level;
La sentencia ALTER SYSTEM es una
extensión de PostgreSQL.