Модуль community.general.vertica_user — добавляет и удаляет пользователей базы данных Vertica и назначает роли

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: community.general.vertica_user.

Краткое описание
Требования
Параметры
Атрибуты
Примечания
Примеры

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

Добавляет или удаляет пользователя базы данных Vertica и при необходимости назначает роли.
Пользователь не будет удалён, пока не будут удалены все зависимые объекты.
В такой ситуации, если модуль пытается удалить пользователя, операция завершается ошибкой, и удаляются только роли, назначенные пользователю.

Требования

На узле, где выполняется этот модуль, должны быть установлены следующие компоненты.

unixODBC
pyodbc

Параметры

Параметр	Описание
cluster string	Имя кластера Vertica. По умолчанию: `"localhost"`
db string	Имя базы данных Vertica.
expired boolean	Задаёт срок действия пароля пользователя. Варианты: `false` `true`
ldap boolean	Установите значение `true`, если пользователи проходят аутентификацию с помощью LDAP. Пользователь создаётся с истёкшим сроком действия пароля, а значение устанавливается в $ldap$ . Варианты: `false` `true`
login_password string	Пароль для аутентификации.
login_user string	Имя пользователя для аутентификации. По умолчанию: `"dbadmin"`
password string	Пароль пользователя, зашифрованный алгоритмом MD5. Пароль необходимо сгенерировать в формате `"md5" + md5[password + username]`; в результате получится строка из 35 символов. Проще всего сделать это, выполнив запрос к базе данных Vertica: select `'md5'\|\| md5('<user_password><user_name>')`.
port string	Порт кластера Vertica для подключения. По умолчанию: `"5433"`
profile string	Задаёт профиль пользователя.
resource_pool string	Задаёт пул ресурсов пользователя.
roles псевдонимы: role string	Список ролей, разделённых запятыми, которые нужно назначить пользователю.
state string	Создать (`present`), удалить (`absent`) или заблокировать (`locked`) пользователя. Варианты: `"present"` ← (по умолчанию) `"absent"` `"locked"`
user псевдонимы: name string / обязательный	Имя пользователя, которого нужно добавить или удалить.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль можно запустить в режиме `check_mode` и получить прогноз изменения статуса, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме сравнения отображает сведения об изменениях (или возможных изменениях в `check_mode`).

Примечания

Примечание

По умолчанию предполагается, что вы входите в систему под учётной записью dbadmin на узле или переключаетесь на неё с помощью sudo.
Этот модуль использует pyodbc — адаптер базы данных ODBC для Python. Необходимо убедиться, что на узле установлены и правильно настроены unixODBC и pyodbc.
Для настройки unixODBC для Vertica необходимо добавить Driver = /opt/vertica/lib64/libverticaodbc.so в раздел Vertica файла /etc/odbcinst.ini или $HOME/.odbcinst.ini, а также добавить ErrorMessagesPath = /opt/vertica/lib64 и DriverManagerEncoding = UTF-16 в раздел Driver файла /etc/vertica.ini или $HOME/.vertica.ini.

Примеры

- name: Creating a new vertica user with password
  community.general.vertica_user: name=user_name password=md5<encrypted_password> db=db_name state=present

- name: Creating a new vertica user authenticated via ldap with roles assigned
  community.general.vertica_user: name=user_name ldap=true db=db_name roles=schema_name_ro state=present

Авторы

Dariusz Owczarek (@dareko)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/vertica_user_module.html