PostgreSQL Reference Manual - Volume 1 - SQL Language Reference by The PostgreSQL Global Development Group Paperback (6"x9"), 716 pages ISBN 0954612027 RRP £32.00 ($49.95) Sales of this book support the PostgreSQL project! Get a printed copy>>>

PostgreSQL Reference Manual Volume 1 Buy the book here! >>> only $49.95

12.106 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 postgres. See Volume 3: Server Configuration for details.

Parameters

name

The name of a run-time parameter. Available parameters are documented in Volume 3: Server Configuration 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, with descriptions.

Notes

The function current_setting produces equivalent output. See section 7.20 System Administration Functions.

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:

       name         | setting |        description
--------------------+---------+--------------------------------
 add_missing_from   | off     | Automatically adds missing ....
 archive_command    | unset   | WAL archiving command.
    .
    .
    .
 work_mem           | 1024    | Sets the maximum memory to ....
 zero_damaged_pages | off     | Continues processing past ....
(146 rows)

Compatibility

The SHOW command is a PostgreSQL extension.

See Also

SET, RESET