postgresql_db - Добавление или удаление баз данных PostgreSQL на удалённом хосте.
Описание
- Добавление или удаление баз данных PostgreSQL на удалённом хосте.
Требования
Нижеперечисленные требования необходимы на хосте, на котором выполняется данный модуль.
- psycopg2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| encoding | Кодировка базы данных | |
| lc_collate | Порядок сортировки (LC_COLLATE) для использования в базе данных. Должен соответствовать порядку сортировки шаблонной базы данных, если не используется template0. | |
| lc_ctype | Классификация символов (LC_CTYPE) для использования в базе данных (например, нижний регистр, верхний регистр, ...). Должен соответствовать LC_CTYPE шаблонной базы данных, если не используется template0. | |
| login_host | Хост, на котором запущена база данных | |
| login_password | Пароль, используемый для аутентификации | |
| login_unix_socket | Путь к сокету Unix для локальных подключений | |
| login_user | По умолчанию: "postgres" | Имя пользователя, используемое для аутентификации |
| maintenance_db (добавлено в 2.5) | По умолчанию: "postgres" | Значение определяет начальную базу данных (также называемую базой технического обслуживания), к которой Ansible подключается. |
| name обязательно | Имя базы данных для добавления или удаления псевдонимы: db | |
| owner | Имя роли, которая будет установлена владельцем базы данных | |
| port | По умолчанию: 5432 | Порт базы данных для подключения. |
| ssl_mode (добавлено в 2.3) |
| Определяет, будет ли и с какой приоритетностью устанавливаться защищенное SSL TCP/IP-соединение с сервером. Дополнительную информацию о режимах см. на сайте https://www.postgresql.org/docs/current/static/libpq-ssl.html. Значение по умолчанию prefer соответствует значению по умолчанию libpq. |
| ssl_rootcert (добавлено в 2.3) | Указывает имя файла, содержащего сертификат(ы) центра сертификации (CA) для SSL. Если файл существует, сертификат сервера будет проверен на соответствие одному из этих центров сертификации. | |
| state |
| Состояние базы данных. present означает, что база данных должна быть создана при необходимости. absent означает, что база данных должна быть удалена, если она существует. dump требует определения целевого объекта, в который будет создан резервный копий базы данных. (Добавлено в 2.4) restore также требует определения целевого объекта, из которого будет восстановлена база данных. (Добавлено в 2.4) Формат резервной копии будет определяться на основе имени целевого объекта. Поддерживаемые форматы сжатия для dump и restore: .bz2, .gz и .xz. Поддерживаемые форматы для dump и restore: .sql и .tar |
| target (добавлено в 2.4) | Файл для создания резервной копии или восстановления из него. Используется при состоянии "dump" или "restore" | |
| target_opts (добавлено в 2.4) | Дополнительные аргументы для pg_dump или pg_restore. Используется при состоянии "dump" или "restore" | |
| template | Шаблон, используемый для создания базы данных |
Примечания
Примечание
- Аутентификация по умолчанию предполагает, что вы вошли в систему как учетная запись
postgresна хосте или используете sudo. - Данный модуль использует psycopg2, адаптер Python для базы данных PostgreSQL. Необходимо убедиться, что psycopg2 установлен на хосте перед использованием данного модуля. Если удалённый хост является сервером PostgreSQL (что является случаем по умолчанию), то PostgreSQL также должен быть установлен на удалённом хосте. Для систем на базе Ubuntu установите пакеты
postgresql,libpq-dev, иpython-psycopg2на удалённом хосте перед использованием данного модуля. - Параметр ssl_rootcert требует как минимум версию Postgres 8.4 и psycopg2 версии 2.4.3.
Примеры
# Create a new database with name "acme"
- postgresql_db:
name: acme
# Create a new database with name "acme" and specific encoding and locale
# settings. If a template different from "template0" is specified, encoding
# and locale settings must match those of the template.
- postgresql_db:
name: acme
encoding: UTF-8
lc_collate: de_DE.UTF-8
lc_ctype: de_DE.UTF-8
template: template0
# Dump an existing database to a file
- postgresql_db:
name: acme
state: dump
target: /tmp/acme.sql
# Dump an existing database to a file (with compression)
- postgresql_db:
name: acme
state: dump
target: /tmp/acme.sql.gz
# Dump a single schema for an existing database
- postgresql_db:
name: acme
state: dump
target: /tmp/acme.sql
target_opts: "-n public"
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут внесены изменения в интерфейс, несовместимые со старыми версиями.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Команда разработчиков Ansible
Подсказка
Если вы обнаружили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/postgresql_db_module.html
