更新时间:2025-05-29 GMT+08:00

会话信息函数

SYS_CONTEXT()

描述:返回当前时刻与上下文命名空间'namespace'关联的参数'parameter'的值,该函数功能在第一个入参为'userenv'时与USERENV()功能一致。

当前支持的第二个入参参数:

'current_edition_name'、'current_schema'、'current_sql'、'current_user'、'current_userid'、'database_role'、'ip_address'、'is_apply_server'、'isdba'、'nls_currency'、'nls_date_format'、'nls_date_language'、'server_host'、'service_name'、'session_user'、'session_userid'、'db_name'、'db_unique_name'、'instance'、'instance_name'、'current_edition_id'、'current_schemaid'、'lang'、'language'、'sid'

返回值类型:text

示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
SELECT SYS_CONTEXT('userenv','NLS_CURRENCY');
 sys_context 
-------------
 $
(1 row)

SELECT SYS_CONTEXT('userenv','NLS_DATE_FORMAT');
  sys_context  
---------------
 ISO, MDY
(1 row)

SELECT SYS_CONTEXT('userenv','NLS_DATE_LANGUAGE');
 sys_context 
-------------
 en_US.UTF-8
(1 row)

USERENV()

描述:返回当前时刻与上下文命名空间'namespace'关联的参数'parameter'的值,该函数功能与SYS_CONTEXT()在第一个入参为'userenv'时功能一致。

当前支持的入参:

'current_edition_name'、'current_schema'、'current_sql'、'current_user'、'current_userid'、'database_role'、'ip_address'、'is_apply_server'、'isdba'、'nls_currency'、'nls_date_format'、'nls_date_language'、'server_host'、'service_name'、'session_user'、'session_userid'、'db_name'、'db_unique_name'、'instance'、'instance_name'、'current_edition_id'、'current_schemaid'、'lang'、'language'、'sid'

当前不支持的入参:

'action'、'is_application_root'、'is_application_pdb'、'audited_cursorid'、'authenticated_identity'、'authentication_data'、'authentication_method'、'cdb_domain'、'cdb_name'、'client_identifier'、'con_id'、'con_name'、'current_sql_length'、'db_domain'、'db_supplemental_log_level'、'dblink_info'、'drain_status'、'entryid'、'enterprise_identity'、'fg_job_id'、'global_uid'、'identification_type'、'is_dg_rolling_upgrade'、'ldap_server_type'、'module'、'network_protocol'、'nls_calendar'、'nls_sort'、'nls_territory'、'oracle_home'、'os_user'、'platform_slash'、'policy_invoker'、'proxy_enterprise_identity'、'proxy_user'、'proxy_userid'、'scheduler_job'、'session_edition_id'、'session_edition_name'、'sessionid'、'statementid'、'terminal'、'unified_audit_sessionid'、'session_default_collation'、'client_info'、'bg_job_id'、'client_program_name'、'current_bind'、'global_context_memory'、'host'、'current_sqln'

返回值类型:text

示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
SELECT USERENV('sid');
 userenv 
---------
 955
(1 row)

SELECT USERENV('instance');
 userenv 
---------
 14524
(1 row)

SELECT USERENV('action');
 userenv 
---------

(1 row)

SELECT USERENV('actijj');
ERROR:  unrecognized configuration parameter "actijj"
CONTEXT:  PL/pgSQL function userenv(text) line 114 at RETURN
referenced column: userenv

当入参为当前不支持的入参时,则返回NULL;当入参为非法入参时报错。

current_catalog

描述:当前数据库的名称(在标准SQL中称"catalog")。

返回值类型:name

示例:

1
2
3
4
5
testdb=# SELECT current_catalog;
 current_database
------------------
 testdb
(1 row)

current_database()

描述:当前数据库的名称。

返回值类型:name

示例:

1
2
3
4
5
testdb=# SELECT current_database();
 current_database
------------------
 testdb
(1 row)

current_query()

描述:由客户端提交的当前执行语句(可能包含多个声明)。

返回值类型:text

示例:

1
2
3
4
5
gaussdb=# SELECT current_query();
      current_query
-------------------------
 SELECT current_query();
(1 row)

current_schema[()]

描述:当前模式的名称。

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT current_schema();
 current_schema
----------------
 public
(1 row)

备注:current_schema返回在搜索路径中第一个顺位有效的模式名。(如果搜索路径为空则返回NULL,没有有效的模式名也返回NULL)。如果创建表或者其他命名对象时没有声明目标模式,则将使用这些对象的模式。

current_schemas(Boolean)

描述:搜索路径中的模式名称。

返回值类型:name[]

示例:

1
2
3
4
5
gaussdb=# SELECT current_schemas(true);
   current_schemas
---------------------
 {pg_catalog,public}
(1 row)

备注:

current_schemas(Boolean)返回搜索路径中所有模式名称的数组。布尔选项决定像pg_catalog这样隐含包含的系统模式是否包含在返回的搜索路径中。

搜索路径可以通过运行时设置更改。命令是:

1
SET search_path TO schema [, schema, ...]

database()

描述:返回当前的schema的名称。

参数:无

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT database();
 database 
----------
 public
(1 row)

此函数仅当sql_compatibility = 'B',设置参数 b_format_version = '5.7'和参数b_format_dev_version = 's1'时生效。

current_user

描述:当前执行环境下的用户名。

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT current_user;
 current_user
--------------
 omm
(1 row)

备注:current_user是用于权限检查的用户标识。通常,他表示会话用户,但是可以通过SET ROLE改变他。在函数执行的过程中随着属性SECURITY DEFINER的改变,其值也会改变。

definer_current_user

描述:当前执行环境下的用户名。

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT definer_current_user();
 definer_current_user
----------------------
 omm
(1 row)

pg_current_sessionid()

描述:当前执行环境下的会话ID。

返回值类型:text

示例:

1
2
3
4
5
gaussdb=# SELECT pg_current_sessionid();
    pg_current_sessionid
----------------------------
 1579228402.140190434944768
(1 row)

备注:pg_current_sessionid()是用于获取当前执行环境下的会话ID。其组成结构为:时间戳.会话ID,当线程池模式开启(enable_thread_pool=on)时,会话ID为SessionID;而线程池模式关闭时,会话ID为ThreadID。

pg_current_sessid

描述:当前执行环境下的会话ID。

返回值类型:text

示例:

gaussdb=# select pg_current_sessid();
pg_current_sessid
-------------------
140308875015936
(1 row)

备注:在线程池模式下获得当前会话的会话ID,非线程池模式下获得当前会话对应的后台线程ID。

pg_current_userid

描述:当前用户ID。

返回值类型:text

gaussdb=# SELECT pg_current_userid();
pg_current_userid
-------------------
10
(1 row)

working_version_num()

描述:版本序号信息。返回一个系统兼容性有关的版本序号。

返回值类型:int

示例:

1
2
3
4
5
gaussdb=# SELECT working_version_num();
 working_version_num
---------------------
               92231
(1 row)

tablespace_oid_name(oid)

描述: 根据表空间oid,查找表空间名称。

返回值类型:text

示例:

1
2
3
4
5
gaussdb=# SELECT tablespace_oid_name(1663);
 tablespace_oid_name
---------------------
 pg_default
(1 row)

inet_client_addr()

描述:连接的远端地址。inet_client_addr返回当前客户端的IP地址。

此函数只有在远程连接模式下有效。

返回值类型:inet

示例:

1
2
3
4
5
gaussdb=# SELECT inet_client_addr();
 inet_client_addr
------------------
 10.10.0.50
(1 row)

inet_client_port()

描述:连接的远端端口。inet_client_port返回当前客户端的端口号。

此函数只有在远程连接模式下有效。

返回值类型:int

示例:

1
2
3
4
5
gaussdb=# SELECT inet_client_port();
 inet_client_port
------------------
            33143
(1 row)

inet_server_addr()

描述:连接的本地地址。inet_server_addr返回服务器接收当前连接用的IP地址。

此函数只有在远程连接模式下有效。

返回值类型:inet

示例:

