# salt.states.postgres_database

## Management of PostgreSQL databases.

The postgres_database module is used to create and manage Postgres databases. Databases can be set as either absent or present

    frank:
      postgres_database.present

`salt.states.postgres_database.` `absent`(name, runas=None, user=None)

  Ensure that the named database is absent

  name
    The name of the database to remove
  runas

    System user all operations should be performed on behalf of

    Deprecated since version 0.17.0.

  user

    System user all operations should be performed on behalf of

    New in version 0.17.0.

`salt.states.postgres_database.` `present`(name, tablespace=None, encoding=None, lc_collate=None, lc_ctype=None, owner=None, template=None, runas=None, user=None)

  Ensure that the named database is present with the specified properties. For more information about all of these options see man createdb(1)

  name
    The name of the database to manage
  tablespace
    Default tablespace for the database
  encoding
    The character encoding scheme to be used in this database
  lc_collate
    The LC_COLLATE setting to be used in this database
  lc_ctype
    The LC_CTYPE setting to be used in this database
  owner
    The username of the database owner
  template
    The template database from which to build this database
  runas

    System user all operations should be performed on behalf of

    Deprecated since version 0.17.0.

  user

    System user all operations should be performed on behalf of

    New in version 0.17.0.

Current Salt release: 0.17.1

### Table Of Contents

- salt.states.postgres_database
  - Management of PostgreSQL databases.

#### Previous topic

salt.states.ports

#### Next topic

salt.states.postgres_group

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd