华为云用户手册

PGXC_SESSION_WLMSTAT PGXC_SESSION_WLMSTAT视图显示当前集群中各CN节点用户执行作业正在运行时的负载管理相关信息。 表1 PGXC_SESSION_WLMSTAT字段 名称 类型 描述 nodename name 节点名称 datid oid 连接后端的数据库OID。 datname name 连接后端的数据库名称。 threadid bigint 后端线程ID。 processid integer 后端线程的PID。 usesysid oid 登录后端的用户OID。 appname text 连接到后端的应用名。 usename name 登录到该后端的用户名。 priority bigint 语句所在Cgroups的优先级。 attribute text 语句的属性： Ordinary：语句发送到数据库后被解析前的默认属性。 Simple：简单语句。 Complicated：复杂语句。 Internal：数据库内部语句。 block_time bigint 语句当前为止的pending的时间，单位为秒。 elapsed_time bigint 语句当前为止的实际执行时间，单位为秒。 total_cpu_time bigint 语句在上一时间周期内的DN上CPU使用的总时间，单位为秒。 cpu_skew_percent integer 语句在上一时间周期内的DN上CPU使用的倾斜率。 statement_mem integer 语句执行所需要的估算内存。 active_points integer 语句占用的资源池并发点数。 dop_value integer 从资源池中获取语句的dop值。 control_group text 语句当前所使用的Cgroups。 status text 语句当前的状态，包括： pending：执行前状态。 running：执行进行状态。 finished：执行正常结束。（当enqueue字段为StoredProc或Transaction时，仅代表语句中的部分作业已经执行完毕，该状态会持续到该语句完全执行完毕。） aborted：执行异常终止。 active：非以上四种状态外的正常状态。 unknown：未知状态。 enqueue text 语句当前的排队情况，包括： Global：全局排队。 Respool：资源池排队。 CentralQueue：在中心协调节点(CCN)中排队。 Transaction：语句处于一个事务块中。 StoredProc：语句处于一个存储过程中。 None：未在排队。 Forced None：事务块语句或存储过程语句由于超出设定的等待时间而强制执行。 resource_pool name 语句当前所在的资源池。 query text 该后端的最新查询。如果state状态是active，此字段显示当前正在执行的查询。所有其他情况表示上一个查询。 isplana bool 逻辑集群模式下，语句当前是否占用其他逻辑集群的资源执行。该值默认为f，表示不占用其他逻辑集群的资源执行。 node_group text 语句所属用户对应的逻辑集群。 lane text 表示语句查询的快慢车道。 fast：快车道。 slow：慢车道。 none：未管控。 父主题： 系统视图

PGXC_RESPOOL_RESOURCE_HISTORY PGXC_RESPOOL_RESOURCE_HISTORY用于查询所有实例上资源池监控历史信息。 表1 PGXC_RESPOOL_RESOURCE_HISTORY字段 名称 类型 描述 nodename name 实例名称，包含CN和DN。 timestamp timestamp 资源池监控信息持久化时间。 nodegroup name 资源池所属逻辑集群名称，默认集群显示“installation”。 rpname name 资源池名称。 cgroup name 资源池关联控制组名称。 ref_count int 资源池引用作业数，作业经过资源池不管是否管控都会计数，仅CN上有效。 fast_run int 资源池快车道运行作业数，只在CN上有效。 fast_wait int 资源池快车道排队作业数，只在CN上有效。 fast_limit int 资源池快车道作业并发限制，只在CN上有效。 slow_run int 资源池慢车道运行作业数，只在CN上有效。 slow_wait int 资源池慢车道排队作业数，只在CN上有效。 slow_limit int 资源池慢车道作业并发限制，只在CN上有效。 used_cpu double 资源池5s监控周期内使用CPU个数平均值，保留小数点后2位。 DN：显示当前DN上资源池使用的CPU个数。 CN：显示所有DN上资源池使用CPU的累积和。 cpu_limit int 资源池可用CPU的上限，CPU配额管控情况下为 GaussDB 可用CPU，CPU限额管控情况下为关联控制组CPU可用CPU。 DN：显示当前DN上资源池可用CPU上限。 CN：显示所有DN上资源池可用CPU上限的累积和。 used_mem int 资源池使用的内存大小，单位为MB。 DN：显示当前DN上资源池使用的内存大小。 CN：显示所有DN上资源池使用内存的累积和。 estimate_mem int 当前CN上，资源池运行作业的估算内存之和，只在CN上有效。 mem_limit int 资源池可用内存上限，单位为MB。 DN：显示当前DN上资源池可用内存上限。 CN：显示所有DN上资源池可用内存上限的累积和。 read_kbytes bigint 资源池5s监控周期内逻辑读字节数，单位为KB。 DN：显示当前DN上资源池逻辑读字节数。 CN：显示所有DN上资源池逻辑读字节的累积和。 write_kbytes bigint 资源池5s监控周期内逻辑写字节数，单位为KB。 DN：显示当前DN上资源池逻辑写字节数。 CN：显示所有DN上资源池逻辑写字节的累积和。 read_counts bigint 资源池5s监控周期内逻辑读次数。 DN：显示当前DN上资源池逻辑读次数。 CN：显示所有DN上资源池逻辑读次数的累积和。 write_counts bigint 资源池5s监控周期内逻辑写次数。 DN：显示当前DN上资源池逻辑写次数。 CN：显示所有DN上资源池逻辑写次数的累积和。 read_speed double 资源池5s监控周期内逻辑读速率的平均值。 DN：显示当前DN上资源池逻辑读速率。 CN：显示所有DN上资源池逻辑读速率的累积和。 write_speed double 资源池5s监控周期内逻辑写速率平均值。 DN：显示当前DN上资源池逻辑写速率。 CN：显示所有DN上资源池逻辑写速率的累积和。 父主题： 系统视图

PGXC_RESPOOL_RESOURCE_INFO PGXC_RESPOOL_RESOURCE_INFO视图显示所有实例上资源池实时监控信息。 DN上仅显示当前DN所属逻辑集群的资源池监控信息。 表1 PGXC_RESPOOL_RESOURCE_INFO字段 名称 类型 描述 nodename name 实例名称，包含CN和DN。 nodegroup name 资源池所属逻辑集群名称，默认集群显示“installation”。 rpname name 资源池名称。 cgroup name 资源池关联控制组名称。 ref_count int 资源池引用作业数，作业经过资源池不管是否管控都会计数，仅CN上有效。 fast_run int 资源池快车道运行作业数，只在CN上有效。 fast_wait int 资源池快车道排队作业数，只在CN上有效。 fast_limit int 资源池快车道作业并发限制，只在CN上有效。 slow_run int 资源池慢车道运行作业数，只在CN上有效。 slow_wait int 资源池慢车道排队作业数，只在CN上有效。 slow_limit int 资源池慢车道作业并发限制，只在CN上有效。 used_cpu double 资源池5s监控周期内使用CPU个数平均值，保留小数点后2位。 DN：显示当前DN上资源池使用的CPU个数。 CN：显示所有DN上资源池使用CPU的累积和。 cpu_limit int 资源池可用CPU的上限，CPU配额管控情况下为GaussDB(DWS)可用CPU，CPU限额管控情况下为关联控制组CPU可用CPU。 DN：显示当前DN上资源池可用CPU上限。 CN：显示所有DN上资源池可用CPU上限的累积和。 used_mem int 资源池当前使用的内存大小，单位为MB。 DN：显示当前DN上资源池使用的内存大小。 CN：显示所有DN上资源池使用内存的累积和。 estimate_mem int 当前CN上，资源池运行作业的估算内存之和，只在CN上有效。 mem_limit int 资源池可用内存上限，单位为MB。 DN：显示当前DN上资源池可用内存上限。 CN：显示所有DN上资源池可用内存上限的累积和。 read_kbytes bigint 资源池5s监控周期内逻辑读字节数，单位为KB。 DN：显示当前DN上资源池逻辑读字节数。 CN：显示所有DN上资源池逻辑读字节的累积和。 write_kbytes bigint 资源池5s监控周期内逻辑写字节数，单位为KB。 DN：显示当前DN上资源池逻辑写字节数。 CN：显示所有DN上资源池逻辑写字节的累积和。 read_counts bigint 资源池5s监控周期内逻辑读次数。 DN：显示当前DN上资源池逻辑读次数。 CN：显示所有DN上资源池逻辑读次数的累积和。 write_counts bigint 资源池5s监控周期内逻辑写次数。 DN：显示当前DN上资源池逻辑写次数。 CN：显示所有DN上资源池逻辑写次数的累积和。 read_speed double 资源池5s监控周期内逻辑读速率的平均值。 DN：显示当前DN上资源池逻辑读速率。 CN：显示所有DN上资源池逻辑读速率的累积和。 write_speed double 资源池5s监控周期内逻辑写速率平均值。 DN：显示当前DN上资源池逻辑写速率。 CN：显示所有DN上资源池逻辑写速率的累积和。 父主题： 系统视图

PGXC_RESPOOL_RUNTIME_INFO PGXC_RESPOOL_RUNTIME_INFO视图显示所有CN上所有资源池作业运行信息。 表1 PGXC_RESPOOL_RUNTIME_INFO字段 名称 类型 描述 nodename name CN名称 nodegroup name 资源池所属逻辑集群名称，默认集群显示"installation" rpname name 资源池名称 ref_count int 资源池引用作业数，作业经过资源池不管是否管控都会计数 fast_run int 资源池快车道运行作业数 fast_wait int 资源池快车道排队作业数 slow_run int 资源池慢车道运行作业数 slow_wait int 资源池慢车道排队作业数 父主题： 系统视图

PGXC_COMM_QUERY_SPEED PGXC_COMM_QUERY_SPEED视图展示所有节点上所有query对应的流量信息。 表1 PGXC_COMM_QUERY_SPEED字段 名称 类型 描述 node_name text 节点名称。 query_id bigint 通信流对应的debug_query_id编号。 rxkB/s bigint 查询对应的通信流接收速率，单位为Byte/s。 txkB/s bigint 查询对应的通信流发送速率，单位为Byte/s。 rxkB bigint 查询对应的通信流接收数据总量，单位为Byte。 txkB bigint 查询对应的通信流发送数据总量，单位为Byte。 rxpck/s bigint 查询对应的通信包接收速率，单位为packages/s。 txpck/s bigint 查询对应的通信包发送速率，单位为packages/s。 rxpck bigint 查询对应的通信包接收总量，单位为packages。 txpck bigint 查询对应的通信包发送总量，单位为packages。 父主题： 系统视图

PG_COMM_QUERY_SPEED PG_COMM_QUERY_SPEED视图展示单个节点上所有query对应的流量信息。 表1 PG_COMM_QUERY_SPEED字段 名称 类型 描述 node_name text 节点名称。 query_id bigint 通信流对应的debug_query_id编号。 rxkB/s bigint 查询对应的通信流接收速率，单位为Byte/s。 txkB/s bigint 查询对应的通信流发送速率，单位为Byte/s。 rxkB bigint 查询对应的通信流接收数据总量，单位为Byte。 txkB bigint 查询对应的通信流发送数据总量，单位为Byte。 rxpck/s bigint 查询对应的通信包接收速率，单位为packages/s。 txpck/s bigint 查询对应的通信包发送速率，单位为packages/s。 rxpck bigint 查询对应的通信包接收总量，单位为packages。 txpck bigint 查询对应的通信包发送总量，单位为packages。 父主题： 系统视图

GS_RESPOOL_RESOURCE_INFO GS_RESPOOL_RESOURCE_INFO视图显示CN上所有资源池作业运行信息以及当前实例（CN/DN）所有资源池资源使用信息。 DN上仅显示当前DN所属逻辑集群的资源池监控信息。 表1 GS_RESPOOL_RESOURCE_INFO字段 名称 类型 描述 nodegroup name 资源池所属逻辑集群名称，默认集群显示“installation”。 rpname name 资源池名称。 cgroup name 资源池关联控制组名称。 ref_count int 资源池引用作业数，作业经过资源池不管是否管控都会计数，只在CN上有效。 fast_run int 资源池快车道运行作业数，只在CN上有效。 fast_wait int 资源池快车道排队作业数，只在CN上有效。 fast_limit int 资源池快车道作业并发限制，只在CN上有效。 slow_run int 资源池慢车道运行作业数，只在CN上有效。 slow_wait int 资源池慢车道排队作业数，只在CN上有效。 slow_limit int 资源池慢车道作业并发限制，只在CN上有效。 used_cpu double 资源池5s监控周期内使用CPU个数平均值，保留小数点后2位： DN：显示当前DN上资源池使用的CPU个数。 CN：显示所有DN上资源池使用CPU的累积和。 cpu_limit int 资源池可用CPU的上限，CPU配额管控情况下为GaussDB可用CPU，CPU限额管控情况下为关联控制组CPU可用CPU： DN：显示当前DN上资源池可用CPU上限。 CN：显示所有DN上资源池可用CPU上限的累积和。 used_mem int 资源池当前使用的内存大小，单位为MB。 DN：显示当前DN上资源池使用的内存大小。 CN：显示所有DN上资源池使用内存的累积和。 estimate_mem int 当前CN上，资源池运行作业的估算内存之和，只在CN上有效。 mem_limit int 资源池可用内存上限，单位为MB。 DN：显示当前DN上资源池可用内存上限。 CN：显示所有DN上资源池可用内存上限的累积和。 read_kbytes bigint 资源池5s监控周期内逻辑读字节数，单位为KB。 DN：显示当前DN上资源池逻辑读字节数。 CN：显示所有DN上资源池逻辑读字节的累积和。 write_kbytes bigint 资源池5s监控周期内逻辑写字节数，单位为KB。 DN：显示当前DN上资源池逻辑写字节数。 CN：显示所有DN上资源池逻辑写字节的累积和。 read_counts bigint 资源池5s监控周期内逻辑读次数： DN：显示当前DN上资源池逻辑读次数。 CN：显示所有DN上资源池逻辑读次数的累积和。 write_counts bigint 资源池5s监控周期内逻辑写次数： DN：显示当前DN上资源池逻辑写次数。 CN：显示所有DN上资源池逻辑写次数的累积和。 read_speed double 资源池5s监控周期内逻辑读速率的平均值： DN：显示当前DN上资源池逻辑读速率。 CN：显示所有DN上资源池逻辑读速率的累积和。 write_speed double 资源池5s监控周期内逻辑写速率平均值： DN：显示当前DN上资源池逻辑写速率。 CN：显示所有DN上资源池逻辑写速率的累积和。 父主题： 系统视图

GS_RESPOOL_RUNTIME_INFO GS_RESPOOL_RUNTIME_INFO视图显示当前CN所有资源池作业运行信息。 表1 GS_RESPOOL_RUNTIME_INFO字段 名称 类型 描述 nodegroup name 资源池所属逻辑集群名称，默认集群显示“installation”。 rpname name 资源池名称。 ref_count int 资源池引用作业数，作业经过资源池不管是否管控都会计数。 fast_run int 资源池快车道运行作业数。 fast_wait int 资源池快车道排队作业数。 slow_run int 资源池慢车道运行作业数。 slow_wait int 资源池慢车道排队作业数。 父主题： 系统视图

GS_RESPOOL_RESOURCE_HISTORY GS_RESPOOL_RESOURCE_HISTORY表记录资源池监控历史信息，CN和DN上均进行记录。 表1 GS_RESPOOL_RESOURCE_HISTORY字段 名称 类型 描述 timestamp timestamp 资源池监控信息持久化时间。 nodegroup name 资源池所属逻辑集群名称，默认集群显示"installation"。 rpname name 资源池名称。 cgroup name 资源池关联控制组名称。 ref_count int 资源池引用作业数，作业经过资源池不管是否管控都会计数，仅CN上有效。 fast_run int 资源池快车道运行作业数，只在CN上有效。 fast_wait int 资源池快车道排队作业数，只在CN上有效。 fast_limit int 资源池快车道作业并发限制，只在CN上有效。 slow_run int 资源池慢车道运行作业数，只在CN上有效。 slow_wait int 资源池慢车道排队作业数，只在CN上有效。 slow_limit int 资源池慢车道作业并发限制，只在CN上有效。 used_cpu double 资源池5s监控周期内使用CPU个数平均值，保留小数点后2位。 DN：显示当前DN上资源池使用的CPU个数。 CN：显示所有DN上资源池使用CPU的累积和。 cpu_limit int 资源池可用CPU的上限，CPU配额管控情况下为GaussDB可用CPU，CPU限额管控情况下为关联控制组CPU可用CPU。 DN：显示当前DN上资源池可用CPU上限。 CN：显示所有DN上资源池可用CPU上限的累积和。 used_mem int 资源池使用的内存大小，单位为MB。 DN：显示当前DN上资源池使用的内存大小。 CN：显示所有DN上资源池使用内存的累积和。 estimate_mem int 当前CN上，资源池运行作业的估算内存之和，只在CN上有效。 mem_limit int 资源池可用内存上限，单位为MB。 DN：显示当前DN上资源池可用内存上限。 CN：显示所有DN上资源池可用内存上限的累积和。 read_kbytes bigint 资源池5s监控周期内逻辑读字节数，单位为KB。 DN：显示当前DN上资源池逻辑读字节数。 CN：显示所有DN上资源池逻辑读字节的累积和。 write_kbytes bigint 资源池5s监控周期内逻辑写字节数，单位为KB。 DN：显示当前DN上资源池逻辑写字节数。 CN：显示所有DN上资源池逻辑写字节的累积和。 read_counts bigint 资源池5s监控周期内逻辑读次数。 DN：显示当前DN上资源池逻辑读次数。 CN：显示所有DN上资源池逻辑读次数的累积和。 write_counts bigint 资源池5s监控周期内逻辑写次数。 DN：显示当前DN上资源池逻辑写次数。 CN：显示所有DN上资源池逻辑写次数的累积和。 read_speed double 资源池5s监控周期内逻辑读速率的平均值。 DN：显示当前DN上资源池逻辑读速率。 CN：显示所有DN上资源池逻辑读速率的累积和。 write_speed double 资源池5s监控周期内逻辑写速率平均值。 DN：显示当前DN上资源池逻辑写速率。 CN：显示所有DN上资源池逻辑写速率的累积和。 父主题： 系统表

操作步骤 查询资源池的作业实时运行情况。 1 SELECT * FROM GS_RESPOOL_RUNTIME_INFO; 得到的结果视图如下： 1 2 3 4 5 6 7 8 9 nodegroup | rpname | ref_count | fast_run | fast_wait | slow_run | slow_wait -----------+--------------+-----------+----------+-----------+----------+----------- vc1 | p2 | 10 | 0 | 0 | 0 | 0 vc2 | p3 | 10 | 5 | 5 | 0 | 0 vc2 | p4 | 0 | 0 | 0 | 0 | 0 vc1 | default_pool | 0 | 0 | 0 | 0 | 0 vc2 | default_pool | 0 | 0 | 0 | 0 | 0 vc1 | p1 | 20 | 5 | 5 | 3 | 7 (6 rows) 其中： ref_count为引用当前资源池信息的作业数，语句从进入管控到结束一直占用该计数； fast_run和slow_run为负载管理记账信息，只有管控(fast_limit/slow_limit大于0)时该值才有效； 该视图仅在CN上有效，持久化信息保存在GS_RESPOOL_RESOURCE_HISTORY中； 各字段说明详见GS_RESPOOL_RUNTIME_INFO。 查询资源池的资源限额和资源实时使用情况。 1 SELECT * FROM GS_RESPOOL_RESOURCE_INFO; 得到的结果视图如下： 1 2 3 4 5 6 7 8 9 nodegroup | rpname | cgroup | ref_count | fast_run | fast_wait | fast_limit | slow_run | slow_wait | slow_limit | used_cpu | cpu_limit | used_mem | estimate_mem | mem_limit |read_kbytes | write_kbytes | read_counts | write_counts | read_speed | write_speed -----------+--------------+---------------------+-----------+----------+-----------+------------+----------+-----------+------------+----------+-----------+----------+--------------+-----------+-------------+--------------+-------------+--------------+------------+------------- vc1 | p2 | DefaultClass:Rush | 10 | 0 | 0 | -1 | 0 | 0 | 10 | 9.97 | 48 | 20 | 0 | 11555 | 8 | 2880 | 1 | 360 | 1 | 589 vc2 | p3 | DefaultClass:Rush | 10 | 5 | 5 | 5 | 0 | 0 | 10 | 4.98 | 48 | 11 | 0 | 11555 | 0 | 848 | 0 | 106 | 0 | 173 vc2 | p4 | DefaultClass:Rush | 0 | 0 | 0 | -1 | 0 | 0 | 10 | 0 | 48 | 0 | 0 | 11555 | 0 | 0 | 0 | 0 | 0 | 0 vc1 | default_pool | DefaultClass:Medium | 0 | 0 | 0 | -1 | 0 | 0 | -1 | 0 | 48 | 0 | 0 | 11555 | 0 | 0 | 0 | 0 | 0 | 0 vc2 | default_pool | DefaultClass:Medium | 0 | 0 | 0 | -1 | 0 | 0 | -1 | 0 | 48 | 0 | 0 | 11555 | 0 | 0 | 0 | 0 | 0 | 0 vc1 | p1 | DefaultClass:Rush | 20 | 5 | 5 | 5 | 3 | 7 | 3 | 7.98 | 48 | 16 | 768 | 11555 | 8 | 2656 | 1 | 332 | 1 | 543 (6 rows) 该视图在CN和DN上均有效，DN上CPU、内存和IO为本DN资源消耗情况，CN上CPU、内存和IO为集群内所有DN上资源消耗的累加和； estimate_mem仅在动态负载管理情况下CN上有效，显示资源池估算内存记账情况； IO监控信息仅在enable_logical_io_statistics开启时才会记录； 各字段说明详见GS_RESPOOL_RESOURCE_INFO。 查询资源池的资源限额和资源历史使用情况。 1 SELECT * FROM GS_RESPOOL_RESOURCE_HISTORY ORDER BY timestamp DESC; 得到的结果视图如下： 1 2 3 4 5 6 7 8 9 timestamp | nodegroup | rpname | cgroup | ref_count | fast_run | fast_wait | fast_limit | slow_run | slow_wait | slow_limit | used_cpu | cpu_limit | used_mem | estimate_mem | mem_limit | read_kbytes | write_kbytes | read_counts | write_counts | read_speed | write_speed -------------------------------+--------------+--------------+---------------------+-----------+----------+-----------+------------+----------+-----------+------------+----------+-----------+----------+--------------+-----------+-------------+--------------+-------------+--------------+------------+------------- 2022-03-04 09:41:57.53739+08 | vc1 | p2 | DefaultClass:Rush | 10 | 0 | 0 | -1 | 0 | 0 | 10 | 9.97 | 48 | 20 | 0 | 11555 | 0 | 2320 | 0 | 290 | 0 | 474 2022-03-04 09:41:57.53739+08 | vc1 | p1 | DefaultClass:Rush | 20 | 5 | 5 | 5 | 3 | 7 | 3 | 7.98 | 48 | 16 | 768 | 11555 | 0 | 1896 | 0 | 237 | 0 | 387 2022-03-04 09:41:57.53739+08 | vc2 | default_pool | DefaultClass:Medium | 0 | 0 | 0 | -1 | 0 | 0 | -1 | 0 | 48 | 0 | 0 | 11555 | 0 | 0 | 0 | 0 | 0 | 0 2022-03-04 09:41:57.53739+08 | vc1 | default_pool | DefaultClass:Medium | 0 | 0 | 0 | -1 | 0 | 0 | -1 | 0 | 48 | 0 | 0 | 11555 | 0 | 0 | 0 | 0 | 0 | 0 2022-03-04 09:41:57.53739+08 | vc2 | p4 | DefaultClass:Rush | 0 | 0 | 0 | -1 | 0 | 0 | 10 | 0 | 48 | 0 | 0 | 11555 | 0 | 0 | 0 | 0 | 0 | 0 2022-03-04 09:41:57.53739+08 | vc2 | p3 | DefaultClass:Rush | 10 | 5 | 5 | 5 | 0 | 0 | 10 | 4.99 | 48 | 11 | 0 | 11555 | 0 | 880 | 0 | 110 | 0 | 180 2022-03-04 09:41:27.335234+08 | vc2 | p3 | DefaultClass:Rush | 10 | 5 | 5 | 5 | 0 | 0 | 10 | 4.98 | 48 | 11 | 0 | 11555 | 0 | 856 | 0 | 107 | 0 | 175 该监控信息来自资源池监控历史表，enable_user_metric_persistent开启时每30秒记录一次； 该表数据保存时间由GUC参数user_metric_retention_time控制； 各字段说明详见GS_RESPOOL_RESOURCE_HISTORY。

