postgresql_tablespace – Добавление или удаление табличных пространств PostgreSQL на удалённых хостах

Новое в версии 2.8.

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

Краткое описание

Добавляет или удаляет табличные пространства PostgreSQL на удалённых хостах.

Требования

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

psycopg2

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ca_cert строка		Указывает имя файла, содержащего сертификаты центра сертификации (CA) для SSL. Если файл существует, сертификат сервера будет проверен на подпись одним из этих центров. псевдонимы: ssl_rootcert
db строка		Имя базы данных, к которой необходимо подключиться и выполнять запросы. псевдонимы: login_db
location путь		Путь к каталогу табличного пространства в файловой системе. Убедитесь, что каталог существует и имеет необходимые права. псевдонимы: path
login_host строка		Хост, на котором работает база данных.
login_password строка		Пароль, используемый для аутентификации.
login_unix_socket строка		Путь к сокету Unix доменной области для локальных подключений.
login_user строка	По умолчанию: "postgres"	Имя пользователя, используемое для аутентификации.
owner строка		Имя роли, которая должна быть установлена владельцем табличного пространства. Если этот параметр не указан, владельцем табличного пространства является роль, которая создала табличное пространство.
port целое число	По умолчанию: 5432	Порт базы данных для подключения. псевдонимы: login_port
rename_to -		Новое имя табличного пространства. Новое имя не может начинаться с pg_, так как такие имена зарезервированы для системных табличных пространств.
session_role строка		Переключиться на роль session_role после подключения. Указанная роль session_role должна быть ролью, членом которой является текущий login_user. Проверка прав на выполнение SQL-команд выполняется так, как если бы роль session_role была той, которая первоначально вошла в систему.
set словарь		Словарь параметров табличного пространства для установки. Поддерживается с PostgreSQL 9.0. Для получения дополнительной информации см. https://www.postgresql.org/docs/current/sql-createtablespace.html. При передаче reset в качестве значения параметра, если параметр был установлен ранее, он будет удалён.
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 ←	Состояние табличного пространства. state=present подразумевает, что табличное пространство должно быть создано, если его не существует. state=absent подразумевает, что табличное пространство должно быть удалено, если оно существует. state=absent взаимоисключительно с location, owner, i(set). См. раздел Примечания для получения информации о ограничениях режима проверки.
tablespace строка / обязательный		Имя табличного пространства для добавления или удаления. псевдонимы: name

Примечания

Примечание

state=absent и state=present (второе, если табличное пространство не существует) не поддерживают режим проверки, так как соответствующие команды PostgreSQL DROP и CREATE TABLESPACE не могут быть выполнены внутри блока транзакции.
По умолчанию аутентификация предполагает, что вы либо входите в систему как пользователь, либо используете 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 TABLESPACE: Полное описание документации команды CREATE TABLESPACE.
Справочник ALTER TABLESPACE: Полное описание документации команды ALTER TABLESPACE.
Справочник DROP TABLESPACE: Полное описание документации команды DROP TABLESPACE.

Примеры

- name: Create a new tablespace called acme and set bob as an its owner
  postgresql_tablespace:
    name: acme
    owner: bob
    location: /data/foo

- name: Create a new tablespace called bar with tablespace options
  postgresql_tablespace:
    name: bar
    set:
      random_page_cost: 1
      seq_page_cost: 1

- name: Reset random_page_cost option
  postgresql_tablespace:
    name: bar
    set:
      random_page_cost: reset

- name: Rename the tablespace from bar to pcie_ssd
  postgresql_tablespace:
    name: bar
    rename_to: pcie_ssd

- name: Drop tablespace called bloat
  postgresql_tablespace:
    name: bloat
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
location строка	всегда	Путь к табличному пространству в файловой системе. Пример: /incredible/fast/ssd
newname строка	если существует	Новое имя табличного пространства Пример: new_ssd
options словарь	всегда	Параметры табличного пространства. Пример: {'random_page_cost': 1, 'seq_page_cost': 1}
owner строка	всегда	Владелец табличного пространства. Пример: Bob
queries строка	всегда	Список запросов, которые пытались выполнить. Пример: ["CREATE TABLESPACE bar LOCATION '/incredible/ssd'"]
state строка	всегда	Состояние табличного пространства в конце выполнения. Пример: present
tablespace строка	всегда	Имя табличного пространства. Пример: ssd

Статус

Данный модуль не гарантирует обратную совместимость. [превью]
Данный модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Flavien Chantelot (@Dorn-)
Antoine Levy-Lambert (@antoinell)
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_tablespace_module.html