Seth Woolley's Man Viewer

SHOW(7)                          SQL Commands                          SHOW(7)



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(7,n,1 builtins) using the SET  statement,  by  editing  the  post-
       gresql.conf  configuration  file(1,n),  through  the PGOPTIONS environmental
       variable (when using libpq or a libpq-based  application),  or  through
       command-line flags when starting the postmaster. See the section called
       ``Run-time Configuration'' in(1,8) the documentation for details.

PARAMETERS
       name   The name of a run-time parameter. Available parameters are docu-
              mented  in(1,8)  the section called ``Run-time Configuration'' in(1,8) the
              documentation and on the SET [set(7,n,1 builtins)(7)] reference page.  In  addi-
              tion, there are a few parameters that can be shown but not set:

              SERVER_VERSION
                     Shows the server's version(1,3,5) number.

              SERVER_ENCODING
                     Shows the server-side character set(7,n,1 builtins) encoding. At present,
                     this parameter can be shown  but  not  set(7,n,1 builtins),  because  the
                     encoding(3,n) is determined at database creation time.

              LC_COLLATE
                     Shows  the  database's locale(3,5,7) setting for collation (text
                     ordering). At present, this parameter can  be  shown  but
                     not  set(7,n,1 builtins),  because  the  setting  is determined at initdb
                     time.

              LC_CTYPE
                     Shows the database's locale(3,5,7) setting for character classi-
                     fication. At present, this parameter can be shown but not
                     set(7,n,1 builtins), because the setting is determined at initdb time.

              IS_SUPERUSER
                     True if(3,n) the current session authorization identifier  has
                     superuser privileges.


       ALL    Show the values of all configurations parameters.

NOTES
       The  function  current_setting produces equivalent output. See the sec-
       tion called ``Miscellaneous Functions'' in(1,8) the documentation.

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
       -------------------------------+---------------------------------------
        australian_timezones          | off
        authentication_timeout        | 60
        checkpoint_segments           | 3
           .
           .
           .
        wal_debug                     | 0
        wal_sync_method               | fdatasync
       (94 rows)


COMPATIBILITY
       The SHOW command is a PostgreSQL extension.

SEE ALSO
       SET [set(7,n,1 builtins)(7)]




SQL - Language Statements         2003-11-02                           SHOW(7)