简介 多租户管理框架下，用户关联资源池执行查询，用户执行查询所占用的资源将汇总至关联资源池上，通过资源池监控视图，用户可以直观的查询到所有资源池的实时资源使用情况，同时也可以通过资源池监控历史表查询资源池资源的历史使用情况。 资源池监控数据每5s更新一次，但是因为CN和DN时间差，实际监控数据更新时间可能会大于5s，正常不会超过10s。资源池监控数据每30s持久化一次，资源池监控和用户监控逻辑基本一致，因此共用GUC参数控制持久化和老化，使用GUC参数enable_user_metric_persistent控制是否进行资源池监控数据持久化，使用GUC参数user_metric_retention_time控制资源池监控数据老化。 资源池监控的资源包含：快慢车道作业运行和排队信息，CPU、内存以及逻辑IO资源监控信息。涉及的监控视图和历史表如下所示： 资源池实时运行信息监控视图(单CN)：GS_RESPOOL_RUNTIME_INFO； 资源池实时运行信息监控视图(所有CN)：PGXC_RESPOOL_RUNTIME_INFO； 资源池实时资源监控视图(单CN)：GS_RESPOOL_RESOURCE_INFO； 资源池实时资源监控视图(所有CN)：PGXC_RESPOOL_RESOURCE_INFO； 资源池历史资源监控表(单CN)：GS_RESPOOL_RESOURCE_HISTORY； 资源池历史资源监控视图(所有CN)：PGXC_RESPOOL_RESOURCE_HISTORY； 资源池监控可以同时监控快慢车道所有作业的CPU、IO和内存使用情况，不再受限于仅监控慢车道作业。 当前快车道作业内存和CPU不受控，在快车道运行作业占用资源较多情况下，可能出现已用资源大于资源限制的情况。 DN资源池监控视图中，IO、内存和CPU显示的是本DN上资源池资源使用和资源限制信息。 CN资源池监控视图中，IO、内存和CPU显示的是集群内所有DN资源池资源使用和资源限制的累积和。 DN每隔5s更新一次资源池监控信息，CN每隔5s从DN收集一次资源池监控信息，因为各实例单独更新/收集资源池监控信息，因此各实例监控信息更新时间可能不一致。 辅助线程中每隔30s自动调用持久化函数，持久化资源池监控数据，正常情况下不需要用户单独调用持久化函数持久化资源池监控数据。

程序编写原则 在PL/pgSQL中的SQL语句宜使用绑定变量。 在PL/pgSQL中的SQL语句宜使用RETURNING子句。 存储过程使用原则： 对于单个存储过程中varchar或者varchar2类型输出参数个数不应超过50个。 不应使用long类型作为输入或输出参数。 对于大小超过10MB的字符串类型输出，应使用CLOB类型。 变量声明原则： 变量声明时，如果含义和应用表某字段含义或某变量相同时，应使用%TYPE声明。 记录声明时，如果含义和某应用表行数据相同时，应使用%ROWTYPE声明。 变量声明每行应只包含一条语句。 不应声明LONG类型的变量。 游标使用类型： 显式游标使用后应关闭。 游标变量使用后应关闭。若游标变量需要传递数据给调用的应用程序，应在应用程序中关闭游标；若游标变量仅在存储过程中使用，应显式关闭游标。 在使用DBMS_SQL.CLOSE_CURSOR关闭游标前，应使用DBMS_SQL.IS_OPEN判断游标是否已打开。 集合使用原则：引用集合中的元素时宜使用FORALL语句，不宜使用FOR循环语句。 动态语句使用原则： 联机系统的交易程序不宜使用动态SQL。 PL/pgSQL中要实现DDL语句和系统控制命令，可使用动态SQL。 尽量使用变量绑定。 拼装SQL的使用原则： 拼装SQL宜使用绑定变量。 拼装SQL语句的条件如果有外部输入源，应对输入条件进行字符检查，防止攻击。 在PL/pgSQL脚本中，单行代码的长度，不宜超过2499字符。 Trigger使用原则： Trigger可用于实现差量数据日志等与业务处理无关的可用性设计场景。 不应使用Trigger实现业务处理相关功能。

总体开发原则 应完全按照设计文档进行开发。 程序模块应做到高内聚低耦合。 应有正确、全面的故障对策。 程序编写应做到结构合理，条理清晰。 程序名称命名应按照统一的命名规则进行命名。 应充分考虑程序的运行效率，包括程序的执行效率和数据库的查询、存储效率，在保证应用的同时应使用效率高的处理方法。 程序注释应详细、正确、规范。 除非应用特别需要控制COMMIT和ROLLBACK的提交时机，否则应在存储过程结束时执行显式的COMMIT或者ROLLBACK操作。 程序处理应支持7*24小时；对于程序中断，应用程序应提供安全、简单的断点再续处理。 应提供标准、简单的应用输出，为应用维护人员提供明确的进度显示、错误描述和运行结果；为业务人员提供明确、直观的报表、凭证输出。

异常处理原则 任何在PL/pgSQL函数中发生的错误都会中止该函数的执行，实际上还会中止其周围的事务。可以使用带有EXCEPTION子句的BEGIN块捕获错误并且从中恢复。 在使用PL/pgSQL块中，如果使用了不能返回确定结果的SQL语句，应在EXCEPTION子句中对程序可能出现的异常进行处理，避免出现未处理的异常被传递到外层块，导致程序逻辑错误。 对于系统已经定义的异常，可以直接使用。DWS暂不支持自定义异常。 进入和退出一个包含EXCEPTION子句的块要比不包含EXCEPTION子句的块开销大的多。因此，非必要场景不使用EXCEPTION。

