September 26, 2024: PostgreSQL 17 Released!
Supported Versions: Current (17) / 16 / 15 / 14 / 13 / 12
Development Versions: devel
Unsupported versions: 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
This documentation is for an unsupported version of PostgreSQL.
You may want to view the same page for the current version, or one of the other supported versions listed above instead.

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