community.general.postgresql_publication – Добавление, обновление или удаление публикации PostgreSQL

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.postgresql_publication.

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

Описание

Добавление, обновление или удаление публикации PostgreSQL.

Требования

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

psycopg2

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ca_cert строка		Указывает имя файла, содержащего сертификат(ы) центра сертификации (CA) для SSL. Если файл существует, сертификат сервера будет проверен на подпись одним из этих центров сертификации. Псевдонимы: ssl_rootcert
cascade булево	Варианты: нет ← да	Удаление зависимостей публикации. Действует только со значением state=absent.
db строка		Имя базы данных для подключения, в которой будет изменено состояние публикации. Псевдонимы: login_db
login_host строка		Хост, на котором работает база данных.
login_password строка		Пароль, используемый для аутентификации.
login_unix_socket строка		Путь к сокету Unix для локальных подключений.
login_user строка	Значение по умолчанию: "postgres"	Имя пользователя, используемое для аутентификации.
name строка / обязательно		Имя публикации для добавления, обновления или удаления.
owner строка		Владелец публикации. Если owner не определен, владелец будет установлен как login_user или session_role.
parameters словарь		Словарь с необязательными параметрами публикации. Доступные параметры зависят от версии PostgreSQL.
port целое число	Значение по умолчанию: 5432	Порт базы данных для подключения. Псевдонимы: login_port
session_role строка добавлен в 0.2.0 community.general		Переключение на session_role после подключения. Указанная session_role должна быть ролью, членом которой является текущий login_user. Проверка разрешений для SQL-команд выполняется так, как если бы session_role была той, которая первоначально вошла в систему.
ssl_mode строка	Варианты: allow disable prefer ← require verify-ca verify-full	Определяет, будет ли и с какой приоритетностью устанавливаться защищенное SSL TCP/IP-соединение с сервером. См. https://www.postgresql.org/docs/current/static/libpq-ssl.html для получения дополнительной информации о режимах. Значение по умолчанию `prefer` соответствует значению по умолчанию libpq.
state строка	Варианты: absent present ←	Состояние публикации.
tables список / элементы=строка		Список таблиц для добавления в публикацию. Если значение не задано, все таблицы являются целевыми. Если для конкретных таблиц уже существует публикация и tables не передается, ничего не будет изменено. Если вам нужно добавить все таблицы в публикацию с тем же именем, удалите существующую и создайте новую, не передавая tables.
trust_input булево добавлен в 0.2.0 community.general	Варианты: нет да ←	Если `no`, проверяется, являются ли значения параметров name, tables, owner, session_role, params потенциально опасными. Использование `no` имеет смысл только тогда, когда возможны SQL-инъекции через параметры.

Примечания

Примечание

Версия PostgreSQL должна быть 10 или выше.
Аутентификация по умолчанию предполагает, что вы входите в систему как или используете sudo для учетной записи postgres на хосте.
Чтобы избежать ошибки «Ошибка аутентификации Peer для пользователя postgres», используйте пользователя postgres в качестве become_user.
Этот модуль использует psycopg2, адаптер базы данных Python для PostgreSQL. Вы должны убедиться, что psycopg2 установлен на хосте перед использованием этого модуля.
Если удаленный хост является сервером PostgreSQL (что является стандартным случаем), то PostgreSQL также должен быть установлен на удаленном хосте.
Для систем на основе Ubuntu установите пакеты postgresql, libpq-dev и python-psycopg2 на удаленном хосте перед использованием этого модуля.
Параметр ca_cert требует как минимум версию Postgres 8.4 и psycopg2 версии 2.4.3.

См. также

Справочник CREATE PUBLICATION: Полное описание команды CREATE PUBLICATION.
Справочник ALTER PUBLICATION: Полное описание команды ALTER PUBLICATION.
Справочник DROP PUBLICATION: Полное описание команды DROP PUBLICATION.

Примеры

- name: Create a new publication with name "acme" targeting all tables in database "test".
  community.general.postgresql_publication:
    db: test
    name: acme

- name: Create publication "acme" publishing only prices and vehicles tables.
  community.general.postgresql_publication:
    name: acme
    tables:
    - prices
    - vehicles

- name: >
    Create publication "acme", set user alice as an owner, targeting all tables.
    Allowable DML operations are INSERT and UPDATE only
  community.general.postgresql_publication:
    name: acme
    owner: alice
    parameters:
      publish: 'insert,update'

- name: >
    Assuming publication "acme" exists and there are targeted
    tables "prices" and "vehicles", add table "stores" to the publication.
  community.general.postgresql_publication:
    name: acme
    tables:
    - prices
    - vehicles
    - stores

- name: Remove publication "acme" if exists in database "test".
  community.general.postgresql_publication:
    db: test
    name: acme
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
alltables булево	если публикация существует	Флаг указывает, что все таблицы опубликованы.
exists булево	всегда	Флаг указывает, существует ли публикация в конце выполнения. Пример: True
owner строка	если публикация существует	Владелец публикации в конце выполнения. Пример: alice
parameters словарь	если публикация существует	Параметры публикации в конце выполнения. Пример: {'publish': {'delete': False, 'insert': False, 'update': True}}
queries строка	всегда	Список выполненных запросов. Пример: ['DROP PUBLICATION "acme" CASCADE']
tables список / элементы=строка	если публикация существует	Список таблиц в публикации в конце выполнения. Если все таблицы опубликованы, возвращается пустой список. Пример: ['"public"."prices"', '"public"."vehicles"']

Авторы

Loic Blot (@nerzhul) <loic.blot@unix-experience.fr>
Andrew Klychkov (@Andersson007) <aaklychkov@mail.ru>

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/postgresql_publication_module.html