书写规范 变量命名规则： 过程、函数的输入参数格式宜为：IN_参数名，参数名宜使用大写。 过程、函数的输出参数格式宜为：OUT_参数名，参数名宜使用大写。 过程、函数的输入输出参数格式宜为：IO_参数名，参数名宜使用大写。 过程、函数的程序中用到的变量宜由v_变量名组成，变量名宜使用小写。 将查询语句做成字符串拼接时，where语句的拼接变量名宜统一为v_where，select语句的拼接变量名宜为v_select。 记录（RECORD）的类型（TYPE）命名宜由T+变量名组成，名称宜使用大写。 游标命名宜由CUR+变量名组成，名称宜使用大写。 引用游标（REF CURSOR）的命名宜由REF+变量名组成，名称宜使用大写。 变量类型定义： 变量类型声明时，如果其含义和应用表某字段含义相同时，应使用%TYPE声明。 记录类型声明时，如果其含义和某应用表行数据相同时，应使用%ROWTYPE声明。 注释规范： 注释应该是有意义的，而不只是重述代码。 注释应简洁、易懂，以中文为主。为了表达准确，名词或操作上也可以使用英文。 应在每个存储过程、函数的开始加入注释，注释内容应包括：本程序的简要功能描述、编写者、编写日期、程序版本号信息和程序变更信息，同时各存储过程开头注释应保持统一格式。 应在输入输出参数的旁边添加注释，注明变量的意义。 应在每个块或大分支的开始添加注释，描述块的简要功能，若使用算法，应添加注释简单描述算法的目的和结果。 变量声明格式： 每行应只包含一条语句，如同时需要赋初始值，应在同一行书写。 大小写规范： 除了变量名，应一律使用大写。 缩进规范： 创建存储过程语句中，同一层的CREATE、AS/IS、BEGIN、END这几个关键字应位于同一列，其他部分依次缩进。 语句详述： 变量定义语句。每行应只包含一条语句。 同一层的IF、ELSEIF、ELSE和END关键字应开始于同一列，执行语句缩进。 CASE和END关键字应位于同一列，WHEN和ELSE关键字应缩进。 同一层的LOOP和END LOOP关键字应位于同一列，层内语句或嵌套应依次缩进。

自定义GaussDB(DWS)外部函数(pgSQL/Java)使用规则 【关注】Java UDF可以实现一些java逻辑计算，禁止在Java UDF中封装业务。 【关注】禁止在Java函数中使用任何方式连接数据库，包括但不限于JDBC。 【关注】只能选择下表中的数据类型，不支持自定义类型、复杂数据类型（Java Array类及派生类）等： 【关注】不支持UDAF（用户定义聚合函数）、UDTF（用户自定义表生成函数）。 表1 PL/Java默认数据类型映射关系 GaussDB(DWS) Java BOOLEAN boolean "char" byte bytea byte[] SMALLINT short INTEGER int BIGINT long FLOAT4 float FLOAT8 double CHAR java.lang.String VARCHAR java.lang.String TEXT java.lang.String name java.lang.String DATE java.sql.Timestamp TIME java.sql.Time (stored value treated as local time) TIMETZ java.sql.Time TIMESTAMP java.sql.Timestamp TIMESTAMPTZ java.sql.Timestamp 父主题： GaussDB(DWS)各对象设计详细规则

数据库通信相关参数 数据库集群默认使用TCP代理通信库进行节点间通信。 表2 数据库通信相关参数 GUC参数 描述 建议 comm_quota_size 参数comm_quota_size控制每个流通道每次数据传输的大小，默认数值1M。 大并发场景下，提升该数值时，可提升通信性能，但消耗更多的内存，需要根据实际场景进行调优。若通过查询DN的视图pg_total_memory_detail，发现通信层使用内存已达参数comm_usable_memory的阈值时，需要减少该数值，如修改为512K。 comm_usable_memory 参数comm_usable_memory用于控制数据库传输时，整个DN上可以用于通信的内存使用量。 该参数的取值并不是用于总量控制，仅作为内存流控的手段，即默认流控数值为1M，若内存使用量超过了该参数取值的1/2时，流控数值自动调整为默认流控的一半，若仅剩20%时，则流控数值改为最小流控值8K。

数据库连接相关参数 表3 数据库连接相关参数 GUC参数 描述 建议 max_connections 允许和数据库连接的最大并发连接数。此参数会影响集群的并发能力。 CN中此参数建议保持默认值。DN中此参数建议设置为CN的个数乘以CN中此参数的值。 增大这个参数可能导致GaussDB(DWS)要求更多的System V共享内存或者信号量，可能超过操作系统缺省配置的最大值。这种情况下，请酌情对数值加以调整。 max_prepared_transactions 设置可以同时处于“预备”状态的事务的最大数目。增加此参数的值会使GaussDB(DWS)比系统默认设置需要更多的System V共享内存。 max_connections取值的设置受max_prepared_transactions的影响，在设置max_connections之前，应确保max_prepared_transactions的值大于或等于max_connections的值，这样可确保每个会话都有一个等待中的预备事务。 session_timeout 客户端连接数据库后处于空闲状态时会根据该参数的默认值自动断开连接。 0-86400，最小单位为秒（s），0表示关闭超时设置。一般不建议设置为0。

