community.postgresql.postgresql_set – Изменение параметра конфигурации сервера PostgreSQL

• Описание
• Требования
• Параметры
• Примечания
• См. также
• Примеры
• Возвращаемые значения

Описание

• Позволяет изменить параметр конфигурации сервера PostgreSQL.
• Модуль использует команду ALTER SYSTEM и применяет изменения, перезагружая конфигурацию сервера.
• ALTER SYSTEM используется для изменения параметров конфигурации всего кластера баз данных.
• Это может быть удобнее и безопаснее, чем традиционный метод ручного редактирования файла postgresql.conf.
• ALTER SYSTEM записывает заданное значение параметра в файл $PGDATA/postgresql.auto.conf, который читается дополнительно к postgresql.conf.
• Модуль позволяет сбросить параметр до значения boot_val (начальное значение кластера) с помощью reset=yes или удалить строку параметра из postgresql.auto.conf и перезагрузить конфигурацию с value=default (для параметров с контекстом postmaster требуется перезапуск).
• После изменения в выводе Ansible можно увидеть предыдущее и новое значение параметра и другую информацию, используя возвращаемые значения и модуль ansible.builtin.debug.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

• psycopg2

Параметры

Примечания

См. также

Примеры

- name: Restore wal_keep_segments parameter to initial state
  community.postgresql.postgresql_set:
    name: wal_keep_segments
    reset: yes

# Set work_mem parameter to 32MB and show what's been changed and restart is required or not
# (output example: "msg": "work_mem 4MB >> 64MB restart_req: False")
- name: Set work mem parameter
  community.postgresql.postgresql_set:
    name: work_mem
    value: 32mb
  register: set

- ansible.builtin.debug:
    msg: "{{ set.name }} {{ set.prev_val_pretty }} >> {{ set.value_pretty }} restart_req: {{ set.restart_required }}"
  when: set.changed
# Ensure that the restart of PostgreSQL server must be required for some parameters.
# In this situation you see the same parameter in prev_val_pretty and value_pretty, but 'changed=True'
# (If you passed the value that was different from the current server setting).

- name: Set log_min_duration_statement parameter to 1 second
  community.postgresql.postgresql_set:
    name: log_min_duration_statement
    value: 1s

- name: Set wal_log_hints parameter to default value (remove parameter from postgresql.auto.conf)
  community.postgresql.postgresql_set:
    name: wal_log_hints
    value: default

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Авторы

• Андрей Клычков (@Andersson007)