community.general.postgresql_schema – Добавление или удаление схемы PostgreSQL

Примечание

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

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

Чтобы использовать его в книге задач, укажите: community.general.postgresql_schema.

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

Обзор

Добавление или удаление схемы PostgreSQL.

Требования

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

psycopg2

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ca_cert строка		Указывает имя файла, содержащего сертификат(ы) центра сертификации (CA) SSL. Если файл существует, сертификат сервера будет проверен на подпись одним из этих центров. псевдонимы: ssl_rootcert
cascade_drop логическое	Варианты: нет ← да	Удаление схемы с CASCADE для удаления дочерних объектов.
database строка	Значение по умолчанию: "postgres"	Имя базы данных для подключения и добавления или удаления схемы. псевдонимы: db, login_db
login_host строка		Хост, на котором работает база данных.
login_password строка		Пароль, используемый для аутентификации.
login_unix_socket строка		Путь к сокету Unix доменной области для локальных подключений.
login_user строка	Значение по умолчанию: "postgres"	Имя пользователя, используемое для аутентификации.
name строка / обязательно		Имя схемы для добавления или удаления. псевдонимы: schema
owner строка		Имя роли, которая будет установлена владельцем схемы.
port целое число	Значение по умолчанию: 5432	Порт базы данных для подключения. псевдонимы: login_port
session_role строка		Переключение на 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 ←	Состояние схемы.
trust_input логическое добавлено в 0.2.0 community.general	Варианты: нет да ←	Если `no`, проверяется, являются ли значения параметров schema, owner, session_role потенциально опасными. Использование `no` целесообразно только тогда, когда возможны SQL-инъекции через параметры.

Примечания

Примечание

Аутентификация по умолчанию предполагает, что вы вошли в систему или воспользуетесь sudo для учетной записи postgres на хосте.
Чтобы избежать ошибки "Ошибка проверки подлинности участника для пользователя 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.

См. также

Схемы PostgreSQL: Общая информация о схемах PostgreSQL.
Ссылка на CREATE SCHEMA: Полная справочная информация по команде CREATE SCHEMA.
Ссылка на ALTER SCHEMA: Полная справочная информация по команде ALTER SCHEMA.
Ссылка на DROP SCHEMA: Полная справочная информация по команде DROP SCHEMA.

Примеры

- name: Create a new schema with name acme in test database
  community.general.postgresql_schema:
    db: test
    name: acme

- name: Create a new schema acme with a user bob who will own it
  community.general.postgresql_schema:
    name: acme
    owner: bob

- name: Drop schema "acme" with cascade
  community.general.postgresql_schema:
    name: acme
    state: absent
    cascade_drop: yes

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

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

Ключ	Возвращаемое значение	Описание
queries список / элементы=строка	всегда	Список выполненных запросов. Пример: ['CREATE SCHEMA "acme"']
schema строка	успех, изменение	Имя схемы. Пример: acme

Авторы

Flavien Chantelot (@Dorn-) <contact@flavien.io>
Thomas O’Donnell (@andytom)

© 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_schema_module.html