内容

SHOW

用于显示配置参数当前值的实用程序命令

SHOW 是一个用于显示 配置参数 当前值的实用程序命令。

SHOW 添加于 PostgreSQL 6.1。

用法

SHOW 是一种简单直观的方式来显示 配置参数 的当前值，或者通过 SHOW ALL 语法列出所有配置参数的当前值。

出于历史原因，SHOW 还可以显示以下项目的当前设置

  • IS_SUPERUSER
  • LC_COLLATE
  • LC_TYPE
  • SERVER_ENCODING
  • SERVER_VERSION

SHOW 命令的替代方案

SHOW 返回的行无法在 SQL 级别进行操作，这限制了此命令在临时命令行查询中的实用性。

函数 current_setting() 和视图 pg_settings 提供了一种更灵活的方式来获取有关当前 配置参数 设置的信息。

源代码

实现 SHOW 的代码包含在 src/backend/utils/misc/guc.c 中，具体来说是以下函数

  • ShowGUCConfigOption() 用于 SHOW name
  • ShowAllGUCConfig() 用于 SHOW ALL

更改历史记录

示例

显示普通配置参数

postgres=# SHOW port;
 port 
------
 5432
(1 row)

尝试显示不存在的配置参数

postgres=# SHOW foo;
ERROR:  unrecognized configuration parameter "foo"

显示所有配置参数（为清晰起见，输出已截断）

postgres=# SHOW ALL;
-[ RECORD 1 ]-----------------------------------------------------------------------
name        | allow_system_table_mods
setting     | off
description | Allows modifications of the structure of system tables.
-[ RECORD 2 ]-----------------------------------------------------------------------
name        | application_name
setting     | psql
description | Sets the application name to be reported in statistics and logs.
-[ RECORD 3 ]-----------------------------------------------------------------------
name        | archive_cleanup_command
setting     |
description | Sets the shell command that will be executed at every restart point.
-[ RECORD 4 ]-----------------------------------------------------------------------
...
  • PostgreSQL 文档： SHOW

类别

配置，SQL 命令，实用程序命令

另请参阅

current_setting()，SET，RESET

反馈

提交关于 "SHOW" 的任何评论、建议或更正 此处。