PostgreSQL 8.0.0rc4 Documentation
Prev | Fast Backward |  | Fast Forward | Next

# SHOW

## Name

SHOW -- show the value of a run-time parameter

## Synopsis

    SHOW name
    SHOW ALL

## Description

`SHOW` will display the current setting of run-time parameters. These variables can be set using the `SET` statement, by editing the `postgresql.conf` configuration file, through the `PGOPTIONS` environmental variable (when using libpq or a libpq-based application), or through command-line flags when starting the `postmaster`. See Section 16.4 for details.

## Parameters

`name`

  The name of a run-time parameter. Available parameters are documented in Section 16.4 and on the SET reference page. In addition, there are a few parameters that can be shown but not set:

  `SERVER_VERSION`

    Shows the server's version number.

  `SERVER_ENCODING`

    Shows the server-side character set encoding. At present, this parameter can be shown but not set, because the encoding is determined at database creation time.

  `LC_COLLATE`

    Shows the database's locale setting for collation (text ordering). At present, this parameter can be shown but not set, because the setting is determined at `initdb` time.

  `LC_CTYPE`

    Shows the database's locale setting for character classification. At present, this parameter can be shown but not set, because the setting is determined at `initdb` time.

  `IS_SUPERUSER`

    True if the current session authorization identifier has superuser privileges.

`ALL`

  Show the values of all configuration parameters.

## Notes

The function `current_setting` produces equivalent output. See Section 9.20.

## Examples

Show the current setting of the parameter `DateStyle`:

    SHOW DateStyle;
     DateStyle
    -----------
     ISO, MDY
    (1 row)

Show the current setting of the parameter `geqo`:

    SHOW geqo;
     geqo
    ------
     on
    (1 row)

Show all settings:

    SHOW ALL;
                  name              |                     setting
    --------------------------------+----------------------------------------------
     add_missing_from               | on
     archive_command                | unset
     australian_timezones           | off
        .
        .
        .
     work_mem                       | 1024
     zero_damaged_pages             | off
    (140 rows)

## Compatibility

The `SHOW` command is a PostgreSQL extension.

## See Also

SET, RESET

Prev | Home | Next
SET TRANSACTION | Up | START TRANSACTION