华为云用户手册

PGXC_WLM_OPERATOR_HISTORY PGXC_WLM_OPERATOR_HISTORY视图显示在所有CN上执行作业结束时的算子信息。此视图用于从 GaussDB (DWS)中查询数据，数据库中的数据会被定时清理，清理周期为3分钟。 需要有系统管理员权限或预置角色gs_role_read_all_stats权限才可以访问此视图。具体的字段请参考表1。 表1 GS_WLM_OPERATOR_INFO的字段 名称 类型 描述 nodename text 执行语句的CN实例名称。 queryid bigint 语句执行使用的内部query_id。 pid bigint 后端线程ID。 plan_node_id integer 查询对应的执行计划的plan node id。 plan_node_name text 对应于plan_node_id的算子的名称。 start_time timestamp with time zone 该算子处理第一条数据的开始时间。 duration bigint 该算子到结束时候总的执行时间，单位为毫秒。 query_dop integer 当前算子执行时的并行度。 estimated_rows bigint 优化器估算的行数信息。 tuple_processed bigint 当前算子返回的元素个数。 min_peak_memory integer 当前算子在所有DN上的最小内存峰值，单位为MB。 max_peak_memory integer 当前算子在所有DN上的最大内存峰值，单位为MB。 average_peak_memory integer 当前算子在所有DN上的平均内存峰值，单位为MB。 memory_skew_percent integer 当前算子在各DN间的内存使用倾斜率。 min_spill_size integer 若发生下盘，所有下盘DN的最小下盘数据量，单位为MB。默认为0。 max_spill_size integer 若发生下盘，所有下盘DN的最大下盘数据量，单位为MB。默认为0。 average_spill_size integer 若发生下盘，所有下盘DN的平均下盘数据量，单位为MB。默认为0。 spill_skew_percent integer 若发生下盘，DN间下盘倾斜率。 min_cpu_time bigint 该算子在所有DN上的最小执行时间，单位为毫秒。 max_cpu_time bigint 该算子在所有DN上的最大执行时间，单位为毫秒。 total_cpu_time bigint 该算子在所有DN上的总执行时间，单位为毫秒。 cpu_skew_percent integer DN间执行时间的倾斜率。 warning text 主要显示如下几类告警信息： Sort/SetOp/HashAgg/HashJoin spill Spill file size large than 256MB Broadcast size large than 100MB Early spill Spill times is greater than 3 Spill on memory adaptive Hash table conflict 父主题： 系统视图

PGXC_WAIT_EVENTS PGXC_WAIT_EVENTS视图显示集群中各节点各类等待状态和事件的统计信息，其字段内容和GS_WAIT_EVENTS视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_WAIT_EVENTS字段 名称 类型 描述 nodename name 节点名称。 type text 事件的类型，包括STATUS，LOCK_EVENT，LWLOCK_EVENT和IO_EVENT四种类型。 event text 事件名称，可参考PG_THREAD_WAIT_STATUS视图。 wait bigint 事件发生次数。该字段及以下字段均为进程运行中的累计值。 failed_wait bigint 等待失败次数。当前版本中只有LOCK和LWLOCK等锁超时或失败才会使用该字段。 total_wait_time bigint 该事件总持续时间。 avg_wait_time bigint 该事件平均持续时间。 max_wait_time bigint 该事件最大等待时间。 min_wait_time bigint 该事件最小等待时间。 父主题： 系统视图

PGXC_VARIABLE_INFO PGXC_VARIABLE_INFO视图用于查询集群中所有节点的XID、OID的状态。 表1 PGXC_VARIABLE_INFO字段 名称 类型 描述 node_name text 节点名称。 nextOid oid 该节点下一次生成的OID。 nextXid xid 该节点下一次生成的事务号。 oldestXid xid 该节点最早的事务号。 xidVacLimit xid 强制autovacuum的临界点。 oldestXidDB oid 该节点datafrozenxid最小的数据库OID。 lastExtend CS NLogpage integer 最后一次扩展csnlog的页面号。 startExtendCSNLogpage integer csnlog扩展的起始页面号。 nextCommitSeqNo integer 该节点下次生成的csn号。 latestCompletedXid xid 该节点提交或者回滚后节点上的最新事务号。 startupMaxXid xid 该节点关机前的最后一个事务号。 父主题： 系统视图

PGXC_USER_TRANSACTION PGXC_USER_TRANSACTION视图提供查询所有CN上用户相关的事务信息。需要有系统管理员权限才可以访问此视图。该视图仅在资源实时监控功能开启，即enable_resource_track为on时有效。 表1 PGXC_USER_TRANSACTION字段 名称 类型 描述 node_name name 节点名称。 usename name 用户名称。 commit_counter bigint 提交次数。 rollback_counter bigint 回滚次数。 resp_min bigint 最小响应时间。 resp_max bigint 最大响应时间。 resp_avg bigint 平均响应时间。 resp_total bigint 响应时间总和。 父主题： 系统视图

PGXC_TOTAL_SCHEMA_INFO_ANALYZE PGXC_TOTAL_SCHEMA_INFO_ANALYZE视图提供了集群整体的Schema空间信息，包括：集群空间总值、各实例空间平均值、倾斜率、单实例空间最大值、单实例空间最小值以及最大最小空间所在的实例名，便于用户获悉集群整体的Schema空间使用情况，仅支持在CN节点上查询。 表1 PGXC_TOTAL_SCHEMA_INFO_ANALYZE字段 名称 类型 描述 schemaname text 模式名称。 databasename text 数据库名称。 nodegroup text 节点组名称。 total_value bigint 该模式的集群空间总值。 avg_value bigint 该模式的各实例空间平均值。 skew_percent integer 倾斜率。 extend_info text 提供信息包括：单实例空间最大值、单实例空间最小值以及最大最小空间所在的实例名。 父主题： 系统视图

PGXC_TOTAL_SCHEMA_INFO PGXC_TOTAL_SCHEMA_INFO视图提供了集群所有实例上的Schema空间信息，便于用户获悉集群各个实例上的Schema空间使用情况，仅支持在CN节点上查询。 表1 PGXC_TOTAL_SCHEMA_INFO字段 名称 类型 描述 schemaname text 模式名称。 schemaid oid 模式OID。 databasename text 数据库名称。 databaseid oid 数据库OID。 nodename text 实例名称。 nodegroup text 节点组名称。 usedspace bigint 已使用的空间大小。 permspace bigint 空间上限值。 父主题： 系统视图

PGXC_TOTAL_MEMORY_DETAIL PGXC_TOTAL_MEMORY_DETAIL视图显示集群内存使用情况。需要有系统管理员权限或预置角色gs_role_read_all_stats权限才可以访问此视图。 表1 PGXC_TOTAL_MEMORY_DETAIL字段 名称 类型 描述 nodename text 节点名称。 memorytype text 内存使用的名称。 max_process_memory：GaussDB(DWS)集群实例所占用的内存大小。 process_used_memory：GaussDB(DWS)进程所使用的内存大小。 max_dynamic_memory：最大动态内存。 dynamic_used_memory：已使用的动态内存。 dynamic_peak_memory：内存的动态峰值。 dynamic_used_shrctx：最大动态共享内存上下文。 dynamic_peak_shrctx：共享内存上下文的动态峰值。 max_shared_memory：最大共享内存。 shared_used_memory：已使用的共享内存。 max_cstore_memory：列存所允许使用的最大内存。 cstore_used_memory：列存已使用的内存大小。 max_sctpcomm_memory：通信库所允许使用的最大内存。 sctpcomm_used_memory：通信库已使用的内存大小。 sctpcomm_peak_memory：通信库的内存峰值。 other_used_memory：其他已使用的内存大小。 gpu_max_dynamic_memory：GPU内存最大值。 gpu_dynamic_used_memory：当前GPU可用内存和当前临时GPU内存之和。 gpu_dynamic_peak_memory：GPU内存使用的最大内存。 pooler_conn_memory：pooler连接占用内存大小。 pooler_freeconn_memory：pooler空闲连接占用的内存大小。 storage_compress_memory：列存压缩和解压缩使用的内存大小。 udf_reserved_memory：为UDF Worker进程预留的内存大小。 mmap_used_memory：mmap使用的内存大小。 memorymbytes integer 内存使用的大小，单位为MB。 父主题： 系统视图

PGXC_SQL_COUNT 通过PGXC_SQL_COUNT视图，可以实时显示集群中各CN节点上SELECT、INSERT、UPDATE、DELETE、MERGE INTO五种SQL、以及DDL、DML、DCL语句的节点级和用户级统计结果，识别当前业务负载较重的query类型，衡量整个集群和单个节点执行某种类型查询的能力。通过对以上几类SQL查询进行计数和响应时间统计，获得指定时刻的统计结果，经计算可以得到指定QPS等统计信息。例如，T1时刻，USER1的SELECT计数结果为X1，T2时刻为X2，则可计算得到该用户SELECT查询的QPS值为(X2-X1)/(T2-T1)。由此，可获得集群用户级QPS曲线图和集群吞吐情况，监测每个用户的业务负载是否发生剧烈变化。如果有剧烈变化，可以定位具体的语句类型(SELECT/INSERT/UPDATE/DELETE/MERGE INTO)。同时观测QPS曲线可以获知问题发生时间点，结合其它工具，定位问题点。能够为集群性能调优、问题定位等提供依据。 PGXC_SQL_COUNT视图的字段与GS_SQL_COUNT一致，详见表1。 当执行MERGE INTO语句时，若能下推，在DN上收到的是MERGE INTO语句，将在DN节点上进行MERGE INTO类型计数，相应mergeinto_count列计数增加；若不能下推，在DN上收到的是UPDATE或INSERT语句，将在DN节点上进行UPDATE或INSERT类型计数，相应的update_count列或insert_count列计数增加。 父主题： 系统视图

PGXC_STAT_REPLICATION PGXC_STAT_REPLICATION视图显示集群中各节点上日志同步的状态信息，除新增node_name（节点名称）字段外，其余字段内容和PG_STAT_REPLICATION视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_STAT_REPLICATION字段 名称 类型 描述 node_name text 节点名称。 pid bigint 线程的PID。 usesysid oid 用户系统ID。 usename name 用户名。 application_name text 程序名称。 client_addr inet 客户端地址。 client_hostname text 客户端名。 client_port integer 客户端端口号。 backend_start timestamp with time zone 程序启动时间。 state text 日志复制的状态（追赶状态，还是一致的流状态）。 sender_sent_location text 发送端发送日志位置。 receiver_write_location text 接收端write日志位置。 receiver_flush_location text 接收端flush日志位置。 receiver_replay_location text 接收端replay日志位置。 sync_priority integer 同步复制的优先级（0表示异步）。 sync_state text 同步状态（异步复制，同步复制，还是潜在同步）。 父主题： 系统视图

PGXC_STAT_DATABASE 视图PGXC_STAT_DATABASE显示集群中各节点上数据库的状态和统计信息，除新增node_name（节点名称）字段外，其余字段内容和PG_STAT_DATABASE视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_STAT_DATABASE字段 名称 类型 描述 node_name text 节点名称。 datid oid 数据库OID。 datname name 数据库名。 numbackends integer 当前节点上连接到该数据库的后端数。 这是该视图中唯一一个反映目前状态值的列；所有列均返回自上次重置以来的累积值。 xact_commit bigint 当前节点上该数据库中已经提交的事务数。 xact_rollback bigint 当前节点上该数据库中已经回滚的事务数。 blks_read bigint 当前节点上该数据库中读取的磁盘块的数量。 blks_hit bigint 当前节点上高速缓存中发现的磁盘块的个数，即缓存中命中的块数（只包括GaussDB(DWS)缓冲区高速缓存，不包括文件系统的缓存）。 tup_returned bigint 当前节点上该数据库查询返回的行数。 tup_fetched bigint 当前节点上该数据库查询抓取的行数。 tup_inserted bigint 当前节点上该数据库插入的行数。 tup_updated bigint 当前节点上该数据库更新的行数。 tup_deleted bigint 当前节点上该数据库删除的行数。 conflicts bigint 当前节点上由于数据库恢复冲突取消的查询数量（只在备用服务器上发生）。可参见PG_STAT_DATABASE_CONFLI CTS 。 temp_files bigint 当前节点上该数据库创建的临时文件个数。计算所有临时文件，不论为什么创建临时文件（比如排序或者哈希），而且不考虑log_temp_files设置。 temp_bytes bigint 当前节点上该数据库写入临时文件的大小。计算所有临时文件，不论为什么创建临时文件，而且不考虑log_temp_files设置。 deadlocks bigint 当前节点上该数据库中发生的死锁数量。 blk_read_time double precision 当前节点上该数据库后端读取数据文件块花费的时间，以毫秒计算。 blk_write_time double precision 当前节点上该数据库后端写入数据文件块花费的时间，以毫秒计算。 stats_reset timestamp with time zone 当前节点上该数据库统计重置的时间。 父主题： 系统视图

