postgresql_ext – Добавление или удаление расширений PostgreSQL из базы данных
Описание
- Добавление или удаление расширений PostgreSQL из базы данных.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- psycopg2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ca_cert строка добавлен в 2.8 | Указывает имя файла, содержащего сертификат(ы) центра сертификации SSL (CA). Если файл существует, сертификат сервера будет проверен на подпись одним из этих центров. псевдонимы: ssl_rootcert | |
| cascade логическое добавлен в 2.8 |
| Автоматически устанавливать/удалять любые расширения, от которых зависит это расширение, которые еще не установлены/удалены (поддерживается с PostgreSQL 9.6). |
| db строка / обязательно | Имя базы данных, к которой нужно добавить или из которой нужно удалить расширение. псевдонимы: login_db | |
| login_host строка | Хост, на котором запущена база данных. | |
| login_password строка | Пароль, используемый для аутентификации. | |
| login_unix_socket строка добавлен в 2.8 | Путь к сокету Unix-домена для локальных подключений. | |
| login_user строка | По умолчанию: "postgres" | Имя пользователя, используемое для аутентификации. |
| name строка / обязательно | Имя расширения, которое нужно добавить или удалить. псевдонимы: ext | |
| port целое число | По умолчанию: 5432 | Порт базы данных для подключения. псевдонимы: login_port |
| schema строка добавлен в 2.8 | Имя схемы, к которой нужно добавить расширение. | |
| 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 строка |
| Состояние расширения базы данных. |
| version строка добавлен в 2.9 | Версия расширения для добавления или обновления. Действует только при state=наличие. Если не указано, будет создана последняя версия расширения. Невозможно понизить версию расширения. Если требуется понизить версию, удалите расширение и создайте новое с соответствующей версией. Установите version=latest, чтобы обновить расширение до последней доступной версии. |
Примечания
Примечание
- Аутентификация по умолчанию предполагает, что вы вошли в систему как или выполняете sudo от имени учетной записи
postgresна хосте. - Этот модуль использует psycopg2, адаптер Python для базы данных PostgreSQL.
- Перед использованием этого модуля необходимо убедиться, что psycopg2 установлен на хосте.
- Если удаленный хост является сервером PostgreSQL (что является случаем по умолчанию), то PostgreSQL также должен быть установлен на удаленном хосте.
- Для систем на основе Ubuntu установите пакеты
postgresql,libpq-dev, иpython-psycopg2на удаленном хосте перед использованием этого модуля. - Аутентификация по умолчанию предполагает, что вы вошли в систему как или выполняете 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 EXTENSION
- Полное руководство по команде CREATE EXTENSION.
- Ссылка ALTER EXTENSION
- Полное руководство по команде ALTER EXTENSION.
- Ссылка DROP EXTENSION
- Полное руководство по команде DROP EXTENSION.
Примеры
- name: Adds postgis extension to the database acme in the schema foo
postgresql_ext:
name: postgis
db: acme
schema: foo
- name: Removes postgis extension to the database acme
postgresql_ext:
name: postgis
db: acme
state: absent
- name: Adds earthdistance extension to the database template1 cascade
postgresql_ext:
name: earthdistance
db: template1
cascade: true
# In the example below, if earthdistance extension is installed,
# it will be removed too because it depends on cube:
- name: Removes cube extension from the database acme cascade
postgresql_ext:
name: cube
db: acme
cascade: yes
state: absent
- name: Create extension foo of version 1.2 or update it if it's already created
postgresql_ext:
db: acme
name: foo
version: 1.2
- name: Assuming extension foo is created, update it to the latest version
postgresql_ext:
db: acme
name: foo
version: latest
Возвращаемые значения
Общие возвращаемые значения описаны в документации, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| query список | всегда | Список выполненных запросов. Пример: ['УДАЛИТЬ РАСШИРЕНИЕ "acme"'] |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [предварительная версия]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Daniel Schep (@dschep)
- Thomas O’Donnell (@andytom)
- Sandro Santilli (@strk)
- Andrew Klychkov (@Andersson007)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_ext_module.html
