# 统计信息函数 统计信息函数根据访问对象分为两种类型：针对某个数据库进行访问的函数，以数据库中每个表或索引的OID作为参数，标识需要报告的数据库；针对某个服务器进行访问的函数，以一个服务器线程号为参数，其范围从1到当前活跃服务器的数目。 - pg_stat_get_db_conflict_tablespace(oid) 描述：由于恢复与数据库中删除的表空间发生冲突而取消的查询数。 返回值类型：bigint - pg_stat_get_db_conflict_truncate(oid) 描述：由于与数据库中在回放的truncate操作发生冲突而取消的查询数。 返回值类型：bigint - pg_stat_get_db_conflict_force_recycle(oid) 描述：由于极致RTO备机读触发强制回收而取消的查询数。 返回值类型：bigint - pg_stat_get_db_conflict_standby_query_timeout(oid) 描述：由于超过极致RTO备机读设置的查询时间上限而取消的查询数。 返回值类型：bigint - pg_stat_get_db_conflict_bufferpin(oid) 描述：冲突的缓冲区数目。 返回值类型：bigint - pg_stat_get_db_conflict_snapshot(oid) 描述：冲突的快照数目。 返回值类型：bigint - pg_stat_get_db_conflict_startup_deadlock(oid) 描述：冲突的死锁数目。 返回值类型：bigint - pg_stat_get_db_conflict_all(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_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_lock_status() 描述：查询打开事务所持有的锁信息，所有用户均可执行该函数。 返回值类型：返回字段可参考[PG_LOCKS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1322.html)视图返回字段，该视图是通过查询本函数得到的结果。 - bucket_lock_status() 描述：查询打开事务所持有的bucket锁信息，所有用户均可执行该函数。 返回值类型：返回字段可参考[GS_BUCKET_LOCKS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1257.html)视图返回字段中除node_name之外的字段。 - gs_bucket_lock_status() 描述：查询所有节点中的打开事务所持有的bucket锁信息，所有用户均可执行该函数。 返回值类型：返回字段可参考[GS_BUCKET_LOCKS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1257.html)视图返回字段，该视图是通过查询本函数得到的结果。 - gs_lwlock_status() 描述：查询数据库系统内所有轻量级锁信息，包括等锁和持锁信息，所有用户均可执行该函数。 返回值类型：setof record - pg_stat_get_wal_senders() 描述：在主机端查询walsender信息。 返回值类型：setof record 返回字段说明如下： 表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模式下主机或备机的复制状态。 返回值类型：setof record 返回字段说明如下： 表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模块信息。字符串为JSON格式，其中各字段含义分别如下： role：表示当前节点角色，角色可分为LEADER、FOLLOWER、LOGGER、PASSIVE、UNKNOW。 term：选举任期。 run_mode：DCF运行模式，当前0表示自动选举模式，1表示手动选举模式，2表示关闭选举模式。 work_mode：DCF工作模式。 hb_interval：DCF节点间心跳间隔时间，单位ms。 elc_timeout：DCF选举超时时间，单位ms。 applied_index：被应用到状态机的日志位置。 commit_index：已被大多数DCF节点保存的日志位置，此commit_index之前日志均已持久化。 first_index：DCF节点保存的首条日志位置，此位置会随着DN调用dcf_truncate而向后推进，之前的日志会被清理。 last_index：DCF节点保存的最后一条日志位置，此日志位置包含DCF节点存储在内存里但是没有持久化的日志。 cluster_min_apply_idx：集群最小已应用的日志位置。 leader_id：leader节点ID。 leader_ip：leader节点IP。 leader_port：leader节点端口，DCF内部使用 。 nodes：本集群其他节点信息，包含节点的id、ip、port、role等关键信息。 | 示例： ``` gaussdb=# select * from get_paxos_replication_info(); paxos_write_location | paxos_commit_location | local_write_location | local_flush_location | local_replay_location | dcf_replication_info ----------------------+-----------------------+----------------------+----------------------+-----------------------+--------------------------------------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ --------------------------------------------------------------------------- 38F/CD54F690 | 38F/CD54F690 | 38F/CD54F690 | 38F/CD546CF8 | 38F/CD546CF8 | {"stream_id":1,"local_node_id":1,"role":"LEADER"," term":1215,"run_mode":1,"work_mode":0,"stg_mode":1,"hb_interval":1000,"elc_timeout":3000,"auto_elc_pri_en":1,"elc_switch_thd":0,"group":0,"priority":3898464883456,"lead er_group":0,"is_in_major":1,"applied_index":362830766,"commit_index":362830766,"first_index":355330879,"last_index":3916160068856,"last_term":1215,"dcf_last_index":3628 30766,"dcf_last_disk":362830754,"cluster_min_apply_idx":362830764,"cluster_mode":"primary_cluster","leader_id":1,"leader_ip":"*.*.*.*","leader_port":*,"nodes" :[{"node_id":1,"ip":"*.*.*.*","port":*,"role":"LEADER","next_index":362830766,"match_index":362830765,"apply_index":362830765},{"node_id":2,"ip":"*.*.*.* 4","port":*,"role":"FOLLOWER","next_index":362830767,"match_index":362830766,"apply_index":362830765},{"node_id":3,"ip":"*.*.*.*","port":*,"role":"LOGGER" ,"next_index":362830767,"match_index":362830766,"apply_index":362830764}]} (1 row) ``` - pgxc_get_senders_catchup_time() 描述：在CN实例查询集群中是否存在处于日志追赶状态的备DN，以及追赶状态详情。 返回值类型：setof record - pg_stat_get_stream_replications() 描述：查询主备复制状态。 返回值类型：setof record 返回值说明如下表所示。 表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_blk_read_time(oid) 描述：通过数据库后端读取数据文件块花费的时间，以毫秒计算。 返回值类型：double - pg_stat_get_db_blk_write_time(oid) 描述：通过数据库后端写入数据文件块花费的时间，以毫秒计算。 返回值类型：double - 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) 描述：表死行数。在Ustore表中仅代表不活跃行指针数量。 返回值类型：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 - gs_stat_get_all_tabentries() 描述：在GUC参数enable_gsstat_cache设置为on时，用户可使用gs_stat_get_all_tabentries()获取其他节点的PgStat统计信息。内部函数，不建议用户直接使用。 返回值类型：setof record 返回参数说明如[表4]所示。 表4返回参数说明 | 返回参数 | 返回参数类型 | 返回参数说明 | |:---|:---|:---| | node_name | name | 节点的名称（pgxc_node中的node_name）。 | | nspname | name | Schema名称。 | | relname | name | 表、索引名称。 | | tuples_returned | bigint | 如果是表，则返回顺序扫描读取的行数目。如果是索引，则返回的索引行的数目。 | | tuples_fetched | bigint | 如果是表，则用位图扫描抓取的行数目。如果是索引，则用简单索引扫描抓取的行数目。 | | tuples_inserted | bigint | 插入表中的行的数量。 | | tuples_updated | bigint | 在表中已更新行的数量。 | | tuples_deleted | bigint | 从表中删除行的数量。 | | tuples_hot_updated | bigint | 热更新的行数表。 | | n_live_tuples | bigint | 活行数表。 | | n_dead_tuples | bigint | 死行数表。在Ustore表中仅代表不活跃行指针数量。 | | blocks_fetched | bigint | 表或者索引的磁盘块抓取请求的数量。 | | blocks_hit | bigint | 在缓冲区中找到的表或者索引的磁盘块请求数目。 | | numscans | bigint | 如果是表，则返回顺序扫描读取的行数目。如果是索引，则返回索引行的数目。 | | autovac_vacuum_timestamp | timestamp with time zone | autovacuum守护进程在该表上最后一次启动清理的时间。 | | autovac_vacuum_count | bigint | autovacuum守护进程在该表上启动清理的次数。 | | autovac_analyze_timestamp | timestamp with time zone | autovacuum守护进程在该表上最后一次启动分析的时间。 | | autovac_analyze_count | bigint | autovacuum守护进程在该表上启动分析的次数。 | | state_change_timestamp | timestamp with time zone | 返回DBE_PERF.stat_all_tables视图中对各表各项监控指标字段更新的时间。 | | index_stat_change_timestamp | timestamp with time zone | 返回DBE_PERF.stat_all_indexes视图中对各表各项监控指标字段更新的时间。 | | state_io_change_timestamp | timestamp with time zone | 返回DBE_PERF.statio_all_indexes, DBE_PERF.statio_all_tables视图中对各表各项监控指标字段更新的时间。 | - pg_total_autovac_tuples(bool) 描述：返回total autovac相关的tuple记录，如nodename、nspname、relname以及各类tuple的IUD信息，入参为：是否查询relation信息。 返回值类型：setof record 返回参数说明如下。 表5返回参数说明 | 返回参数 | 返回参数类型 | 返回参数说明 | |:---|:---|:---| | nodename | name | 节点名称。 | | nspname | name | 名称空间名称。 | | relname | name | 表、索引、视图等对象名称。 | | partname | name | 分区名称。 | | n_dead_tuples | bigint | 表分区内的死行数。在Ustore表中仅代表不活跃行指针数量。 | | n_live_tuples | bigint | 表分区内的活行数。 | | changes_since_analyze | bigint | analyze产生改变的数量。 | - pg_total_gsi_autovac_tuples(bool) 描述：返回total autovac相关的tuple记录，如nodename、nspname、relname以及GSI自上次analyze之后发生变化的记录数，入参为：是否查询relation信息。该函数用于辅助autovacuum全局二级索引，不建议用户使用。 返回值类型：setof record - pg_autovac_status(oid) 描述：返回和autovac状态相关的参数信息，如nodename、nspname、relname、analyze、vacuum设置，analyze/vacuum阈值，analyze/vacuum tuple数等。仅SYSADMIN可以使用该函数。 返回值类型：setof record 返回值参数说明如下。 表6返回值参数说明 | 返回参数 | 返回参数类型 | 返回参数说明 | |:---|:---|:---| | 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_autovac_coordinator(oid) 描述：返回对某个表做autovac的coordinator名称，表信息非法或node信息异常返回NULL。 返回值类型：text - 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/distributed-ref-v10-gaussdb/gaussdb-08-1337.html)视图last_data_changed列的数据是通过该函数求值，在表数量很大的场景中，通过视图获取表数据最后修改时间的性能较差，建议直接使用该函数获取表数据的最后修改时间。入参是表的oid。 返回值类型：timestamptz - pg_stat_set_last_data_changed_time(oid) 描述：手动设置该表上最后一次insert/update/delete, exchange/truncate/drop partition操作的时间。 返回值类型：void - pg_stat_get_last_updated(oid, text) 描述：返回DBE_PERF.stat_all_tables, DBE_PERF.stat_all_indexes, DBE_PERF.statio_all_indexes, DBE_PERF.statio_all_tables视图中对各表各项监控指标字段更新的时间。入参1为表的oid，入参2为text类型，取值为"stat_table", "stat_index", "stat_io"。 返回值类型：timestamptz - pg_backend_pid() 描述：当前会话的服务器线程的线程ID。 返回值类型：integer - pg_stat_get_activity(integer) 描述：返回一个关于带有特殊PID的后台线程的记录信息，当参数为NULL时，则返回每个活动的后台线程的记录。返回结果不包含connection_info列。初始用户、系统管理员和MONADMIN可以查看所有的数据，普通用户只能查询自己的结果。 示例： ``` gaussdb=# SELECT pg_backend_pid(); pg_backend_pid ----------------- 139881386280704 (1 row) -- 查询结果依赖于上方的返回值。 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) ``` 返回值类型：setof record 返回参数说明如下。 表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，则这个值是上一个查询的开始时间。 | | 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可以查看所有的数据，普通用户只能查询自己的结果。 返回值类型：setof record 返回值说明如下。 | 返回值 | 返回值类型 | 返回值说明 | |:---|:---|:---| | 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，则这个值是上一个查询的开始时间。 | | 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量，单位为字节。 | | control_status | text | 当进行异常SQL CPU资源管控时为under_cpu_throttle，否则为normal。 | - 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，会按照该参数指定的阈值进行增量收集运行态计划。 - 另外，该函数只能看到在CN生成的计划，若查看在DN生成的计划，需要参考函数gs_get_dn_explain。 返回值类型：text，具体各个字段的类型和含义如下： | 返回值 | 返回值类型 | 返回值说明 | |:---|:---|:---| | 运行态计划字符串 | text | 其中计划字符串中的A-rows是算子实时返回行数。 | - gs_get_dn_explain(text, bigint) 描述：返回一个关于指定node name（来自pgxc_node系统表的node_name字段）和global session id的DN的后台线程的运行态计划，global session id不能为空。该功能生效的必要条件是GUC参数track_activities为on，支持语句的范围为可以explain且其计划不包含STREAM算子的SQL。详细说明如下： - 同函数gs_get_explain，其中global session id是由pg_stat_activity字段global_sessionid计算而来。global_sessionid格式如下：${number1}:${number2}#{number3}。需要注意的是number1为有符号数，当number1为正数时，如global_sessionid样例为1938253334:1#0，那么gs_get_dn_explain函数的参数值应为${number2}\*10000000000+${number1}；当number1为负数时，需要将其转换为32位无符号数，如global_sessionid样例为-1736975100:1#0，那么gs_get_dn_explain函数的参数值应为${number2}\*10000000000+(${number1}+4294967296)。 - 另外该函数需要ADMIN或MONADMIN权限才可执行。 返回值类型：text，具体各个字段的类型和含义如下： | 返回值 | 返回值类型 | 返回值说明 | |:---|:---|:---| | 运行态计划字符串 | text | 其中计划字符串中的A-rows是算子实时返回行数。 | - pg_stat_get_activity_ng(integer) 描述：返回一个关于带有特殊PID的活跃后台线程记录信息，当参数为NULL时，则返回每个活跃的后台线程的记录。系统管理员和MONADMIN可以查看所有的数据，普通用户只能查询自己的结果。 返回值类型：setof record 函数返回字段说明如下： | 名称 | 类型 | 描述 | |:---|:---|:---| | datid | oid | 数据库oid。 | | pid | bigint | 后端线程的ID。 | | sessionid | bigint | 会话的id。 | | node_group | text | 数据所属用户对应的node group。 | - 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 - gs_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 - pgxc_fenced_udf_process(integer) 描述：查看UDF Master和Work线程数，仅SYSADMIN和MONADMIN用户有权限执行。入参为1时查看master线程数，入参为2时查看worker线程数，入参为3时终止所有worker线程。 返回值类型：text - fenced_udf_process(integer) 描述：查看本地UDF Master和Work进程数。仅SYSADMIN和MONADMIN用户有权限终止所有worker进程。入参为1时查看master进程数，入参为2时查看worker进程数，入参为3时终止所有worker进程。 返回值类型：text - total_cpu() 描述：获取当前节点使用的cpu时间，单位是jiffies。 返回值类型：bigint - total_memory() 描述：获取当前节点使用的虚拟内存大小，单位KB。 返回值类型：bigint - pgxc_terminate_all_fenced_udf_process() 描述：Kill所有的UDF Work线程，仅SYSADMIN和MONADMIN用户有权限执行。 返回值类型：boolean - gs_get_nodegroup_tablecount(name) 描述：得到一个节点组中所有数据库包含的用户表数目。 返回值类型：integer - pgxc_max_datanode_size(name) 描述：得到一个node_group的所有DN节点中数据库文件占用磁盘空间的最大值，单位为字节。 返回值类型：bigint - gs_check_tables_distribution() 描述： 检查当前系统中用户表的分布是否存在不一致，如果返回空记录，表示不存在不一致。该函数应该在非扩缩容重分布时调用。 返回值类型：record - pg_stat_bad_block() 描述：获取当前节点自启动后，读取出现Page的损坏信息。 返回值类型：record - pgxc_stat_bad_block() 描述：获取集群所有节点自启动后，读取出现Page的损坏信息。 返回值类型：record - pg_stat_bad_block_clear() 描述：清理节点记录的读取出现的Page损坏信息（需要系统管理员权限）。 返回值类型：void - pgxc_stat_bad_block_clear 描述：清理集群所有节点记录的读取出现的Page损坏信息（需要系统管理员权限）。 返回值类型：void - pgxc_log_comm_status(void) 描述：当使用sctp（由于规格变更，当前版本已经不再支持本特性，请不要使用）通信模式时，PGXC系统视图将datanode的通信层状态输出到各个日志文件中。 返回值类型：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_all_control_group_info() 描述：查看数据库内所有的控制组信息。函数返回信息具体的字段参考[GS_ALL_CONTROL_GROUP_INFO](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1254.html)字段。 返回值类型：record - gs_get_control_group_info() 描述：查看所有的控制组信息。函数返回信息具体的字段参考[GS_GET_CONTROL_GROUP_INFO](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1258.html)。该函数需要SYSADMIN权限的用户才能够执行。 返回值类型：record - gs_get_session_sql_memory() 描述：查看当前运行中语句的内存使用量。函数返回信息具体字段参考[DBE_PERF.SESSION_SQL_MEMORY](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1537.html)字段。 返回值类型：record - gs_get_global_session_sql_memory() 描述：查看当前所有节点上运行中语句的内存使用量。函数返回信息具体字段参考[DBE_PERF.GLOBAL_SESSION_SQL_MEMORY](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1538.html)字段。 返回值类型：record - gs_blackbox_dump() 描述：将系统中的黑匣子文件导出到"$GAUSSLOG/gs_blackbox/{nodename}"目录中。执行成功后返回在"$GAUSSLOG/gs_blackbox/{nodename}"中生成的黑匣子文件的名称。 返回值类型：text - gs_blackbox_show(blackBoxFile cstring) 描述：解析黑匣子文件，并按照表格方式展示。 参数： | 参数名称 | 参数说明 | 取值范围 | |:---|:---|:---| | blackBoxFile | 指定需要解析的黑匣子文件，不指定参数表示当前进程采集的黑匣子文件。 | 字符串，或者不指定，指定有效的黑匣子文件名字，则读取"$GAUSSLOG/gs_blackbox/nodename"目录下对应名称的文件。仅支持名称，不支持路径，如果在"$GAUSSLOG/gs_blackbox/nodename"下不存在对应名称的文件，则报错返回。 | 返回值类型：setof record 返回值说明如下： | 返回值 | 返回值类型 | 返回值说明 | |:---|:---|:---| | type | text | 黑匣子字段类型。 | | tid | bigint | 线程号。 | | sample_time | timestamp | 采集时间。 | | value | text | 黑匣子记录的内容。 | 查询结果举例如下： | type | tid | sample_time | value | |:---|:---|:---|:---| | ERRNUMBER | 123456 | 2024-03-19 09:33:17.386 | 19460 | | BLACK_BOX_PLSQL_EXCEPTION | 45678 | 2024-03-19 09:33:18.396 | message: "Dropped rowtype entry for non-dropped column when make tuple." funcname: basic_make_tuple_from_row filename:pl_exec.cpp context:xxxx | - gs_blackbox_list() 描述：列举当前实例黑匣子目录下的黑匣子文件。默认是"$GAUSSLOG/gs_blackbox/{nodename}"目录下。 返回值类型：setof record 返回值说明如下： | 返回值 | 返回值类型 | 返回值说明 | |:---|:---|:---| | file | text | 黑匣子文件名称。 | - get_instr_workload_info(integer) 描述：获取当前CN节点上事务量信息，事务时间信息。 返回值类型：record | 属性 | 类型 | 描述 | |:---|:---|:---| | user_oid | oid | 用户ID。 | | commit_counter | bigint | 前端事务commit数量。 | | rollback_counter | bigint | 前端事务rollback数量。 | | resp_min | bigint | 前端事务最小响应时间（单位：微秒）。 | | resp_max | bigint | 前端事务最大响应时间（单位：微秒）。 | | resp_avg | bigint | 前端事务平均响应时间（单位：微秒）。 | | resp_total | bigint | 前端事务总响应时间（单位：微秒）。 | | bg_commit_counter | bigint | 后端事务commit数量。 | | bg_rollback_counter | bigint | 后端事务rollback数量。 | | bg_resp_min | bigint | 后端事务最小响应时间（单位：微秒）。 | | bg_resp_max | bigint | 后端事务最大响应时间（单位：微秒）。 | | bg_resp_avg | bigint | 后端事务平均响应时间（单位：微秒）。 | | bg_resp_total | bigint | 后端事务总响应时间（单位：微秒）。 | | dist_commit_counter | bigint | 分布式事务commit数量。 | | dist_rollback_counter | bigint | 分布式事务rollback数量。 | | dist_resp_min | bigint | 分布式事务最小响应时间（单位：微秒）。 | | dist_resp_max | bigint | 分布式事务最大响应时间（单位：微秒）。 | | dist_resp_avg | bigint | 分布式事务平均响应时间（单位：微秒）。 | | dist_resp_total | bigint | 分布式事务总响应时间（单位：微秒）。 | | dbid | oid | 数据库标识。 | ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 只统计主事务信息，子事务信息不会被统计在内。 - pv_instance_time() 描述：获取当前节点上各个关键阶段的时间消耗。 返回值类型：record | Stat_name属性 | 属性值 | 描述 | |:---|:---|:---| | DB_TIME | 1062385 | 所有线程端到端的时间消耗总和（单位：微秒）。 | | CPU_TIME | 311777 | 所有线程CPU时间消耗总和（单位：微秒）。 | | EXECUTION_TIME | 380037 | 消耗在执行器上的时间总和（单位：微秒）。 | | PARSE_TIME | 6033 | 消耗在SQL解析上的时间总和（单位：微秒）。 | | PLAN_TIME | 173356 | 消耗在执行计划生成上的时间总和（单位：微秒）。 | | REWRITE_TIME | 2274 | 消耗在查询重写上的时间总和（单位：微秒）。 | | PL_EXECUTION_TIME | 0 | 消耗在plpgsql执行上的时间总和（单位：微秒）。 | | PL_COMPILATION_TIME | 557 | 消耗在SQL编译上的时间总和（单位：微秒）。 | | NET_SEND_TIME | 1673 | 消耗在网络发送上的时间总和（单位：微秒）。 | | DATA_IO_TIME | 426622 | 消耗在数据读写上的时间总和（单位：微秒）。 | - DBE_PERF.get_global_instance_time() 描述：提供整个集群各个关键阶段的时间消耗，仅在CN上支持查询。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - get_instr_unique_sql() 描述：获取当前节点的执行语句（归一化SQL）信息，具有SYSADMIN和MONADMIN权限的用户可查询全部信息，其他用户只能查询自己执行的语句的信息。函数返回信息具体字段参考[DBE_PERF.STATEMENT](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1527.html)字段。 返回值类型：record - get_instr_wait_event(integer) 描述：获取当前节点event等待的统计信息。 返回值类型：record - get_instr_user_login() 描述：获取当前节点的用户登录或者退出登录次数信息，查询该函数必须具有SYSADMIN或者MONADMIN权限。 返回值类型：record - get_instr_rt_percentile(integer) 描述：获取CCN节点SQL 响应时间P80、P95分布信息，集群统一的信息在CCN节点上，其他节点查询为0。 返回值类型：record - get_node_stat_reset_time() 描述：获取当前节点的统计信息重置（重启，主备倒换，数据库删除）时间。 返回值类型：record - gs_paxos_stat_replication() 描述：在主机端查询备机信息。 返回值类型：setof record 返回字段说明如下： | 字段名称 | 字段类型 | 字段说明 | |:---|:---|:---| | 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 | 信道信息。 | - get_paxos_replication_info() 描述：查询Paxos模式下主机或备机的复制状态。 返回值类型：setof record 返回字段说明如下： | 字段名称 | 字段类型 | 字段说明 | |:---|:---|:---| | 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模块信息。 | - gs_wlm_get_user_info(int) 描述：获取所有用户的相关信息，入参为int类型，可以为任意int值或NULL。该函数只有SYSADMIN权限的用户可以执行。 返回值类型：record - gs_wlm_readjust_user_space(oid) 描述：修正指定用户的存储空间使用情况。普通用户仅可修正自己的使用情况，管理员用户可以修正所有用户的使用情况。当参数oid传入0时，表示需要修正所有用户的使用情况。 返回值类型：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_io_wait_status() 描述：返回当前节点I/O管控的实时统计信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 节点名称。 | | device_name | text | 节点挂载的数据磁盘名称。 | | read_per_second | float | 读完成每秒次数。 | | write_per_second | float | 写完成每秒次数。 | | write_ratio | float | 写磁盘占总的I/O使用的比例。 | | io_util | float | 每秒I/O所占CPU总时间的百分比。 | | total_io_util | integer | 过去三次I/O所占CPU总时间的等级（取值为0\~6）。 | | tick_count | integer | 更新磁盘IO信息的周期，固定为1秒，每次读取数据前都会被清零。 | | io_wait_list_len | integer | I/O请求线程等待队列的大小，若为0，则表示当前没有I/O被管控。 | - gs_get_shared_memctx_detail(text) 描述：返回指定内存上下文上的内存申请的详细信息，包含每一处内存申请所在的文件、行号和大小（同一文件同一行大小会做累加）。只支持查询通过PG_SHARED_MEMORY_DETAIL视图（请参见[PG_SHARED_MEMORY_DETAIL](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1332.html)）查询出来的内存上下文，入参为内存上下文名称（即PG_SHARED_MEMORY_DETAIL视图返回结果的contextname列）。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | file | text | 申请内存所在文件的文件名。 | | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，同一文件同一行多次申请会做累加。 | - gs_get_session_memctx_detail(text) 描述：返回指定内存上下文上的内存申请的详细信息，包含每一处内存申请所在的文件、行号和大小（同一文件同一行大小会做累加）。仅在线程池模式下生效。且只支持查询通过PV_SESSION_MEMORY_CONTEXT视图（请参见[PV_SESSION_MEMORY_CONTEXT](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1389.html)）查询出来的内存上下文，入参为内存上下文名称（即PV_SESSION_MEMORY_CONTEXT视图返回结果的contextname列）。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | file | text | 申请内存所在文件的文件名。 | | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，单位为byte，同一文件同一行多次申请会做累加。 | ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 该函数仅在线程池模式下生效。 - gs_get_thread_memctx_detail(tid,text) 描述：返回指定内存上下文上的内存申请的详细信息，包含每一处内存申请所在的文件、行号和大小（同一文件同一行大小会做累加）。只支持查询通过PV_THREAD_MEMORY_CONTEXT视图（请参见[PV_THREAD_MEMORY_CONTEXT](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1393.html)）查询出来的内存上下文，第一个入参为线程id（即PV_THREAD_MEMORY_CONTEXT视图返回数据的tid列），第二个参数为内存上下文名称（即PV_THREAD_MEMORY_CONTEXT视图返回数据的contextname列）。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | file | text | 申请内存所在文件的文件名。 | | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，单位为byte，同一文件同一行多次申请会做累加。 | - 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_stat_get_hotkeys_info() ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 若GUC参数enable_hotkeys_collection = off, gs_stat_get_hotkeys_info、global_stat_get_hotkeys_info函数和global_stat_hotkeys_info视图无法正常查询。不影响gs_stat_clean_hotkeys和global_stat_clean_hotkeys清理接口的正常使用。 描述：获取当前节点上热点key的统计情况。 返回值类型：record ``` gaussdb=# SELECT * FROM gs_stat_get_hotkeys_info() order by count, hash_value; database_name | schema_name | table_name | key_value | hash_value | count ---------------+-------------+-------------------+-----------+------------+------- regression | public | hotkey_single_col | {22} | 1858004829 | 2 regression | public | hotkey_single_col | {11} | 2011968649 | 2 (2 rows) ``` | 名称 | 类型 | 描述 | |:---|:---|:---| | database_name | text | 热点key所在database名称。 | | schema_name | text | 热点key所在schema名称。 | | table_name | text | 热点key所在table名称。 | | key_value | text | 热点key的value。 | | hash_value | bigint | 热点key在数据库中的哈希值，如果是List/Range分布表，该字段为0。 | | count | bigint | 热点key被访问频次。 | - gs_stat_clean_hotkeys() ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - 热点key检测是针对大并发大流量场景设计的特性，访问几次的场景，查询清理会存在一定误差。 - 清理接口的设计上，只会清理LRU队列中的统计数据，而不会清理FIFO中的历史数据。因此如果清理完后，再访问一次FIFO中存在的历史键值，仍会被当做热点key处理。global_stat_clean_hotkeys同理。 描述：清理当前节点上热点key的统计信息。 返回值：boolean ``` gaussdb=# SELECT * FROM gs_stat_clean_hotkeys(); gs_stat_clean_hotkeys ----------------------- t (1 row) ``` - gs_stat_progress_vacuum(pid) 描述：用于查看当前VACUUM的进度。仅统计Astore和Ustore的页式表的VACUUM进度，不支持统计hashbucket和段页式。 返回值类型：record 表8返回值参数说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | pid | bigint | VACUUM线程的线程pid。 | | dataname | text | 正在清理的数据库名称。 | | relid | oid | 正在清理表的OID。 | | relname | text | 正在清理的表名称。 | | phase | text | 当前VACUUM所处的阶段。 | | detail | text | 清理进度详情，包含总页面数、已扫描页面数、已清理页面数和已清理索引数。 | 表9phase取值详细说明 | phase | 字段类型 | 说明 | |:---|:---|:---| | invalid | text | VACUUM正在启动，此时将获取表锁。 | | initialize | text | VACUUM正在准备开始扫描堆表，该阶段预计非常短暂。 | | vacuuming main part | text | VACUUM正在清理分区主表（通常为清理分区主表的GPI），可通过detail列信息查看清理进度。 | | scanning heap | text | VACUUM正在扫描堆表，必要时会对每个页面进行碎片整理或执行冻结操作，可通过detail列信息查看清理进度。 | | vacuuming indexes | text | VACUUM正在清理索引。若表存在索引，该阶段至少发生一次，并可能在按需对索引进行多次清理后，才会返回继续扫描堆表，可通过detail列信息查看清理进度。 | | vacuuming heap | text | VACUUM正在对堆表进行清理（区别于扫描堆表），并且在每次索引清理后执行。若堆表未完全扫描，将在此阶段后返回继续扫描，可通过detail列信息查看清理进度。 | | vacuuming part cache | text | VACUUM正在清理已缓存分区的死元组，可通过detail列信息查看清理进度。 | | cleaning up indexes | text | VACUUM正在清理索引，该阶段在堆表完全扫描且所有索引与堆表清理完成后执行。 | | truncating heap | text | VACUUM正在截断堆表的尾部空页，并将空页返回操作系统。 | | vacuuming urq | text | VACUUM正在回收Ustore表的索引的页面。 | | unknown phase | text | 表示当前处于未在上述阶段中定义的未知状态，通常不会出现。 | ``` --设置guc参数： gaussdb=# SET vacuum_cost_delay=100; SET gaussdb=# CREATE TABLE t1 (a int, b int, c text) with (storage_type=astore) gaussdb-# partition by range(a) ( gaussdb, gaussdb, gaussdb, gaussdb, gaussdb, gaussdb, gaussdb, gaussdb, gaussdb, gaussdb); CREATE TABLE gaussdb=# CREATE INDEX idx11 on t1(a) global; CREATE INDEX gaussdb=# gaussdb=# CREATE INDEX idx12 on t1(b) global; CREATE INDEX gaussdb=# gaussdb=# CREATE INDEX idx13 on t1(c) global; CREATE INDEX gaussdb=# INSERT INTO t1 VALUES (generate_Series(1,100000), generate_series(1,3), 'abcde'); INSERT 0 300000 gaussdb=# DELETE t1; DELETE 300000 gaussdb=# VACUUM t1; VACUUM --新起一个会话连接当前节点，执行如下 gaussdb=# SELECT pid,query FROM pg_stat_activity where query = 'vacuum t1;'; pid | query -----------------+------------ 140242746078976 | vacuum t1; (1 row) gaussdb=# SELECT * FROM gs_stat_progress_vacuum(140242746078976); pid | dataname | relid | relname | phase | detail -----------------+----------+-------+---------+----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------------- 140242746078976 | postgres | 24962 | t1 | vacuuming heap | vacuum command "vacuum t1;" starts at 2025-09-09 17:20:00.659862-04, vacuumed 0/11 partitions, current part "p10", current phase already run 0s; heap: scanned 1 63/163 blocks, skipped 0 blocks, vacuumed 53/163 blocks; info: found 30003 dead tuples, already run 47s, delay 47s. (1 row) gaussdb=# DROP TABLE t1; ``` - global_stat_get_hotkeys_info() ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 执行业务过程中，执行select \* from global_stat_hotkeys_info minus select \* from global_stat_get_hotkeys_info();因为存在时间差，可能出现不为0的情况。 描述：获取整个集群中热点key的统计情况。 返回值类型：record ``` gaussdb=# SELECT * FROM global_stat_get_hotkeys_info() order by count, hash_value; database_name | schema_name | table_name | key_value | hash_value | count ---------------+-------------+-------------------+-----------+------------+------- regression | public | hotkey_single_col | {22} | 1858004829 | 2 regression | public | hotkey_single_col | {11} | 2011968649 | 2 (2 rows) ``` - global_stat_clean_hotkeys() 描述：清理整个集群中热点key的统计信息。 返回值：boolean ``` gaussdb=# SELECT * FROM global_stat_clean_hotkeys(); global_stat_clean_hotkeys ----------------------- t (1 row) ``` - global_comm_get_recv_stream() 描述：获取所有DN节点上所有的通信库接收流状态。函数返回信息具体字段参考[PG_COMM_RECV_STREAM](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1094.html)字段。 返回值类型：record - global_comm_get_send_stream() 描述：获取所有DN节点上所有的通信库发送流状态。函数返回信息具体字段参考[PG_COMM_SEND_STREAM](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1095.html)字段。 返回值类型：record - global_comm_get_status() 描述：获取所有DN节点的通信库状态。函数返回信息具体字段参考[PG_COMM_STATUS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1096.html)字段。 返回值类型：record - global_comm_client_info() 描述：获取全局节点活跃的客户端连接信息。函数返回信息具体字段参考[COMM_CLIENT_INFO](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1086.html)字段。 返回类型：record - global_comm_get_client_info() 描述：获取全局节点客户端连接信息。函数返回信息具体字段参考[COMM_CLIENT_INFO](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1086.html)字段。 返回类型：record - pgxc_stat_activity() 描述：显示当前集群下所有CN的当前用户查询相关的信息，该函数仅具有SYSADMIN或者MONADMIN权限的用户可以执行，普通用户可查看本用户的相关信息。505.0.0版本新增三列信息，灰度升级观察期中执行会报错，需使用PG_STAT_ACTIVITY视图（请参见[PG_STAT_ACTIVITY](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1334.html)）直连目标节点进行查询。 返回值类型：record | 名称 | 类型 | 描述 | |:---|:---|:---| | coorname | text | 当前集群下的CN名称。 | | datid | oid | 用户会话在后台连接到的数据库OID。 | | datname | text | 用户会话在后台连接到的数据库名称。 | | pid | bigint | 后台线程ID。 | | sessionid | bigint | 会话ID。 | | usesysid | oid | 登录该后台的用户OID。 | | usename | text | 登录该后台的用户名。 | | application_name | text | 连接到该后台的应用名。 | | client_addr | inet | 连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部线程，如autovacuum。 | | client_hostname | text | 客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。 | | client_port | integer | 客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。 | | backend_start | timestamp with time zone | 该过程开始的时间，即当客户端连接服务器的时间。 | | xact_start | timestamp with time zone | 启动当前事务的时间，如果没有事务是活跃的，则为null。如果当前查询是首个事务，则这列等同于query_start列。 | | query_start | timestamp with time zone | 开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。 | | state_change | timestamp with time zone | 上次状态改变的时间。 | | waiting | boolean | 如果后台当前正等待锁则为true。 | | enqueue | text | 语句当前排队状态。可能值是： - waiting in queue：表示语句在排队中。 - 空：表示语句正在运行。 | | state | text | 该后台当前总体状态。可能值是： - active：后台正在执行一个查询。 - idle：后台正在等待一个新的客户端命令。 - idle in transaction：后台在事务中，但事务中没有语句在执行。 - idle in transaction (aborted)：后台在事务中，但事务中有语句执行失败。 - fastpath function call：后台正在执行一个fast-path函数。 - disabled：如果后台禁用track_activities，则报告这个状态。 说明： 只有系统管理员能查看到自己账户所对应的会话状态。其他账户的state信息为空。例如以judy用户连接数据库后，在PGXC_STAT_ACTIVITY视图中查看到的普通用户joe及初始用户omm的state信息为空： ``` SELECT datname, usename, usesysid, state,pid FROM pgxc_stat_activity; ``` ``` datname | usename | usesysid | state | pid ----------+---------+----------+--------+----------------- testdb | omm | 10 | | 139968752121616 testdb | omm | 10 | | 139968903116560 db_tpcds | judy | 16398 | active | 139968391403280 testdb | omm | 10 | | 139968643069712 testdb | omm | 10 | | 139968680818448 testdb | joe | 16390 | | 139968563377936 (6 rows) ``` | | resource_pool | name | 用户使用的资源池。 | | query_id | bigint | 查询语句的ID。 | | query | text | 该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。 | | 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量，单位为字节。 | - pgxc_stat_activity_with_conninfo() 描述：显示当前集群下所有CN的当前用户查询相关的信息，返回值定义参考[PGXC_STAT_ACTIVITY](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1377.html)视图。该函数仅具有SYSADMIN或者MONADMIN权限的用户可以执行，普通用户只能查看本用户相关的信息。 返回值类型：record - pgxc_stat_all_tables() 描述：显示各节点数据中每个表（包括TOAST表）的一行的统计信息，该函数仅具有SYSADMIN或者MONADMIN权限的用户可以执行。 返回值类型：record - pgxc_get_thread_wait_status() 描述：查看集群各个节点上所有SQL语句产生的线程之间的调用层次关系，以及各个线程的阻塞等待状态。 返回值类型：record - pv_session_memory 描述：统计Session级别的内存使用情况，包含执行作业在数据节点上GaussDB线程和Stream线程分配的所有内存。 ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 若GUC参数enable_memory_limit=off，该函数不能使用。 返回值类型：record 表10返回值说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | sessid | text | 线程启动时间+线程标识。 | | init_mem | integer | 当前正在执行作业进入执行器前已分配的内存，单位MB。 | | used_mem | integer | 当前正在执行作业已分配的内存，单位MB。 | | peak_mem | integer | 当前正在执行作业已分配的内存峰值，单位MB。 | - 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 | 开始当前查询的时间。 | | query_id | bigint | 查询语句ID。 | - DBE_PERF.global_stat_activity_timeout(int) 描述：获取当前系统（所有CN）中执行时间超过超时阈值的查询作业信息。需要GUC参数track_activities设置为on才能正确返回结果。超时阈值的取值范围是0\~2147483。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | nodename | text | 用户会话连接的coordinate node的名称。 | | database | name | 用户会话连接的数据库名称。 | | pid | bigint | 后台线程ID。 | | sessionid | bigint | 会话ID。 | | usesysid | oid | 登录该后台的用户OID。 | | application_name | text | 连接到该后台的应用名。 | | query | text | 该后台正在执行的查询。 | | xact_start | timestamptz | 启动当前事务的时间。 | | query_start | timestamptz | 开始当前查询的时间。 | | query_id | bigint | 查询语句ID。 | - DBE_PERF.get_global_active_session() 描述：显示所有CN节点和主DN节点上的ACTIVE SESSION PROFILE内存中的样本的汇总。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。505.0版本新增event_start_time、current_xid、top_xid三个字段信息，由低于505.0版本升级至505.0或更高版本时，升级观察期无法查询。 返回值类型：record - DBE_PERF.get_global_os_runtime() 描述：显示当前操作系统运行的状态信息，仅在CN上支持查询。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_os_threads() 描述：提供整个集群中所有正常节点下的线程状态信息，仅在CN上支持查询。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_os_threads() 描述：提供整个集群中所有正常节点下的线程状态信息，仅在CN上支持查询。集群创建后的默认情况下，查询该函数必须具有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/distributed-ref-v10-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 - 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() 描述：汇聚当前用户所有CN上执行作业结束后的算子相关记录（持久化）。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record。 - DBE_PERF.get_global_operator_history() 描述：汇聚当前用户所有CN上执行作业结束后的算子相关记录。集群创建后的默认情况下，查询该函数必须具有MONADMIN和SYSADMIN权限。 返回值类型：record - DBE_PERF.get_global_operator_runtime() 描述：汇聚当前用户所有CN上执行作业实时的算子相关记录。集群创建后的默认情况下，查询该函数必须具有MONADMIN和SYSADMIN权限。 返回值类型：record - DBE_PERF.get_global_statement_complex_history() 描述：汇聚当前用户所有CN节点上复杂查询的历史记录。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record。 - DBE_PERF.get_global_statement_complex_history_table() 描述：汇聚当前用户所有CN节点上复杂查询的历史记录（持久化）。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statement_complex_runtime() 描述：汇聚当前用户所有CN节点上复杂查询的实时信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN和SYSADMIN权限。 返回值类型：record - DBE_PERF.get_global_memory_node_detail() 描述：汇聚某个数据库在所有节点上的内存使用情况。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_shared_memory_detail() 描述：汇聚所有节点已产生的共享内存上下文的使用信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_comm_delay() 描述：汇聚所有DN节点的通信库时延状态。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_comm_recv_stream() 描述：汇聚所有DN节点的通信库接收流状态。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_comm_send_stream() 描述：汇聚所有DN节点的通信库发送流状态。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_comm_status() 描述：汇聚所有DN节点的通信库状态。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_all_indexes() 描述：汇集所有节点当前数据库中的索引信息及I/O统计量。集群创建后的默认情况下，查询该函数必须具有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的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有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() 描述：汇聚各节点的命名空间中所有系统表索引的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_sys_indexes() 描述：统计各节点的命名空间中所有系统表索引的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_sys_sequences() 描述：提供命名空间中所有系统表为sequences的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_sys_tables() 描述：提供各节点的命名空间中所有系统表的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_sys_tables() 描述：集群内汇集命名空间中所有系统表的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_user_indexes() 描述：各节点的命名空间中所有用户关系表索引的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_user_indexes() 描述：集群内汇集命名空间中所有用户关系表索引的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_user_sequences() 描述：显示各节点的命名空间中所有用户的sequences的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_statio_user_tables() 描述：显示各节点的命名空间中所有用户关系表的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_statio_user_tables() 描述：集群内汇聚命名空间中所有用户关系表的I/O状态信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_dn_stat_all_tables() 描述：汇聚DN节点数据库中每个表的统计信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_cn_stat_all_tables() 描述：汇聚CN节点数据库中每个表的统计信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_dn_stat_all_tables() 描述：统计DN节点数据库中每个表的统计信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_summary_cn_stat_all_tables() 描述：统计CN节点数据库中每个表的统计信息。集群创建后的默认情况下，查询该函数必须具有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() 描述：汇聚集群所有主DN节点上的复制槽的并行解码信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。该函数仅限CN上执行，DN上执行报错。返回值同视图[DBE_PERF.GLOBAL_PARALLEL_DECODE_STATUS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1602.html)。 返回值类型：record - DBE_PERF.GET_GLOBAL_PARALLEL_DECODE_THREAD_INFO() 描述：汇聚集群所有主DN节点上的复制槽的并行解码线程信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。该函数仅限CN上执行，DN上执行报错。返回值同视图[DBE_PERF.GLOBAL_PARALLEL_DECODE_THREAD_INFO](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1604.html)。 返回值类型：record - DBE_PERF.get_global_bgwriter_stat() 描述：汇聚所有节点后端写线程活动的统计信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_replication_stat() 描述：汇聚各节点日志同步状态信息，如发起端发送日志位置，接收端接收日志位置等。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - DBE_PERF.get_global_pooler_status() 描述：汇聚所有CN节点的pooler中的缓存连接状态。集群创建后的默认情况下，查询该函数必须具有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权限。函数返回信息具体字段参考[DBE_PERF.SUMMARY_STATEMENT](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1528.html)字段。 返回值类型：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权限。函数返回信息具体字段参考[STATEMENT_HISTORY](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1027.html)字段。 参数：参见[表11]。 返回值类型：record 表11standby_statement_history参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | only_slow | boolean | 是否仅查询慢SQL。 - true为是，相当于 select .. where is_slow_sql = true。 - false或NULL为查询全部SQL，相当于不对is_slow_sql进行过滤。 | | time1 | timestamptz | 可选输入，表示查询SQL的finish_time的最小时间。 | | time2 | timestamptz | 可选输入，表示查询SQL的finish_time的最大时间。若time1\>=time2，则函数执行报错。 | ![](https://support.huaweicloud.com/distributed-ref-v10-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.global_io_wait_info() 描述：查询所有CN和DN节点上的IO管控的实时统计信息。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - pg_stat_get_mem_mbytes_reserved(tid) 描述：统计资源管理相关变量值，仅用于定位问题使用。 参数：线程id 返回值类型：text - pg_stat_get_file_stat() 描述：通过对数据文件I/O的统计，反映数据的I/O性能，用以发现I/O操作异常等性能问题。 返回值类型：record - pg_stat_get_redo_stat() 描述：用于统计会话线程日志回放情况。 返回值类型：record - pg_stat_get_status(int8) 描述：可以检测当前实例中工作线程（backend thread）以及辅助线程（auxiliary thread）的阻塞等待情况。 返回值类型：record - get_local_rel_iostat() 描述：查询当前节点的数据文件I/O状态累计值。 返回值类型：record - DBE_PERF.get_global_rel_iostat() 描述：汇聚所有节点数据文件I/O的统计。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - pg_catalog.plancache_status(is_with_plan) 描述：是否显示在当前节点上的全局计划缓存的状态信息，即plan_info列。入参is_with_plan为bool类型，默认值为false。当入参为true时，显示plan_info的信息。函数返回信息和[DBE_PERF.GLOBAL_PLANCACHE_STATUS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1642.html)一致。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - 当pg_catalog.plancache_status的入参为true时，如果计划较多，可能产生一定的性能劣化，推荐使用pg_catalog.global_plancache_show_plan函数查询单条SQL的详细计划信息。 - 当对所查询计划依赖的表权限不足时，会在plan_info列显示"权限不足"的报错信息。 - DBE_PERF.global_plancache_status(is_with_plan) 描述：是否显示在所有节点上的全局计划缓存的状态信息，即plan_info列。入参is_with_plan为bool类型，默认值为false。当入参为true时，显示plan_info的信息。函数返回信息见字段[DBE_PERF.GLOBAL_PLANCACHE_STATUS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1642.html)。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - 当DBE_PERF.global_plancache_status的入参为true时，如果计划较多，可能产生一定的性能劣化，推荐使用pg_catalog.global_plancache_show_plan函数查询单条SQL的详细计划信息。 - 当对所查询计划依赖的表权限不足时，会在plan_info列显示"权限不足"的报错信息。 - pg_catalog.gs_plancache_stat() 描述：查看当前进程内全部session的参数化语句相关信息，函数返回信息和[DBE_PERF.GS_PLANCACHE_STAT](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1539.html)一致。查询该函数需要MONADMIN权限。 返回值类型：record - pg_catalog.gs_dist_plancache_stat() 描述：查看包含备机的全部进程的参数化语句信息的系统函数，函数返回信息和[DBE_PERF.GS_DIST_PLANCACHE_STAT](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1540.html)一致。查询该函数需要MONADMIN权限。 返回值类型：record - DBE_PERF.global_threadpool_status() 描述：显示在所有节点上的线程池中工作线程及会话的状态信息。函数返回信息见字段[DBE_PERF.GLOBAL_THREADPOOL_STATUS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1513.html)。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 返回值类型：record - comm_check_connection_status() 描述：返回该CN和所有活跃节点（CN和主DN）的连接情况。该函数仅支持在CN上查询，普通用户可使用。 参数：nan 返回值类型：node_name text, remote_name text, remote_host text, remote_port integer, is_connected boolean, no_error_occur boolean。 - DBE_PERF.global_comm_check_connection_status() 描述：返回所有CN和所有活跃节点（CN和主DN）的连接情况。该函数仅支持在CN上查询，权限控制继承DBE_PERF schema。集群创建后的默认情况下，查询该函数必须具有MONADMIN权限。 参数：nan 返回值类型：node_name text, remote_name text, remote_host text, remote_port integer, is_connected boolean, no_error_occur boolean - remote_candidate_stat() 描述：显示本实例的候选buffer链中页面个数，buffer淘汰信息，包含normal buffer pool和segment buffer pool。 返回值类型：record 表12remote_candidate_stat参数说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 节点名称。 | | candidate_slots | integer | 当前Normal Buffer Pool候选buffer链中页面个数。 | | get_buf_from_list | bigint | Normal Buffer Pool，buffer淘汰从候选buffer链中获取页面的次数。 | | get_buf_clock_sweep | bigint | Normal Buffer Pool，buffer淘汰从原淘汰方案中获取页面的次数。 | | seg_candidate_slots | integer | 当前Segment Buffer Pool候选buffer链中页面个数。 | | seg_get_buf_from_list | bigint | Segment Buffer Pool，buffer淘汰从候选buffer链中获取页面的次数。 | | seg_get_buf_clock_sweep | bigint | Segment Buffer Pool，buffer淘汰从原淘汰方案中获取页面的次数。 | - remote_ckpt_stat() 描述：用于显示整个集群所有实例的检查点信息和各类日志刷页情况（本节点除外、DN上不可使用）。 返回值类型：record 表13remote_ckpt_stat参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 实例名称。 | | ckpt_redo_point | text | 当前实例的检查点。 | | ckpt_clog_flush_num | int8 | 从启动到当前时间clog刷盘页面数。 | | ckpt_csnlog_flush_num | int8 | 从启动到当前时间csnlog刷盘页面数。 | | ckpt_multixact_flush_num | int8 | 从启动到当前时间multixact刷盘页面数。 | | ckpt_predicate_flush_num | int8 | 从启动到当前时间predicate刷盘页面数。 | | ckpt_twophase_flush_num | int8 | 从启动到当前时间twophase刷盘页面数。 | - remote_double_write_stat() 描述：显示整个集群所有实例的双写文件的情况(本节点除外、DN上不可使用)。 返回值类型：record 表14remote_double_write_stat参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 实例名称。 | | curr_dwn | int8 | 当前双写文件的序列号。 | | curr_start_page | int8 | 当前双写文件恢复起始页面。 | | file_trunc_num | int8 | 当前双写文件复用的次数。 | | file_reset_num | int8 | 当前双写文件写满后发生重置的次数。 | | total_writes | int8 | 当前双写文件总的I/O次数。 | | low_threshold_writes | int8 | 低效率写双写文件的I/O次数（一次I/O刷页数量少于16页面）。 | | high_threshold_writes | int8 | 高效率写双写文件的I/O次数（一次I/O刷页数量多于一批，421个页面）。 | | total_pages | int8 | 当前刷页到双写文件区的总的页面个数。 | | low_threshold_pages | int8 | 低效率刷页的页面个数。 | | high_threshold_pages | int8 | 高效率刷页的页面个数。 | | file_id | int8 | 当前双写文件的id号。 | - remote_single_flush_dw_stat() 描述：显示整个集群所有实例的单页面淘汰双写文件的情况（本节点除外、DN上不可使用）。 返回值类型：record 表15remote_single_flush_dw_stat参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 实例名称。 | | curr_dwn | integer | 当前双写文件的序列号。 | | curr_start_page | integer | 当前双写文件start位置。 | | total_writes | bigint | 当前双写文件总计写数据页面个数。 | | file_trunc_num | bigint | 当前双写文件复用的次数。 | | file_reset_num | bigint | 当前双写文件写满后发生重置的次数。 | - remote_pagewriter_stat() 描述：显示整个集群所有实例的刷页信息和检查点信息（本节点除外、DN上不可使用）。 返回值类型：record 表16remote_pagewriter_stat参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 实例名称。 | | pgwr_actual_flush_total_num | int8 | 从启动到当前时间总计刷脏页数量。 | | pgwr_last_flush_num | int4 | 上一批刷脏页数量。 | | remain_dirty_page_num | int8 | 当前预计还剩余多少脏页。 | | queue_head_page_rec_lsn | text | 当前实例的脏页队列第一个脏页的recovery_lsn。 | | queue_rec_lsn | text | 当前实例的脏页队列的recovery_lsn。 | | current_xlog_insert_lsn | text | 当前实例Xlog写入的位置。 | | ckpt_redo_point | text | 当前实例的检查点。 | - remote_recovery_status() 描述：显示关于主机和备机的日志流控信息（本节点除外、DN上不可使用）。 返回值类型：record 表17remote_recovery_status参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 节点的名称，包含主机和备机。 | | standby_node_name | text | 备机名称。 | | source_ip | text | 主机的IP地址。 | | source_port | int4 | 主机的端口号。 | | dest_ip | text | 备机的IP地址。 | | dest_port | int4 | 备机的端口号。 | | current_rto | int8 | 备机当前的日志流控时间，单位秒。 | | target_rto | int8 | 备机通过GUC参数设置的预期流控时间，单位秒。 | | current_sleep_time | int8 | 为了达到这个预期主机所需要的睡眠时间，单位微秒。 | - remote_rto_stat() 描述：显示关于主机和备机的日志流控信息（本节点除外、DN上不可使用）。 返回值类型：record 表18remote_rto_stat参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 节点的名称，包含主机和备机。 | | rto_info | text | 流控的信息，包含了备机当前的日志流控时间（单位：秒），备机通过GUC参数设置的预期流控时间（单位：秒），为了达到这个预期主机所需要的睡眠时间（单位：微秒）。 | - remote_redo_stat() 描述：显示整个集群所有实例的日志回放情况（本节点除外、DN上不可使用）。 返回值类型：record 表19remote_redo_stat参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 实例名称。 | | redo_start_ptr | int8 | 当前实例日志回放的起始点。 | | redo_start_time | int8 | 当前实例日志回放的起始UTC时间。 | | redo_done_time | int8 | 当前实例日志回放的结束UTC时间。 | | curr_time | int8 | 当前实例的当前UTC时间。 | | min_recovery_point | int8 | 当前实例日志的最小一致性点位置。 | | read_ptr | int8 | 当前实例日志的读取位置。 | | last_replayed_read_ptr | int8 | 当前实例的日志回放位置。 | | recovery_done_ptr | int8 | 当前实例启动完成时的回放位置。 | | read_xlog_io_counter | int8 | 当前实例读取回放日志的I/O次数计数。 | | read_xlog_io_total_dur | int8 | 当前实例读取回放日志的I/O总时延。 | | read_data_io_counter | int8 | 当前实例回放过程中读取数据页面的I/O次数计数。 | | read_data_io_total_dur | int8 | 当前实例回放过程中读取数据页面的I/O总时延。 | | write_data_io_counter | int8 | 当前实例回放过程中写数据页面的I/O次数计数。 | | write_data_io_total_dur | int8 | 当前实例回放过程中写数据页面的I/O总时延。 | | process_pending_counter | int8 | 当前实例回放过程中日志分发线程的同步次数计数。 | | process_pending_total_dur | int8 | 当前实例回放过程中日志分发线程的同步总时延。 | | apply_counter | int8 | 当前实例回放过程中回放线程的同步次数计数。 | | apply_total_dur | int8 | 当前实例回放过程中回放线程的同步总时延。 | | speed | int8 | 当前实例日志回放速率。 | | local_max_ptr | int8 | 当前实例启动成功后本地收到的回放日志的最大值。 | | primary_flush_ptr | int8 | 主机落盘日志的位置。 | | worker_info | text | 当前实例回放线程信息，若没有开并行回放则该值为空。 | - pgxc_gtm_snapshot_status() 描述：用于查看当前GTM上事务信息，仅在GTM模式下支持本系统函数，GTM-LITE和GTM-FREE模式下不支持。 返回值类型：record 函数返回字段描述如下： 表20pgxc_gtm_snapshot_status返回参数说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | xmin | xid | 仍在运行的最小事务号。 | | xmax | xid | 已完成的所有事务号中最大事务号的下一个事务号。 | | csn | integer | 待提交事务的序列号。 | | oldestxmin | xid | 当前最早的活跃事务在其取快照时，所有运行事务号最小的事务。 | | xcnt | integer | 当前活跃的事务个数。 | | running_xids | text | 当前活跃的事务号。 | - pv_os_run_info() 描述：显示当前操作系统运行的状态信息，具体字段信息参考[PV_OS_RUN_INFO](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1386.html)。 参数：nan 返回值类型：setof record - pv_session_stat() 描述：以会话线程或AutoVacuum线程为单位，统计会话状态信息，具体字段信息参考[PV_SESSION_STAT](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1391.html)。 参数：nan 返回值类型：setof record - pv_session_time() 描述：用于统计会话线程的运行时间信息，及各执行阶段所消耗时间，具体字段信息参考[PV_SESSION_TIME](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1392.html)。 参数：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 - gs_prepared_statements() 描述：显示所有会话所有可用的预备语句。该函数需要SYSADMIN权限的用户才能够执行。函数返回信息具体的字段和[GS_ALL_PREPARED_STATEMENTS](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-1255.html)字段一致。 返回值类型：record - local_redo_time_count(\[int\]) 描述：返回本节点回放流程的耗时统计（仅在备机上存在有效数据）。在并行回放模式下，返回各个回放线程的流程耗时统计。在极致RTO模式下，返回各回放线程的流程耗时统计和不同日志类型的流程耗时统计。 参数： | 参数名 | 类型 | 描述 | |:---|:---|:---| | operation | int | 可选输入，若无输入则行为是查询统计信息。 - -1：表示关闭统计开关（默认状态为关闭）。 - 0：表示打开统计开关。 - 1：表示查询统计信息。 - 2：表示重置统计信息。 关闭统计开关后，重新打开时会清理之前的统计信息。 | 返回值如下： 表21local_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（是否回放到指定位置）。 - 并行回放： 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 manager：database类日志处理。 redo worker：回放数据page页的日志。 trxn manager：分发给trxn worker。 trxn worker：强同步类型日志通知完成等待。 read page worker：更新本线程lsn。 startup：日志decode。 - 并行回放： page redo：share trxn日志回放。 startup：日志回放。 | | step5_count | step5的统计次数。 | | step6_total | step6的总时间，每个线程对应的流程如下： - 极致RTO： redo worker：回放非数据页page日志。 trxn manager：全局lsn更新。 - 并行回放： 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：强同步等待。 redo manager：段页式类日志处理。 - 并行回放: page redo：all workers do日志回放。 | | step8_count | step8的统计次数。 | | step9_total | step9的总时间，每个线程对应的流程如下： - 极致RTO： redo manager：处理段页式UNDO日志。 - 并行回放： page redo：multi workers do日志回放。 | | step9_count | step9的统计次数。 | 日志类型的流程耗时统计：（开关为关闭的情况下，会对回放的日志进行抽样统计） | 字段名 | 流程描述 | |:---|:---| | thread_name | 采样的名称 | | step1_total | 极致RTO: - 数据类型日志：处理日志整体用时，包含step2。 - 事务类型日志：回放事务日志。 | | step1_count | step1的统计次数。 | | step2_total | 极致RTO: - 数据类型日志：回放page页日志整体用时，包含step3、step4。step2和（step3+step4）的差值主要是执行备机读多版本页面的构建。 - 事务类型日志：事务线程回放前同步等待时间。 | | step2_count | step2的统计次数。 | | step3_total | 极致RTO: - 数据类型日志：读取数据page页。 | | step3_count | step3的统计次数。 | | step4_total | 极致RTO: - 数据类型日志：回放数据page页的日志。 | | step4_count | step4的统计次数。 | | step5_total | 极致RTO: - 事务类型日志：在redo_worker线程回放的用时。 | | step5_count | step5的统计次数。 | | step6_total | 极致RTO: - 数据类型日志：更新fsm。 | | step6_count | step6的统计次数。 | | Step7_total | 极致RTO: - 事务类型日志：在redo_worker线程同步等待的用时。 | | Step7_count | Step7的统计次数。 | - local_xlog_redo_statics() 描述：返回本节点已经回放的各个类型的日志统计信息（仅在备机上有有效数据）。 返回值如下： 表22local_xlog_redo_statics返回参数说明 | 字段名 | 描述 | |:---|:---| | xlog_type | 日志类型。 | | rmid | resource manager id。 | | info | Xlog operation。 | | num | 日志个数。 | | extra | 针对page回放日志和xact日志有有效值。 - 如果是page页回放日志类型则表示从磁盘读取page的个数。 - 如果是xact日志类型则表示删除文件的个数。 | - remote_bgwriter_stat() 描述：显示整个集群所有实例的bgwriter线程刷页信息，候选buffer链中页面个数，buffer淘汰信息（本节点除外、DN上不可使用）。 返回值类型：record 表23remote_bgwriter_stat参数说明 | 参数 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 实例名称。 | | bgwr_actual_flush_total_num | bigint | 从启动到当前时间bgwriter线程总计刷脏页数量。 | | bgwr_last_flush_num | integer | bgwriter线程上一批刷脏页数量。 | | candidate_slots | integer | 当前候选buffer链中页面个数。 | | get_buffer_from_list | bigint | buffer淘汰从候选buffer链中获取页面的次数。 | | get_buf_clock_sweep | bigint | buffer淘汰从原淘汰方案中获取页面的次数。 | 示例： remote_bgwriter_stat函数查询bgwriter线程刷页信息。 ``` gaussdb=# SELECT * FROM remote_bgwriter_stat(); node_name | bgwr_actual_flush_total_num | bgwr_last_flush_num | candidate_slots | get_buffer_from_list | get_buf_clock_sweep -----------+-----------------------------+---------------------+-----------------+----------------------+--------------------- datanode3 | 0 | 0 | 266232 | 404 | 0 datanode2 | 0 | 0 | 266232 | 424 | 0 datanode1 | 0 | 0 | 266232 | 393 | 0 (3 rows) ``` - gs_stack() 描述：显示线程调用栈。查询该函数需要有SYSADMIN权限或者MONADMIN权限。 参数：tid，线程id。tid是可选参数，指定tid参数时，函数返回tid对应线程调用栈；当不指定tid参数时，函数返回所有线程的调用栈。 返回值：当指定tid时，返回值为text；当不指定tid时，返回值为setof record。 示例： 获取指定线程调用栈。 ``` 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) ``` 获取所有线程的调用栈。 ``` 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 ``` ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 不支持多个gs_stack()并发。 - gs_perf_start(duration integer\[, freq integer\]) 描述：采集当前节点上各个线程的on-cpu火焰图的堆栈调用数据，函数返回火焰图落盘地址。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT/DBUSER模式下可用，在DISABLE模式下不可用。 参数说明如下： | 参数名称 | 描述 | 类型 | 范围 | |:---|:---|:---|:---| | duration | 采集堆栈时长（单位为秒，如果输入浮点型，会对浮点型小数点后第一位进行四舍五入后取整处理）。 | integer | 1\~60 | | freq | 采集堆栈频率（可选参数，单位为HZ，默认为100，如果输入浮点型，会对浮点型小数点后第一位进行四舍五入后取整处理）。 | integer | 10\~1000 | 返回值类型：text 示例： 设置频率为100HZ，采集10s的on-cpu堆栈信息。 ``` gaussdb=# SELECT gs_perf_start(10,100); gs_perf_start ------------------------------------------------------------------------------------ Successfully collected perf flamegraph data, the result filepaths are : + $GAUSSLOG/gs_flamegraph/cn_5001/flamegraph-manual-oncpu-2025-03-03_104812.html.gz;+ Record 886 cpu clock samples. + (1 row) ``` ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) 执行该函数时（包括后述gs_perf_start_offcpu()、gs_perf_start_all()、gs_perf_start_detail()）需要gs_perf_service正常运行。同时gs_perf_service在采集过程中，需要申请环形buffer，该buffer的大小受操作系统中/proc/sys/kernel/perf_event_mlock_kb控制。如果采集过程中出现"perf mmap failed"错误，可以在调整/proc/sys/kernel/perf_event_mlock_kb的大小后，再重新执行采集。 - gs_perf_start_offcpu(duration integer) 描述：采集当前节点上各个线程的off-cpu火焰图的堆栈调用数据，函数返回火焰图落盘地址。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER/DISABLE模式下不可用。 参数说明如下： | 参数名称 | 描述 | 类型 | 范围 | |:---|:---|:---|:---| | duration | 采集堆栈时长（单位为毫秒，如果输入浮点型，会对浮点型小数点后第一位进行四舍五入后取整处理）。 | integer | 50\~3000 | 返回值类型：text 示例： 采集2000ms的off-cpu堆栈信息。 ``` gaussdb=# SELECT gs_perf_start_offcpu(2000); gs_perf_start_offcpu ------------------------------------------------------------------------------------- Successfully collected perf flamegraph data, the result filepaths are : + $GAUSSLOG/gs_flamegraph/cn_5001/flamegraph-manual-offcpu-2025-03-03_104918.html.gz;+ Record 48 sched switch samples. + (1 row) ``` - gs_perf_start_detail(duration integer\[, freq integer\]) 描述：采集当前节点所在机器上所有CPU核心的所有线程中on-cpu/off-cpu堆栈的调用栈详细信息，函数返回多核多线程原始数据压缩文件地址。每次运行该命令时，都会删除历史采集的多核多线程数据。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER/DISABLE模式下不可用。 参数说明如下： | 参数名称 | 描述 | 类型 | 范围 | |:---|:---|:---|:---| | duration | 采集堆栈时长（单位为毫秒，如果输入浮点型，会对浮点型小数点后第一位进行四舍五入后取整处理）。 | integer | 50\~3000 | | freq | 采集堆栈频率（可选参数，单位为HZ，默认为100，如果输入浮点型，会对浮点型小数点后第一位进行四舍五入后取整处理）。 | integer | 10\~1000 | 返回值类型：text 示例： 采集2000ms的多核多线程火焰图数据。 ``` gaussdb=# SELECT gs_perf_start_detail(2000); gs_perf_start_detail --------------------------------------------------------------------------------------------------- Successfully collected perf detail data, the result filepath is : + $GAUSSLOG/gs_flamegraph/cn_5001/detail-2025-03-03_105043.lz4 + Please save the file locally, otherwise the file will be deleted during the next data collection.+ Record 1735211 samples. + (1 row) ``` - gs_perf_start_all(duration integer\[, freq integer\]) 描述：采集当前节点所在机器上所有节点中on-cpu/off-cpu火焰图的堆栈调用数据，函数返回所有节点落盘火焰图文件地址。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER模式下只能采集oncpu火焰图数据，在DISABLE模式下不可用。 参数说明如下： | 参数名称 | 描述 | 类型 | 范围 | |:---|:---|:---|:---| | duration | 采集堆栈时长（单位为毫秒，如果输入浮点型，会对浮点型小数点后第一位进行四舍五入后取整处理）。 | integer | 50\~3000 | | freq | 采集堆栈频率（可选参数，单位为HZ，默认为100，如果输入浮点型，会对浮点型小数点后第一位进行四舍五入后取整处理）。 | integer | 10\~1000 | 返回值类型：text 示例： 设置频率为100HZ，采集1000ms当前节点所在机器上所有节点中oncpu/offcpu火焰图数据。 ``` gaussdb=# SELECT gs_perf_start_all(1000,100); gs_perf_start_all --------------------------------------------------------------------------------------------------------- Successfully collected perf flamegraph data, the result filepaths are : + $GAUSSLOG/gs_flamegraph/{nodename}/flamegraph-manual-oncpu-2025-03-03_105122.html.gz; + $GAUSSLOG/gs_flamegraph/{nodename}/flamegraph-manual-offcpu-2025-03-03_105122.html.gz; + Please visit gs_flamegraph directory(all nodes of current machine) to get results for individual nodes.+ Record 664 cpu clock samples. + Record 370 sched switch samples. + (1 row) ``` - gs_perf_list() 描述：查看当前节点上保存的on-cpu/off-cpu火焰图的采集数据，不会展示多核多线程火焰图记录。该函数在ROOT/DBUSER模式下可用，在DISABLE模式下不可用。 参数：nan 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | nodename | text | 采集节点名称。 | | filename | text | 采集落盘文件名称。 | | collect_type | text | 采集类型。 | 示例： 查询当前节点上保存的火焰图生成记录。 ``` gaussdb=# SELECT * FROM gs_perf_list() limit 10; nodename | filename | collect_type ----------+--------------------------------------------------------+-------------- cn_5001 | flamegraph-auto-offcpu-2025-03-02_175022.html.gz | auto cn_5001 | flamegraph-cpuspiking-offcpu-2025-03-02_140825.html.gz | cpuspiking cn_5001 | flamegraph-auto-offcpu-2025-03-03_063522.html.gz | auto cn_5001 | flamegraph-auto-offcpu-2025-03-03_102523.html.gz | auto cn_5001 | flamegraph-auto-offcpu-2025-03-02_173523.html.gz | auto cn_5001 | flamegraph-manual-offcpu-2025-03-03_025410.html.gz | manual cn_5001 | flamegraph-manual-oncpu-2025-03-03_003428.html.gz | manual cn_5001 | flamegraph-manual-oncpu-2025-03-02_181653.html.gz | manual cn_5001 | flamegraph-manual-oncpu-2025-03-03_031815.html.gz | manual cn_5001 | flamegraph-manual-oncpu-2025-03-03_001013.html.gz | manual (10 rows) ``` - gs_perf_query(\[filename text\]) 描述：查询历史采集on-cpu/off-cpu火焰图的堆栈调用数据。函数归并各个线程的函数调用栈并求和函数运行时间，返回聚集后的结果。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT/DBUSER模式下可用，在DISABLE模式下不可用。 参数说明如下： | 参数名称 | 描述 | 类型 | |:---|:---|:---| | filename | 历史采集的文件的名称（可选参数，默认为最近一次手动采集的火焰图）。 | text | 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | backtrace | text | 堆栈名称（带树状结构）。 | | period | bigint | 堆栈的执行时间。 | | level | integer | 堆栈所在堆栈调用树的层级。 | | sequence | integer | 堆栈调用树排序后的顺序。 | | thread_name | text | 该堆栈所在的线程名称。 | | overhead | float | 该堆栈执行所占时间百分比。 | 示例： 查询采集到的堆栈信息。 ``` gaussdb=# SELECT * FROM gs_perf_query() WHERE overhead > 2 AND level < 10; backtrace | period | level | sequence | thread_name | overhead -------------------------------------------------------------------------------+-------------+-------+----------+---------------+---------- root +| 74140000000 | 0 | 1 | root | 100 | | | | | worker +| 69930000000 | 1 | 2 | worker | 94.32 | | | | | |── start_thread +| 67620000000 | 2 | 3 | worker | 91.21 | | | | | | └── ThreadStarterFunc +| 67620000000 | 3 | 4 | worker | 91.21 | | | | | | └── internal_thread_func +| 67620000000 | 4 | 5 | worker | 91.21 | | | | | | └── int gauss_db_thread_main +| 67620000000 | 5 | 6 | worker | 91.21 | | | | | | └── backend_run +| 67620000000 | 6 | 7 | worker | 91.21 | | | | | | |── PostgresMain +| 67520000000 | 7 | 8 | worker | 91.07 | | | | | | | |── exec_simple_query +| 64800000000 | 8 | 9 | worker | 87.4 | | | | | | | | |── OpFusion::opfusion_process +| 30130000000 | 9 | 10 | worker | 40.64 | | | | | | | | |── pg_analyze_and_rewrite +| 11290000000 | 9 | 1405 | worker | 15.23 | | | | | | | | |── pg_plan_queries +| 9550000000 | 9 | 2660 | worker | 12.88 | | | | | | | | |── PortalRun +| 4680000000 | 9 | 4310 | worker | 6.31 | | | | | | | | |── finish_xact_command +| 3120000000 | 9 | 4923 | worker | 4.21 | | | | | | | | |── pg_parse_query +| 1520000000 | 9 | 5262 | worker | 2.05 | | | | | | | | |── OpFusion::opfusion_factory +| 1500000000 | 9 | 5374 | worker | 2.02 | | | | | txnsnapworker +| 1640000000 | 1 | 6770 | txnsnapworker | 2.21 | | | | | |── start_thread +| 1620000000 | 2 | 6771 | txnsnapworker | 2.19 | | | | | | └── ThreadStarterFunc +| 1620000000 | 3 | 6772 | txnsnapworker | 2.19 | | | | | | └── internal_thread_func +| 1620000000 | 4 | 6773 | txnsnapworker | 2.19 | | | | | | └── int gauss_db_thread_main +| 1620000000 | 5 | 6774 | txnsnapworker | 2.19 | | | | | | └── txn_snap_cap_worker_main +| 1620000000 | 6 | 6775 | txnsnapworker | 2.19 | | | | | | └── PostgresInitializer::InitTxnSnapWorker +| 1620000000 | 7 | 6776 | txnsnapworker | 2.19 | | | | | | |── PostgresInitializer::SetDatabase +| 1600000000 | 8 | 6777 | txnsnapworker | 2.16 | | | | | | | └── PostgresInitializer::SetDatabaseByName+| 1600000000 | 9 | 6778 | txnsnapworker | 2.16 ``` - gs_perf_query_general(\[filename text\]) 描述：查询历史采集on-cpu/off-cpu火焰图的堆栈调用函数占比数据，由于计算精度原因，该占比数据总和可能会不等于1。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT/DBUSER模式下可用，在DISABLE模式下不可用。 参数说明如下： | 参数名称 | 描述 | 类型 | |:---|:---|:---| | filename | 历史采集的文件的名称（可选参数，默认为最近一次手动采集的火焰图）。 | text | 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | function_name | text | 堆栈函数名称。 | | percentage | float | 堆栈函数调用占比。 | 示例： 查询最近一次手动采集生成的火焰图函数调用占比。 ``` gaussdb=# SELECT * FROM gs_perf_query_general(); function_name | percentage -------------------------------+------------ pthread_mutex_lock | 28.57 do_select | 7.17 undopage::init_undo_zone_lock | 7.14 unknown | 7.14 undo::recycle_main | 7.14 undo::is_valid_zone_id | 7.14 __vdso_gettimeofday | 7.14 hrtimer_start_range_ns | 7.14 undo::get_zone_id | 7.14 __pthread_mutex_unlock | 7.14 gs_stat_encap_status_info | 7.14 (11 rows) ``` - gs_perf_query_detail(\[filename text\]) 描述：查询历史采集on-cpu/off-cpu火焰图的堆栈函数调用占比及调用堆栈详细信息，由于计算精度原因，该占比数据总和可能会不等于1。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT/DBUSER模式下可用，在DISABLE模式下不可用。 参数说明如下： | 参数名称 | 描述 | 类型 | |:---|:---|:---| | filename | 历史采集的文件的名称（可选参数，默认为最近一次手动采集的火焰图）。 | text | 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | function_name | text | 堆栈函数名称。 | | percentage | float | 堆栈函数调用占比。 | | function_callstack | text | 堆栈函数调用栈。 | | function_callstack_percentage | float | 堆栈函数调用栈占比。 | 示例： 查询最近一次手动采集生成的火焰图调用占比详情。 ``` testdb3=# SELECT * FROM gs_perf_query_detail(); function_name | percentage | function_callstack | function_callstack_percentage --------------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------- pthread_mutex_lock | 30 | TrackStmtWorker->unknown->internal_thread_func->int gauss_db_other_feature_thread_main->pthread_mutex_lock | 30 stmt_flush_main | 20 | TrackStmtWorker->unknown->internal_thread_func->int gauss_db_other_feature_thread_main->stmt_flush_main | 20 finish_task_switch | 20 | AntiRecycler->unknown->internal_thread_func->int gauss_db_storage_thread_main->anti_recycler_main->anti_tab_recycle_loop->__select ->[enter kernel]->system_call_fastpath->SyS_select->core_ sys_select->do_select->poll_schedule_timeout->schedule_hrtimeout_range->schedule_hrtimeout_range_clock->schedule->__schedule->finish_task_switch | 10 finish_task_switch | 20 | vlogwriter->unknown->internal_thread_func->int gauss_db_storage_thread_main->verifylogwriter_main->__select ->[enter kernel]->system_call_fastpath->SyS_select->core_sys_select->do_select-> poll_schedule_timeout->schedule_hrtimeout_range->schedule_hrtimeout_range_clock->schedule->__schedule->finish_task_switch | 10 system_call_after_swapgs | 10 | WALwriter->semctl ->[enter kernel]->system_call_after_swapgs | 10 lwlock_release | 10 | AntiRecycler->unknown->internal_thread_func->int gauss_db_storage_thread_main->anti_recycler_main->anti_tab_recycle_loop->lwlock_release | 10 __select | 10 | AntiRecycler->unknown->internal_thread_func->int gauss_db_storage_thread_main->anti_recycler_main->anti_tab_recycle_loop->__select | 10 (7 rows) ``` - gs_perf_report() 描述：当前版本采集逻辑默认落盘，不再需要手动指令进行落盘。作用为展示上一次手动查询oncpu的文件地址。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT/DBUSER模式下可用，在DISABLE模式不可用。 参数：nan 返回值类型：text 示例： 生成火焰图文件。 ``` testdb3=# SELECT * FROM gs_perf_report(); gs_perf_report ------------------------------------------------ flamegraph-manual-oncpu-2025-01-24_140232.html.gz (1 row) ``` - gs_perf_clean() 描述：当前版本采集逻辑默认落盘，采集后不再占用内存上下文，不再需要手动指令进行清理内存数据。当前版本提示函数废弃，后续版本直接移除函数。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT/DBUSER模式下可用，在DISABLE模式下不可用。 参数：nan 返回值类型：text 示例： 清理perf产生的数据。 ``` gaussdb=# SELECT * FROM gs_perf_clean(); gs_perf_clean --------------------------------------------------------------------------------------------------------------------------------- gs_perf_clean is a duplicated function. now you don't need clean perf memory. this function will be removed in the next version (1 row) ``` - gs_perf_start_shaking_collect(scope text, unique_querys textarray, duration int, max_collect_times int, ringbuffer_size int) 描述：用于开启性能抖动监控，并返回开启操作是否成功。开启性能抖动监控后会清理已存在的性能抖动火焰图文件。重复执行gs_perf_start_shaking_collect函数，若前一次性能抖动监控未结束，后一次仅会重设unique_querys参数和清理已存在的性能抖动火焰图文件，不会影响gs_perf_service的行为。当某SQL发生慢SQL且属于unique_querys入参时，则触发性能抖动火焰图生成，如果该慢SQL在CN上执行则采集所有节点的性能抖动火焰图，否则采集本节点的性能抖动火焰图。节点开启性能抖动监控失败后会尝试关闭该节点性能抖动监控。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER/DISABLE模式下不可用。 表24gs_perf_start_shaking_collect参数说明 | 参数名称 | 类型 | 描述 | 范围 | |:---|:---|:---|:---| | scope | text | local代表开始本节点监控。all代表开启所有节点性能抖动监控，all仅支持在分布式CN上使用。必填，填NULL则为local。 | local或all | | unique_querys | textarray | 被监控的unique sql id列表，慢sql属于这个列表的话是性能抖动。必填，填NULL则为空列表。 | 列表长度限制为0-32 | | duration | int | 性能抖动最长连续监控时长，单位为分钟。必填，填NULL则为60。 | 5-6000 | | max_collect_times | int | 性能抖动火焰图最大性能抖动快照保存次数，超过该值停止采集perf数据。必填，填NULL则为3。 | 1-10 | | ringbuffer_size | int | 保存性能perf的环形缓冲区的大小，单位为MB。必填，填NULL则为8。 | 1-32 | 返回值说明如下： 表25gs_perf_start_shaking_collect返回值说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | nodename | text | 节点名称。 | | message | text | 返回值为"Successfully entered CPU_SHAKE mode."，表示性能抖动监控开启成功。 返回值为"Current is in CPU_SHAKE mode."，表示重复开启监控。 返回值为"Unexpected Result: start_shaking_collect error，try to close shaking collect success. Details：详细报错消息"，表示该节点开启失败，并成功关闭。 返回值为"Unexpected Result: start_shaking_collect error，try to close shaking collect failed. Details：详细报错消息"，表示该节点开启失败，并且关闭失败，常见于断连状态。 | 示例： 开启所有节点性能抖动监控。设置要监控的unique sql id 列表为{4124148646,2053082188}，监控时长为60分钟，最大性能抖动快照保存次数为4次，环形缓冲区大小为8MB。 ``` gaussdb=# SELECT * FROM gs_perf_start_shaking_collect('all','{4124148646,2053082188}',60,4,8); nodename | message ----------+-------------------------------------- cn_5001 | Current is in CPU_SHAKE mode. cn_5002 | Current is in CPU_SHAKE mode. cn_5003 | Current is in CPU_SHAKE mode. dn_6001 | Successfully entered CPU_SHAKE mode. dn_6004 | Successfully entered CPU_SHAKE mode. dn_6007 | Successfully entered CPU_SHAKE mode. dn_6002 | Current is in CPU_SHAKE mode. dn_6003 | Current is in CPU_SHAKE mode. dn_6005 | Current is in CPU_SHAKE mode. dn_6006 | Current is in CPU_SHAKE mode. dn_6009 | Current is in CPU_SHAKE mode. dn_6008 | Current is in CPU_SHAKE mode. (12 rows) ``` ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - 执行gs_perf_start_shaking_collect()、gs_perf_do_shaking_collect()、gs_perf_close_shaking_collect()、gs_perf_get_shaking_collect_status()需要gs_perf_service正常运行。同时gs_perf_service在采集过程中，需要申请环形buffer，该buffer的大小由cpu核心数和gs_perf_start_shaking_collect()的入参ringbuffer_size控制。 - 执行gs_perf_start_shaking_collect()、gs_perf_do_shaking_collect()、gs_perf_close_shaking_collect()、gs_perf_get_shaking_collect_status()命令过程中手动中止或者消息返回超时只会中断前端SQL，不会终止后台perf_service进程执行对应任务。在gs_perf_do_shaking_collect()执行过程中可以通过sudo kill -9 perf_service进程PID方式关闭perf_service进程，强制打断后台任务。 - 开启、关闭性能抖动监控以及保存性能抖动火焰图以物理机器为单位。因此，在某个节点上开启、关闭和保存时，会影响同一物理机器上其他节点的监控状态。例如，在某节点上开启性能抖动监控后，同一机器上其他节点也会进入监控状态并且不能再次开启监控。 - 当scope参数为all时，开启、关闭性能抖动监控以及保存性能抖动火焰图的实现方式为顺序遍历所有节点，在每个节点上执行对应的开启、关闭和保存操作。因此，同一机器上只有一个节点会返回成功消息，其他节点会返回重复执行的失败消息。 - 集群中某节点故障后，调用系统函数且scope为all，故障节点不会执行相应操作，正常节点会执行相应操作，互不影响。返回结果中故障节点node_name字段为node_host:node_port。 - 当发生被监控的SQL触发慢SQL并采集所有节点性能抖动数据时，会顺序遍历所有节点并采集节点所在机器性能抖动数据，遍历顺序不固定，最终保证每个物理机器都有一个节点采集了性能抖动数据。 - 升级部分分片之后，可以在升级上的分片上执行新增性能抖动火焰图函数，返回结果中升级上的分片正常返回。 - 采集进程gs_perf_service重启之后，性能抖动监控会被解除。如果希望再次监控，需要重新执行开启性能抖动监控的命令。 - 使用gs_perf_start_shaking_collect()函数启动性能抖动监控后，数据库需要约1秒的时间完成火焰图资源的初始化，随后采集性能抖动火焰图文件。 - gs_perf_do_shaking_collect(scope text) 描述：用于执行性能抖动多核多线程火焰图落盘，即保存性能抖动快照，返回是否保存成功的结果。依赖于gs_perf_start_shaking_collect()接口，开启性能抖动监控才能执行性能抖动快照落盘。两次落盘最小时间间隔为1min。为防止后台采集进程hang住，当单节点执行性能抖动火焰图生成动作时，后台采集进程gs_perf_service超过10min未完成，或者gs_perf_service在执行性能抖动采集时异常退出，会返回超时消息。执行该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER/DISABLE模式下不可用。 表26gs_perf_do_shaking_collect参数说明 | 参数名称 | 类型 | 描述 | 范围 | |:---|:---|:---|:---| | scope | text | local代表本节点的perf数据落盘，all代表开始所有节点的perf数据落盘，all仅支持在分布式CN上使用。必填，填NULL则为local。 | all或local | 返回值说明如下： 表27gs_perf_do_shaking_collect返回值说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | nodename | text | 节点名称。 | | message | text | 返回值为"Successfully collect perf detail data ......"，表示性能抖动快照保存成功。 返回值为"Current is not in CPU_SHAKE mode."，表示未在监控状态，性能抖动快照保存失败。 返回值为"Skipping collection this time ......"，表示1min内重复保存。 返回值为"Unexpected Result: do_shaking_collect error. Details: 详细报错消息"，表示执行失败。 | 示例： 所有节点执行性能抖动快照落盘。返回保存成功、快照路径和落盘时间。 ``` gaussdb=# SELECT * FROM gs_perf_do_shaking_collect('all'); nodename | message ----------+---------------------------------------------------------------------------------------------------------------------------------- ---------------------------------------------------------- cn_5001 | Skipping collection this time. Reason: The data has already been collected just now. cn_5002 | Skipping collection this time. Reason: The data has already been collected just now. cn_5003 | Skipping collection this time. Reason: The data has already been collected just now. dn_6001 | Successfully collect perf detail data. The file path is: $GAUSSLOG/gs_flamegraph/dn_6001/shake_detail-2025-11-27_173849.lz4, collect time is 2025-11-27_173849 dn_6004 | Successfully collect perf detail data. The file path is: $GAUSSLOG/gs_flamegraph/dn_6004/shake_detail-2025-11-27_173850.lz4, collect time is 2025-11-27_173850 dn_6007 | Skipping collection this time. Reason: The data has already been collected just now. dn_6003 | Successfully collect perf detail data. The file path is: $GAUSSLOG/gs_flamegraph/dn_6003/shake_detail-2025-11-27_173850.lz4, collect time is 2025-11-27_173850 dn_6002 | Skipping collection this time. Reason: The data has already been collected just now. dn_6005 | Skipping collection this time. Reason: The data has already been collected just now. dn_6006 | Skipping collection this time. Reason: The data has already been collected just now. dn_6009 | Skipping collection this time. Reason: The data has already been collected just now. dn_6008 | Skipping collection this time. Reason: The data has already been collected just now. (12 rows) ``` - gs_perf_close_shaking_collect(scope text) 描述：用于关闭性能抖动监控，并返回关闭操作是否成功。该函数依赖于gs_perf_start_shaking_collect()接口，必须先启动监控才能关闭，否则将返回未在监控中的提示信息。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER/DISABLE模式下不可用。 表28gs_perf_close_shaking_collect参数说明 | 参数名称 | 类型 | 描述 | 范围 | |:---|:---|:---|:---| | scope | text | local代表结束本节点监控，all代表结束所有节点监控，all仅支持在分布式CN上使用。必填，填NULL则为local。 | local或all | 返回值说明如下： 表29gs_perf_close_shaking_collect返回值说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | nodename | text | 节点名称。 | | message | text | 返回值为"Successfully exit CPU_SHAKE mode."，表示性能抖动监控关闭成功。 返回值为"Current is not in CPU_SHAKE mode."，表示未在监控状态，关闭失败。 返回值为"Unexpected Result: close_shaking_collect error. Detail: 详细报错消息"，表示关闭失败。 | 示例： ``` gaussdb=# SELECT * FROM gs_perf_close_shaking_collect('all'); nodename | message ----------+----------------------------------- cn_5001 | Current is not in CPU_SHAKE mode. cn_5002 | Current is not in CPU_SHAKE mode. cn_5003 | Current is not in CPU_SHAKE mode. dn_6001 | Successfully exit CPU_SHAKE mode. dn_6004 | Current is not in CPU_SHAKE mode. dn_6007 | Current is not in CPU_SHAKE mode. dn_6002 | Current is not in CPU_SHAKE mode. dn_6003 | Current is not in CPU_SHAKE mode. dn_6005 | Successfully exit CPU_SHAKE mode. dn_6006 | Current is not in CPU_SHAKE mode. dn_6009 | Successfully exit CPU_SHAKE mode. dn_6008 | Current is not in CPU_SHAKE mode. (12 rows) ``` - gs_perf_get_shaking_collect_result(scope text) 描述：用于查看最近一次监控中的性能抖动火焰图采集历史文件。每次开启性能抖动监控时，会清空性能抖动快照采集历史，返回结果仅包括正常节点。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER/DISABLE模式下不可用。 表30gs_perf_get_shaking_collect_result参数说明 | 参数名称 | 类型 | 描述 | 范围 | |:---|:---|:---|:---| | scope | text | local代表查询本节点性能抖动火焰图快照历史，all代表查询所有节点性能抖动火焰图快照历史，all仅支持在分布式CN上使用。必填，填NULL则为local。 | local或all | 返回值说明如下： 表31gs_perf_get_shaking_collect_result返回值说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | nodename | text | 节点名称。 | | num | text | 采集序号。 | | filename | text | 性能抖动快照文件名。 | | shake_time | text | 性能抖动快照落盘时间。 | 示例： 查看最近一次监控中的性能抖动火焰图采集历史。 ``` gaussdb=# SELECT * FROM gs_perf_get_shaking_collect_result('all'); nodename | num | filename | shake_time ----------+-----+------------------------------------+------------------- dn_6001 | 1 | shake_detail-2025-11-28_160835.lz4 | 2025-11-28_160835 dn_6004 | 1 | shake_detail-2025-11-28_160835.lz4 | 2025-11-28_160835 dn_6003 | 1 | shake_detail-2025-11-28_160835.lz4 | 2025-11-28_160835 (3 rows) ``` - gs_perf_get_shaking_collect_status(scope text) 描述：用于查看节点性能抖动监控状态。查询该函数需要有SYSADMIN权限或者MONADMIN权限。该函数在ROOT模式下可用，在DBUSER/DISABLE模式下不可用。 表32gs_perf_get_shaking_collect_status参数说明 | 参数名称 | 类型 | 描述 | 范围 | |:---|:---|:---|:---| | scope | text | local代表查询本节点所在机器的采集状态，all代表查询所有节点所在机器的采集状态，all仅用于分布式。必填，填NULL，如果执行节点为CN则为all，否则为local。 | local或all | 表33gs_perf_get_shaking_collect_status返回值说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | nodename | text | 节点名称。 | | status | text | 该节点所在机器是否已开启性能抖动监控。 - NOT IN SHAKE MODE：未在监控。 - IN SHAKE MODE：已在监控中。 - NO PERF SERVICE：采集进程未响应。 - Unexpected Result: get_shaking_connect_status error. Detail: 详细报错消息：表示查询失败。 | 示例： 查看该节点所在机器是否已开启性能抖动监控。 ``` gaussdb=# SELECT * FROM gs_perf_get_shaking_collect_status('all'); nodename | status ----------+--------------- cn_5001 | IN SHAKE MODE cn_5002 | IN SHAKE MODE cn_5003 | IN SHAKE MODE dn_6001 | IN SHAKE MODE dn_6004 | IN SHAKE MODE dn_6007 | IN SHAKE MODE dn_6002 | IN SHAKE MODE dn_6003 | IN SHAKE MODE dn_6005 | IN SHAKE MODE dn_6006 | IN SHAKE MODE dn_6009 | IN SHAKE MODE dn_6008 | IN SHAKE MODE (12 rows) ``` - 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 | 语句执行的开始时间。 | | stmt_elapse_time | bigint | 距离查询开始执行时已经过去的时间。 | | 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=# CREATE USER testuser WITH PASSWORD '********' sysadmin; gaussdb=# SET SESSION AUTHORIZATION testuser PASSWORD '********'; 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) gaussdb=> RESET SESSION AUTHORIZATION; gaussdb=# DROP USER testuser; ``` - 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权限执行。日志预解析线程通常在备DN双机复制链路断开时，由CM组件发送启动命令启动。如果日志预解析线程已经被启动，可以通过调用该函数查询最近一次的预解析状态。如果线程尚未启动，该函数将返回默认值。在容灾场景下，灾备集群的DN和CN会自动启动日志预解析线程。需要注意的是，CN仅在灾备集群中会启动日志预解析线程。 返回值类型：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) ``` 未拉起过日志预解析线程时的查询查询结果示例： ``` 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 ----------------+------------------------+------------------------+--------------------------+------------------------+-----------------------+-----------------+---------- 0 | 2000-01-01 08:00:00+08 | 2000-01-01 08:00:00+08 | 00000000/00000000 | 00000000/00000000 | 0 | 0 | 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 | base_page_file的总数量。 | | base_page_total_size | xid | base_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或灾备集群CN查询，其他情况查询结果为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或灾备集群CN查询，其他情况查询结果为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) 描述：查询发送回放冲突信号的数量。 参数：输入参数为数据库的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(\[int\]) 描述：查询WAL日志回放的相关统计信息。包括回放线程的缓存命中率、回放DDL日志删除文件数量、回放线程读取数据页时产生物理读、回放线程读取WAL日志的等待事件信息。需要连接备DN查询。 返回值类型：setof record | 参数类型 | 名称 | 类型 | 描述 | |:---|:---|:---|:---| | 输入参数 | operation | int | 可选输入，若无输入则行为是查询统计信息。 - 1：表示查询统计信息。 - 2：表示重置缓存命中率的统计信息。 | | 输出参数 | buffer_hit_rate | float8 | 回放线程的缓存命中率。 | | 输出参数 | ddl_unlink_nrels_count | int8 | 回放DDL日志删除文件数量。 | | 输出参数 | read_buffer_io_counter | int8 | 回放线程读取数据页时产生物理读的waitevent触发次数。 | | 输出参数 | read_buffer_io_total_dur | int8 | 回放线程读取数据页时产生物理读的waitevent总用时。 | | 输出参数 | read_buffer_io_avg_dur | int8 | 回放线程读取数据页时产生物理读的waitevent平均用时。 | | 输出参数 | read_buffer_io_min_dur | int8 | 回放线程读取数据页时产生物理读的waitevent最小用时。 | | 输出参数 | read_buffer_io_max_dur | int8 | 回放线程读取数据页时产生物理读的waitevent最大用时。 | | 输出参数 | read_wal_buf_counter | int8 | 回放线程读取WAL日志的waitevent触发次数。 | | 输出参数 | read_wal_buf_total_dur | int8 | 回放线程读取WAL日志的waitevent总用时。 | | 输出参数 | read_wal_buf_avg_dur | int8 | 回放线程读取WAL日志的waitevent平均用时。 | | 输出参数 | read_wal_buf_min_dur | int8 | 回放线程读取WAL日志的waitevent最小用时。 | | 输出参数 | read_wal_buf_max_dur | int8 | 回放线程读取WAL日志的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或灾备集群CN查询。 返回值类型：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类型回放冲突的最大用时。 | | conflict_bufferpin_counter | int8 | 处理buffer pin类型回放冲突的触发次数。 | | conflict_bufferpin_total_dur | int8 | 处理buffer pin类型回放冲突的总用时。 | | conflict_bufferpin_avg_dur | int8 | 处理buffer pin类型回放冲突的平均用时。 | | conflict_bufferpin_min_dur | int8 | 处理buffer pin类型回放冲突的最小用时。 | | conflict_bufferpin_max_dur | int8 | 处理buffer pin类型回放冲突的最大用时。 | 示例： ``` 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_timeout_max_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 conflict_bufferpin_counter | 0 conflict_bufferpin_total_dur | 0 conflict_bufferpin_avg_dur | 0 conflict_bufferpin_min_dur | 0 conflict_bufferpin_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_plsql_statements(sessionid bigint, pkg id oid, function id oid) 描述：返回存储过程相关内存信息。 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | pid | bigint | 后台线程id。 | | sessionid | bigint | 会话id。 | | global_sessionid | text | 全局会话id。 | | databaseid | oid | 数据库id。 | | pkg_id | oid | 存储过程所属PACKAGE id，如果不属于package则为0。 | | func_id | oid | 存储过程id。 | | func_signature | text | 存储过程名称（name + fn_collation + search_path）。 | | plsql_compiled_totalsize | bigint | 存储过程编译产物的总内存大小。 | | plsql_plan_totalsize | bigint | 存储过程内计划的总内存大小。 | 示例： ``` gaussdb=# CREATE OR REPLACE PROCEDURE proc_assign AS a int := 0; BEGIN a = a + 1; RAISE INFO '%', a; END; / gaussdb=# CALL proc_assign(); INFO: 1 proc_assign ------------- (1 row) gaussdb=# SELECT * FROM pg_catalog.gs_plsql_statements(pg_current_sessid()); pid | sessionid | global_sessionid | databaseid | pkg_id | func_id | func_signature | plsql_compiled_totalsize | plsql_plan_totalsize -----------+-----------+------------------+------------+--------+---------+---------------------------------------------------------------------- ------------+--------------------------+---------------------- 536868608 | 5052 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 8192 | 65536 (1 row) -- 需要过滤function id -- gaussdb=# SELECT * FROM pg_catalog.gs_plsql_statements(NULL, NULL, 16854); ``` ``` pid | sessionid | global_sessionid | databaseid | pkg_id | func_id | func_signature | plsql_compiled_totalsize | plsql_plan_totalsize -----------+-----------+------------------+------------+--------+---------+---------------------------------------------------------------------- ------------+--------------------------+---------------------- 536868608 | 5052 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 8192 | 65536 (1 row) gaussdb=# DROP PROCEDURE proc_assign; ``` - gs_global_plsql_statements(sessionid bigint, pkg id oid, function id oid) 描述：返回存储过程相关内存信息。 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 当前节点名称。 | | pid | bigint | 后台线程id。 | | sessionid | bigint | 会话id。 | | global_sessionid | text | 全局会话id。 | | databaseid | oid | 数据库id。 | | pkg_id | oid | 存储过程所属PACKAGE id，如果不属于PACKAGE则为0。 | | func_id | oid | 存储过程id。 | | func_signature | text | 存储过程名称（name + fn_collation + search_path）。 | | plsql_compiled_totalsize | bigint | 存储过程编译产物的总内存大小。 | | plsql_plan_totalsize | bigint | 存储过程内计划的总内存大小。 | 示例： ``` gaussdb=# CREATE OR REPLACE PROCEDURE proc_assign AS a int := 0; BEGIN a = a + 1; RAISE INFO '%', a; END; / gaussdb=# CALL proc_assign(); INFO: 1 proc_assign ------------- (1 row) gaussdb=# SELECT * FROM pg_catalog.gs_global_plsql_statements(pg_current_sessid()); node_name | pid | sessionid | global_sessionid | databaseid | pkg_id | func_id | func_signature | plsql_compiled_totalsize | plsql_plan_totalsize --------------+------------+-----------------+------------------+------------+--------+---------+------------------------------------------------ ---------------------------------------------------------------+--------------------------+---------------------- coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 16387 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 24576 | 64512 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13509 | name: gs_global_plsql_statements(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 122880 | 216064 (2 rows) gaussdb=# DROP PROCEDURE proc_assign; ``` - gs_plsql_statements_details(sessionid bigint, pkg id oid, function id oid) 描述：返回存储过程计划缓存语句相关内存信息。 ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 查询函数时，GaussDB会根据current_user的权限来决定是否允许访问。如果current_user是初始用户或系统管理员, 则可以查询所有会话信息。如果current_user是普通用户,则只能查看自己的会话信息(即session_user是当前用户的信息)。 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | pid | bigint | 后台线程id。 | | sessionid | bigint | 会话id。 | | global_sessionid | text | 全局会话id。 | | databaseid | oid | 数据库id。 | | pkg_id | oid | 存储过程所属PACKAGE id，如果不属于PACKAGE则为0。 | | func_id | oid | 存储过程id。 | | func_signature | text | 存储过程名称（name + fn_collation + search_path）。 | | lineno | bigint | 语句在存储过程内行号。 | | query | text | 计划缓存语句。 | | usedsize | bigint | 计划缓存语句使用内存大小。 | | totalsize | bigint | 计划缓存语句总内存大小。 | 示例： ``` gaussdb=# CREATE OR REPLACE PROCEDURE proc_assign AS a int := 0; BEGIN a = a + 1; RAISE INFO '%', a; END; / gaussdb=# CALL proc_assign(); INFO: 1 proc_assign ------------- (1 row) gaussdb=# SELECT * FROM pg_catalog.gs_plsql_statements_details(pg_current_sessid()); pid | sessionid | global_sessionid | databaseid | pkg_id | func_id | func_signature | lineno | query | usedsize | totalsize -----------+-----------+------------------+------------+--------+---------+---------------------------------------------------------------------- ------------+--------+--------------+----------+----------- 536868608 | 5251 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 3 | SELECT a + 1 | 15064 | 25600 536868608 | 5251 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 4 | SELECT a | 12320 | 17408 536868608 | 5251 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 1 | SELECT 0 | 12088 | 21504 (3 rows) -- 需要过滤function id -- gaussdb=# SELECT * FROM pg_catalog.gs_plsql_statements(NULL, NULL, 16854); pid | sessionid | global_sessionid | databaseid | pkg_id | func_id | func_signature | lineno | query | usedsize | totalsize -----------+-----------+------------------+------------+--------+---------+---------------------------------------------------------------------- ------------+--------+--------------+----------+----------- 536868608 | 5251 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 3 | SELECT a + 1 | 15064 | 25600 536868608 | 5251 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 4 | SELECT a | 12320 | 17408 536868608 | 5251 | 0:0#0 | 13108 | 0 | 16854 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 1 | SELECT 0 | 12088 | 21504 (3 rows) gaussdb=# DROP PROCEDURE proc_assign; ``` - gs_global_plsql_statements_details(sessionid bigint, pkg id oid, function id oid) 描述：返回存储过程计划缓存语句相关内存信息。 ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 查询函数时，GaussDB会根据current_user的权限来决定是否允许访问。如果current_user是初始用户或系统管理员, 则可以查询所有会话信息。如果current_user是普通用户,则只能查看自己的会话信息(即session_user是当前用户的信息)。 返回值类型：setof record 函数返回字段说明： | 名称 | 类型 | 描述 | |:---|:---|:---| | node_name | text | 当前节点名称。 | | pid | bigint | 后台线程id。 | | sessionid | bigint | 会话id。 | | global_sessionid | text | 全局会话id。 | | databaseid | oid | 数据库id。 | | pkg_id | oid | 存储过程所属PACKAGE id，如果不属于PACKAGE则为0。 | | func_id | oid | 存储过程id。 | | func_signature | text | 存储过程名称（name + fn_collation + search_path）。 | | lineno | bigint | 语句在存储过程内行号。 | | query | text | 计划缓存语句。 | | usedsize | bigint | 计划缓存语句使用内存大小。 | | totalsize | bigint | 计划缓存语句总内存大小。 | 示例： ``` gaussdb=# CREATE OR REPLACE PROCEDURE proc_assign AS a int := 0; BEGIN a = a + 1; RAISE INFO '%', a; END; / gaussdb=# CALL proc_assign(); INFO: 1 proc_assign ------------- (1 row) gaussdb=# SELECT * FROM pg_catalog.gs_global_plsql_statements_details(pg_current_sessid()); node_name | pid | sessionid | global_sessionid | databaseid | pkg_id | func_id | func_signature | lineno | query | use dsize | totalsize --------------+------------+-----------------+------------------+------------+--------+---------+------------------------------------------------ -----------------------------------------------------------------------+--------+---------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------------------+---- ------+----------- coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 16387 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 3 | SELECT a + 1 | 12160 | 18432 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 16387 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 4 | SELECT a | 10152 | 14336 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 16387 | name: proc_assign(), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 1 | SELECT 0 | 9832 | 14336 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13510 | name: gs_global_plsql_statements_details(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 12 | SELECT COALESCE(sessionid::text, 'NULL') | 13992 | 22528 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13510 | name: gs_global_plsql_statements_details(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 13 | SELECT COALESCE(pkg_id::text, 'NULL') | 13480 | 22528 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13510 | name: gs_global_plsql_statements_details(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 14 | SELECT COALESCE(func_id::text, 'NULL') | 13480 | 22528 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13510 | name: gs_global_plsql_statements_details(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 15 | SELECT 'SELECT node_name FROM pg_catalog.pgxc_node WHERE node_type in (''C'', ''D'') AND nodeis_active = true' | 10528 | 14336 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13510 | name: gs_global_plsql_statements_details(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 17 | SELECT 'EXECUTE DIRECT ON (' || pg_catalog.quote_ident(row_name .node_name)|| ')''SELECT * from pg_catalog.gs_plsql_statements_details('|| sessionid_str ||', '|| pkg_id_str ||', '|| func_id_str || ');''' | 31456 | 47104 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13510 | name: gs_global_plsql_statements_details(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 31 | SELECT (fet_active) | 10248 | 14336 coordinator1 | 1171777280 | 139767997523712 | 0:0#0 | 14023 | 0 | 13510 | name: gs_global_plsql_statements_details(bigint,oid,oid), fn_collation: 0, search_path: addUser: false, schemas: 2200 | 31 | SELECT (query_str_nodes) | 10248 | 14336 (10 rows) gaussdb=# DROP PROCEDURE proc_assign; ``` #### 分区表统计信息函数 - 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/distributed-ref-v10-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; gaussdb=# DROP TABLE subpart_tab1; ``` - 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) 描述：分区表死行数。在Ustore表中仅代表不活跃行指针数量。 返回值类型：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 - gs_stat_partition_analyze_vacuum(oid) 描述：缓存加速获取特定分区的vacuum/analyze相关统计信息。 参数：partoid 返回值类型：record - gs_stat_get_parttabentries() 描述：使用该函数可获取其他节点的分区表的vacuum/analyze相关统计信息。内部函数，不建议用户直接使用。 返回值类型：record - gs_wlm_respool_cpu_info() 描述：描述资源池的CPU资源限制和使用信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | respool_name | name | 资源池名称。 | | control_group | name | cgroup名称。 | | cpu_affinity | name | CPU绑定core的数值。 | | cpu_usage | integer | 资源池的CPU使用率。如果资源池没有进行CPU管控，则该项显示为0。 | ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 对于CN和DN混合部署的场景，CN和DN共享同一份CPU资源，因此CN和DN的cpu_usage显示相同，对于CN和DN独立部署场景，会独立显示。 示例： ``` gaussdb=# SELECT * FROM GS_WLM_RESPOOL_CPU_INFO(); respool_name | control_group | cpu_affinity | cpu_usage ---------------+----------------------+--------------+----------- respool_cpu_2 | respool_cpu_2:Medium | 0-95 | 78 default_pool | DefaultClass:Medium | 0-32 | 65 (2 rows) ``` - gs_wlm_respool_connection_info() 描述：描述资源池的连接数资源限制和使用信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | respool_name | name | 资源池名称。 | | max_connections | name | 资源池最大连接数。 | | curr_connections | integer | 当前资源池已有连接数。 | 示例： ``` gaussdb=# SELECT * FROM GS_WLM_RESPOOL_CONNECTION_INFO(); respool_name | max_connections | curr_connections ---------------+-----------------+------------------ respool1 | -1 | 0 default_pool | -1 | 1 (2 rows) ``` - gs_wlm_respool_memory_info() 描述：描述资源池的内存资源限制和使用信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | respool_name | name | 资源池名称。 | | max_dynamic_memory | integer | 最大可使用的动态内存。 | | current_dynamic_memory | integer | 当前已经使用的动态内存。 | | max_shared_memory | integer | 最大可使用的共享内存。 | | current_shared_memory | integer | 当前已经使用的共享内存。 | | shared_memory_hits_percent | integer | 该功能不可用，留待后续演进。字段保留，恒为0。 | ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 在出现资源池动态内存使用超过最大值时，可能会出现查询GUC参数current_dynamic_memory返回的结果大于max_dynamic_memory的情况，这属于正常现象，实际并未申请内存。 示例： ``` gaussdb=# SELECT * FROM GS_WLM_RESPOOL_MEMORY_INFO(); respool_name | max_dynamic_memory | current_dynamic_memory | max_shared_memory | current_shared_memory | shared_memory_hits_percent -----------------+--------------------+------------------------+-------------------+-----------------------+---------------------------- default_pool | -1 | 3383kB | -1 | 3848kB | 0 resource_pool_a | 30720kB | 0kB | -1 | 0kB | 0 (2 rows) ``` - gs_wlm_respool_concurrency_info() 描述：描述资源池中的并发数资源限制和使用信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | respool_name | name | 资源池名称。 | | max_concurrency | integer | 资源池支持的最大并发数。 | | running_concurrency | integer | 当前资源池正在执行的并发数。 | | waiting_concurrency | integer | 当前资源池正在等待的并发数。如果资源池没有进行并发限制，则该项显示为0。 | 示例： ``` gaussdb=# SELECT * FROM GS_WLM_RESPOOL_CONCURRENCY_INFO(); respool_name | max_concurrency | running_concurrency | waiting_concurrency -----------------+-----------------+---------------------+--------------------- default_pool | -1 | 1 | 0 resource_pool_a | -1 | 0 | 0 (2 rows) ``` - gs_wlm_respool_io_info() 描述：描述资源池的I/O资源限制和使用信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | respool_name | name | 资源池名称。 | | io_limits | integer | 每秒触发I/O的次数上限（单位：IOPS）。0表示不控制。 | | io_priority | text | I/O 资源管控的优先级等级。当I/O利用率高达90%时，作业的I/O操作按此优先级进行管控。None表示不控制。 | | current_iops | integer | 当前I/O已经触发的次数（单位：IOPS）。 - 因该值与I/O统计算法有关，存在偶尔超过上限的情况，属于正常波动。 - 如果资源池没有进行I/O管控，则该项显示为0。 | ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 在I/O管控过程中，I/O操作的计数单位由GUC参数io_control_unit定义。1个io_control_unit次为1次IOPS。 示例： ``` gaussdb=# SELECT * FROM GS_WLM_RESPOOL_IO_INFO(); respool_name | io_limits | io_priority | current_iops -----------------+-----------+-------------+-------------- default_pool | 0 | None | 0 resource_pool_a | 0 | Low | 0 (2 rows) ``` - gs_wlm_user_space_info() 描述：描述用户的存储空间的使用信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | user_name | name | 用户名称。 | | max_permanent_space | bigint | 用户可使用的最大永久存储空间，单位：B。 | | current_permanent_space | bigint | 当前用户已使用的永久存储空间，单位：B。 | | max_temp_space | bigint | 用户可使用的最大临时存储空间，单位：B。 | | current_temp_space | bigint | 当前用户已使用的临时存储空间，单位：B。 | | max_spill_space | bigint | 用户可使用的最大算子落盘存储空间，单位：B。 | | current_spill_space | bigint | 当前用户已使用的算子落盘存储空间，单位：B。 | 示例： ``` gaussdb=# SELECT * FROM GS_WLM_USER_SPACE_INFO(); user_name | max_permanent_space | current_permanent_space | max_temp_space | current_temp_space | max_spill_space | current_spill_space -----------------------------+---------------------+-------------------------+----------------+--------------------+-----------------+--------------------- xy | -1 | 2464 | -1 | 0 | -1 | 0 (1 rows) ``` - gs_wlm_session_io_info() 描述：描述session的I/O的使用信息。 返回值类型：setof record | 名称 | 类型 | 描述。 | |:---|:---|:---| | session_id | integer | 会话ID。 | | io_limits | integer | 每秒触发I/O的次数上限（单位：IOPS）。0表示不控制。 | | io_priority | text | I/O 资源管控的优先级等级。当I/O利用率高达90%时，作业的I/O操作按此优先级进行管控。None表示不控制。 | | current_iops | integer | 当前I/O已经触发的次数（单位：IOPS）。当前I/O统计值存在偶尔超过上限的情况，与I/O统计算法有关，属于正常波动。 | | wait_time | integer | 当前I/O超过上限后等待的时间总和。 | ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 在I/O管控过程中，I/O操作的计数单位由GUC参数io_control_unit定义。1个io_control_unit次为1次IOPS。 示例： ``` gaussdb=# SELECT * FROM GS_WLM_SESSION_IO_INFO(); session_id | io_limits | io_priority | current_iops | wait_time -----------------+-----------+-------------+--------------+----------- 139976325986048 | 10 | None | 0 | 2709 (1 row) ``` - gs_wlm_session_memory_info() 描述：描述session的内存的使用信息。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | session_id | integer | session_id。 | | sess_used_dynamic_memory | bigint | 当前已经使用的动态内存，单位为B。 | | sess_max_dynamic_memory | bigint | 最大可使用的动态内存，单位为B。 | 示例： ``` gaussdb=# SELECT * FROM GS_WLM_SESSION_MEMORY_INFO(); sessid | sess_used_dynamic_memory | sess_max_dynamic_memory -----------------+--------------------------+------------------------- 139976325986048 | 4326056 | -1 139976402532096 | 4452664 | -1 (2 rows) ``` - gs_emergency_operation_records() 描述：展示当前节点对Unix Domain Socket运维通道的使用情况。 返回值类型：setof record | 名称 | 类型 | 描述 | |:---|:---|:---| | record_time | timestamptz | 使用运维通道的时间。 | | action | text | 使用运维通道执行的操作。 | | source | text | 接入运维通道的来源，取值为gsql和cm。 | | detail | text | 执行操作的具体结果。 | - gs_memory_profiling(option integer) 描述：生成GaussDB当前进程的jeprof报告。option表示是否开启内存采集功能，并根据实际输入返回结果为字符串类型的说明。 参数：option，整型，操作选项。 - 0：表示关闭内存采集，函数返回"memory profiling closed"说明。 - 1：表示开启内存采集，函数返回"memory profiling opened"说明。 - 2：表示在开启内存采集的情况下进行内存调用收集，并生成jeprof报告，报告位于mem_log目录下，报告的命名格式为jeprof-*YY-mm-dd_HHMMSS*，函数返回"dump succeeded"说明。 - 其他：返回提示信息"Invalid input, please input 0(disable), 1(enable) or 2(dump)."。 返回值类型：text ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - 仅具有SYSADMIN权限的用户可以使用该函数。 - 开启内存采集会影响性能，因此仅推荐在尝试分析内存问题（例如内存泄漏）的非性能敏感场景下开启功能。生成的jeprof报告可以通过如下命令生成PDF报告： ``` jeprof --show_bytes gaussdbbin路径 -pdf 生成的jeprof报告路径 > 期待输出文件.pdf ``` - gs_jemalloc_info_details() 描述：统计jemalloc的关键字段并生成jemalloc stat报告。stat报告位于mem_log目录下，命名为memory_stat_report-*YY-mm-dd_HHMMSS*.log。 返回值类型：setof record 表34gs_jemalloc_info_details字段 | **名称** | **类型** | **描述** | |:---|:---|:---| | nodename | text | 节点名称 | | memorytype | text | 字段名称 | | memorymbytes | integer | 对应字段下虚拟内存的大小（单位：MB） | ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 仅具有SYSADMIN权限的用户可以使用该函数。