begriffs open source - ai-pg/blob - full-docs/txt/sql-show.txt

   1
   2 SHOW
   3
   4    SHOW — show the value of a run-time parameter
   5
   6 Synopsis
   7
   8 SHOW name
   9 SHOW ALL
  10
  11 Description
  12
  13    SHOW will display the current setting of run-time parameters. These
  14    variables can be set using the SET statement, by editing the
  15    postgresql.conf configuration file, through the PGOPTIONS environmental
  16    variable (when using libpq or a libpq-based application), or through
  17    command-line flags when starting the postgres server. See Chapter 19
  18    for details.
  19
  20 Parameters
  21
  22    name
  23           The name of a run-time parameter. Available parameters are
  24           documented in Chapter 19 and on the SET reference page. In
  25           addition, there are a few parameters that can be shown but not
  26           set:
  27
  28         SERVER_VERSION
  29                 Shows the server's version number.
  30
  31         SERVER_ENCODING
  32                 Shows the server-side character set encoding. At present,
  33                 this parameter can be shown but not set, because the
  34                 encoding is determined at database creation time.
  35
  36         IS_SUPERUSER
  37                 True if the current role has superuser privileges.
  38
  39    ALL
  40           Show the values of all configuration parameters, with
  41           descriptions.
  42
  43 Notes
  44
  45    The function current_setting produces equivalent output; see
  46    Section 9.28.1. Also, the pg_settings system view produces the same
  47    information.
  48
  49 Examples
  50
  51    Show the current setting of the parameter DateStyle:
  52 SHOW DateStyle;
  53  DateStyle
  54 -----------
  55  ISO, MDY
  56 (1 row)
  57
  58    Show the current setting of the parameter geqo:
  59 SHOW geqo;
  60  geqo
  61 ------
  62  on
  63 (1 row)
  64
  65    Show all settings:
  66 SHOW ALL;
  67             name         | setting |                description
  68 -------------------------+---------+--------------------------------------------
  69 -----
  70  allow_system_table_mods | off     | Allows modifications of the structure of ..
  71 .
  72     .
  73     .
  74     .
  75  xmloption               | content | Sets whether XML data in implicit parsing .
  76 ..
  77  zero_damaged_pages      | off     | Continues processing past damaged page head
  78 ers.
  79 (196 rows)
  80
  81 Compatibility
  82
  83    The SHOW command is a PostgreSQL extension.
  84
  85 See Also
  86
  87    SET, RESET