PGXC_STAT_BGWRITER PGXC_STAT_BGWRITER视图显示集群中各节点上后端写进程活动的统计信息，除新增node_name（节点名称）字段外，其余字段内容和PG_STAT_BGWRITER视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_STAT_BGWRITER字段 名称 类型 描述 node_name text 节点名称。 checkpoints_timed bigint 定期执行的检查点数量。 checkpoints_req bigint 请求执行的检查点数量。 checkpoint_write_time double precision 检查点期间将文件写入磁盘花费的时间，以毫秒为单位。 checkpoint_sync_time double precision 检查点期间数据同步到磁盘花费的时间，以毫秒为单位。 buffers_checkpoint bigint 检查点期间写入缓冲区的数量。 buffers_clean bigint 后端写进程写的缓冲区数量。 maxwritten_clean bigint 由于写入缓冲区太多，后端写进程停止清理扫描的次数。 buffers_backend bigint 后端直接写入的缓冲区数量。 buffers_backend_fsync bigint 后端需要fsync的次数。 buffers_alloc bigint 分配的缓冲区数量。 stats_reset timestamp with time zone 统计重置的时间。 父主题： 系统视图

PGXC_STAT_BAD_BLOCK PGXC_STAT_BAD_BLOCK视图显示集群所有节点从启动后，在读取数据时出现Page/CU校验失败的统计信息。 表1 PGXC_STAT_BAD_BLOCK字段 名字 类型 描述 nodename text 节点名称。 databaseid integer 数据库OID。 tablespaceid integer 表空间OID。 relfilenode integer 文件对象ID。 forknum integer 文件类型。 error_count integer 出现校验失败的次数。 first_time timestamp with time zone 第一次出现的时间。 last_time timestamp with time zone 最近一次出现的时间。 父主题： 系统视图

应用实例 查看当前处于阻塞状态的查询语句。 1 SELECT datname,usename,state,query FROM PGXC_STAT_ACTIVITY WHERE waiting = true; 查看快照线程的工作状态。 1 SELECT application_name,backend_start,state_change,state,query FROM PGXC_STAT_ACTIVITY WHERE application_name='WDRSnapshot'; 查看正在运行的查询语句。 1 2 3 4 5 6 7 8 9 SELECT datname,usename,state,pid FROM PGXC_STAT_ACTIVITY; datname | usename | state | pid ----------+---------+--------+----------------- gaussdb | Ruby | active | 140298793514752 gaussdb | Ruby | active | 140298718004992 gaussdb | Ruby | idle | 140298650908416 gaussdb | Ruby | idle | 140298625742592 gaussdb | dbadmin | active | 140298575406848 (5 rows) 查看指定数据库postgres上已使用的会话连接数。其中1表示数据库postgres上已使用的会话连接数。 1 2 3 4 5 SELECT COUNT(*) FROM PGXC_STAT_ACTIVITY WHERE DATNAME='postgres'; count ------- 1 (1 row)

PGXC_SETTINGS PGXC_SETTINGS视图显示集群中各节点数据库运行时参数的相关信息，除新增node_name（节点名称）字段外，其余字段内容和PG_SETTINGS视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_SETTINGS字段 名称 类型 描述 node_name text 节点名称。 name text 参数名称。 setting text 参数当前值。 unit text 参数的隐式结构。 category text 参数的逻辑组。 short_desc text 参数的简单描述。 extra_desc text 参数的详细描述。 context text 设置参数值的上下文，包括：internal，postmaster，sighup，backend，superuser和user。 vartype text 参数类型，包括bool，enum，integer，real和string。 source text 参数的赋值方式。 min_val text 参数最小值。如果参数类型不是数值型，那么该字段值为null。 max_val text 参数最大值。如果参数类型不是数值型，那么该字段值为null。 enumvals text[] enum类型参数合法值。如果参数类型不是enum型，那么该字段值为null。 boot_val text 数据库启动时参数默认值。 reset_val text 数据库重置时参数默认值。 sourcefile text 设置参数值的配置文件。如果参数不是通过配置文件赋值，那么该字段值为null。 sourceline integer 设置参数值的配置文件的行号。如果参数不是通过配置文件赋值，那么该字段值为null。 父主题： 系统视图

