华为openGauss 统计信息函数

统计信息函数根据访问对象分为两种类型：针对某个数据库进行访问的函数，以数据库中每个表或索引的OID作为参数，标识需要报告的数据库；针对某个服务器进行访问的函数，以一个服务器进程号为参数，其范围从1到当前活跃服务器的数目。

• pg_stat_get_db_numbackends(oid)

  描述：处理该数据库活跃的服务器进程数目。

  返回值类型：integer

• pg_stat_get_db_xact_commit(oid)

  描述：数据库中已提交事务的数量。

  返回值类型：bigint

• pg_stat_get_db_xact_rollback(oid)

  描述：数据库中回滚事务的数量。

  返回值类型：bigint

• pg_stat_get_db_blocks_fetched(oid)

  描述：数据库中磁盘块抓取请求的总数。

  返回值类型：bigint

• pg_stat_get_db_blocks_hit(oid)

  描述：数据库在缓冲区中找到的磁盘块抓取请求的总数。

  返回值类型：bigint

• pg_stat_get_db_tuples_returned(oid)

  描述：为数据库返回的Tuple数。

  返回值类型：bigint

• pg_stat_get_db_tuples_fetched(oid)

  描述：为数据库中获取的Tuple数。

  返回值类型：bigint

• pg_stat_get_db_tuples_inserted(oid)

  描述：在数据库中插入Tuple数。

  返回值类型：bigint

• pg_stat_get_db_tuples_updated(oid)

  描述：在数据库中更新的Tuple数。

  返回值类型：bigint

• pg_stat_get_db_tuples_deleted(oid)

  描述：数据库中删除Tuple数。

  返回值类型：bigint

• pg_stat_get_db_conflict_lock(oid)

  描述：数据库中锁冲突的数量。

  返回值类型：bigint

• pg_stat_get_db_deadlocks(oid)

  描述：数据库中死锁的数量。

  返回值类型：bigint

• pg_stat_get_numscans(oid)

  描述：如果参数是一个表，则顺序扫描读取的行数目。如果参数是一个索引，则返回索引行的数目。

  返回值类型：bigint

• pg_stat_get_tuples_returned(oid)

  描述：如果参数是一个表，则顺序扫描读取的行数目。如果参数是一个索引，则返回的索引行的数目。

  返回值类型：bigint

• pg_stat_get_tuples_fetched(oid)

  描述：如果参数是一个表，则位图扫描抓取的行数目。如果参数是一个索引，则用简单索引扫描抓取的行数目。

  返回值类型：bigint

• pg_stat_get_tuples_inserted(oid)

  描述：插入表中行的数量。

  返回值类型：bigint

• pg_stat_get_tuples_updated(oid)

  描述：在表中已更新行的数量。

  返回值类型：bigint

• pg_stat_get_tuples_deleted(oid)

  描述：从表中删除行的数量。

  返回值类型：bigint

• pg_stat_get_tuples_changed(oid)

  描述：该表上一次analyze或autoanalyze之后插入、更新、删除行的总数量。

  返回值类型：bigint

• pg_stat_get_tuples_hot_updated(oid)

  描述：热更新的行数表。

  返回值类型：bigint

• pg_stat_get_live_tuples(oid)

  描述：活行数表。

  返回值类型：bigint

• pg_stat_get_dead_tuples(oid)

  描述：死行数表。

  返回值类型：bigint

• pg_stat_get_blocks_fetched(oid)

  描述：表或者索引的磁盘块抓取请求的数量。

  返回值类型：bigint

• pg_stat_get_blocks_hit(oid)

  描述：在缓冲区中找到的表或者索引的磁盘块请求数目。

  返回值类型：bigint

• pg_stat_get_partition_tuples_inserted(oid)

  描述：插入相应表分区中行的数量。

  返回值类型：bigint

• pg_stat_get_partition_tuples_updated(oid)

  描述：在相应表分区中已更新行的数量。

  返回值类型：bigint

• pg_stat_get_partition_tuples_deleted(oid)

  描述：从相应表分区中删除行的数量。

  返回值类型：bigint

• pg_stat_get_partition_tuples_changed(oid)

  描述：该表分区上一次analyze或autoanalyze之后插入、更新、删除行的总数量。

  返回值类型：bigint

• pg_stat_get_partition_live_tuples(oid)

  描述：活行数表分区。

  返回值类型：bigint

• pg_stat_get_partition_dead_tuples(oid)

  描述：死行数表分区。

  返回值类型：bigint

