# 统计信息函数 统计信息函数根据访问对象分为两种类型：针对某个数据库进行访问的函数，以数据库中每个表或索引的OID作为参数，标识需要报告的数据库；针对某个服务器进行访问的函数，以一个服务器进程号为参数，其范围从1到当前活跃服务器的数目。 - pg_stat_get_db_conflict_tablespace(oid) 描述：由于恢复与数据库中删除的表空间发生冲突而取消的查询数。 返回值类型：bigint - pg_control_group_config() 描述：在当前节点上打印cgroup配置。该函数需要SYSADMIN权限的用户才能够执行。 返回值类型：record - pg_stat_get_db_stat_reset_time(oid) 描述：上次重置数据库统计信息的时间。首次连接到每个数据库期间初始化为系统时间。当您在数据库上调用pg_stat_reset以及针对其中的任何表或索引执行pg_stat_reset_single_table_counters时，重置时间都会更新。 返回值类型：timestamptz - pg_stat_get_function_total_time(oid) 描述：该函数花费的总挂钟时间，以微秒为单位。包括花费在此函数调用其它函数上的时间。 返回值类型：bigint - pg_stat_get_xact_tuples_returned(oid) 描述：当前事务中参数为表时通过顺序扫描读取的行数，或参数为索引时返回的索引条目数。 返回值类型：bigint - pg_lock_status() 描述：查询打开事务所持有的锁信息，所有用户均可执行该函数。 返回值类型：返回字段可参考[PG_LOCKS](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1132.html#ZH-CN_TOPIC_0000002235460349)视图返回字段，该视图是通过查询本函数得到的结果。 - gs_lwlock_status() 描述：查询数据库系统内所有轻量级锁信息，包括等锁和持锁信息，所有用户均可执行该函数。 返回值类型：setofrecord - pg_stat_get_xact_numscans(oid) 描述：当前事务中参数为表时执行的顺序扫描次数，或参数为索引时执行的索引扫描次数。 返回值类型：bigint - pg_stat_get_xact_blocks_fetched(oid) 描述：当前事务中对表或索引的磁盘块获取请求数。 返回值类型：bigint - pg_stat_get_xact_blocks_hit(oid) 描述：当前事务中对缓存中找到的表或索引的磁盘块获取请求数。 返回值类型：bigint - pg_stat_get_xact_function_calls(oid) 描述：在当前事务中调用该函数的次数。 返回值类型：bigint - pg_stat_get_xact_function_self_time(oid) 描述：在当前事务中仅花费在此函数上的时间，不包括花费在此函数内部调用其它函数上的时间。 返回值类型：bigint - pg_stat_get_xact_function_total_time(oid) 描述：当前事务中该函数所花费的总挂钟时间（以微秒为单位），包括花费在此函数内部调用其它函数上的时间。 返回值类型：bigint - pg_stat_get_wal_senders() 描述：在主机端查询walsender信息。 返回值类型：setofrecord 返回字段说明如下： 表1返回字段说明 | 字段名称 | 字段类型 | 字段说明 | |:---|:---|:---| | pid | bigint | walsender的线程号。 | | sender_pid | integer | walsender的pid相对的轻量级线程号。 | | local_role | text | 主节点类型。 | | peer_role | text | 备节点类型。 | | peer_state | text | 备节点状态。 | | state | text | walsender状态。 | | catchup_start | timestamp with time zone | catchup启动时间。 | | catchup_end | timestamp with time zone | catchup结束时间。 | | sender_sent_location | text | 主节点发送位置。 | | sender_write_location | text | 主节点落盘位置。 | | sender_flush_location | text | 主节点flush磁盘位置。 | | sender_replay_location | text | 主节点redo位置。 | | receiver_received_location | text | 备节点接收位置。 | | receiver_write_location | text | 备节点落盘位置。 | | receiver_flush_location | text | 备节点flush磁盘位置。 | | receiver_replay_location | text | 备节点redo磁盘位置。 | | sync_percent | text | 同步百分比。 | | sync_state | text | 同步状态。 | | sync_group | text | 同步复制的所属分组。 | | sync_priority | text | 同步复制的优先级。 | | sync_most_available | text | 最大可用模式设置。 | | channel | text | walsender信道信息。 | - get_paxos_replication_info() 描述：查询Paxos模式下主机或备机的复制状态。 返回值类型：setofrecord 返回字段说明如下： 表2返回字段说明 | 字段名称 | 字段类型 | 字段说明 | |:---|:---|:---| | paxos_write_location | text | 已经写入DCF的XLog位置。 | | paxos_commit_location | text | 已经在DCF中达成一致的XLog位置。 | | local_write_location | text | 节点的落盘位置。 | | local_flush_location | text | 节点的flush磁盘位置。 | | local_replay_location | text | 节点的redo磁盘位置。 | | dcf_replication_info | text | 节点的DCF模块信息。 | - pg_stat_get_stream_replications() 描述：查询主备复制状态。 返回值类型：setofrecord 返回值说明如下。 表3返回值说明 | 返回参数 | 返回参数类型 | 返回参数说明 | |:---|:---|:---| | local_role | text | 本地角色。 | | static_connections | integer | 连接统计。 | | db_state | text | 数据库状态。 | | detail_information | text | 详细信息。 | - pg_stat_get_db_numbackends(oid) 描述：处理该数据库活跃的服务器进程数目。 返回值类型：integer - pg_stat_get_db_xact_commit(oid) 描述：数据库中已提交事务的数量。 返回值类型：bigint - pg_stat_get_db_xact_rollback(oid) 描述：数据库中回滚事务的数量。 返回值类型：bigint - pg_stat_get_db_blocks_fetched(oid) 描述：数据库中磁盘块抓取请求的总数。 返回值类型：bigint - pg_stat_get_db_blocks_hit(oid) 描述：数据库在缓冲区中找到的磁盘块抓取请求的总数。 返回值类型：bigint - pg_stat_get_db_tuples_returned(oid) 描述：为数据库返回的Tuple数。 返回值类型：bigint - pg_stat_get_db_tuples_fetched(oid) 描述：为数据库中获取的Tuple数。 返回值类型：bigint - pg_stat_get_db_tuples_inserted(oid) 描述：在数据库中插入Tuple数。 返回值类型：bigint - pg_stat_get_db_tuples_updated(oid) 描述：在数据库中更新的Tuple数。 返回值类型：bigint - pg_stat_get_db_tuples_deleted(oid) 描述：数据库中删除Tuple数。 返回值类型：bigint - pg_stat_get_db_conflict_lock(oid) 描述：数据库中锁冲突的数量。 返回值类型：bigint - pg_stat_get_db_deadlocks(oid) 描述：数据库中死锁的数量。 返回值类型：bigint - pg_stat_get_numscans(oid) 描述：如果参数是一个表，则顺序扫描读取的行数目。如果参数是一个索引，则返回索引行的数目。 返回值类型：bigint - pg_stat_get_role_name(oid) 描述：根据用户oid获取用户名。仅SYSADMIN和MONADMIN用户可以访问。 返回值类型：text 示例： ``` gaussdb=# select pg_stat_get_role_name(10); pg_stat_get_role_name ----------------------- aabbcc (1 row) ``` - pg_stat_get_tuples_returned(oid) 描述：如果参数是一个表，则顺序扫描读取的行数目。如果参数是一个索引，则返回的索引行的数目。 返回值类型：bigint - pg_stat_get_tuples_fetched(oid) 描述：如果参数是一个表，则位图扫描抓取的行数目。如果参数是一个索引，则用简单索引扫描抓取的行数目。 返回值类型：bigint - pg_stat_get_tuples_inserted(oid) 描述：插入表中行的数量。 返回值类型：bigint - pg_stat_get_tuples_updated(oid) 描述：在表中已更新行的数量。 返回值类型：bigint - pg_stat_get_tuples_deleted(oid) 描述：从表中删除行的数量。 返回值类型：bigint - pg_stat_get_tuples_changed(oid) 描述：该表上一次analyze或autoanalyze之后插入、更新、删除行的总数量。 返回值类型：bigint - pg_stat_get_tuples_hot_updated(oid) 描述：表热更新的行数。 返回值类型：bigint - pg_stat_get_live_tuples(oid) 描述：表活行数。 返回值类型：bigint - pg_stat_get_dead_tuples(oid) 描述：表死行数。 返回值类型：bigint - pg_stat_get_blocks_fetched(oid) 描述：表或者索引的磁盘块抓取请求的数量。 返回值类型：bigint - pg_stat_get_blocks_hit(oid) 描述：在缓冲区中找到的表或者索引的磁盘块请求数目。 返回值类型：bigint - pg_stat_get_xact_tuples_fetched(oid) 描述：事务中扫描的tuple行数。 返回值类型：bigint - pg_stat_get_xact_tuples_inserted(oid) 描述：表相关的活跃子事务中插入的tuple数。 返回值类型：bigint - pg_stat_get_xact_tuples_deleted(oid) 描述：表相关的活跃子事务中删除的tuple数。 返回值类型：bigint - pg_stat_get_xact_tuples_hot_updated(oid) 描述：表相关的活跃子事务中热更新的tuple数。 返回值类型：bigint - pg_stat_get_xact_tuples_updated(oid) 描述：表相关的活跃子事务中更新的tuple数。 返回值类型：bigint - pg_stat_get_last_vacuum_time(oid) 描述：用户在该表上最后一次手动启动清理或者autovacuum线程启动清理的时间。 返回值类型：timestamptz - pg_stat_get_last_autovacuum_time(oid) 描述：autovacuum守护进程在该表上最后一次启动清理的时间。 返回值类型：timestamptz - pg_stat_get_vacuum_count(oid) 描述：用户在该表上启动清理的次数。 返回值类型：bigint - pg_stat_get_autovacuum_count(oid) 描述：autovacuum守护进程在该表上启动清理的次数。 返回值类型：bigint - pg_stat_get_last_analyze_time(oid) 描述：用户在该表上最后一次手动启动分析或者autovacuum线程启动分析的时间。 返回值类型：timestamptz - pg_stat_get_last_autoanalyze_time(oid) 描述：autovacuum守护进程在该表上最后一次启动分析的时间。 返回值类型：timestamptz - pg_stat_get_analyze_count(oid) 描述：用户在该表上启动分析的次数。 返回值类型：bigint - pg_stat_get_autoanalyze_count(oid) 描述：autovacuum守护进程在该表上启动分析的次数。 返回值类型：bigint - pg_total_autovac_tuples(bool) 描述：返回total autovac相关的tuple记录，如nodename、nspname、relname以及各类tuple的IUD信息，入参为：是否查询relation信息。 返回值类型：setofrecord 返回参数说明如下。 表4返回参数说明 | 返回参数 | 返回参数类型 | 返回参数说明 | |:---|:---|:---| | nodename | name | 节点名称。 | | nspname | name | 名称空间名称。 | | relname | name | 表、索引、视图等对象名称。 | | partname | name | 分区名称。 | | n_dead_tuples | bigint | 表分区内的死行数。 | | n_live_tuples | bigint | 表分区内的活行数。 | | changes_since_analyze | bigint | analyze产生改变的数量。 | - pg_total_gsi_autovac_tuples(bool) 描述：集中式不支持。 返回值类型：setofrecord - pg_autovac_status(oid) 描述：返回和autovac状态相关的参数信息，如nodename,nspname,relname,analyze,vacuum设置，analyze/vacuum阈值, analyze/vacuum tuple数等。仅SYSADMIN可以使用该函数。 返回值类型：setofrecord 返回值参数说明如下。 表5返回值参数说明 | 返回参数 | 返回参数类型 | 返回参数说明 | |:---|:---|:---| | nspname | text | 名称空间名称。 | | relname | text | 表、索引、视图等对象名称。 | | nodename | text | 节点名称。 | | doanalyze | Boolean | 是否执行analyze。 | | anltuples | bigint | analyze tuple数量。 | | anlthresh | bigint | analyze阈值。 | | dovacuum | Boolean | 是否执行vacuum。 | | vactuples | bigint | vacuum tuple数量。 | | vacthresh | bigint | vacuum阈值。 | - pg_autovac_timeout(oid) 描述：返回某个表做autovac连续超时的次数，表信息非法或node信息异常返回NULL。 返回值类型：bigint - pg_stat_get_last_data_changed_time(oid) 描述：对于在表上的修改insert/update/delete/truncate和在表的分区(partition/subpartition)上的修改exchange/truncate/drop，在该表上最后一次操作的时间，[PG_STAT_ALL_TABLES](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1153.html#ZH-CN_TOPIC_0000002235460405)视图last_data_changed列的数据是通过该函数求值，在表数量很大的场景中，通过视图获取表数据最后修改时间的性能较差，建议直接使用该函数获取表数据的最后修改时间。入参是表的oid。 返回值类型：timestamptz - pg_stat_set_last_data_changed_time(oid) 描述：手动设置该表上最后一次insert/update/delete, exchange/truncate/drop partition操作的时间。 返回值类型：void - pg_backend_pid() 描述：当前会话的服务器线程的线程ID。 返回值类型：integer - pg_stat_get_activity(integer) 描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。返回结果不包含connection_info列。初始用户、系统管理员和MONADMIN可以查看所有的数据，普通用户只能查询自己的结果。 示例： ``` gaussdb=# select * from pg_stat_get_activity(139881386280704); datid | pid | sessionid | usesysid | application_name | state | query | waiting | xact_start | query_start | backend_start | state_change | client_addr | client_hostname | client_port | enqueue | query_id | srespool | global_sessionid | unique_sql_id | trace_id -------+-----------------+-----------+----------+------------------+--------+------------------------------------------------------+---------+-------------------------------+-------------------------------+----- --------------------------+------------------------------+-------------+-----------------+-------------+---------+-------------------+--------------+------------------+---------------+---------- 16545 | 139881386280704 | 69 | 10 | gsql | active | select * from pg_stat_get_activity(139881386280704); | f | 2022-01-18 19:43:05.167718+08 | 2022-01-18 19:43:05.167718+08 | 2022 -01-18 19:42:33.513507+08 | 2022-01-18 19:43:05.16773+08 | | | -1 | | 72620543991624410 | default_pool | 1938253334#69#0 | 3751941862 | (1 row) ``` 返回值类型：setofrecord 返回参数说明如下。 表6返回参数说明 | 返回参数 | 返回参数类型 | 返回参数说明 | |:---|:---|:---| | datid | oid | 用户会话在后台连接到的数据库OID。 | | pid | bigint | 后台线程ID。 | | sessionid | bigint | 会话ID。 | | usesysid | oid | 登录该后台的用户OID。 | | application_name | text | 连接到该后台的应用名。 | | state | text | 该后台当前总体状态。 | | query | text | 该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。 | | waiting | Boolean | 如果后台当前正等待锁则为true。 | | xact_start | timestamp with time zone | 启动当前事务的时间，如果没有事务是活跃的，则为null。 如果当前查询是首个事务，则这列等同于query_start列。 | | query_start | timestamp with time zone | 开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。如果是存储过程、函数、PACKAGE，则查询的是第一个查询时间，不会随着存储过程内语句运行而改变。 | | backend_start | timestamp with time zone | 该过程开始的时间，即当客户端连接服务器时。 | | state_change | timestamp with time zone | 上次状态改变的时间。 | | client_addr | inet | 连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部进程，如autovacuum。 | | client_hostname | text | 客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。 | | client_port | integer | 客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。 | | enqueue | text | 该字段暂不支持。 | | query_id | bigint | 查询语句的ID。 | | srespool | name | 资源池名字。 | | global_sessionid | text | 全局会话id。 | | unique_sql_id | bigint | 语句的unique sql id。 | | trace_id | text | 驱动传入的trace id，与应用的一次请求相关联。 | - pg_stat_get_activity_with_conninfo(integer) 描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。初始用户、系统管理员和MONADMIN可以查看所有的数据，普通用户只能查询自己的结果。 返回值类型：setofrecord 返回值说明如下。 表7返回值说明 | 返回值 | 返回值类型 | 返回值说明 | |:---|:---|:---| | datid | oid | 用户会话在后台连接到的数据库OID。 | | pid | bigint | 后台线程ID。 | | sessionid | bigint | 会话ID。 | | usesysid | oid | 登录该后台的用户OID。 | | application_name | text | 连接到该后台的应用名。 | | state | text | 该后台当前的总体状态。 | | query | text | 该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。 | | waiting | Boolean | 如果后台当前正等待锁则为true。 | | xact_start | timestamp with time zone | 启动当前事务的时间，如果没有事务是活跃的，则为null。如果当前查询是首个事务，则这列等同于query_start列。 | | query_start | timestamp with time zone | 开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。如果是存储过程、函数、PACKAGE，则查询的是第一个查询时间，不会随着存储过程内语句运行而改变。 | | backend_start | timestamp with time zone | 该过程开始的时间，即当客户端连接服务器时。 | | state_change | timestamp with time zone | 上次状态改变的时间。 | | client_addr | inet | 连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部进程，如autovacuum。 | | client_hostname | text | 客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。 | | client_port | integer | 客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。 | | enqueue | text | 该字段暂不支持。 | | query_id | bigint | 查询语句的ID。 | | connection_info | text | json格式字符串，记录当前连接数据库的驱动类型、驱动版本号、当前驱动的部署路径、进程属主用户等信息。 | | srespool | name | 资源池名字。 | | global_sessionid | text | 全局会话ID。 | | unique_sql_id | bigint | 语句的unique sql id。 | | trace_id | text | 驱动传入的trace id，与应用的一次请求相关联。 | | top_xid | xid | 事务的顶层事务ID。 | | current_xid | xid | 事务的当前事务ID。 | | xlog_quantity | bigint | 事务当前使用的xLog量，单位为字节。 | - gs_get_explain(integer) 描述：返回一个关于指定PID的后台线程的运行态计划，PID不能为空。该功能生效的必要条件是GUC参数track_activities为on，支持语句的范围为可以explain且其计划不包含STREAM算子的SQL，详细说明如下： - 若GUC参数plan_collect_thresh=-1，则该函数的返回结果一直为空。 - 若GUC参数plan_collect_thresh=0，若当前SQL执行时间大于等于GUC参数log_min_duration_statement指定值，且计划中所有算子处理的tuple数量和大于等于10000时，开始收集运行态计划；且后续每当所有算子处理tuple数量的和的增量超过10000时，进行一次收集。 - 若GUC参数plan_collect_thresh\>0，会按照该参数指定的阈值进行增量收集运行态计划。 返回值类型：text，具体各个字段的类型和含义如下： | 参数 | 类型 | 描述 | |:---|:---|:---| | 运行态计划字符串 | text | 其中计划字符串中的A-rows是算子实时返回行数。 | - pg_stat_get_function_calls(oid) 描述：函数已被调用次数。 返回值类型：bigint - pg_stat_get_function_self_time(oid) 描述：只有在此函数上所花费的时间。此函数调用其它函数所花费的时间被排除在外。 返回值类型：bigint - pg_stat_get_backend_idset() 描述：设置当前活动的服务器进程数（从1到活动服务器进程的数量）。 返回值类型：setofinteger - pg_stat_get_backend_pid(integer) 描述：给定的服务器线程的线程ID。 返回值类型：bigint - pg_stat_get_backend_dbid(integer) 描述：给定服务器进程的数据库ID。 返回值类型：oid - pg_stat_get_backend_userid(integer) 描述：给定服务器进程的用户ID，本函数仅系统管理员可调用。 返回值类型：oid - pg_stat_get_backend_activity(integer) 描述：给定服务器进程的当前活动查询，仅在调用者是系统管理员或被查询会话的用户，并且打开track_activities的时候才能获得结果。 返回值类型：text - pg_stat_get_backend_waiting(integer) 描述：如果给定服务器进程在等待某个锁，并且调用者是系统管理员或被查询会话的用户，并且打开track_activities的时候才返回真。 返回值类型：Boolean - pg_stat_get_backend_activity_start(integer) 描述：给定服务器进程当前正在执行的查询的起始时间，仅在调用者是系统管理员或被查询会话的用户，并且打开track_activities的时候才能获得结果。 返回值类型：timestampwithtimezone - pg_stat_get_backend_xact_start(integer) 描述：给定服务器进程当前正在执行的事务的开始时间，但只有当前用户是系统管理员或被查询会话的用户，并且打开track_activities的时候才能获得结果。 返回值类型：timestampwithtimezone - pg_stat_get_backend_start(integer) 描述：给定服务器进程启动的时间，如果当前用户不是系统管理员或被查询的后端的用户，则返回NULL。 返回值类型：timestampwithtimezone - pg_stat_get_backend_client_addr(integer) 描述：连接到给定客户端后端的IP地址。如果是通过Unix域套接字连接的则返回NULL；如果当前用户不是系统管理员或被查询会话的用户，也返回NULL。 返回值类型：inet - pg_stat_get_backend_client_port(integer) 描述：连接到给定客户端后端的TCP端口。如果是通过Unix域套接字连接的则返回-1；如果当前用户不是系统管理员或被查询会话的用户，也返回NULL。 返回值类型：integer - pg_stat_get_bgwriter_timed_checkpoints() 描述：后台写进程开启定时检查点的时间（因为checkpoint_timeout时间已经过期了）。 返回值类型：bigint - pg_stat_get_bgwriter_requested_checkpoints() 描述：后台写进程开启基于后端请求的检查点的时间，因为已经超过了checkpoint_segments或因为已经执行了CHECKPOINT。 返回值类型：bigint - pg_stat_get_bgwriter_buf_written_checkpoints() 描述：在检查点期间后台写进程写入的缓冲区数目。 返回值类型：bigint - pg_stat_get_bgwriter_buf_written_clean() 描述：为日常清理脏块，后台写进程写入的缓冲区数目。 返回值类型：bigint - pg_stat_get_bgwriter_maxwritten_clean() 描述：后台写进程停止清理扫描的时间，因为已经写入了更多的缓冲区（相比bgwriter_lru_maxpages参数声明的缓冲区数）。 返回值类型：bigint - pg_stat_get_buf_written_backend() 描述：后端进程写入的缓冲区数，因为它们需要分配一个新的缓冲区。 返回值类型：bigint - pg_stat_get_buf_alloc() 描述：分配的总缓冲区数。 返回值类型：bigint - pg_stat_clear_snapshot() 描述：清理当前的统计快照，该函数仅SYSADMIN和MONADMIN可以执行。 返回值类型：void - pg_stat_reset() 描述：为当前数据库重置统计计数器为0（需要系统管理员权限）。 返回值类型：void - pg_stat_reset_shared(text) 描述：重置shared cluster每个节点当前数据统计计数器为0（需要系统管理员权限）。 返回值类型：void - pg_stat_reset_single_table_counters(oid) 描述：为当前数据库中的一个表或索引重置统计为0（需要系统管理员权限）。 返回值类型：void - pg_stat_reset_single_function_counters(oid) 描述：为当前数据库中的一个函数重置统计为0（需要系统管理员权限）。 返回值类型：void - fenced_udf_process(integer) 描述：查看本地UDF Master和Work进程数。入参为1时查看master进程数，入参为2时查看worker进程数，入参为3时结束所有worker进程。 返回值类型：text - total_cpu() 描述：获取当前节点使用的CPU时间，单位是jiffies。 返回值类型：bigint - total_memory() 描述：获取当前节点使用的虚拟内存大小，单位KB。 返回值类型：bigint - pg_stat_bad_block(text, int, int, int, int, int, timestamp with time zone, timestamp with time zone) 描述：获取当前节点自启动后，读取出现Page的损坏信息。 例: select \* from pg_stat_bad_block(); 返回值类型：record - pg_stat_bad_block_clear() 描述：清理节点记录的读取出现的Page损坏信息（需要系统管理员权限）。 返回值类型：void - gs_respool_exception_info(pool text) 描述：查看某个资源池关联的查询规则信息。 返回值类型：record - gs_control_group_info(pool text) 描述：查看资源池关联的控制组信息。该函数需要SYSADMIN权限的用户才能够执行。 返回值类型：record 返回信息如下： | 属性 | 属性值 | 描述 | |:---|:---|:---| | name | class_a:workload_a1 | class和workload名称。 | | class | class_a | Class控制组名称。 | | workload | workload_a1 | Workload控制组名称。 | | type | DEFWD | 控制组类型（Top、CLASS、BAKWD、DEFWD、TSWD）。 | | gid | 87 | 控制组id。 | | shares | 30 | 占父节点CPU资源的百分比。 | | limits | 0 | 占父节点CPU核数的百分比。 | | rate | 0 | Timeshare中的分配比例。 | | cpucores | 0-3 | CPU核心数。 | - gs_prepared_statements() 描述：显示所有会话所有可用的预备语句，该函数需要SYSADMIN权限的用户才能够执行，函数返回信息具体的字段和[GS_ALL_PREPARED_STATEMENTS](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1021.html#ZH-CN_TOPIC_0000002235460225)字段一致。 返回值类型：record - gs_all_control_group_info() 描述：查看数据库内所有的控制组信息。 返回值类型：record - gs_get_control_group_info() 描述：查看所有的控制组信息。函数返回信息具体的字段[GS_GET_CONTROL_GROUP_INFO](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1031.html#ZH-CN_TOPIC_0000002200420130)字段。该函数需要SYSADMIN权限的用户才能够执行。 返回值类型：record - gs_plan_trace_delete(TIMESTAMPTZ) 描述：删除当前用户的小于等于指定时间max_time的所有plan trace。所有用户都可以使用该函数，且只要该函数在执行过程中没有任何异常，那么该函数将返回t。 返回值类型：bool - gs_plan_trace_watch_sqlid(bigint) 描述：侦听一个要生成plan trace的unique sql id，该id来自dbe_perf.statement系统表的unique_sql_id字段。另外，该函数只能被初始用户和有SYSADMIN/opradmin/MONADMIN权限的用户调用，且只要该函数在执行过程中没有任何异常，那么该函数将返回t。 返回值类型：bool ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) 1. 在数据库系统中，当前被侦听的unique sql id被存放到一个长度为128的循环数组中，如果调用该函数的速度过于频繁，那么有可能存在被侦听但是没有生成plan trace的unique sql id被覆盖掉。 2. 如果一个unique sql id只被侦听一次，那么该unique sql id只能生成一次plan trace。如果相同的unique sql id被侦听多次，那么该unique sql id会生成多次plan trace。 - gs_plan_trace_show_sqlids() 描述：查看当前系统中待生成plan trace的unique sql id字符串列表。该函数只能被初始用户和有SYSADMIN/opradmin/MONADMIN权限的用户调用。 返回值类型：text ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) 1. 系统中有两个待生成plan trace的unique sq id：730834934、730834935，那么使用该函数看到的结果为字符串文本："730834934,730834935,"。 2. 使用这个函数看不到正在生成plan trace的unique sql id。 - get_instr_workload_info(integer) 描述：获取数据库主节点上事务量信息，事务时间信息。 返回值类型：record | 属性 | 属性值 | 描述 | |:---|:---|:---| | resourcepool_oid | 10 | 资源池的oid(逻辑同负载等价)。 | | commit_counter | 4 | 前端事务commit数量。 | | rollback_counter | 1 | 前端事务rollback数量。 | | resp_min | 949 | 前端事务最小响应时间（单位：微秒）。 | | resp_max | 201891 | 前端事务最大响应时间（单位：微秒）。 | | resp_avg | 43564 | 前端事务平均响应时间(单位：微秒)。 | | resp_total | 217822 | 前端事务总响应时间（单位：微秒）。 | | bg_commit_counter | 910 | 后端事务commit数量。 | | bg_rollback_counter | 0 | 后端事务rollback数量。 | | bg_resp_min | 97 | 后端事务最小响应时间（单位：微秒）。 | | bg_resp_max | 678080687 | 后端事务最大响应时间（单位：微秒）。 | | bg_resp_avg | 327847884 | 后端事务平均响应时间（单位：微秒）。 | | bg_resp_total | 298341575300 | 后端事务总响应时间（单位：微秒）。 | - pv_instance_time() 描述：获取当前节点上各个关键阶段的时间消耗。 返回值类型：record | Stat_name属性 | 属性值 | 描述 | |:---|:---|:---| | DB_TIME | 1062385 | 所有线程端到端的墙上时间（WALL TIME）消耗总和(单位： 微秒)。 | | CPU_TIME | 311777 | 所有线程CPU时间消耗总和(单位： 微秒)。 | | EXECUTION_TIME | 380037 | 消耗在执行器上的时间总和(单位： 微秒)。 | | PARSE_TIME | 6033 | 消耗在SQL解析上的时间总和(单位： 微秒)。 | | PLAN_TIME | 173356 | 消耗在执行计划生成上的时间总和(单位： 微秒)。 | | REWRITE_TIME | 2274 | 消耗在查询重写上的时间总和(单位： 微秒)。 | | PL_EXECUTION_TIME | 0 | 消耗在PL/SQL执行上的时间总和(单位： 微秒)。 | | PL_COMPILATION_TIME | 557 | 消耗在SQL编译上的时间总和(单位： 微秒)。 | | NET_SEND_TIME | 1673 | 消耗在网络发送上的时间总和(单位： 微秒)。 | | DATA_IO_TIME | 426622 | 消耗在数据读写上的时间总和(单位： 微秒)。 | - DBE_PERF.get_global_instance_time() 描述：提供整个数据库各个关键阶段的时间消耗，查询该函数必须具有MONADMIN权限。 返回值类型：record - get_instr_unique_sql() 描述：获取当前节点的执行语句（归一化SQL）信息，查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：record - reset_unique_sql(text, text, bigint) 描述：用来清理CN/DN内存中的Unique SQL（需要SYSADMIN/MONADMIN权限）。 返回值类型：Boolean 表8reset_unique_sql参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | scope | text | 清理范围类型： 'GLOBAL' - 清理所有的CN/DN节点，如果是'GLOBAL'，则只可以为CN节点执行此函数。 'LOCAL' - 清理本节点。 | | clean_type | text | 'BY_USERID' - 按用户ID来进行清理Unique SQL。 'BY_CNID' - 按CN的ID来进行清理Unique SQL。 'ALL' - 全部清理。 | | clean_value | int8 | 具体清理type对应的清理值。如果第二个参数为ALL，则第三个参数不起作用，可以取任意值。 | ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 此函数中所说节点指分布式节点，当前GaussDB为集中式数据库，global与local功能一致，取值范围不支持BY_CNID。 - get_instr_wait_event(NULL) 描述：获取当前节点event等待的统计信息。 返回值类型：record - get_instr_user_login() 描述：获取当前节点的用户登录/退出次数信息，查询该函数必须具有SYSADMIN或者MONADMIN权限。 返回值类型：record - get_instr_rt_percentile(integer) 描述：获取数据库SQL响应时间P80、P95分布信息。 返回值类型：record - get_node_stat_reset_time() 描述：获取当前节点的统计信息重置（重启，主备倒换，数据库删除）时间。 返回值类型：record - DBE_PERF.get_global_os_runtime() 描述：显示当前操作系统运行的状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_os_threads() 描述：提供整个数据库中所有正常节点下的线程状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_workload_sql_count() 描述：提供整个数据库中不同负载SELECT，UPDATE，INSERT，DELETE，DDL，DML，DCL计数信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_workload_sql_elapse_time() 描述：提供整个数据库中不同负载SELECT、UPDATE、INSERT和DELETE，响应时间信息（TOTAL、AVG、MIN、MAX），查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_workload_transaction() 描述：获取数据库内所有节点上的事务量信息，事务时间信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_session_stat() 描述：获取数据库节点上的会话状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 状态信息有14项：commit、rollback、sql、table_scan、blocks_fetched、physical_read_operation、shared_blocks_dirtied、local_blocks_dirtied、shared_blocks_read、local_blocks_read、blocks_read_time、blocks_write_time、sort_imemory、sort_idisk。 - DBE_PERF.get_global_session_time() 描述：提供整个数据库各节点各个关键阶段的时间消耗，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_session_memory() 描述：汇聚各节点的Session级别的内存使用情况，包含执行作业在数据节点上gaussdb线程和Stream线程分配的所有内存，单位为MB，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_session_memory_detail() 描述：汇聚各节点的线程的内存使用情况，以MemoryContext节点来统计，查询该函数必须具有MONADMIN权限。 返回值类型：record - create_wlm_session_info(int flag) 描述：将当前内存中记录的TopSQL查询语句级别相关统计信息清理。该函数只有管理员用户可以执行。 返回值类型：int - pg_stat_get_wlm_session_info(int flag) 描述：获取当前内存中记录的TopSQL查询语句级别相关统计信息，当传入的参数不为0时，会将这部分信息从内存中清理掉。该函数只有SYSADMIN和MONADMIN用户可以执行。 返回值类型：record - gs_paxos_stat_replication() 描述：在主机端查询备机信息。 返回值类型：setofrecord 返回字段说明如下： | 字段名称 | 字段类型 | 字段说明 | |---|---|---| | local_role | text | 发送日志节点的角色。 | | peer_role | text | 接收日志节点的角色。 | | local_dcf_role | text | 发送日志节点的DCF角色。 | | peer_dcf_role | text | 接收日志节点的DCF角色。 | | peer_state | text | 接收日志节点的状态。 | | sender_write_location | text | 发送日志节点写到xlog buffer的位置。 | | sender_commit_location | text | 发送日志节点DCF日志达成一致性点。 | | sender_flush_location | text | 发送日志节点写到xlog disk的位置。 | | sender_replay_location | text | 发送日志节点replay的位置。 | | receiver_write_location | text | 接收日志节点写到xlog buffer的位置。 | | receiver_commit_location | text | 接收日志节点DCF日志达成一致性点。 | | receiver_flush_location | text | 接收日志节点写到xlog disk的位置。 | | receiver_replay_location | text | 接收日志节点重演xlog的位置。 | | sync_percent | text | 同步百分比。 | | dcf_run_mode | int4 | DCF同步模式。 | | channel | text | 信道信息。 | - gs_wlm_get_resource_pool_info(int) 描述：获取所有用户的资源使用统计信息，入参为int类型可以为任意int值或NULL。 返回值类型：record - gs_wlm_get_all_user_resource_info() 描述：获取所有用户的资源使用统计信息。 返回值类型：record - gs_wlm_get_user_info(int) 描述：获取所有用户的相关信息，入参为int类型，可以为任意int值或NULL。该函数只有SYSADMIN权限的用户可以执行。 返回值类型：record - gs_wlm_readjust_user_space(oid) 描述：修正所有用户的存储空间使用情况。该函数只有管理员用户可以执行。 返回值类型：record - gs_wlm_readjust_user_space_through_username(text name) 描述：修正指定用户的存储空间使用情况。该函数普通用户只能修正自己的使用情况，只有管理员用户可以修正所有用户的使用情况。当name指定为"0000"，表示需要修正所有用户的使用情况。 返回值类型：record - gs_wlm_readjust_user_space_with_reset_flag(text name, boolean isfirst) 描述：修正指定用户的存储空间使用情况。入参isfirst为true表示从0开始统计，否则从上一次结果继续统计。该函数普通用户只能修正自己的使用情况，只有管理员用户可以修正所有用户的使用情况。当name指定为"0000"，表示需要修正所有用户的使用情况。 返回值类型：record - gs_wlm_session_respool(bigint) 描述：获取当前所有后台线程的session resource pool相关信息，入参为bigint类型可以为任意bigint值或NULL。 返回值类型：record - gs_wlm_get_session_info() 描述：目前该接口已废弃，暂不可用。 - gs_wlm_get_user_session_info() 描述：目前该接口已废弃，暂不可用。 - gs_io_wait_status() 描述：目前该接口不支持单机和集中式，暂不可用。 - global_stat_get_hotkeys_info() 描述：获取整个数据库实例中热点key的统计情况。目前该接口不支持单机和集中式，暂不可用。 - global_stat_clean_hotkeys() 描述：清理整个数据库实例中热点key的统计信息。目前该接口不支持单机和集中式，暂不可用。 - DBE_PERF.get_global_session_stat_activity() 描述：汇聚数据库内各节点上正在运行的线程相关的信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_thread_wait_status() 描述：汇聚所有节点上工作线程（backend thread）以及辅助线程（auxiliary thread）的阻塞等待情况，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_operator_history_table() 描述：汇聚当前用户数据库主节点上执行作业结束后的算子相关记录（持久化），查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_operator_history() 描述：汇聚当前用户数据库主节点上执行作业结束后的算子相关记录，查询该函数必须具有SYSADMIN和MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_operator_runtime() 描述：汇聚当前用户数据库主节点上执行作业实时的算子相关记录，查询该函数必须具有SYSADMIN和MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statement_complex_history() 描述：汇聚当前用户数据库主节点上复杂查询的历史记录，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statement_complex_history_table() 描述：汇聚当前用户数据库主节点上复杂查询的历史记录（持久化），查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statement_complex_runtime() 描述：汇聚当前用户数据库主节点上复杂查询的实时信息，查询该函数必须具有SYSADMIN和MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_memory_node_detail() 描述：汇聚所有节点某个数据库节点内存使用情况，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_shared_memory_detail() 描述：汇聚所有节点已产生的共享内存上下文的使用信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_all_indexes() 描述：汇聚所有节点当前数据库中的每个索引行，显示特定索引的I/O的统计，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_all_tables() 描述：显示汇聚各节点数据中每个表（包括TOAST表）的一行的统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_all_tables() 描述：显示各节点数据中每个表（包括TOAST表）的一行的统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_local_toastname_and_toastindexname() 描述：提供本地toast表的name和index和其关联表的对应关系，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_all_indexes() 描述：统计所有节点当前数据库中的每个索引行，显示特定索引的I/O的统计，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_all_sequences() 描述：提供命名空间中所有sequences的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_all_tables() 描述：汇聚各节点的数据库中每个表I/O的统计，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_all_tables() 描述：统计数据库内数据库中每个表I/O的统计，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_local_toast_relation() 描述：提供本地toast表的name和其关联表的对应关系，查询该函数必须具有MONADMIN权限 返回值类型：record - DBE_PERF.get_global_statio_sys_indexes() 描述：汇聚各节点的命名空间中所有系统表索引的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_sys_indexes() 描述：统计各节点的命名空间中所有系统表索引的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_sys_sequences() 描述：提供命名空间中所有系统表为sequences的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_sys_tables() 描述：提供各节点的命名空间中所有系统表的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_sys_tables() 描述：数据库内汇聚命名空间中所有系统表的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_user_indexes() 描述：各节点的命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_user_indexes() 描述：数据库内汇聚命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_user_sequences() 描述：显示各节点的命名空间中所有用户的sequences的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_user_tables() 描述：显示各节点的命名空间中所有用户关系表的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_user_tables() 描述：数据库内汇聚命名空间中所有用户关系表的IO状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_all_indexes() 描述：汇聚所有节点数据库中每个索引的统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_all_indexes() 描述：统计所有节点数据库中每个索引的统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_sys_tables() 描述：汇聚各节点pg_catalog、information_schema模式的所有命名空间中系统表的统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_sys_tables() 描述：统计各节点pg_catalog、information_schema模式的所有命名空间中系统表的统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_sys_indexes() 描述：汇聚各节点pg_catalog、information_schema模式中所有系统表的索引状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_sys_indexes() 描述：统计各节点pg_catalog、information_schema模式中所有系统表的索引状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_user_tables() 描述：汇聚所有命名空间中用户自定义普通表的状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_user_tables() 描述：统计所有命名空间中用户自定义普通表的状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_user_indexes() 描述：汇聚所有数据库中用户自定义普通表的索引状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_user_indexes() 描述：统计所有数据库中用户自定义普通表的索引状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_database() 描述：汇聚所有节点数据库统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_database_conflicts() 描述：统计所有节点数据库统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_xact_all_tables() 描述：汇聚命名空间中所有普通表和toast表的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_xact_all_tables() 描述：统计命名空间中所有普通表和toast表的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_xact_sys_tables() 描述：汇聚所有节点命名空间中系统表的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_xact_sys_tables() 描述：统计所有节点命名空间中系统表的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_xact_user_tables() 描述：汇聚所有节点命名空间中用户表的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_stat_xact_user_tables() 描述：统计所有节点命名空间中用户表的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_user_functions() 描述：汇聚所有节点命名空间中用户定义函数的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_xact_user_functions() 描述：统计所有节点命名空间中用户定义函数的事务状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_stat_bad_block() 描述：汇聚所有节点表、索引等文件的读取失败信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_file_redo_iostat() 描述：统计所有节点表、索引等文件的读取失败信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_file_iostat() 描述：汇聚所有节点数据文件IO的统计，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_locks() 描述：汇聚所有节点的锁信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_replication_slots() 描述：汇聚所有节点上逻辑复制信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.GET_GLOBAL_PARALLEL_DECODE_STATUS() 描述：汇聚当前节点上的复制槽的并行解码信息，查询该函数必须具有MONADMIN权限。返回值同视图[DBE_PERF.GLOBAL_PARALLEL_DECODE_STATUS](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1396.html#ZH-CN_TOPIC_0000002235340893)。 返回值类型：record - DBE_PERF.GET_GLOBAL_PARALLEL_DECODE_THREAD_INFO() 描述：汇聚当前节点上的复制槽的并行解码线程信息，查询该函数必须具有MONADMIN权限。返回值同视图[DBE_PREF.GLOBAL_PARALLEL_DECODE_THREAD_INFO](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1398.html#ZH-CN_TOPIC_0000002200580446)。 返回值类型：record - DBE_PERF.get_global_bgwriter_stat() 描述：汇聚所有节点后端写进程活动的统计信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_replication_stat() 描述：汇聚各节点日志同步状态信息，如发起端发送日志位置，收端接收日志位置等，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_transactions_running_xacts() 描述：汇聚各节点运行事务的信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_transactions_running_xacts() 描述：统计各节点运行事务的信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_transactions_prepared_xacts() 描述：汇聚各节点当前准备好进行两阶段提交的事务的信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_transactions_prepared_xacts() 描述：统计各节点当前准备好进行两阶段提交的事务的信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statement() 描述：汇聚各节点历史执行语句状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statement_count() 描述：汇聚各节点SELECT、UPDATE、INSERT、DELETE，响应时间信息（TOTAL、AVG、MIN、MAX），查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_config_settings() 描述：汇聚各节点GUC参数配置信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_wait_events() 描述：汇聚各节点wait events状态信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_statement_responsetime_percentile() 描述：获取数据库SQL响应时间P80，P95分布信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_user_login() 描述：统计数据库各节点用户登录/退出次数信息，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_record_reset_time() 描述：汇聚数据库统计信息重置（重启，主备倒换，数据库删除）时间，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.standby_statement_history(only_slow\[, time1, time2\]) 描述：备机中用来查询FULL SQL记录的函数，主机通过表statement_history进行查询，备机通过此函数进行查询。查询该函数必须具有MONADMIN权限。 参数：参见[表9]。 返回值类型：record，同表statement_history。 表9standby_statement_history参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | only_slow | bool | 是否仅查询慢SQL。 true为是，相当于 select .. where is_slow_sql = true;。 false或NULL为查询全部SQL，相当于不对is_slow_sql进行过滤。 | | time1 | timestamptz | 可选输入，表示查询SQL的finish_time的最小时间。 | | time2 | timestamptz | 可选输入，表示查询SQL的finish_time的最大时间。 | ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - 两个时间参数time1、time2的说明：表示查询的SQL的finish_time所属时间段，分别表示起始与终止时间，输入NULL或者不输入表示没有限制, 功能等同于select .. where finish_time between time1 and time2;。 - 备机上该功能的数据并非存在表里，不存在start_time列的索引，推荐使用参数对finish_time进行条件查找。 - 由于备机Full/Slow SQL采用异步下盘方式，所以用户SQL信息存储时刻可能有所滞后，建议客户查询此接口适当扩大时间查询范围。 - DBE_PERF.track_memory_context(context_list text) 描述：设置需要统计内存申请详细信息的内存上下文。入参为内存上下文的名称，使用","分隔，如"ThreadTopMemoryContext, SessionCacheMemoryContext"，注意该内存上下文名称是上下文敏感的。此外，单个内存上下文的长度为63，超过的部分会被截断。而且一次能够统计的内存上下文上限为16个，设置超过16个内存上下文会设置失败。每一次调用该函数都会将上次统计的结果清空，当入参指定为""时，表示取消该统计功能。查询该函数必须具有MONADMIN权限。 返回值类型：boolean - DBE_PERF.track_memory_context_detail() 描述：获取DBE_PERF.track_memory_context函数指定的内存上下文的内存申请详细信息。返回值的定义见视图DBE_PERF.track_memory_context_detail。查询该函数必须具有MONADMIN权限。 返回值类型：record - pg_stat_get_mem_mbytes_reserved(tid) 描述：统计资源管理相关变量值，仅用于定位问题使用。 参数：线程id。 返回值类型：text - gs_wlm_user_resource_info(name text) 描述：查询具体某个用户的资源限额和资源使用情况。 返回值类型：record - pg_stat_get_file_stat() 描述：通过对数据文件IO的统计，反映数据的IO性能，用以发现IO操作异常等性能问题。 返回值类型：record - pg_stat_get_redo_stat() 描述：用于统计会话线程日志回放情况。 返回值类型：record - pg_stat_get_status(int8) 描述：可以检测当前实例中工作线程（backend thread）以及辅助线程（auxiliary thread）的阻塞等待情况。 返回值类型：record - get_local_rel_iostat() 描述：查询当前节点的数据文件IO状态累计值。 返回值类型：record - DBE_PERF.get_global_rel_iostat() 描述：汇聚所有节点数据文件IO的统计，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.global_threadpool_status() 描述：显示在所有节点上的线程池中工作线程及会话的状态信息。函数返回信息具体字段[GLOBAL_THREADPOOL_STATUS](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1318.html#ZH-CN_TOPIC_0000002200580366)字段，查询该函数必须具有MONADMIN权限。 返回值类型：record - pv_os_run_info() 描述：显示当前操作系统运行的状态信息，具体字段信息参考[GS_OS_RUN_INFO](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1041.html#ZH-CN_TOPIC_0000002200579946)。 参数：nan 返回值类型：setof record - pv_session_stat() 描述：以会话线程或AutoVacuum线程为单位，统计会话状态信息，具体字段信息参考[GS_SESSION_STAT](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1049.html#ZH-CN_TOPIC_0000002200579954)。 参数：nan 返回值类型：setof record - pv_session_time() 描述：用于统计会话线程的运行时间信息，及各执行阶段所消耗时间，具体字段信息参考[GS_SESSION_TIME](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1050.html#ZH-CN_TOPIC_0000002200420150)。 参数：nan 返回值类型：setof record - pg_stat_get_db_temp_bytes() 描述：用于统计通过数据库查询写入临时文件的数据总量。计算所有临时文件，不论为什么创建临时文件，而且不管log_temp_files设置。 参数：oid 返回值类型：bigint - pg_stat_get_db_temp_files() 描述：通过数据库查询创建的临时文件数量。计算所有临时文件，不论为什么创建临时文件（比如排序或者哈希），而且不管log_temp_files设置。 参数：oid 返回值类型：bigint - create_wlm_instance_statistics_info() 描述：将当前实例的历史监控数据进行持久化保存。 参数：nan 返回值类型：integer - remote_candidate_stat() 描述：用于显示数据库所有实例的检查点信息和各类日志刷页情况（本节点除外），集中式不支持。 返回值类型：record - remote_ckpt_stat() 描述：用于显示数据库所有实例的检查点信息和各类日志刷页情况（本节点除外），集中式不支持。 返回值类型：record - remote_single_flush_dw_stat() 描述：显示数据库所有实例的单页面双写文件的情况(本节点除外)，集中式不支持。 返回值类型：record - remote_double_write_stat() 描述：显示数据库所有实例的双写文件的情况(本节点除外)，集中式不支持。 返回值类型：record - remote_pagewriter_stat() 描述：显示数据库所有实例的刷页信息和检查点信息(本节点除外)，集中式不支持。 返回值类型：record - remote_recovery_status() 描述：显示关于主机和备机的日志流控信息(本节点除外)，集中式不支持。 返回值类型：record - remote_redo_stat() 描述：显示所有实例的日志回放情况(本节点除外)，集中式不支持。 返回值类型：record - DBE_PERF.gs_stat_activity_timeout(int) 描述：获取当前节点上执行时间超过超时阈值的查询作业信息。需要GUC参数track_activities设置为on才能正确返回结果。超时阈值的取值范围是0\~2147483，查询该函数必须具有MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | database | name | 用户会话连接的数据库名称。 | | pid | bigint | 后台线程ID。 | | sessionid | bigint | 会话ID。 | | usesysid | oid | 登录该后台的用户OID。 | | application_name | text | 连接到该后台的应用名。 | | query | text | 该后台正在执行的查询。 | | xact_start | timestamptz | 启动当前事务的时间。 | | query_start | timestamptz | 开始当前查询的时间。如果是存储过程、函数、PACKAGE，则查询的是第一个查询时间，不会随着存储过程内语句运行而改变。 | | query_id | bigint | 查询语句ID。 | - gs_wlm_user_resource_info(name text) 描述：查询具体某个用户的资源限额和资源使用情况。普通用户只能查询到自己相关的信息，管理员权限的用户可以查看全部用户的信息。 返回值类型：record - create_wlm_instance_statistics_info 描述：将当前实例的历史监控数据进行持久化保存。 参数：nan 返回值类型：integer - create_wlm_operator_info(int flag) 描述：将当前内存中记录的TopSQL算子级别相关统计信息清理，当传入的参数大于0时，会将这部分信息归档到gs_wlm_operator_info中，否则不会归档。该函数只有SYSADMIN权限的用户可以执行。 返回值类型：int - GS_ALL_NODEGROUP_CONTROL_GROUP_INFO(text) 描述：提供了所有逻辑数据库实例的控制组信息。该函数在调用的时候需要指定要查询逻辑数据库实例的名称。例如要查询'installation'逻辑数据库实例的控制组信息： ``` SELECT * FROM GS_ALL_NODEGROUP_CONTROL_GROUP_INFO('installation') ``` 返回值类型：record 函数返回字段如下： | 名称 | 类型 | 描述 | |:---|:---|:---| | name | text | 控制组的名称。 | | type | text | 控制组的类型。 | | gid | bigint | 控制组ID。 | | classgid | bigint | Workload所属Class的控制组ID。 | | class | text | Class控制组。 | | workload | text | Workload控制组。 | | shares | bigint | 控制组分配的CPU资源配额。 | | limits | bigint | 控制组分配的CPU资源限额。 | | wdlevel | bigint | Workload控制组层级。 | | cpucores | text | 控制组使用的CPU核的信息。 | - gs_total_nodegroup_memory_detail 描述：返回当前数据库逻辑数据库使用内存的信息，单位为MB得到一个逻辑数据库。 返回值类型：setof record - local_redo_time_count() 描述：返回本节点各个回放线程的各个流程的耗时统计（仅在备机上有有效数据）。 返回值如下： local_redo_time_count返回参数说明。 | 字段名 | 描述 | |:---|:---| | thread_name | 线程名字。 | | step1_total | step1的总时间，每个线程对应的流程如下： - 极致RTO： redo batch：从队列中获取一条日志。 redo manager：从队列中获取一条日志。 redo worker：从队列中获取一条日志。 trxn manager：从队列中读取一条日志。 trxn worker：从队列中读取一条日志。 read worker：从文件中读取一次xlog page（整体）。 read page worker：从队列中获取一个日志。 startup：从队列中获取一个日志。 - 并行回放： page redo：从队列中获取一条日志。 startup：读取一条日志。 | | step1_count | step1的统计次数。 | | step2_total | step2的总时间，每个线程对应的流程如下： - 极致RTO： redo batch：处理日志（整体）。 redo manager：处理日志（整体）。 redo worker：处理日志（整体）。 trxn manager：处理日志（整体）。 trxn worker：处理日志（整体）。 read worker：读取xlog page耗时。 read page worker：生成和发送lsn forwarder。 startup：check stop(是否回放到指定位置）。 - 并行回放： page redo：处理日志（整体）。 startup：check stop（是否回放到指定位置）。 | | step2_count | step2的统计次数。 | | step3_total | step3的总时间，每个线程对应的流程如下： - 极致RTO： redo batch：更新standbystate。 redo manager：数据日志处理。 redo worker：回放page页日志（整体）。 trxn manager：更新flush lsn。 trxn worker：回放日志处理。 read worker：推进xlog segment。 read page worker：获取一个新的item。 startup：redo delay（延迟回放特性等待时间）。 - 并行回放： page redo：更新standbystate。 startup：redo delay（延迟回放特性等待时间）。 | | step3_count | step3的统计次数。 | | step4_total | step4的总时间，每个线程对应的流程如下： - 极致RTO： redo batch：解析xLog。 redo manager：DDL处理。 redo worker：读取数据page页。 trxn manager：同步等待时间。 trxn worker：更新本线程lsn。 read page worker：将日志放入分发线程。 startup：分发（整体）。 - 并行回放： page redo：undo 日志回放。 startup：分发（整体）。 | | step4_count | step4的统计次数。 | | step5_total | step5的总时间，每个线程对应的流程如下： - 极致RTO： redo batch：分发给redo manager。 redo manager：分发给redo worker。 redo worker：回放数据page页的日志。 trxn manager：分发给trxn worker。 trxn worker：强同步wait时间。 read page worker：更新本线程lsn。 startup：日志decode。 - 并行回放： page redo：share trxn 日志回放。 startup：日志回放。 | | step5_count | step5的统计次数。 | | step6_total | step6的总时间，每个线程对应的流程如下： - 极致RTO： redo worker：回放非数据页page日志。 trxn manager：全局lsn更新。 redo manager：数据页面日志存入hash表日志crc校验。 - 并行回放： page redo：synctrxn日志回放。 startup：强同步等待。 | | step6_count | step6的统计次数。 | | step7_total | step7的总时间，每个线程对应的流程如下： - 极致RTO： redo manager：创建表空间。 redo worker：fsm更新。 - 并行回放： page redo：single日志回放。 | | step7_count | step7的统计次数。 | | step8_total | step8的总时间，每个线程对应的流程如下： - 极致RTO： redo worker：强同步等待。 - 并行回放： page redo：all workers do日志回放。 | | step8_count | step8的统计次数。 | | step9_total | step9的总时间，每个线程对应的流程如下： - 极致RTO： redo manager：分发日志给page redo线程。 - 并行回放： page redo：muliti workers do日志回放。 | | step9_count | step9的统计次数。 | - local_xlog_redo_statics() 描述：返回本节点已经回放的各个类型的日志统计信息（仅在备机上有有效数据）。 返回值如下： 表10local_xlog_redo_statics返回参数说明 | 字段名 | 描述 | |:---|:---| | xlog_type | 日志类型。 | | rmid | resource manager id。 | | info | xlog operation。 | | num | 日志个数。 | | extra | 针对page回放日志和xact日志有有效值。 - 如果是page页回放日志类型则表示从磁盘读取page的个数。 - 如果是xact日志类型则表示删除文件的个数。 | - gs_get_shared_memctx_detail(text) 描述：返回指定内存上下文上的内存申请的详细信息，包含每一处内存申请所在的文件、行号和大小（同一文件同一行大小会做累加）。只支持查询通过pg_shared_memory_detail视图查询出来的内存上下文，入参为内存上下文名称（即pg_shared_memory_detail返回结果的contextname列）。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | file | text | 申请内存所在文件的文件名。 | | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，同一文件同一行多次申请会做累加。 | ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 该视图不支持release版本小型化场景。 - gs_get_session_memctx_detail(text) 描述：返回指定内存上下文上的内存申请的详细信息，包含每一处内存申请所在的文件、行号和大小（同一文件同一行大小会做累加）。仅在线程池模式下生效。只支持查询通过gs_session_memory_context视图查询出来的内存上下文，入参为内存上下文名称（即gs_session_memory_context返回结果的contextname列）。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | file | text | 申请内存所在文件的文件名。 | | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，单位为byte，同一文件同一行多次申请会做累加。 | ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 该视图仅在线程池模式下生效，且该视图不支持release版本小型化场景。 - gs_get_history_memory_detail(cstring) 描述：查询历史内存快照信息，入参类型为cstring，取值为NULL或内存快照log文件名称： 1. 若入参为NULL，则显示当前节点所有的内存快照log文件列表。 2. 若入参为[1]查询到的列表中的内存快照log名称，则显示该log文件记录的内存快照详细信息。 3. 若输入其他入参，则会提示入参错误或打开文件失败。 查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：text | 名称 | 类型 | 描述 | |:---|:---|:---| | memory_info | text | 内存信息，如果函数入参为NULL，该列显示内存快照文件列表信息；入参为内存快照文件名称，则显示该文件的具体内容。 | - gs_stack() 描述：显示线程调用栈。查询该函数需要有SYSADMIN权限或者MONADMIN权限。 参数：tid，线程id。tid是可选参数，指定tid参数时，函数返回tid对应线程调用栈；当不指定tid参数时，函数返回所有线程的调用栈。 返回值：当指定tid时，返回值为text；当不指定tid时，返回值为setof record。 示例： select \* from gs_stack(tid)获取指定线程调用栈。 ``` gaussdb=# select * from gs_stack(139663481165568); gs_stack -------------------------------------------------------------------- __poll + 0x2d + WaitLatchOrSocket(Latch volatile*, int, int, long) + 0x29f + WaitLatch(Latch volatile*, int, long) + 0x2e + JobScheduleMain() + 0x90f + int GaussDbThreadMain<(knl_thread_role)9>(knl_thread_arg*) + 0x456+ InternalThreadFunc(void*) + 0x2d + ThreadStarterFunc(void*) + 0xa4 + start_thread + 0xc5 + clone + 0x6d + (1 row) ``` select \* from gs_stack()获取所有线程的调用栈。 ``` gaussdb=# select * from gs_stack(); -[ RECORD 1 ]------------------------------------------------------------------------------------------------------- tid | 139670364324352 lwtid | 308 stack | __poll + 0x2d | CommWaitPollParam::caller(int (*)(pollfd*, unsigned long, int), unsigned long) + 0x34 | int comm_socket_call(CommWaitPollParam*, int (*)(pollfd*, unsigned long , int)) + 0x28 | comm_poll(pollfd*, unsigned long, int) + 0xb1 | ServerLoop() + 0x72b | PostmasterMain(int, char**) + 0x314e | main + 0x617 | __libc_start_main + 0xf5 | 0x55d38f8db3a7 [ RECORD 2 ]------------------------------------------------------------------------------------------------------- tid | 139664851859200 lwtid | 520 stack | __poll + 0x2d | WaitLatchOrSocket(Latch volatile*, int, int, long) + 0x29f | SysLoggerMain(int) + 0xc86 | int GaussDbThreadMain<(knl_thread_role)17>(knl_thread_arg*) + 0x45d | InternalThreadFunc(void*) + 0x2d | ThreadStarterFunc(void*) + 0xa4 | start_thread + 0xc5 | clone + 0x6d ``` - gs_get_thread_memctx_detail(tid,text) 描述：返回指定内存上下文上的内存申请的详细信息，包含每一处内存申请所在的文件、行号和大小（同一文件同一行大小会做累加）。只支持查询通过gs_thread_memory_context视图查询出来的内存上下文，第一个入参为线程id（即gs_thread_memory_context返回数据的tid列），第二个参数为内存上下文名称（即gs_thread_memory_context返回数据的contextname列）。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | file | text | 申请内存所在文件的文件名。 | | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，单位为byte，同一文件同一行多次申请会做累加。 | ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 该视图不支持release版本小型化场景。 - gs_tpworker_execstmt_stat() 描述：描述语句的运行时信息，SYSADMIN和MONADMIN用户执行则显示全部正在执行的语句的信息，普通用户查询只能查询自己执行的SQL语句的信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | db_oid | oid | 用户会话在后台连接到的数据库OID。 | | db_name | name | 用户会话在后台连接到的数据库名称。 | | threadpool_worker | varchar | 线程所属的numagroup和线程的ID，格式如下：numagroup_threadid。 | | thread_id | bigint | 线程ID。 | | session_id | bigint | 会话ID。 | | query_id | bigint | 正在执行的SQL语句的ID。 | | query_text | text | 正在执行的SQL语句内容。 | | unique_sql_id | bigint | SQL语句生成的唯一id。 | | client_hostname | text | 客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。 | | client_app_name | text | 客户端app的名字。 | | stmt_slow_time_threshold | int | 单位毫秒，SQL语句被标记为慢SQL的预设超时时间。 | | stmt_start_time | timestamp with time zone | 语句执行的开始时间。如果是存储过程、函数、PACKAGE，则查询的是第一个查询时间，不会随着存储过程内语句运行而改变。 | | stmt_elapse_time | int | 距离查询开始执行时已经过去的时间。 | | stmt_control_status | varchar | 当前语句状态： - Waiting：等待状态，session接入未获得线程执行。 - Running：当前语句正常执行。 - Control：当前语句进入了资源管控阶段。 | | stmt_control_rule | text | 当前语对应的慢SQL管控规则。 | | stmt_control_iostat | text | 当前语句的iops值和最大iops上限。格式如下： curVal/maxVal | | stmt_control_memstat | text | 当前字段预留，暂不支持。 | | stmt_control_cpustat | text | 当前字段预留，暂不支持。 | | stmt_control_netstat | text | 当前字段预留，暂不支持。 | - gs_tpworker_execslot_stat() 描述：描述线程的运行时信息，SYSADMIN和MONADMIN用户执行则显示全部线程的信息，普通用户查询只能查询自己执行的SQL语句所在的线程的信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | numagroup | int | 当前线程所属的numagroup。 | | worker_id | int | 当前线程的ID。 | | worker_bind_type | text | 线程绑定方式numabind, cpubind, allbind，nobind。 | | worker_cpu_affinity | text | 线程和CPU的亲和性，即线程可以调度的cpu核数范围。 | | worker_status | varchar | 当前线程状态： - Waiting：等待状态，session接入未获得线程执行。 - Running：当前语句正常执行。 - Control：当前语句进入了资源管控阶段。 | | served_query_id | bigint | 正在执行的SQL语句的ID。 | | served_query_text | text | 正在执行的SQL语句内容。 | - gs_session_all_settings(sessionid bigint) 描述：查询本节点上sessionid对应的session的全量GUC参数配置。需要SYSADMIN或者MONADMIN权限执行。 入参说明：sessionid，会话ID。 返回值类型：setof record 函数返回字段说明如下： | 名称 | 类型 | 描述 | |:---|:---|:---| | name | text | 参数名称。 | | setting | text | 参数当前值。 | | unit | text | 参数的隐式单位。 | 示例： ``` gaussdb=# select sessionid from pg_stat_activity where usename = 'testuser'; sessionid ----------- 788861 (1 row) gaussdb=# select * from gs_session_all_settings(788861) where name = 'work_mem'; name | setting | unit ----------+---------+------ work_mem | 131072 | kB (1 row) ``` - gs_session_all_settings() 描述：查询本节点上所有session的全量GUC参数配置。需要SYSADMIN或者MONADMIN权限执行。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | sessionid | bigint | 会话的ID。 | | pid | bigint | 后端线程的ID。 | | name | text | 参数名称。 | | setting | text | 参数当前值。 | | unit | text | 参数的隐式单位。 | 示例： ``` gaussdb=# select * from gs_session_all_settings() where name = 'work_mem'; sessionid | pid | name | setting | unit -----------------+-----------------+----------+---------+------ 140550214145792 | 96974 | work_mem | 65536 | kB 140550214145792 | 96971 | work_mem | 65536 | kB 140549731735296 | 140549731735296 | work_mem | 65536 | kB 140549764413184 | 140549764413184 | work_mem | 65536 | kB (4 rows) ``` - gs_local_wal_preparse_statistics() 描述：查询本节点上日志预解析线程最近一次启动，预解析日志的情况。需要SYSADMIN权限执行。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | preparser_term | text | 最近一次预解析日志得到的最大term值。 | | preparser_start_time | timestamptz | 最近一次预解析启动时间。 | | preparser_end_time | timestamptz | 最近一次预解析结束时间。 | | preparser_start_location | text | 最近一次预解析日志起始位置。 | | preparser_end_location | text | 最近一次预解析日志结束位置。 | | preparser_total_bytes | int8 | 最近一次预解析日志量，单位：byte。 | | preparser_speed | int8 | 最近一次预解析速度，单位：byte/ms。 | | is_valid | bool | 最近一次预解析结果是否可以用于选主。 | 示例： ``` gaussdb=# select * from gs_local_wal_preparse_statistics(); preparser_term | preparser_start_time | preparser_end_time | preparser_start_location | preparser_end_location | preparser_total_bytes | preparser_speed | is_valid ----------------+-------------------------------+-------------------------------+--------------------------+------------------------+-----------------------+-----------------+---------- 3107 | 2023-02-01 17:04:23.367946+08 | 2023-02-01 17:04:25.354434+08 | 00000003/C3EEA660 | 00000004/0BE60738 | 1207394520 | 1207394520 | f (1 row) ``` - gs_hot_standby_space_info() 描述：查询standby_read/base_page，standby_read/block_info_meta，standby_read/lsn_info_meta文件夹中的文件总数和总大小。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | base_page_file_num | xid | bage_page_file的总数量。 | | base_page_total_size | xid | bage_page_file的总大小。 | | lsn_info_meta_file_num | xid | lsn_info_meta_file的总数量。 | | lsn_info_meta_total_size | xid | lsn_info_meta_file的总大小。 | | block_info_meta_file_num | xid | block_info_meta_file的总数量。 | | block_info_meta_total_size | xid | block_info_meta_file的总大小。 | 示例： ``` gaussdb=# select * from gs_hot_standby_space_info(); base_page_file_num | base_page_total_size | lsn_info_meta_file_num | lsn_info_meta_total_size | block_info_meta_file_num | block_info_meta_total_size --------------------+----------------------+------------------------+--------------------------+--------------------------+---------------------------- 6 | 163840 | 6 | 3136 | 16 | 147456 (1 row) ``` - exrto_file_read_stat() 描述：查询备机读新增的base page file、lsn info meta file和block info meta file三种类型的文件磁盘访问次数和访问总时延。连接备DN查询，其他情况查询结果为0。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | lsn_info_page_disk_read_counter | int8 | lsn info meta file的磁盘访问次数。 | | lsn_info_page_disk_read_dur | int8 | lsn info meta file的磁盘访问总时延。 | | blk_info_meta_disk_read_counter | int8 | block info meta file的磁盘访问次数。 | | blk_info_meta_disk_read_dur | int8 | block info meta file的磁盘访问总时延。 | | base_page_read_disk_counter | int8 | base page file的磁盘访问次数。 | | base_page_read_disk_dur | int8 | base page file的磁盘访问总时延。 | 示例： ``` gaussdb=# SELECT * FROM exrto_file_read_stat(); lsn_info_page_disk_read_counter | lsn_info_page_disk_read_dur | blk_info_meta_disk_read_counter | blk_info_meta_disk_read_dur | base_page_read_disk_counter | base_page_read_disk_dur ---------------------------------+-----------------------------+---------------------------------+-----------------------------+-----------------------------+------------------------- 14987 | 92313 | 23879 | 129811 | 0 | 0 (1 row) ``` - gs_exrto_recycle_info() 描述：查询资源回收位置，其中包括每个线程的回收lsn，全局回收的lsn，查询线程最老的快照的lsn。连接备DN查询，其他情况查询结果为0。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | page_redo_worker_thread_id | text | redo线程的回收lsn位置，其中thread_id为redo线程的线程id。 | | global_recycle_lsn | text | 全局回收位置的lsn。 | | exrto_snapshot_oldest_lsn | text | 查询线程的最老的快照lsn。 | 示例： ``` gaussdb=# SELECT * FROM gs_exrto_recycle_info(); thread_id | recycle_lsn ----------------------------------+------------- page_redo_worker_140148895381248 | 0/7B4552E0 page_redo_worker_140148872312576 | 0/7B4535B8 global_recycle_lsn | 0/7B4535B8 exrto_snapshot_oldest_lsn | 0/8488E6D0 (4 rows) ``` - gs_stat_get_db_conflict_all(oid) 入参说明：dbid(oid)为数据库的oid。 描述：查询发送不同类型回放冲突信号的数量。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | conflict_all | int8 | 发送回放冲突信号的总数量。 | | conflict_tablespace | int8 | 发送tablespace类型回放冲突信号的数量。 | | conflict_lock | int8 | 发送lock类型回放冲突信号的数量。 | | conflict_snapshot | int8 | 发送snapshot类型回放冲突信号的数量。 | | conflict_bufferpin | int8 | 发送bufferpin类型回放冲突信号的数量。 | | conflict_startup_deadlock | int8 | 发送startup_deadlock类型回放冲突信号的数量。 | | conflict_truncate | int8 | 发送truncate类型回放冲突信号的数量。 | | conflict_standby_query_timeout | int8 | 发送standby_query_timeout类型回放冲突信号的数量。 | | conflict_force_recycle | int8 | 发送force_recycle类型回放冲突信号的数量。 | 示例： ``` gaussdb=# SELECT * FROM gs_stat_get_db_conflict_all(12738); conflict_all | conflict_tablespace | conflict_lock | conflict_snapshot | conflict_bufferpin | conflict_startup_deadlock | conflict_truncate | conflict_standby_query_timeout | conflict_force_recycle --------------+---------------------+---------------+-------------------+--------------------+---------------------------+-------------------+--------------------------------+------------------------ 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 (1 row) ``` - gs_redo_stat_info() 描述：查询回放信息。包括回放线程的buffer命中率、执行unlink_rels文件数量、极致RTO场景下回放线程读取buffer时产生I/O操作的waitevent信息以及wal_read_from_write_buffer的waitevent信息。需要连接备DN查询。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | buffer_hit_rate | float8 | 回放线程的buffer命中率。 | | ddl_unlink_nrels_count | int8 | 回放DDL操作执行unlink rel文件的数量。 | | read_buffer_io_counter | int8 | 极致RTO场景下，回放线程读取buffer时产生I/O操作的waitevent触发次数。 | | read_buffer_io_total_dur | int8 | 极致RTO场景下，回放线程读取buffer时产生I/O操作的waitevent总用时。 | | read_buffer_io_avg_dur | int8 | 极致RTO场景下，回放线程读取buffer时产生I/O操作的waitevent平均用时。 | | read_buffer_io_min_dur | int8 | 极致RTO场景下，回放线程读取buffer时产生I/O操作的waitevent最小用时。 | | read_buffer_io_max_dur | int8 | 极致RTO场景下，回放线程读取buffer时产生I/O操作的waitevent最大用时。 | | read_wal_buf_counter | int8 | 极致RTO场景下，wal_read_from_write_buffer的waitevent触发次数。 | | read_wal_buf_total_dur | int8 | 极致RTO场景下，wal_read_from_write_buffer的waitevent总用时。 | | read_wal_buf_avg_dur | int8 | 极致RTO场景下，wal_read_from_write_buffer的waitevent平均用时。 | | read_wal_buf_min_dur | int8 | 极致RTO场景下，wal_read_from_write_buffer的waitevent最小用时。 | | read_wal_buf_max_dur | int8 | 极致RTO场景下，wal_read_from_write_buffer的waitevent最大用时。 | 示例： ``` gaussdb=# SELECT * FROM gs_redo_stat_info(); -[ RECORD 1 ]------------+---------- buffer_hit_rate | 70.5707 ddl_unlink_nrels_count | 3 read_buffer_io_counter | 1732 read_buffer_io_total_dur | 2850806 read_buffer_io_avg_dur | 1645 read_buffer_io_min_dur | 3 read_buffer_io_max_dur | 981639 read_wal_buf_counter | 9779 read_wal_buf_total_dur | 193612470 read_wal_buf_avg_dur | 19798 read_wal_buf_min_dur | 3 read_wal_buf_max_dur | 1914777 ``` - gs_recovery_conflict_waitevent_info() 描述：查询处理回放冲突的函数的waitevent相关信息。需要连接备DN查询。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | conflict_lock_counter | int8 | 处理LOCK类型回放冲突的触发次数。 | | conflict_lock_total_dur | int8 | 处理LOCK类型回放冲突的总用时。 | | conflict_lock_avg_dur | int8 | 处理LOCK类型回放冲突的平均用时。 | | conflict_lock_min_dur | int8 | 处理LOCK类型回放冲突的最小用时。 | | conflict_lock_max_dur | int8 | 处理LOCK类型回放冲突的最大用时。 | | conflict_snapshot_counter | int8 | 处理SNAPSHOT类型回放冲突的触发次数。 | | conflict_snapshot_total_dur | int8 | 处理SNAPSHOT类型回放冲突的总用时。 | | conflict_snapshot_avg_dur | int8 | 处理SNAPSHOT类型回放冲突的平均用时。 | | conflict_snapshot_min_dur | int8 | 处理SNAPSHOT类型回放冲突的最小用时。 | | conflict_snapshot_max_dur | int8 | 处理SNAPSHOT类型回放冲突的最大用时。 | | conflict_tablespace_counter | int8 | 处理TABLESPACE类型回放冲突的触发次数。 | | conflict_tablespace_total_dur | int8 | 处理TABLESPACE类型回放冲突的总用时。 | | conflict_tablespace_avg_dur | int8 | 处理TABLESPACE类型回放冲突的平均用时。 | | conflict_tablespace_min_dur | int8 | 处理TABLESPACE类型回放冲突的最小用时。 | | conflict_tablespace_max_dur | int8 | 处理TABLESPACE类型回放冲突的最大用时。 | | conflict_database_counter | int8 | 处理DATABASE类型回放冲突的触发次数。 | | conflict_database_total_dur | int8 | 处理DATABASE类型回放冲突的总用时。 | | conflict_database_avg_dur | int8 | 处理DATABASE类型回放冲突的平均用时。 | | conflict_database_min_dur | int8 | 处理DATABASE类型回放冲突的最小用时。 | | conflict_database_max_dur | int8 | 处理DATABASE类型回放冲突的最大用时。 | | conflict_truncate_counter | int8 | 处理TRUNCATE类型回放冲突的触发次数。 | | conflict_truncate_total_dur | int8 | 处理TRUNCATE类型回放冲突的总用时。 | | conflict_truncate_avg_dur | int8 | 处理TRUNCATE类型回放冲突的平均用时。 | | conflict_truncate_min_dur | int8 | 处理TRUNCATE类型回放冲突的最小用时。 | | conflict_truncate_max_dur | int8 | 处理TRUNCATE类型回放冲突的最大用时。 | | conflict_standby_query_timeout_counter | int8 | 处理STANDBY_QUERY_TIMEOUT类型回放冲突的触发次数。 | | conflict_standby_query_timeout_total_dur | int8 | 处理STANDBY_QUERY_TIMEOUT类型回放冲突的总用时。 | | conflict_standby_query_timeout_avg_dur | int8 | 处理STANDBY_QUERY_TIMEOUT类型回放冲突的平均用时。 | | conflict_standby_query_timeout_min_dur | int8 | 处理STANDBY_QUERY_TIMEOUT类型回放冲突的最小用时。 | | conflict_standby_query_timeout_max_dur | int8 | 处理STANDBY_QUERY_TIMEOUT类型回放冲突的最大用时。 | | conflict_force_recycle_counter | int8 | 处理FORCE_RECYCLE类型回放冲突的触发次数。 | | conflict_force_recycle_total_dur | int8 | 处理FORCE_RECYCLE类型回放冲突的总用时。 | | conflict_force_recycle_avg_dur | int8 | 处理FORCE_RECYCLE类型回放冲突的平均用时。 | | conflict_force_recycle_min_dur | int8 | 处理FORCE_RECYCLE类型回放冲突的最小用时。 | | conflict_force_recycle_max_dur | int8 | 处理FORCE_RECYCLE类型回放冲突的最大用时。 | 示例： ``` gaussdb=# SELECT * FROM gs_recovery_conflict_waitevent_info(); -[ RECORD 1 ]----------------------------+------ conflict_lock_counter | 0 conflict_lock_total_dur | 0 conflict_lock_avg_dur | 0 conflict_lock_min_dur | 0 conflict_lock_max_dur | 0 conflict_snapshot_counter | 0 conflict_snapshot_total_dur | 0 conflict_snapshot_avg_dur | 0 conflict_snapshot_min_dur | 0 conflict_snapshot_max_dur | 0 conflict_tablespace_counter | 0 conflict_tablespace_total_dur | 0 conflict_tablespace_avg_dur | 0 conflict_tablespace_min_dur | 0 conflict_tablespace_max_dur | 0 conflict_database_counter | 0 conflict_database_total_dur | 0 conflict_database_avg_dur | 0 conflict_database_min_dur | 0 conflict_database_max_dur | 0 conflict_truncate_counter | 6 conflict_truncate_total_dur | 35872 conflict_truncate_avg_dur | 5978 conflict_truncate_min_dur | 5130 conflict_truncate_max_dur | 7459 conflict_standby_query_timeout_counter | 0 conflict_standby_query_timeout_total_dur | 0 conflict_standby_query_timeout_avg_dur | 0 conflict_standby_query_timeout_min_dur | 0 conflict_standby_query_timeoutmax_dur | 0 conflict_force_recycle_counter | 0 conflict_force_recycle_total_dur | 0 conflict_force_recycle_avg_dur | 0 conflict_force_recycle_min_dur | 0 conflict_force_recycle_max_dur | 0 ``` - gs_display_delay_ddl_info() 描述：查看备机中延迟删除的文件信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | type | INT4 | 删除操作的对象是表或数据库。 | | lsn | TEXT | 标识特定日志文件记录在此日志文件中的位置。 | | tablespace | INT4 | 数据库中用于存储表和索引的物理空间。 | | database | INT4 | 该数据库的物理存储位置。 | | relation | INT4 | 数据库中的对象，可以是表、视图、索引的物理位置。 | | bucketid | INT4 | 指定关系对象所属的bucket。 | | opt | INT4 | 压缩表相关属性。 | | forknum | INT4 | 主体命名之后的后缀命名，通过主体命名和后缀命名，可以找到唯一的物理文件。 | 示例： ``` gaussdb=# SELECT * FROM gs_display_delay_ddl_info(); type | lsn | tablespace | database | relation | bucketid | opt | forknum ------+-----+------------+----------+----------+----------+-----+--------- (0 rows) ``` #### 分区表统计信息函数 - gs_stat_get_partition_stats(oid) 描述：获取特定分区的统计信息。 返回值类型：record - gs_stat_get_xact_partition_stats(oid) 描述：获取特定分区的事务中统计信息。 返回值类型：record - gs_stat_get_all_partitions_stats() 描述：获取所有分区的统计信息。 返回值类型：setof record - gs_stat_get_xact_all_partitions_stats() 描述：获取所有分区的事务中统计信息。 返回值类型：setof record - gs_statio_get_all_partitions_stats() 描述：获取所有分区的I/O统计信息。 返回值类型：setof record 上述五个函数示例： ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/caution_3.0-zh-cn.png) 运行时统计信息上报是异步的，且基于UDP协议，后台线程处理可能存在延迟和丢包，此处示例预期仅供参考。 事务外统计信息查询 ``` gaussdb=# CREATE TABLE part_tab1 gaussdb-# ( gaussdb(# a int, b int gaussdb gaussdb-# PARTITION BY RANGE(b) gaussdb-# ( gaussdb, gaussdb, gaussdb gaussdb; CREATE TABLE gaussdb=# CREATE TABLE subpart_tab1 gaussdb-# ( gaussdb NOT NULL , gaussdb NOT NULL , gaussdb NOT NULL , gaussdb(# sales_amt int gaussdb gaussdb-# PARTITION BY RANGE (month_code) SUBPARTITION BY RANGE (dept_code) gaussdb-# ( gaussdb gaussdb(# ( gaussdb, gaussdb gaussdb, gaussdb gaussdb(# ( gaussdb, gaussdb gaussdb gaussdb; CREATE TABLE gaussdb=# CREATE INDEX index_part_tab1 ON part_tab1(b) LOCAL gaussdb-# ( gaussdb(# PARTITION b_index1, gaussdb(# PARTITION b_index2, gaussdb(# PARTITION b_index3 gaussdb; CREATE INDEX gaussdb=# CREATE INDEX idx_user_no ON subpart_tab1(user_no) LOCAL; CREATE INDEX gaussdb=# INSERT INTO part_tab1 VALUES(1, 1); INSERT 0 1 gaussdb=# INSERT INTO part_tab1 VALUES(1, 11); INSERT 0 1 gaussdb=# INSERT INTO part_tab1 VALUES(1, 21); INSERT 0 1 gaussdb=# UPDATE part_tab1 SET a = 2 WHERE b = 1; UPDATE 1 gaussdb=# UPDATE part_tab1 SET a = 3 WHERE b = 11; UPDATE 1 gaussdb=# UPDATE /*+ indexscan(part_tab1) */ part_tab1 SET a = 4 WHERE b = 21; UPDATE 1 gaussdb=# DELETE FROM part_tab1; DELETE 3 gaussdb=# ANALYZE part_tab1; ANALYZE gaussdb=# VACUUM part_tab1; VACUUM gaussdb=# INSERT INTO subpart_tab1 VALUES('201902', '1', '1', 1); INSERT 0 1 gaussdb=# INSERT INTO subpart_tab1 VALUES('201902', '2', '2', 1); INSERT 0 1 gaussdb=# INSERT INTO subpart_tab1 VALUES('201903', '1', '3', 1); INSERT 0 1 gaussdb=# INSERT INTO subpart_tab1 VALUES('201903', '2', '4', 1); INSERT 0 1 gaussdb=# UPDATE subpart_tab1 SET sales_amt = 2 WHERE user_no='1'; UPDATE 1 gaussdb=# UPDATE subpart_tab1 SET sales_amt = 3 WHERE user_no='2'; UPDATE 1 gaussdb=# UPDATE subpart_tab1 SET sales_amt = 4 WHERE user_no='3'; UPDATE 1 gaussdb=# UPDATE /*+ indexscan(subpart_tab1) */ subpart_tab1 SET sales_amt = 5 WHERE user_no='4'; UPDATE 1 gaussdb=# DELETE FROM subpart_tab1; DELETE 4 gaussdb=# ANALYZE subpart_tab1; ANALYZE gaussdb=# VACUUM subpart_tab1; VACUUM gaussdb=# SELECT * FROM gs_stat_all_partitions; partition_oid | schemaname | relname | partition_name | sub_partition_name | seq_scan | seq_tup_read | idx_scan | idx_tup_fetch | n_tup_ins | n_tup_upd | n_tup_del | n_tup_hot_upd | n_live_tup | n_dead_tup | last_vacuum | last_autovacuum | last_analyze | last_autoanalyze | vacuum_count | autovacuum_count | analyze_count | autoanalyze_count ---------------+------------+--------------+----------------+--------------------+----------+--------------+----------+---------------+-----------+-----------+-----------+---------------+------------+ ------------+-------------------------------+------------------------+-------------------------------+------------------------+--------------+------------------+---------------+------------------- 16964 | public | subpart_tab1 | p_201902 | p_201902_b | 5 | 1 | 4 | 1 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:45.293965+08 | 2000-01-01 08:00:00+08 | 2023-05-15 20:36:44.688861+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 16963 | public | subpart_tab1 | p_201902 | p_201902_a | 5 | 1 | 4 | 0 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:45.291022+08 | 2000-01-01 08:00:00+08 | 2023-05-15 20:36:44.688843+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 16961 | public | subpart_tab1 | p_201901 | p_201901_b | 5 | 1 | 4 | 0 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:45.288037+08 | 2000-01-01 08:00:00+08 | 2023-05-15 20:36:44.688829+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 16960 | public | subpart_tab1 | p_201901 | p_201901_a | 5 | 1 | 4 | 0 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:45.285311+08 | 2000-01-01 08:00:00+08 | 2023-05-15 20:36:44.688802+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 16954 | public | part_tab1 | p3 | | 2 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:29.490636+08 | 2000-01-01 08:00:00+08 | 2023-05-15 20:36:28.540115+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 16953 | public | part_tab1 | p2 | | 4 | 1 | 1 | 0 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:29.487914+08 | 2000-01-01 08:00:00+08 | 2023-05-15 20:36:28.540098+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 16952 | public | part_tab1 | p1 | | 5 | 1 | 1 | 0 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:29.48536+08 | 2000-01-01 08:00:00+08 | 2023-05-15 20:36:28.540071+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 (7 rows) gaussdb=# SELECT * FROM gs_statio_all_partitions; partition_oid | schemaname | relname | partition_name | sub_partition_name | heap_blks_read | heap_blks_hit | idx_blks_read | idx_blks_hit | toast_blks_read | toast_blks_hit | tidx_blks_read | t idx_blks_hit ---------------+------------+--------------+----------------+--------------------+----------------+---------------+---------------+--------------+-----------------+----------------+----------------+-- ------------- 16964 | public | subpart_tab1 | p_201902 | p_201902_b | 4 | 8 | 2 | 21 | | | | 16963 | public | subpart_tab1 | p_201902 | p_201902_a | 4 | 8 | 2 | 21 | | | | 16961 | public | subpart_tab1 | p_201901 | p_201901_b | 4 | 8 | 2 | 21 | | | | 16960 | public | subpart_tab1 | p_201901 | p_201901_a | 4 | 8 | 2 | 21 | | | | 16954 | public | part_tab1 | p3 | | 4 | 8 | 2 | 15 | | | | 16953 | public | part_tab1 | p2 | | 4 | 8 | 2 | 15 | | | | 16952 | public | part_tab1 | p1 | | 4 | 8 | 2 | 15 | | | | (7 rows) gaussdb=# SELECT * FROM gs_stat_get_partition_stats(16952); partition_oid | seq_scan | seq_tup_read | idx_scan | idx_tup_fetch | n_tup_ins | n_tup_upd | n_tup_del | n_tup_hot_upd | n_live_tup | n_dead_tup | last_vacuum | last_autovacuum | last_analyze | last_autoanalyze | vacuum_count | autovacuum_count | analyze_count | autoanalyze_count | last_data_changed | heap_blks_read | heap_blks_hit | idx_blks_re ad | idx_blks_hit | tup_fetch | block_fetch ---------------+----------+--------------+----------+---------------+-----------+-----------+-----------+---------------+------------+------------+------------------------------+---------------------- --+-------------------------------+------------------------+--------------+------------------+---------------+-------------------+------------------------+----------------+---------------+------------ ---+--------------+-----------+------------- 16952 | 5 | 1 | 1 | 0 | 1 | 1 | 1 | 1 | 0 | 1 | 2023-05-15 20:36:29.48536+08 | 2000-01-01 08:00:00+0 8 | 2023-05-15 20:36:28.540071+08 | 2000-01-01 08:00:00+08 | 1 | 0 | 1 | 0 | 2000-01-01 08:00:00+08 | 4 | 8 | 2 | 21 | 0 | 12 (1 row) ``` 事务内统计信息查询： ``` gaussdb=# BEGIN; BEGIN gaussdb=# INSERT INTO part_tab1 VALUES(1, 1); INSERT 0 1 gaussdb=# INSERT INTO part_tab1 VALUES(1, 11); INSERT 0 1 gaussdb=# INSERT INTO part_tab1 VALUES(1, 21); INSERT 0 1 gaussdb=# UPDATE part_tab1 SET a = 2 WHERE b = 1; UPDATE 1 gaussdb=# UPDATE part_tab1 SET a = 3 WHERE b = 11; UPDATE 1 gaussdb=# UPDATE /*+ indexscan(part_tab1) */ part_tab1 SET a = 4 WHERE b = 21; UPDATE 1 gaussdb=# DELETE FROM part_tab1; DELETE 3 gaussdb=# INSERT INTO subpart_tab1 VALUES('201902', '1', '1', 1); INSERT 0 1 gaussdb=# INSERT INTO subpart_tab1 VALUES('201902', '2', '2', 1); INSERT 0 1 gaussdb=# INSERT INTO subpart_tab1 VALUES('201903', '1', '3', 1); INSERT 0 1 gaussdb=# INSERT INTO subpart_tab1 VALUES('201903', '2', '4', 1); INSERT 0 1 gaussdb=# UPDATE subpart_tab1 SET sales_amt = 2 WHERE user_no='1'; UPDATE 1 gaussdb=# UPDATE subpart_tab1 SET sales_amt = 3 WHERE user_no='2'; UPDATE 1 gaussdb=# UPDATE subpart_tab1 SET sales_amt = 4 WHERE user_no='3'; UPDATE 1 gaussdb=# UPDATE /*+ indexscan(subpart_tab1) */ subpart_tab1 SET sales_amt = 5 WHERE user_no='4'; UPDATE 1 gaussdb=# DELETE FROM subpart_tab1; DELETE 4 gaussdb=# SELECT * FROM gs_stat_xact_all_partitions; partition_oid | schemaname | relname | partition_name | sub_partition_name | seq_scan | seq_tup_read | idx_scan | idx_tup_fetch | n_tup_ins | n_tup_upd | n_tup_del | n_tup_hot_upd ---------------+------------+--------------+----------------+--------------------+----------+--------------+----------+---------------+-----------+-----------+-----------+--------------- 16964 | public | subpart_tab1 | p_201902 | p_201902_b | 4 | 4 | 1 | 2 | 1 | 1 | 1 | 1 16963 | public | subpart_tab1 | p_201902 | p_201902_a | 4 | 4 | 1 | 0 | 1 | 1 | 1 | 1 16961 | public | subpart_tab1 | p_201901 | p_201901_b | 4 | 4 | 1 | 0 | 1 | 1 | 1 | 1 16960 | public | subpart_tab1 | p_201901 | p_201901_a | 4 | 4 | 1 | 0 | 1 | 1 | 1 | 1 16954 | public | part_tab1 | p3 | | 1 | 1 | 1 | 2 | 1 | 1 | 1 | 1 16953 | public | part_tab1 | p2 | | 3 | 2 | 0 | 0 | 1 | 1 | 1 | 1 16952 | public | part_tab1 | p1 | | 4 | 2 | 0 | 0 | 1 | 1 | 1 | 1 (7 rows) gaussdb=# SELECT * FROM gs_stat_get_xact_partition_stats(16952); partition_oid | seq_scan | seq_tup_read | idx_scan | idx_tup_fetch | n_tup_ins | n_tup_upd | n_tup_del | n_tup_hot_upd | tup_fetch ---------------+----------+--------------+----------+---------------+-----------+-----------+-----------+---------------+----------- 16952 | 4 | 2 | 0 | 0 | 1 | 1 | 1 | 1 | 0 (1 row) -- 删除表 gaussdb=# DROP TABLE part_tab1; DROP TABLE gaussdb=# DROP TABLE subpart_tab1; DROP TABLE ``` - gs_stat_get_partition_analyze_count(oid) 描述：用户在该分区上启动分析的次数 返回值类型：bigint - gs_stat_get_partition_autoanalyze_count(oid) 描述：autovacuum守护进程在该分区上启动分析的次数。 返回值类型：bigint - gs_stat_get_partition_autovacuum_count(oid) 描述：autovacuum守护进程在该分区上启动清理的次数。 返回值类型：bigint - gs_stat_get_partition_last_analyze_time(oid) 描述：用户在该分区上最后一次手动启动分析或者autovacuum线程启动分析的时间。 返回值类型：timestamptz - gs_stat_get_partition_last_autoanalyze_time(oid) 描述：autovacuum守护进程在该分区上最后一次启动分析的时间。 返回值类型：timestamptz - gs_stat_get_partition_last_autovacuum_time(oid) 描述：autovacuum守护进程在该分区上最后一次启动清理的时间。 返回值类型：timestamptz - gs_stat_get_partition_last_data_changed_time(oid) 描述：对于在分区上的修改insert/update/delete/truncate，在该表上最后一次操作的时间。当前暂不支持。 返回值类型：timestamptz - gs_stat_get_partition_last_vacuum_time(oid) 描述：用户在该分区上最后一次手动启动清理或者autovacuum线程启动清理的时间。 返回值类型：timestamptz - gs_stat_get_partition_numscans(oid) 描述：分区顺序扫描读取的行数目。 返回值类型：bigint - gs_stat_get_partition_tuples_returned(oid) 描述：分区顺序扫描读取的行数目。 返回值类型：bigint - gs_stat_get_partition_tuples_fetched(oid) 描述：分区位图扫描抓取的行数目。 返回值类型：bigint - gs_stat_get_partition_vacuum_count(oid) 描述：用户在该分区上启动清理的次数。 返回值类型：bigint - gs_stat_get_xact_partition_tuples_fetched(oid) 描述：事务中扫描的tuple行数。 返回值类型：bigint - gs_stat_get_xact_partition_numscans(oid) 描述：当前事务中分区执行的顺序扫描次数。 返回值类型：bigint - gs_stat_get_xact_partition_tuples_returned(oid) 描述：当前事务中分区通过顺序扫描读取的行数。 返回值类型：bigint - gs_stat_get_partition_blocks_fetched(oid) 描述：分区的磁盘块抓取请求的数量。 返回值类型：bigint - gs_stat_get_partition_blocks_hit(oid) 描述：在缓冲区中找到的分区的磁盘块请求数目。 返回值类型：bigint - pg_stat_get_partition_tuples_inserted(oid) 描述：插入相应表分区中行的数量。 返回值类型：bigint - pg_stat_get_partition_tuples_updated(oid) 描述：在相应表分区中已更新行的数量。 返回值类型：bigint - pg_stat_get_partition_tuples_deleted(oid) 描述：从相应表分区中删除行的数量。 返回值类型：bigint - pg_stat_get_partition_tuples_changed(oid) 描述：该表分区上一次analyze或autoanalyze之后插入、更新、删除行的总数量。 返回值类型：bigint - pg_stat_get_partition_live_tuples(oid) 描述：分区表活行数。 返回值类型：bigint - pg_stat_get_partition_dead_tuples(oid) 描述：分区表死行数。 返回值类型：bigint - pg_stat_get_xact_partition_tuples_inserted(oid) 描述：表分区相关的活跃子事务中插入的tuple数。 返回值类型：bigint - pg_stat_get_xact_partition_tuples_deleted(oid) 描述：表分区相关的活跃子事务中删除的tuple数。 返回值类型：bigint - pg_stat_get_xact_partition_tuples_hot_updated(oid) 描述：表分区相关的活跃子事务中热更新的tuple数。 返回值类型：bigint - pg_stat_get_xact_partition_tuples_updated(oid) 描述：表分区相关的活跃子事务中更新的tuple数。 返回值类型：bigint - pg_stat_get_partition_tuples_hot_updated(oid) 描述：返回给定分区id的分区热更新元组数的统计。 参数：oid 返回值类型：bigint