PGXC_RUNNING_XACTS PGXC_RUNNING_XACTS视图主要功能是显示集群中各个节点运行事务的信息，字段内容和PG_RUNNING_XACTS相同。 表1 PGXC_RUNNING_XACTS字段 名称 类型 描述 handle integer 事务在GTM对应的句柄。 gxid xid 事务ID号。 state tinyint 事务状态（3：prepared或者0：starting）。 node text 节点名称。 xmin xid 节点上当前数据涉及的最小事务号xmin。 vacuum boolean 标志当前事务是否是lazy vacuum事务。 timeline bigint 标识数据库重启次数。 prepare_xid xid 处于prepared状态事务的id号，若不在prepared状态，值为0。 pid bigint 事务对应的线程ID。 next_xid xid CN传给DN的事务ID号。 父主题： 系统视图

PGXC_REPLICATION_SLOTS PGXC_REPLICATION_SLOTS视图显示集群中DN上的复制信息，除新增node_name（节点名称）字段外，其余字段内容和PG_REPLICATION_SLOTS视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_REPLICATION_SLOTS字段 名称 类型 描述 node_name text 节点名称。 slot_name text 复制节点的名称。 plugin name 逻辑复制槽对应的输出插件名。 slot_type text 复制节点的类型。 datoid oid 复制节点的数据库OID。 database name 复制节点的数据库名称。 active boolean 复制节点是否为激活状态。 xmin xid 复制节点事务标识。 catalog_xmin text 逻辑复制槽对应的最早解码事务标识。 restart_lsn text 复制节点的Xlog文件信息。 dummy_standby boolean 复制节点是否为假备。 父主题： 系统视图

PGXC_REL_IOSTAT PGXC_REL_IOSTAT视图显示集群中各节点上磁盘读写的统计信息。除新增node_name（节点名称）字段外，其余字段内容和GS_REL_IOSTAT视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_REL_IOSTAT字段 名称 类型 描述 node_name text 节点名称。 phyrds bigint 读磁盘次数。 phywrts bigint 写磁盘次数。 phyblkrd bigint 读磁盘页数。 phyblkwrt bigint 写磁盘页数。 父主题： 系统视图

PGXC_REDO_STAT 视图PGXC_REDO_STAT显示集群中各节点上X LOG 重做过程中的统计信息，除新增node_name（节点名称）字段外，其余字段内容和PV_REDO_STAT视图相同。需要有系统管理员权限或预置角色gs_role_read_all_stats权限才可以访问此视图。 表1 PGXC_REDO_STAT字段 名称 类型 描述 node_name text 节点名称。 phywrts bigint 物理写次数。 phyblkwrt bigint 物理写块数。 writetim bigint 物理写消耗时间。 avgiotim bigint 平均每次写入时间。 lstiotim bigint 上一次写入时间。 miniotim bigint 最小写入时间。 maxiowtm bigint 最大写入时间。 父主题： 系统视图

PGXC_OS_THREADS PGXC_OS_THREADS视图提供当前集群中所有正常节点下的线程状态信息。 表1 PGXC_OS_THREADS字段 名称 类型 描述 node_name text 当前集群中所有正常节点的名称。 pid bigint 当前集群中所有正常节点进程中正在运行的线程号。 lwpid integer 与pid对应的轻量级线程号。 thread_name text 与pid对应的线程名称。 creation_time timestamp with time zone 与pid对应的线程创建的时间。 父主题： 系统视图

PGXC_OS_RUN_INFO PGXC_OS_RUN_INFO视图显示集群中各节点上操作系统运行的状态信息，除新增node_name（节点名称）字段外，其余字段内容和PV_OS_RUN_INFO视图相同。需要有系统管理员权限或预置角色gs_role_read_all_stats权限才可以访问此视图。 表1 PGXC_OS_RUN_INFO字段 名称 类型 描述 node_name text 节点名称。 id integer 编号。 name text 操作系统运行状态名称。 value numeric 操作系统运行状态值。 comments text 操作系统运行状态注释。 cumulative boolean 操作系统运行状态的值是否为累加值。 父主题： 系统视图

PGXC_NODE_STAT_RESET_TIME PGXC_NODE_STAT_RESET_TIME视图显示集群中各节点的统计信息重置时间，除新增node_name（节点名称）字段外，其余字段内容和GS_NODE_STAT_RESET_TIME视图相同。需要有系统管理员权限才可以访问此视图。 表1 PGXC_NODE_STAT_RESET_TIME字段 名称 类型 描述 node_name text 节点名称。 reset_time timestamp 各节点的统计信息重置时间。 父主题： 系统视图

