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
更改历史记录
- PostgreSQL 7.4
- PostgreSQL 7.2
- 添加了
SHOW ALL
语法(提交4ee76ad8)
- 添加了
- PostgreSQL 6.1
- 添加(初始提交4b531912)
示例
显示普通配置参数
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