vertica_schema – Adds or removes Vertica database schema and roles¶
Synopsis¶
- Adds or removes Vertica database schema and, optionally, roles with schema access privileges.
- A schema will not be removed until all the objects have been dropped.
- In such a situation, if the module tries to remove the schema it will fail and only remove roles created for the schema if they have no dependencies.
Requirements¶
The below requirements are needed on the host that executes this module.
- unixODBC
- pyodbc
Parameters¶
Notes¶
Note
- The default authentication assumes that you are either logging in as or sudo’ing to the dbadminaccount on the host.
- This module uses pyodbc, a Python ODBC database adapter. You must ensure thatunixODBCandpyodbcis installed on the host and properly configured.
- Configuring unixODBCfor Vertica requiresDriver = /opt/vertica/lib64/libverticaodbc.soto be added to theVerticasection of either/etc/odbcinst.inior$HOME/.odbcinst.iniand bothErrorMessagesPath = /opt/vertica/lib64andDriverManagerEncoding = UTF-16to be added to theDriversection of either/etc/vertica.inior$HOME/.vertica.ini.
Examples¶
- name: creating a new vertica schema
  vertica_schema: name=schema_name db=db_name state=present
- name: creating a new schema with specific schema owner
  vertica_schema: name=schema_name owner=dbowner db=db_name state=present
- name: creating a new schema with roles
  vertica_schema:
    name=schema_name
    create_roles=schema_name_all
    usage_roles=schema_name_ro,schema_name_rw
    db=db_name
    state=present
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Dariusz Owczarek (@dareko)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