PGXC_NODE_ENV PGXC_NODE_ENV视图提供获取集群中所有节点的环境变量信息。 表1 PGXC_NODE_ENV字段 名称 类型 描述 node_name text 集群中所有节点的名称。 host text 集群中所有节点的主机名称。 process integer 集群中所有节点的进程号。 port integer 集群中所有节点的端口号。 installpath text 集群中所有节点的安装目录。 datapath text 集群中所有节点的数据目录。 log_directory text 集群中所有节点的日志目录。 父主题： 系统视图

PGXC_LOCK_CONFLICTS PGXC_LOCK_CONFLICTS视图提供集群中有冲突的锁的信息。 当某一个锁正在等待另一个锁，或正在被另一个锁等待，即该锁是有冲突的。 目前，PGXC_LOCK_CONFLICTS视图只收集locktype为relation、partition、page、tuple和transactionid的锁的信息。 表1 PGXC_LOCK_CONFLICTS字段 名称 类型 描述 locktype text 被锁定对象的类型。 nodename name 被锁定对象的节点的名称。 dbname name 被锁定对象的数据库的名称。如果被锁定对象是事务，则为NULL。 nspname name 被锁定对象的命名空间的名称。 relname name 被锁定对象对应的关系的名称。如果被锁定对象既不是关系，也不是关系的一部分，则为NULL。 partname name 被锁定对象对应的分区的名称。如果被锁定对象不是分区，则为NULL。 page integer 被锁定对象对应的页面的编号。如果被锁定对象既不是页面，也不是元组，则为NULL。 tuple smallint 被锁定对象对应的元组的编号。如果被锁定对象不是元组，则为NULL。 transactionid xid 被锁定对象对应的事务的ID。如果被锁定对象不是事务，则为NULL。 username name 申请锁的用户的名称。 gxid xid 申请锁的事务的ID。 xactstart timestamp with time zone 申请锁的事务的开始时间。 queryid bigint 申请锁的线程的最新查询ID。 query text 申请锁的线程的最新查询语句。 pid bigint 申请锁的线程的ID。 mode text 锁的级别。 granted boolean 如果锁已被持有，则为TRUE。 如果锁还在等待其它锁，则为FALSE。 父主题： 系统视图

PGXC_INSTR_UNIQUE_SQL PGXC_INSTR_UNIQUE_SQL视图展示集群中所有CN节点的Unique SQL的完整统计信息。 需要有系统管理员权限才可以访问此视图，该视图的字段与GS_INSTR_UNIQUE_SQL视图字段相同。具体的字段请参考表1。 表1 GS_INSTR_UNIQUE_SQL字段 名称 类型 描述 node_name name 接收SQL的CN节点名称。 node_id integer 节点ID，等同于pgxc_node表中node_id。 user_name name 用户名称。 user_id oid 用户ID。 unique_sql_id bigint 归一化的UNIQUE SQL ID。 query text 归一化的SQL文本。 n_calls bigint 成功执行次数。 min_elapse_time bigint SQL在数据库内的最小运行时间，单位为微秒。 max_elapse_time bigint SQL在数据库内的最大运行时间，单位为微秒。 total_elapse_time bigint SQL在数据库内的总运行时间，单位为微秒。 n_returned_rows bigint 行活动-SELECT语句返回的结果集行数。 n_tuples_fetched bigint 行活动-随机扫描行（列存表/外表不统计）。 n_tuples_returned bigint 行活动-顺序扫描行（列存表/外表不统计）。 n_tuples_inserted bigint 行活动-插入行数。 n_tuples_updated bigint 行活动-更新行数。 n_tuples_deleted bigint 行活动-删除行数。 n_blocks_fetched bigint buffer的块访问次数，即物理读/IO。 n_blocks_hit bigint buffer的块命中次数，即逻辑读/Cache。 n_soft_parse bigint 软解析次数（缓存计划）。 n_hard_parse bigint 硬解析次数（生成计划）。 db_time bigint 有效的DB执行时间，包含等待时间、网络发送时间等，若查询执行涉及到多线程，DB_TIME是多个线程的DB_TIME之和，单位为微秒。 cpu_time bigint CPU的执行时间，不包含sleep时间，单位为微秒。 execution_time bigint 查询执行器内的SQL执行时间，DDL语句、以及某些不经过执行器执行的语句（例如Copy语句）不计数，单位为微秒。 parse_time bigint SQL解析时间，单位为微秒。 plan_time bigint SQL生成计划时间，单位为微秒。 rewrite_time bigint SQL重写时间，单位为微秒。 pl_execution_time bigint plpgsql过程化语言函数上的执行时间，单位为微秒。 pl_compilation_time bigint plpgsql过程化语言函数上的编译时间，单位为微秒。 net_send_time bigint 网络时间，包含CN向客户端发送数据、DN向CN发送数据等时间，单位为微秒。 data_io_time bigint IO时间，文件IO耗时，单位为微秒。 first_time timestamp with time zone 该SQL第一次执行的时间。 last_time timestamp with time zone 该SQL上一次执行的时间。 父主题： 系统视图