1
2
3
4
5
gaussdb=# SELECT inet_server_addr();
 inet_server_addr
------------------
 10.10.0.13
(1 row)

inet_server_port()

描述:连接的本地端口。inet_server_port返回接收当前连接的端口号。如果是通过Unix-domain socket连接的,则所有这些函数都返回NULL。

此函数只有在远程连接模式下有效。

返回值类型:int

示例:

1
2
3
4
5
gaussdb=# SELECT inet_server_port();
 inet_server_port
------------------
             8000
(1 row)

pg_backend_pid()

描述:当前会话连接的服务线程的线程ID。

返回值类型:int

示例:

1
2
3
4
5
gaussdb=# SELECT pg_backend_pid();
 pg_backend_pid
-----------------
 140229352617744
(1 row)

pg_conf_load_time()

描述:配置加载时间。pg_conf_load_time返回最后加载服务器配置文件的时间戳。

返回值类型:timestamp with time zone

示例:

1
2
3
4
5
gaussdb=# SELECT pg_conf_load_time();
      pg_conf_load_time       
------------------------------
 2017-09-01 16:05:23.89868+08
(1 row)

pg_my_temp_schema()

描述:会话的临时模式的OID,不存在则为0。

返回值类型:oid

示例:

1
2
3
4
5
gaussdb=# SELECT pg_my_temp_schema();
 pg_my_temp_schema 
-------------------
                 0
(1 row)

备注:pg_my_temp_schema返回当前会话中临时模式的OID,如果不存在(没有创建临时表)的话则返回0。如果给定的OID是其它会话中临时模式的OID,pg_is_other_temp_schema则返回true。

pg_is_other_temp_schema(oid)

描述:是否为另一个会话的临时模式。

返回值类型:Boolean

示例:

1
2
3
4
5
gaussdb=# SELECT pg_is_other_temp_schema(25356);
 pg_is_other_temp_schema
-------------------------
 f
(1 row)

pg_listening_channels()

描述:会话正在侦听的信道名称。

返回值类型:setof text

示例:

1
2
3
4
gaussdb=# SELECT pg_listening_channels();
 pg_listening_channels
-----------------------
(0 rows)

备注:pg_listening_channels返回当前会话正在侦听的一组信道名称。

pg_postmaster_start_time()

描述:服务器启动时间。pg_postmaster_start_time返回服务器启动时的timestamp with time zone。

返回值类型:timestamp with time zone

示例:

1
2
3
4
5
gaussdb=# SELECT pg_postmaster_start_time();
   pg_postmaster_start_time   
------------------------------
 2017-08-30 16:02:54.99854+08
(1 row)

pg_get_ruledef(rule_oid)

描述:获取规则的CREATE RULE命令。

返回值类型:text

示例:

gaussdb=# SELECT * FROM pg_get_ruledef(24828);
                                pg_get_ruledef
-------------------------------------------------------------------
 CREATE RULE t1_ins AS ON INSERT TO t1 DO INSTEAD INSERT INTO t2 (id) VALUES (new.id);
(1 row)

sessionid2pid()

描述: 从sessionid中得到pid信息(例如,gs_session_stat中sessid列)。

返回值类型: int8

示例:

1
2
3
4
5
6
gaussdb=# SELECT sessionid2pid(sessid::cstring) FROM gs_session_stat LIMIT 2;
  sessionid2pid
-----------------
 139973107902208
 139973107902208
(2 rows)

session_context( 'namespace' , 'parameter')

描述:获取并返回指定namespace下参数parameter的值。

返回值类型:VARCHAR

示例:

1
2
3
4
5
gaussdb=# SELECT session_context('USERENV', 'CURRENT_SCHEMA');
session_context 
------------------
  public
(1 row)

备注:当前支持的parameter:current_user、current_schema、client_info、ip_address、sessionid、sid。

pg_trigger_depth()

描述:触发器的嵌套层次。

返回值类型:int

示例:

1
2
3
4
5
gaussdb=# SELECT pg_trigger_depth();
 pg_trigger_depth 
------------------
                0
(1 row)

session_user

描述:会话用户名。

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT session_user;
 session_user
--------------
 omm
