postgresql_schema – Добавление или удаление схемы PostgreSQL
Новая в версии 2.3.
Описание
- Добавление или удаление схемы PostgreSQL.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- psycopg2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ca_cert строка добавлен в 2.8 | Указывает имя файла, содержащего сертификат(ы) центра сертификации SSL (CA). Если файл существует, сертификат сервера будет проверен на подпись одним из этих центров сертификации. псевдонимы: ssl_rootcert | |
| cascade_drop логическое значение добавлен в 2.8 |
| Удалить схему с 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 строка добавлен в 2.8 | Переключение на session_role после подключения. Указанная роль session_role должна быть ролью, членом которой является текущий login_user. Проверка разрешений для команд SQL выполняется так, как если бы роль session_role была той, которая первоначально вошла в систему. | |
| ssl_mode строка добавлен в 2.8 |
| Определяет, будет ли и с какой приоритетностью устанавливаться безопасное SSL TCP/IP соединение с сервером. См. https://www.postgresql.org/docs/current/static/libpq-ssl.html для получения дополнительной информации о режимах. Значение по умолчанию prefer соответствует значению по умолчанию libpq. |
| state строка |
| Состояние схемы. |
Примечания
Примечание
- Этот модуль использует psycopg2, адаптер Python для баз данных PostgreSQL.
- Необходимо убедиться, что psycopg2 установлен на хосте перед использованием этого модуля.
- Если удалённый хост является сервером PostgreSQL (что является случаем по умолчанию), то PostgreSQL также должен быть установлен на удалённом хосте.
- Для систем на базе Ubuntu, установите пакеты
postgresql,libpq-dev, иpython-psycopg2на удалённом хосте перед использованием этого модуля. - Аутентификация по умолчанию предполагает, что вы вошли как или используете sudo для учетной записи
postgresна хосте. - Этот модуль использует psycopg2, адаптер Python для баз данных PostgreSQL. Вы должны убедиться, что psycopg2 установлен на хосте перед использованием этого модуля. Если удаленный хост - это сервер PostgreSQL (что является случаем по умолчанию), то PostgreSQL также должен быть установлен на удаленном хосте. Для систем на базе Ubuntu, установите пакеты
postgresql,libpq-dev, иpython-psycopg2на удаленном хосте перед использованием этого модуля. - Для параметра ca_cert требуется как минимум версия Postgres 8.4 и версия psycopg2 2.4.3.
Примеры
- name: Create a new schema with name acme in test database
postgresql_schema:
db: test
name: acme
- name: Create a new schema acme with a user bob who will own it
postgresql_schema:
name: acme
owner: bob
- name: Drop schema "acme" with cascade
postgresql_schema:
name: acme
state: absent
cascade_drop: yes
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| queries список | всегда | Список выполненных запросов. Пример: ['CREATE SCHEMA "acme"'] |
| schema строка | успех, изменение | Имя схемы. Пример: acme |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/postgresql_schema_module.html