数据库内存相关参数 表1 数据库内存相关参数 GUC参数 描述 建议 max_process_memory max_process_memory设置单个CN/DN可用的最大物理内存。 DN上该数值需要根据系统物理内存及单节点部署主DN个数决定的。计算公式如下：（物理内存大小 – vm.min_free_kbytes）* 0.8 / (n+主DN个数)。该参数目的是尽可能保证系统的可靠性，不会因数据库内存膨胀导致节点OOM。这个公式中提到vm.min_free_kbytes，其含义是预留操作系统内存供内核使用，通常用作操作系统内核中通信收发内存分配，至少为5%内存。即， max_process_memory=物理内存*0.8/(n+主DN个数)，其中，当集群规模小于256时， n=1；当集群规模大于256且小于512时， n=2；当集群规模超过512时，n=3。 CN上该数值内存可设置与DN数值一样。 RAM ：集群规划时分配给集群的最大使用内存。 shared_buffers 设置DWS使用的共享内存大小。增加此参数的值会使DWS比系统默认设置需要更多的System V共享内存。 建议设置shared_buffers值为内存的40%以内。行存列存分开对待。行存设大，列存设小。列存：(单服务器内存/单服务器DN个数)*0.4*0.25。 如果设置较大的shared_buffers需要同时增加checkpoint_segments的值，因为写入大量新增、修改数据需要消耗更多的时间周期。 cstore_buffers 设置列存和OBS、HDFS外表列存格式（orc、parquet、carbondata）所使用的共享缓冲区的大小。 列存表使用cstore_buffers设置的共享缓冲区，几乎不用shared_buffers。因此在列存表为主的场景中，应减少shared_buffers，增加cstore_buffers。 OBS、HDFS外表使用cstore_buffers设置ORC、Parquet、Carbondata的元数据和数据的缓存，元数据缓存大小为cstore_buffers的1/4，最大不超过2GB，其余缓存空间为列存数据和外表列存格式数据共享使用。 work_mem 设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。 该参数默认小规格内存为512MB， 大规格内存为2GB（max_process_memory大于等于30GB为大规格内存，否则为小规格内存）。 建议参数work_mem依据查询特点和并发来确定，一旦work_mem限定的物理内存不够，算子运算数据将写入临时表空间，带来5-10倍的性能下降，查询响应时间从秒级下降到分钟级。 对于串行无并发的复杂查询场景，平均每个查询有5-10关联操作，建议work_mem=50%内存/10。 对于串行无并发的简单查询场景，平均每个查询有2-5个关联操作，建议work_mem=50%内存/5。 对于并发场景，建议work_mem=串行下的work_mem/物理并发数。 maintenance_work_mem 设置维护性操作（比如VACUUM、CREATE INDEX、ALTER TABLE ADD FOREIGN KEY等）中可使用的最大的内存。 建议设置此参数的值等于work_mem，可以改进清理和恢复数据库转储的速度。因为在一个数据库会话里，任意时刻只有一个维护性操作可以执行，并且在执行维护性操作时不会有太多的会话。 当自动清理进程运行时，autovacuum_max_workers倍数的内存将会被分配，所以此时设置maintenance_work_mem的值应该不小于work_mem。

数据库并发队列相关参数 GUC参数 描述 建议 max_active_statements（全局并发队列） 控制单个CN上运行并发执行的作业数量。 采用全局并发队列机制将控制所有普通用户的执行作业，不区分复杂度，即执行语句都将作为一个执行单元，当并发执行的作业数量达到此参数阈值时，将进入队列等待。对于管理员执行的作业，不受全局并发控制的限制。 需根据系统资源（如CPU资源、IO资源和内存资源）情况，调整此数值大小，使得系统支持最大限度的并发作业，且防止并发执行作业过多，引起系统崩溃。 parctl_min_cost（局部并发队列） 控制在一个CN上同一资源池内的并发作业数量。 局部并发控制机制根据执行作业的cost，控制复杂查询的并发作业数量。

GLOBAL_ROW_TABLE_IO_STAT GLOBAL_ROW_TABLE_IO_STAT视图提供当前数据库所有行存表的IO统计数据。其字段的名称、类型和顺序与GS_ROW_TABLE_IO_STAT视图相同，具体的字段请参考表1。各统计字段为所有节点对应字段之和。 表1 GS_ROW_TABLE_IO_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 heap_read bigint 堆逻辑读块数。 heap_hit bigint 堆命中块数。 idx_read bigint 索引逻辑读块数。 idx_hit bigint 索引命中块数。 toast_read bigint TOAST表逻辑读块数。 toast_hit bigint TOAST表命中块数。 tidx_read bigint TOAST表Index逻辑读个数。 tidx_hit bigint TOAST表Index命中个数。 父主题： 系统视图

GLOBAL_COLUMN_TABLE_IO_STAT GLOBAL_COLUMN_TABLE_IO_STAT视图提供当前数据库所有列存表的IO统计数据。其字段的名称、类型和顺序与GS_COLUMN_TABLE_IO_STAT视图相同。各统计字段为所有节点对应字段之和。 表1 GLOBAL_COLUMN_TABLE_IO_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 heap_read bigint 堆逻辑读块数。 heap_hit bigint 堆命中块数。 idx_read bigint 索引逻辑读块数。 idx_hit bigint 索引命中块数。 cu_read bigint Compression Unit逻辑读个数。 cu_hit bigint Compression Unit命中个数。 cidx_read bigint Compression Unit Index逻辑读个数。 cidx_hit bigint Compression Unit Index命中个数。 父主题： 系统视图

GLOBAL_TABLE_CHANGE_STAT GLOBAL_TABLE_CHANGE_STAT视图显示当前数据库中所有表格（不包括外表）变更情况。表示次数的各字段为实例启动以来的累计值。 表1 GLOBAL_TABLE_CHANGE_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 last_vacuum timestamp with time zone 最后一次手动Vacuum的时间。 vacuum_count bigint 手动Vacuum的次数。为各CN节点上次数之和。 last_autovacuum timestamp with time zone 最后一次自动Vacuum的时间。 autovacuum_count bigint 自动Vacuum的次数。为各CN节点上次数之和。 last_analyze timestamp with time zone 最后一次分析（包括手动和自动）的时间。 analyze_count bigint 分析（包括手动和自动）的次数。由于analyze会同时在所有节点上进行，该字段为所有CN节点上的最大值。 last_autoanalyze timestamp with time zone 最后一次自动分析的时间。 autoanalyze_count bigint 自动分析的次数。为各CN节点上次数之和。 last_change bigint 最后一次修改（INSERT，UPDATE或DELETE）的时间。 父主题： 系统视图

GLOBAL_TABLE_STAT GLOBAL_TABLE_STAT视图显示当前数据库中所有表格（不包括外表）的统计信息。除live_tuples和dead_tuples为当前实时值外，其余各统计字段为实例启动以来的累计值。 表1 GLOBAL_TABLE_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 distribute_mode char 表的分布方式，与系统表pgxc_class中的pclocatortype字段含义相同。 seq_scan bigint 顺序扫描的次数。只统计行存表。如果是分区表，显示各个分区扫描次数的和。 seq_tuple_read bigint 顺序扫描的行数。只统计行存表。 index_scan bigint 索引扫描的次数。只统计行存表。 index_tuple_read bigint 索引扫描的行数。只统计行存表。 tuple_inserted bigint 插入的行数。如果是复制表，显示各节点最大值；如果是分布表，显示各节点之和。 tuple_updated bigint 更新的行数。如果是复制表，显示各节点最大值；如果是分布表，显示各节点之和。 tuple_deleted bigint 删除的行数。如果是复制表，显示各节点最大值；如果是分布表，显示各节点之和。 tuple_hot_updated bigint 热更新的行数。如果是复制表，显示各节点最大值；如果是分布表，显示各节点之和。 live_tuples bigint 活元组数量。显示各节点最大值；如果是分布表，显示各节点之和。 只适用行存表。 dead_tuples bigint 死元组数量。显示各节点最大值；如果是分布表，显示各节点之和。 只适用行存表。 父主题： 系统视图