(1 row)

备注:session_user通常是连接当前数据库的初始用户,不过系统管理员可以用SET SESSION AUTHORIZATION修改这个设置。

user

描述:等价于current_user。

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT user;
 current_user
--------------
 omm
(1 row)

getpgusername()

描述:获取数据库用户名。

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT getpgusername();
 getpgusername 
---------------
 GaussDB_userna
(1 row)

getdatabaseencoding()

描述:获取数据库编码方式。

返回值类型:name

示例:

1
2
3
4
5
gaussdb=# SELECT getdatabaseencoding();
 getdatabaseencoding 
---------------------
 SQL_ASCII
(1 row)

version()

描述:版本信息。version返回一个描述服务器版本信息的字符串。

返回值类型:text

示例:

gaussdb=# SELECT version();
version
-------------------------------------------------------------------------------------------------------------------------------------------------------------
gaussdb (GaussDB Kernel XXX.X.XXX build fab4f5ea) compiled at 2021-10-24 11:58:22 commit 3086 last mr 6592 release
(1 row)

opengauss_version()

描述:openGauss版本信息。

返回值类型:text

使用示例如下,查询结果中的x.x.x请以实际输出为准:

1
2
3
4
5
gaussdb=# SELECT opengauss_version();
 opengauss_version
-------------------
 x.x.x
(1 row)

gs_deployment()

描述:当前系统的部署形态信息。

返回值类型:text

示例:

1
2
3
4
5
gaussdb=# SELECT gs_deployment();
    gs_deployment
---------------------
 BusinessCentralized
(1 row)

get_hostname()

描述:返回当前节点的hostname。

返回值类型:text

示例:

1
2
3
4
5
gaussdb=# SELECT get_hostname();
 get_hostname
--------------
 linux-user
(1 row)

get_nodename()

描述:返回当前节点的名字。

返回值类型:text

示例:

1
2
3
4
5
gaussdb=# SELECT get_nodename();
 get_nodename
--------------
 datanode1
(1 row)

get_nodeinfo(text)

描述:根据检索的属性返回对应的节点信息的值,可检索属性目前包括:node_name、node_type。

返回值类型:text

示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
gaussdb=# SELECT get_nodeinfo('node_type');
 get_nodeinfo 
--------------
 CEN_DN
(1 row)
gaussdb=# SELECT get_nodeinfo('node_name');
 get_nodeinfo 
--------------
 datanode1
(1 row)

get_schema_oid(cstring)

描述:返回查询schema的oid。

返回值类型:oid

示例:

1
2
3
4
5
gaussdb=# SELECT get_schema_oid('public');
 get_schema_oid
----------------
           2200
(1 row)

get_client_info()

描述:返回客户端信息。多租场景下,non-PDB调用该函数时返回全部信息,PDB调用该函数时仅返回该PDB相关信息。

返回值类型:record

pv_session_memory_detail()

描述:返回会话的内存使用情况,以MemoryContext节点来统计。多租场景下,non-PDB调用该函数时返回全局统计信息,PDB调用该函数时仅返回该PDB的统计信息。

返回值类型:record

表1 返回值说明

名称

类型

描述

sessid

text

  • 关闭线程池(enable_thread_pool = off)时该字段表示线程启动时间+session标识(字符串信息为timestamp.sessionid)。
  • 开启线程池(enable_thread_pool = on)时,内存上下文是线程级别的,则对应的该字段表示线程启动时间+线程标识(字符串信息为timestamp.threadid),内存上下文是session级别的,则对应的该字段表示线程启动时间+session标识(字符串信息为timestamp.sessionid)。

threadid

bigint

会话绑定的线程标识。

contextname

text

内存上下文名称。

level

smallint

当前上下文在整体内存上下文中的层级。

parent

text

父内存上下文名称。

totalsize

bigint

当前内存上下文的内存总数,单位Byte。

freesize

bigint

当前内存上下文中已释放的内存总数,单位Byte。

usedsize

bigint

当前内存上下文中已使用的内存总数,单位Byte;“TempSmallContextGroup”内存上下文中该字段含义为统计计数。