• pg_stat_get_xact_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_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_last_vacuum_time(oid)

  描述：用户在该表上最后一次手动启动清理或者autovacuum线程启动清理的时间。

  返回值类型：timestamptz

• pg_stat_get_last_autovacuum_time(oid)

  描述：autovacuum守护进程在该表上最后一次启动清理的时间。

  返回值类型：timestamptz

• pg_stat_get_vacuum_count(oid)

  描述：用户在该表上手动启动清理的次数。

  返回值类型：bigint

• pg_stat_get_autovacuum_count(oid)

  描述：autovacuum守护进程在该表上启动清理的次数。

  返回值类型：bigint

• pg_stat_get_last_analyze_time(oid)

  描述：用户在该表上最后一次手动启动分析或者autovacuum线程启动分析的时间。

  返回值类型：timestamptz

• pg_stat_get_last_autoanalyze_time(oid)

  描述：autovacuum守护进程在该表上最后一次启动分析的时间。

  返回值类型：timestamptz

• pg_stat_get_analyze_count(oid)

  描述：用户在该表上手动启动分析的次数。

  返回值类型：bigint

• pg_stat_get_autoanalyze_count(oid)

  描述：autovacuum守护进程在该表上启动分析的次数。

  返回值类型：bigint

• pg_total_autovac_tuples(bool,bool)

  描述：返回total autovac相关的tuple记录，如nodename,nspname,relname以及各类tuple的IUD信息，入参分别为：是否查询relation信息，是否查询local信息。

  返回值类型：setofrecord

• pg_autovac_status(oid)

  描述：返回和autovac状态相关的参数信息，如nodename,nspname,relname,analyze,vacuum设置，analyze/vacuum阈值, analyze/vacuum tuple数等。

  返回值类型：setofrecord

• pg_autovac_timeout(oid)

  描述：返回某个表做autovac连续超时的次数，表信息非法或node信息异常返回NULL。

  返回值类型：bigint

• pg_autovac_dbnode(oid)

  描述：返回对某个表做autovac的dbnode名称，表信息非法或node信息异常返回NULL。

  返回值类型：text

• pg_stat_get_last_data_changed_time(oid)

  描述：insert/update/delete, exchange/truncate/drop partition在该表上最后一次操作的时间，PG_STAT_ALL_TABLES视图last_data_changed列的数据是通过该函数求值，在表数量很大的场景中，通过视图获取表数据最后修改时间的性能较差，建议直接使用该函数获取表数据的最后修改时间。

  返回值类型：timestamptz

• pg_stat_set_last_data_changed_time(oid)

  描述：手动设置该表上最后一次insert/update/delete, exchange/truncate/drop partition操作的时间。

  返回值类型：void

• pg_backend_pid()

  描述：当前会话的服务器线程的线程ID。

  返回值类型：integer

• pg_stat_get_activity(integer)

  描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。返回结果是PG_STAT_ACTIVITY视图中的一个子集，不包含connection_info列。

  返回值类型：setofrecord

• pg_stat_get_activity_with_conninfo(integer)

  描述：返回一个关于带有特殊PID的后台进程的记录信息，当参数为NULL时，则返回每个活动的后台进程的记录。返回结果是PG_STAT_ACTIVITY视图中的一个子集。

  返回值类型：setofrecord

• pg_user_iostat(text)

  描述：显示和当前用户执行作业正在运行时的IO负载管理相关信息。

  返回值类型：record

  函数返回字段说明如下：

  名称	类型	描述
  userid	oid	用户id。
  min_curr_iops	int4	当前该用户io在数据库节点中的最小值。对于行存，以万次/s为单位；对于列存，以次/s为单位。
  max_curr_iops	int4	当前该用户io在数据库节点中的最大值。对于行存，以万次/s为单位；对于列存，以次/s为单位。
  min_peak_iops	int4	该用户io峰值中，数据库节点的最小值。对于行存，以万次/s为单位；对于列存，以次/s为单位。
  max_peak_iops	int4	该用户io峰值中，数据库节点的最大值。对于行存，以万次/s为单位；对于列存，以次/s为单位。
  io_limits	int4	用户指定的资源池所设置的io_limits。对于行存，以万次/s为单位；对于列存，以次/s为单位。
  io_priority	text	该用户所设io_priority。对于行存，以万次/s为单位；对于列存，以次/s为单位。

• pg_stat_get_function_calls(oid)

  描述：函数已被调用次数。

  返回值类型：bigint