PGXC_ROW_TABLE_IO_STAT PGXC_ROW_TABLE_IO_STAT视图提供集群所有CN和DN节点上当前数据库所有行存表的IO统计数据。除在每一行前面增加name类型的nodename字段外，其余字段的名称、类型和顺序与GS_ROW_TABLE_IO_STAT视图相同，具体的字段请参考表1。 表1 GS_ROW_TABLE_IO_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 heap_read bigint 堆逻辑读块数。 heap_hit bigint 堆命中块数。 idx_read bigint 索引逻辑读块数。 idx_hit bigint 索引命中块数。 toast_read bigint TOAST表逻辑读块数。 toast_hit bigint TOAST表命中块数。 tidx_read bigint TOAST表Index逻辑读个数。 tidx_hit bigint TOAST表Index命中个数。 父主题： 系统视图

PGXC_COLUMN_TABLE_IO_STAT PGXC_COLUMN_TABLE_IO_STAT视图提供集群所有CN和DN节点上当前数据库所有列存表的IO统计数据。除在每一行前面增加name类型的nodename字段外，其余字段的名称、类型和顺序与GS_COLUMN_TABLE_IO_STAT视图相同，具体的字段请参考表1。 表1 GS_COLUMN_TABLE_IO_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 heap_read bigint 堆逻辑读块数。 heap_hit bigint 堆命中块数。 idx_read bigint 索引逻辑读块数。 idx_hit bigint 索引命中块数。 cu_read bigint Compression Unit逻辑读个数。 cu_hit bigint Compression Unit命中个数。 cidx_read bigint Compression Unit Index逻辑读个数。 cidx_hit bigint Compression Unit Index命中个数。 父主题： 系统视图

PGXC_TABLE_CHANGE_STAT PGXC_TABLE_CHANGE_STAT视图提供集群所有CN节点上当前数据库所有表的变更情况。除在每一行前面增加name类型的nodename字段外，其余字段的名称、类型和顺序与GS_TABLE_CHANGE_STAT视图相同。 表1 PGXC_TABLE_CHANGE_STAT字段 名称 类型 描述 nodename name 节点名称。 schemaname name 表的命名空间。 relname name 表的名称。 last_vacuum timestamp with time zone 最后一次手动vacuum的时间。 vacuum_count bigint 手动Vacuum的次数。 last_autovacuum timestamp with time zone 最后一次自动vacuum的时间。 autovacuum_count bigint 自动vacuum的次数。 last_analyze timestamp with time zone 最后一次分析（包括手动和自动）的时间。 analyze_count bigint 分析（包括手动和自动）的次数。 last_autoanalyze timestamp with time zone 最后一次自动分析的时间。 autoanalyze_count bigint 自动分析的次数。 last_change bigint 最后一次修改（INSERT，UPDATE或DELETE）的时间。 父主题： 系统视图

REMOTE_TABLE_STAT REMOTE_TABLE_STAT视图提供集群所有DN节点上当前数据库所有表的统计信息。除在每一行前面增加name类型的nodename字段外，其余字段的名称、类型和顺序与GS_TABLE_STAT视图相同。 表1 REMOTE_TABLE_STAT字段 名称 类型 描述 nodename name 节点名称。 schemaname name 表的命名空间。 relname name 表的名称。 seq_scan bigint 顺序扫描的次数。只统计行存表。如果是分区表，显示各个分区扫描次数的和。 seq_tuple_read bigint 顺序扫描的行数。只统计行存表。 index_scan bigint 索引扫描的次数。只统计行存表。 index_tuple_read bigint 索引扫描的行数。只统计行存表。 tuple_inserted bigint 插入的行数。 tuple_updated bigint 更新的行数。 tuple_deleted bigint 删除的行数。 tuple_hot_updated bigint 热更新的行数。 live_tuples bigint 活元组数量。CN上查询该视图，analyze后显示该表格总的活元组数量，未analyze的情况下显示0。只适用行存表。 dead_tuples bigint 死元组数量。CN上查询该视图，analyze后显示该表格总的死元组数量，未analyze的情况下显示0。只适用行存表。 父主题： 系统视图

PGXC_TABLE_STAT PGXC_TABLE_STAT视图提供集群所有CN和DN节点上当前数据库所有表的统计信息。除在每一行前面增加name类型的nodename字段外，其余字段的名称、类型和顺序与GS_TABLE_STAT视图相同。 表1 PGXC_TABLE_STAT字段 名称 类型 描述 nodename name 节点名称。 schemaname name 表的命名空间。 relname name 表的名称。 seq_scan bigint 顺序扫描的次数。只统计行存表。如果是分区表，显示各个分区扫描次数的和。 seq_tuple_read bigint 顺序扫描的行数。只统计行存表。 index_scan bigint 索引扫描的次数。只统计行存表。 index_tuple_read bigint 索引扫描的行数。只统计行存表。 tuple_inserted bigint 插入的行数。 tuple_updated bigint 更新的行数。 tuple_deleted bigint 删除的行数。 tuple_hot_updated bigint 热更新的行数。 live_tuples bigint 活元组数量。CN上查询该视图，analyze后显示该表格总的活元组数量，未analyze的情况下显示0。只适用行存表。 dead_tuples bigint 死元组数量。CN上查询该视图，analyze后显示该表格总的死元组数量，未analyze的情况下显示0。只适用行存表。 父主题： 系统视图

GS_ROW_TABLE_IO_STAT GS_ROW_TABLE_IO_STAT视图显示当前数据库中所有行存表在当前节点上的IO情况。各统计字段为实例启动以来的累计值。 表1 GS_ROW_TABLE_IO_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 heap_read bigint 堆逻辑读块数。 heap_hit bigint 堆命中块数。 idx_read bigint 索引逻辑读块数。 idx_hit bigint 索引命中块数。 toast_read bigint TOAST表逻辑读块数。 toast_hit bigint TOAST表命中块数。 tidx_read bigint TOAST表Index逻辑读个数。 tidx_hit bigint TOAST表Index命中个数。 父主题： 系统视图