PGXC_INSTANCE_TIME PGXC_INSTANCE_TIME视图显示集群中各节点上进程的运行时间信息及各执行阶段所消耗时间，除新增node_name（节点名称）字段外，其余字段内容和PV_INSTANCE_TIME视图相同。需要有系统管理员权限或预置角色gs_role_read_all_stats权限才可以访问此视图。 表1 PGXC_INSTANCE_TIME字段 名称 类型 描述 node_name text 节点名称。 stat_id integer 类型编号。 stat_name text 运行时间类型名称。 value bigint 运行时间值。 父主题： 系统视图

PGXC_GTM_SNAPSHOT_STATUS PGXC_GTM_SNAPSHOT_STATUS视图用于查看当前GTM上事务信息。 表1 PGXC_GTM_SNAPSHOT_STATUS字段 名称 类型 描述 xmin xid 仍在运行的最小事务号。 xmax xid 已完成的事务号最大的事务的下一个事务号。 csn integer 待提交事务的序列号。 oldestxmin xid 当前最早的活跃事务在其取快照时，所有运行事务号最小的事务。 xcnt integer 当前活跃的事务个数。 running_xids text 当前活跃的事务号。 父主题： 系统视图

应用示例 查询当前数据库中（库中表个数少于1W的场景）所有表的数据倾斜情况： 1 2 3 4 5 6 7 8 9 10 11 12 13 SELECT * FROM pgxc_get_table_skewness ORDER BY totalsize DESC; schemaname | tablename | totalsize | avgsize | maxratio | minratio | skewsize | skewratio | skewstddev ------------+-------------------------+-----------+---------+----------+----------+----------+-----------+------------ dbadmin | reason | 147456 | 49152 | .333 | .333 | 0 | 0.000 | 0 tpcds | reason_t2 | 73728 | 24576 | .556 | 0.000 | 40960 | .556 | 21674 dbadmin | reason_bk | 65536 | 21845 | .500 | 0.000 | 32768 | .500 | 18919 tsearch | pgweb | 49152 | 16384 | .333 | .333 | 0 | 0.000 | 0 dbadmin | student | 40960 | 13653 | .400 | .200 | 8192 | .200 | 4730 tsearch | ts_zhparser | 40960 | 13653 | .400 | .200 | 8192 | .200 | 4730 dbms_om | gs_wlm_session_info | 24576 | 8192 | .333 | .333 | 0 | 0.000 | 0 dbms_om | gs_wlm_ec_operator_info | 24576 | 8192 | .333 | .333 | 0 | 0.000 | 0 dbms_om | gs_wlm_operator_info | 24576 | 8192 | .333 | .333 | 0 | 0.000 | 0 (9 rows) 若数据库中表个数非常多（至少大于1W的场景），因PGXC_GET_TABLE_SKEWNESS涉及全库查并计算非常全面的倾斜字段，所以可能会花费比较长的时间（小时级），建议参考PGXC_GET_TABLE_SKEWNESS视图定义，直接使用table_distribution()函数自定义输出，减少输出列进行计算优化，例如： 1 2 3 4 5 6 SELECT schemaname,tablename,max(dnsize) AS maxsize, min(dnsize) AS minsize FROM pg_catalog.pg_class c INNER JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace INNER JOIN pg_catalog.table_distribution() s ON s.schemaname = n.nspname AND s.tablename = c.relname INNER JOIN pg_catalog.pgxc_class x ON c.oid = x.pcrelid AND x.pclocatortype = 'H' GROUP BY schemaname,tablename;

