SHOW 语句 用于查看一个或多个session级别的变量值,其中的部分变量值可以通过 SET来配置。

Required Privileges

权限 要求。

Synopsis

图片

Note: session settings的SHOW 语句与 其他 SHOWSHOW CLUSTER SETTING, SHOW CREATE TABLE, SHOW CREATE VIEW, SHOW USERS, SHOW DATABASES, SHOW COLUMNS, SHOW GRANTS, 和 SHOW CONSTRAINTS无关。

参数

The SHOW <session variable> 接受一个参数:变量名。

变量名不区分大小写。当变量名中有空格时,需使用双引号。

支持变量

Variable name Description Initial value Can be modified with SET?
application_name 用于统计信息收集的应用名字 来自built-in SQL client会话的空字符串,或者 cockroach Yes
database 当前数据库. 连接字符串中的数据库,如果未指定,则为空 Yes
default_transaction_isolation 当前会话的事务隔离级别。 相关更多信息,请看 Transaction parameters 在连接是字符串中设置,如果没有设置,则默认为SERIALIZABLE Yes
default_transaction_read_only New in v2.0: 当前会话的默认事务访问方式。如果设置成on, 当前会话的事务只允许进行都操作;如果设置成off, 读写都可以。更多相关信息,请看 SET TRANSACTION off Yes
distsql auto
node_id New in v1.1: 当前连接节点的ID。

此变量对负载平衡连接的验证非常有用
Node-dependent No
search_path Changed in v2.0:为了解析不合理的表名与函数,一些元数据将会被搜索。更多相关信息,请看 Name Resolution. {public} Yes
server_version CockcroachDB使用的PostgreSQL 版本。 Version-dependent No
server_version_num New in v2.0: CockcroachDB使用的PostgreSQL 版本。 Version-dependent Yes
session_user 连接当前会话的用户 包含在连接字符串 No
sql_safe_updates 如果设置成 false, 一些不安全的操作可以被操作,如 DROP 一个非空的数据库和这个数据库中所有对象,不使用 WHERE 条件进行DELETE操作,不使用 WHERE 条件进行 UPDATE 操作, 和进行操作 ALTER TABLE .. DROP COLUMN. 更多相关信息,请看 Allow Potentially Unsafe SQL Statements 在内置的 built-in SQL client的交互会话中,默认为 true
其他客户端连接设置为false
Yes
timezone 当前会话默认的的时区。

Changed in v2.0: 在CockroachDB 1.x中,该参数中间有空格,为 "time zone",但是为了和PostgreSQL兼容,现在这个参数中间没有空格
UTC Yes
tracing off
transaction_isolation 当前事务的隔离级别。更多信息,请看 Transaction parameters

Changed in v2.0: 在CockroachDB 1.x中,该参数是transaction isolation level(有空格),为了与PostgreSQL兼容,改成当前的名字。
SERIALIZABLE Yes
transaction_priority 事务优先级。相关更多信息,请看Transaction parameters

Changed in v2.0: 在CockroachDB 1.x中,该参数是 transaction priority (有空格),为了与PostgreSQL兼容,改成当前的名字。
NORMAL Yes
transaction_read_only New in v2.0: 事务发访问模式。更多信息,请看Set Transaction off Yes
transaction_status 当前事务的状态。 更所信息,请看 Transactions

Changed in v2.0: 在CockroachDB 1.x中,该参数是 transaction status (有空格)。为了与PostgreSQL兼容,改成当前的名字。
NoTxn No
client_encoding (Reserved; exposed only for ORM compatibility.) UTF8 No
client_min_messages (保留,仅仅用于ORM兼容) (Reserved) No
datestyle (保留,仅仅用于ORM兼容) ISO No
extra_float_digits (保留,仅仅用于ORM兼容) (Reserved) No
intervalstyle New in v2.0: (保留,仅仅用于ORM兼容) postgres No
max_index_keys (保留,仅仅用于ORM兼容) (Reserved) No
standard_conforming_strings (保留,仅仅用于ORM兼容) (Reserved) No

支持兼容的具体案例

Syntax Equivalent to
SHOW TRANSACTION PRIORITY SHOW "transaction priority"
SHOW TRANSACTION ISOLATION LEVEL SHOW "transaction isolation level"
SHOW TIME ZONE SHOW "timezone"
SHOW TRANSACTION STATUS SHOW "transaction status"

例子

查看一个会话变量的值

> SHOW DATABASE;
+----------+
| database |
+----------+
| test     |
+----------+
(1 row)

查看所有会话变量的值

> SHOW ALL;
+-------------------------------+--------------+
|           Variable            |    Value     |
+-------------------------------+--------------+
| application_name              |              |
| client_encoding               | UTF8         |
| client_min_messages           |              |
| database                      |              |
| default_transaction_isolation | SERIALIZABLE |
| distsql                       | off          |
| extra_float_digits            |              |
| max_index_keys                |           32 |
| node_id                       |            1 |
| search_path                   | pg_catalog   |
| server_version                | 9.5.0        |
| session_user                  | root         |
| standard_conforming_strings   | on           |
| timezone                      | UTC          |
| transaction isolation level   | SERIALIZABLE |
| transaction priority          | NORMAL       |
| transaction status            | NoTxn        |
+-------------------------------+--------------+
(16 rows)

See Also