postgresql_schema – Добавление или удаление схемы PostgreSQL
Описание
- Добавление или удаление схемы PostgreSQL.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- psycopg2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ca_cert строка добавлено в 2.8 | Указывает имя файла, содержащего сертификат(ы) центра сертификации (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 строка |
| Состояние схемы. |
Примечания
Примечание
- По умолчанию предполагается, что вы входите как пользователь или используете 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
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.9/modules/postgresql_schema_module.html