• pg_stat_get_function_time(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()

  描述：清理当前的统计快照。

  返回值类型：void

• pg_stat_reset()

  描述：为当前数据库重置统计计数器为0（需要系统管理员权限）。

  返回值类型：void

• pg_stat_reset_shared(text)

  描述：重置shared cluster每个节点当前数据统计计数器为0（需要系统管理员权限）。

  返回值类型：void

• pg_stat_reset_single_table_counters(oid)

  描述：为当前数据库中的一个表或索引重置统计为0（需要系统管理员权限）。

  返回值类型：void

• pg_stat_reset_single_function_counters(oid)

  描述：为当前数据库中的一个函数重置统计为0（需要系统管理员权限）。

  返回值类型：void

• pg_stat_session_cu(int, int, int)

  描述：获取当前节点所运行session的CU命中统计信息。

  返回值类型：record

• gs_get_stat_session_cu(text, int, int, int)

  描述：获取openGauss所有运行session的CU命中统计信息。

  返回值类型：record

• gs_get_stat_db_cu(text, text, int, int, int)

  描述：获取openGauss一个数据库的CU命中统计信息。

  返回值类型：record

• pg_stat_get_cu_mem_hit(oid)

  描述：获取当前节点当前数据库中一个列存表的CU内存命中次数。

  返回值类型：bigint

• pg_stat_get_cu_hdd_sync(oid)

  描述：获取当前节点当前数据库中一个列存表从磁盘同步读取CU次数。

  返回值类型：bigint

• pg_stat_get_cu_hdd_asyn(oid)

  描述：获取当前节点当前数据库中一个列存表从磁盘异步读取CU次数。

  返回值类型：bigint

• pg_stat_get_db_cu_mem_hit(oid)

  描述：获取当前节点一个数据库CU内存命中次数。

  返回值类型：bigint

• pg_stat_get_db_cu_hdd_sync(oid)

  描述：获取当前节点一个数据库从磁盘同步读取CU次数。

  返回值类型：bigint

• pgxc_get_wlm_current_instance_info(text, int default null)

  描述：在数据库主节点上查询当前的资源使用情况，读取内存中还未存到 5.19.2.3 GS_WLM_INSTANCE_HISTORY系统表的数据。入参分别为节点名称 (可以输入ALL、C、D、实例名称)、每个节点返回的大数量。返回值为 GS_WLM_INSTANCE_HISTORY。

  返回值类型：setofrecord

• pgxc_get_wlm_history_instance_info(text, TIMESTAMP, TIMESTAMP, int default null)

  描述：在数据库主节点上查询历史资源使用情况，读取 GS_WLM_INSTANCE_HISTORY系统表的数据。入参分别为节点名称(可以输入 ALL、C、D、实例名称)、起始区间时间、结束区间时间和每个实例返回的大数 量。返回值为GS_WLM_INSTANCE_HISTORY。

  返回值类型：setofrecord

• pg_stat_get_db_cu_hdd_asyn(oid)

  描述：获取当前节点一个数据库从磁盘异步读取CU次数。

  返回值类型：bigint

• pg_stat_bad_block(text, int, int, int, int, int, timestamp with time zone, timestamp with time zone)

  描述：获取当前节点自启动后，读取出现Page/CU的损坏信息。

  例: select * from pg_stat_bad_block();

  返回值类型：record

• pg_stat_bad_block_clear()

  描述：清理节点记录的读取出现的Page/CU损坏信息（需要系统管理员权限）。

  返回值类型：void

• gs_respool_exception_info(pool text)

  描述：查看某个资源池关联的查询规则信息。

  返回值类型：record

• gs_control_group_info(pool text)

  描述：查看资源池关联的控制组信息

  返回值类型：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核心数

• get_instr_workload_info(integer)

  描述：获取数据库主节点上事务量信息，事务时间信息。

  返回值类型：record

  属性	属性值	描述
  resourcepool_oid	10	资源池的oid(逻辑同负载等价)
  commit_counter	4	前端事务commit数量
  rollback_counter	1	前端事务rollback数量
  resp_min	949	前端事务最小响应时间（单位：微秒）
  resp_max	201891	前端事务最大响应时间（单位：微秒）
  resp_avg	43564	前端事务平均响应时间(单位：微秒)
  resp_total	217822	前端事务总响应时间（单位：微秒）
  bg_commit_counter	910	后端事务commit数量
  bg_rollback_counter	0	后端事务rollback数量
  bg_resp_min	97	后端事务最小响应时间（单位：微秒）
  bg_resp_max	678080687	后端事务最大响应时间（单位：微秒）
  bg_resp_avg	327847884	后端事务平均响应时间（单位：微秒）
  bg_resp_total	298341575300	后端事务总响应时间（单位：微秒）

• pv_instance_time()

  描述：获取当前节点上各个关键阶段的时间消耗。

  返回值类型：record

  Stat_name属性	属性值	描述
  DB_TIME	1062385	所有线程端到端的墙上时间（WALL TIME）消耗总和(单位： 微秒)
  CPU_TIME	311777	所有线程CPU时间消耗总和(单位： 微秒)
  EXECUTION_TIME	380037	消耗在执行器上的时间总和(单位： 微秒)
  PARSE_TIME	6033	消耗在SQL解析上的时间总和(单位： 微秒)
  PLAN_TIME	173356	消耗在执行计划生成上的时间总和(单位： 微秒)
  REWRITE_TIME	2274	消耗在查询重写上的时间总和(单位： 微秒)
  PL_EXECUTION_TIME	0	消耗在PL/SQL执行上的时间总和(单位： 微秒)
  PL_COMPILATION_TIME	557	消耗在SQL编译上的时间总和(单位： 微秒)
  NET_SEND_TIME	1673	消耗在网络发送上的时间总和(单位： 微秒)
  DATA_IO_TIME	426622	消耗在数据读写上的时间总和(单位： 微秒)

• DBMS_PERF.get_global_instance_time()

  描述：提供openGauss各个关键阶段的时间消耗，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。

  返回值类型：record

• get_instr_unique_sql()

  描述：获取当前结点的执行语句（归一化SQL）信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• reset_unique_sql(text, text, bigint)

  描述：重置系统执行语句（归一化SQL）信息，执行该函数必须具有sysadmin权限。第一个参数取值范围“global/local”，global表示清理所有节点上的信息，local表示只清理当前节点；第二参数取值范围“ALL/BY_USERID/BY_CNID”，ALL表示清理所有信息，BY_USERID表示通过指定USERID清理只属于该用户的sql信息，BY_CNID表示清理系统中涉及到该数据库主节点的sql信息；第三个参数表示具体的CNID和USERID，如果第二个参数为ALL，第三个参数不起作用，可以取任意值。

  返回值类型：boolean

• get_instr_wait_event(NULL)

  描述：获取当前节点event等待的统计信息。

  返回值类型：record

• get_instr_user_login()

  描述：获取当前结点的用户登入登出次数信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• get_instr_rt_percentile()

  描述：获取CCN结点SQL 响应时间P80，P95分布信息，openGauss统一的信息在CCN节点上，其他节点查询为0。

  返回值类型：record

• get_node_stat_reset_time()

  描述：获取当前结点的统计信息重置（重启，主备倒换，数据库删除）时间。

  返回值类型：record

• dbms_perf.get_average_value()

  描述：获取当前结点的统计信息重置（重启，主备倒换，数据库删除）时间。

  返回值类型：record

• DBMS_PERF.get_global_os_runtime()

  描述：显示当前操作系统运行的状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_os_threads()

  描述：提供openGauss中所有正常节点下的线程状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_os_threads()

  描述：提供openGauss中所有正常节点下的线程状态信息，仅在数据库主节点上支持查询，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_workload_sql_count()

  描述：提供openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，DDL， DML，DCL计数信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_workload_sql_elapse_time()

  描述：提供openGauss中不同负载SELECT，UPDATE，INSERT，DELETE，响应时间信息（TOTAL,AVG, MIN, MAX），查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_workload_transaction()

  描述：获取openGauss内所有节点上的事务量信息，事务时间信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_session_stat()

  描述：获取openGauss节点上的会话状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

  说明：
  状态信息有如下17项，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,cu_mem_hit,
  cu_hdd_sync_read,cu_hdd_asyread

• DBMS_PERF.get_global_session_time()

  描述：提供openGauss各节点各个关键阶段的时间消耗，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_session_memory()

  描述：汇聚各节点的Session级别的内存使用情况，包含执行作业在数据节点上Postgres线程和Stream线程分配的所有内存，单位为MB，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_session_memory_detail()

  描述：汇聚各节点的线程的内存使用情况，以MemoryContext节点来统计，查询该函数必须具有sysadmin权限。

  返回值类型：record

• gs_session_memory_detail_tp

  描述：统计线程的内存使用情况，以MemoryContext节点来统计。当开启线程池（enable_thread_pool = on）时，该视图包含所有的线程和会话的内存使用情况。

  返回值类型：record

• DBMS_PERF.get_global_session_stat_activity()

  描述：汇聚openGauss内各节点上正在运行的线程相关的信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_thread_wait_status()

  描述：汇聚所有结点上工作线程（backend thread）以及辅助线程（auxiliary thread）的阻塞等待情况，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_wlm_controlgroup_ng_config()

  描述：数据库内所有的控制组信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_wlm_user_resource_runtime()

  描述：显示所有用户资源使用情况，参数use_workload_manager为on时才有效，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_wlm_workload_runtime()

  描述：汇聚当前用户在数据库主节点上执行作业时在数据库主节点上的状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_operator_ec_history()

  描述：汇聚当前用户在数据库主节点上EC算子的历史状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_operator_ec_history_table()

  描述：汇聚当前用户在数据库主节点上EC算子的历史状态信息（持久化），查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_operator_ec_runtime()

  描述：汇聚当前用户在数据库主节点上EC算子的实时状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_operator_history_table()

  描述：汇聚当前用户数据库主节点上执行作业结束后的算子相关记录（持久化），查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_operator_history()

  描述：汇聚当前用户数据库主节点上执行作业结束后的算子相关记录，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_operator_runtime()

  描述：汇聚当前用户数据库主节点上执行作业实时的算子相关记录，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statement_complex_history()

  描述：汇聚当前用户数据库主节点上复杂查询的历史记录，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statement_complex_history_table()

  描述：汇聚当前用户数据库主节点上复杂查询的历史记录（持久化），查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statement_complex_runtime()

  描述：汇聚当前用户数据库主节点上复杂查询的实时信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_memory_node_detail()

  描述：汇聚所有节点某个数据库节点内存使用情况，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_shared_memory_detail()

  描述：汇聚所有节点已产生的共享内存上下文的使用信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_comm_delay()

  描述：汇聚数据库节点的通信库时延状态，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_comm_recv_stream()

  描述：汇聚数据库节点的通信库接收流状态，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_comm_send_stream()

  描述：汇聚数据库节点的通信库发送流状态，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_comm_status()

  描述：汇聚数据库节点的通信库状态，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_all_indexes

  描述：汇聚所有节点当前数据库中的每个索引行，显示特定索引的I/O的统计，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_local_toastname_and_toastindexname()

  描述：提供本地toast表的name和index和其关联表的对应关系。

  返回值类型：record

• DBMS_PERF.get_summary_statio_all_indexes

  描述：统计所有节点当前数据库中的每个索引行，显示特定索引的I/O的统计，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_all_sequences

  描述：提供命名空间中所有sequences的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_all_tables

  描述：汇聚各节点的数据库中每个表I/O的统计，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_statio_all_tables

  描述：统计openGauss内数据库中每个表I/O的统计，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_local_toast_relation()

  描述：提供本地toast表的name和其关联表的对应关系。

  返回值类型：record

• DBMS_PERF.get_global_statio_sys_indexes()

  描述：汇聚各节点的命名空间中所有系统表索引的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_statio_sys_indexes()

  描述：统计各节点的命名空间中所有系统表索引的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_sys_sequences()

  描述：提供命名空间中所有系统表为sequences的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_sys_tables()

  描述：提供各节点的命名空间中所有系统表的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_statio_sys_tables()

  描述：openGauss内汇聚命名空间中所有系统表的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_user_indexes()

  描述：各节点的命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_statio_user_indexes()

  描述：openGauss内汇聚命名空间中所有用户关系表索引的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_user_sequences()

  描述：显示各节点的命名空间中所有用户的sequences的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statio_user_tables()

  描述：显示各节点的命名空间中所有用户关系表的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_statio_user_tables()

  描述：openGauss内汇聚命名空间中所有用户关系表的IO状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_stat_db_cu()

  描述：视图查询openGauss各个节点，每个数据库的CU命中情况，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_dn_stat_all_tables()

  描述：汇聚数据库节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_cn_stat_all_tables()

  描述：汇聚数据库主节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_dn_stat_all_tables()

  描述：统计数据库节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_cn_stat_all_tables()

  描述：统计数据库主节点结点数据库中每个表的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_all_indexes()

  描述：汇聚所有结点数据库中每个索引的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_all_indexes()

  描述：统计所有结点数据库中每个索引的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_sys_tables()

  描述：汇聚各节点pg_catalog、information_schema模式的所有命名空间中系统表的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_sys_tables()

  描述：统计各节点pg_catalog、information_schema模式的所有命名空间中系统表的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_sys_indexes()

  描述：汇聚各节点pg_catalog、information_schema模式中所有系统表的索引状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_sys_indexes()

  描述：统计各节点pg_catalog、information_schema模式中所有系统表的索引状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_user_tables()

  描述：汇聚所有命名空间中用户自定义普通表的状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_user_tables()

  描述：统计所有命名空间中用户自定义普通表的状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_user_indexes()

  描述：汇聚所有数据库中用户自定义普通表的索引状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_user_indexes()

  描述：统计所有数据库中用户自定义普通表的索引状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_database()

  描述：汇聚所有节点数据库统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_database_conflicts()

  描述：统计所有节点数据库统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_xact_all_tables()

  描述：汇聚命名空间中所有普通表和toast表的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_xact_all_tables()

  描述：统计命名空间中所有普通表和toast表的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_xact_sys_tables()

  描述：汇聚所有节点命名空间中系统表的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_xact_sys_tables()

  描述：统计所有节点命名空间中系统表的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_xact_user_tables()

  描述：汇聚所有节点命名空间中用户表的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_stat_xact_user_tables()

  描述：统计所有节点命名空间中用户表的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_user_functions()

  描述：汇聚所有节点命名空间中用户定义函数的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_xact_user_functions()

  描述：统计所有节点命名空间中用户定义函数的事务状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_stat_bad_block()

  描述：汇聚所有节点表、索引等文件的读取失败信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_file_redo_iostat()

  描述：统计所有节点表、索引等文件的读取失败信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_file_iostat()

  描述：汇聚所有节点数据文件IO的统计，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_locks()

  描述：汇聚所有节点的锁信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_replication_slots()

  描述：汇聚所有节点上逻辑复制信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_bgwriter_stat()

  描述：汇聚所有节点后端写进程活动的统计信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_replication_stat()

  描述：汇聚各节点日志同步状态信息，如发起端发送日志位置，收端接收日志位置等，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_pooler_status()

  描述：汇聚数据库主节点的pooler中的缓存连接状态，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_transactions_running_xacts()

  描述：汇聚各节点运行事务的信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_transactions_running_xacts()

  描述：统计各节点运行事务的信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_transactions_prepared_xacts()

  描述：汇聚各节点当前准备好进行两阶段提交的事务的信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_transactions_prepared_xacts()

  描述：统计各节点当前准备好进行两阶段提交的事务的信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_statement()

  描述：汇聚各节点历史执行语句状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_statement_count()

  描述：汇聚各节点SELECT，UPDATE，INSERT，DELETE，响应时间信息（TOTAL,AVG, MIN, MAX），查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_config_settings()

  描述：汇聚各节点GUC参数配置信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_wait_events()

  描述：汇聚各节点wait events状态信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_statement_responsetime_percentile()

  描述：获取openGaussSQL响应时间P80，P95分布信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_summary_user_login()

  描述：统计openGauss各节点用户登入登出次数信息，查询该函数必须具有sysadmin权限。

  返回值类型：record

• DBMS_PERF.get_global_record_reset_time()

  描述：汇聚openGauss统计信息重置（重启，主备倒换，数据库删除）时间，查询该函数必须具有sysadmin权限。

  返回值类型：record

• gs_wlm_user_resource_info(name text)

  描述：查询具体某个用户的资源限额和资源使用情况。

  返回值类型：record

• get_local_rel_iostat()

  描述：查询当前节点的数据文件IO状态累计值。

  返回值类型：record

• DBMS_PERF.get_global_rel_iostat()

  描述：汇聚所有节点数据文件IO的统计，查询该函数必须具有sysadmin权限。

  返回值类型：record

• 函数返回字段描述如下：

表 1 PGXC_GTM_SNAPSHOT_STATUS返回参数说明

示例：

pg_backend_pid函数显示当前后台服务线程ID。

``` postgres=# SELECT pg_backend_pid(); pg_backend_pid

139706243217168 (1 row) ```

pg_stat_get_backend_pid函数显示后台线程ID。

``` postgres=# SELECT pg_stat_get_backend_pid(1); pg_stat_get_backend_pid

     139706243217168
复制

(1 row) ```

须知：