PGXC_DEADLOCK PGXC_DEADLOCK视图获取导致分布式死锁产生的锁等待信息。 目前，PGXC_DEADLOCK视图只收集locktype为relation、partition、page、tuple和transactionid的锁等待信息。 表1 PGXC_DEADLOCK字段 名称 类型 描述 locktype text 被锁定对象的类型。 nodename name 被锁定对象的节点名称。 dbname name 被锁定对象的数据库名称。如果被锁定对象是事务，则为NULL。 nspname name 被锁定对象的命名空间名称。 relname name 被锁定对象对应的关系名称。如果被锁定对象既不是关系，也不是关系的一部分，则为NULL。 partname name 被锁定对象对应的分区名称。如果被锁定对象不是分区，则为NULL。 page integer 被锁定对象对应的页面编号。如果被锁定对象既不是页面，也不是元组，则为NULL。 tuple smallint 被锁定对象对应的元组编号。如果被锁定对象不是元组，则为NULL。 transactionid xid 被锁定对象对应的事务ID。如果被锁定对象不是事务，则为NULL。 waitusername name 等待锁的用户名称。 waitgxid xid 等待锁的事务ID。 waitxactstart timestamp with time zone 等待锁事务的开始时间。 waitqueryid bigint 等待锁线程的最新查询ID。 waitquery text 等待锁线程的最新查询语句。 waitpid bigint 等待锁的线程ID。 waitmode text 等待锁的级别。 holdusername name 持有锁的用户名称。 holdgxid xid 持有锁的事务ID。 holdxactstart timestamp with time zone 持有锁的事务开始时间。 holdqueryid bigint 持有锁的线程最新查询ID。 holdquery text 持有锁的线程最新查询语句。 holdpid bigint 持有锁的线程ID。 holdmode text 持有锁的级别。 父主题： 系统视图

PGXC_COMM_STATUS PGXC_COMM_STATUS视图展示所有DN的通信库状态。 表1 PGXC_COMM_STATUS字段 名称 类型 描述 node_name text 节点名称。 rxpck/s integer 节点通信库接收速率，单位为Byte/s。 txpck/s integer 节点通信库发送速率，单位为Byte/s。 rxkB/s bigint 节点通信库接收速率，单位为KByte/s。 txkB/s bigint 节点通信库发送速率，单位为KByte/s。 buffer bigint cmailbox的buffer大小。 memKB(libcomm) bigint libcomm进程通信内存大小，单位为KByte。 memKB(libpq) bigint libpq进程通信内存大小，单位为KByte。 %USED(PM) integer postmaster线程实时使用率。 %USED (sflow) integer gs_sender_flow_controller线程实时使用率。 %USED (rflow) integer gs_receiver_flow_controller线程实时使用率。 %USED (rloop) integer 多个gs_receivers_loop线程中最高的实时使用率。 stream integer 当前使用的逻辑连接总数。 父主题： 系统视图

PGXC_COMM_SEND_STREAM PGXC_COMM_SEND_STREAM视图展示所有DN上的通信库发送流状态。 表1 PGXC_COMM_SEND_STREAM字段 名称 类型 描述 node_name text 节点名称。 local_tid bigint 使用此通信流的线程ID。 remote_name text 连接对端节点名称。 remote_tid bigint 连接对端线程ID。 idx integer 通信对端DN在本DN内的标识编号。 sid integer 通信流在物理连接中的标识编号。 tcp_sock integer 通信流所使用的tcp通信socket。 state text 通信流当前的状态。 UNKNOWN：表示当前逻辑连接状态未知。 READY：表示逻辑连接已就绪。 RUN：表示逻辑连接发送报文正常。 HOLD：表示逻辑连接发送报文等待中。 CLOSED：表示关闭逻辑连接。 TO_CLOSED：表示将会关闭逻辑连接。 query_id bigint 通信流对应的debug_query_id编号。 pn_id integer 通信流所执行查询的plan_node_id编号。 send_smp integer 通信流所执行查询send端的smpid编号。 recv_smp integer 通信流所执行查询recv端的smpid编号。 send_bytes bigint 通信流发送的数据总量，单位为Byte。 time bigint 通信流当前生命周期使用时长，单位为毫秒。 speed bigint 通信流的平均发送速率，单位为Byte/s。 quota bigint 通信流当前的通信配额值，单位为Byte。 wait_quota bigint 通信流等待quota值产生的额外时间开销，单位为毫秒。 父主题： 系统视图