华为云用户手册

PG_SHARED_MEMORY_DETAIL PG_SHARED_MEMORY_DETAIL视图查询所有已产生的共享内存上下文的使用信息。 表1 PG_SHARED_MEMORY_DETAIL字段 名字 类型 描述 contextname text 内存上下文的名字。 level smallint 当前上下文在整体内存上下文中的层级。 parent text 上级内存上下文。 totalsize bigint 共享内存总大小，单位为Byte。 freesize bigint 共享内存剩余大小，单位为Byte。 usedsize bigint 共享内存使用大小，单位为Byte。 父主题： 系统视图

GS_TOTAL_NODEGROUP_MEMORY_DETAIL GS_TOTAL_NODEGROUP_MEMORY_DETAIL视图统计当前数据库逻辑集群使用内存的信息，单位为MB。 表1 GS_TOTAL_NODEGROUP_MEMORY_DETAIL字段 名称 类型 描述 ngname text 逻辑集群名称。 memorytype text 内存类型，包括以下几种： ng_total_memory：该逻辑集群的总内存大小。 ng_used_memory：该逻辑集群的实际使用内存大小。 ng_estimate_memory：该逻辑集群的估算使用内存大小。 ng_foreignrp_memsize：该逻辑集群的外部资源池的总内存大小。 ng_foreignrp_usedsize：该逻辑集群的外部资源池实际使用内存大小。 ng_foreignrp_peaksize：该逻辑集群的外部资源池使用内存的峰值。 ng_foreignrp_mempct：该逻辑集群的外部资源池占该逻辑集群总内存大小的百分比。 ng_foreignrp_estmsize：该逻辑集群的外部资源池估算使用内存大小。 memorymbytes integer 内存类型分配内存的大小。 父主题： 系统视图

GS_WLM_USER_RESOURCE_HISTORY GS_WLM_USER_RESOURCE_HISTORY系统表存储与用户使用资源相关的信息，该表在CN和DN上均存有数据。该系统表的每条记录都是对应时间点某用户的资源使用情况，包括：内存、CPU核数、存储空间、临时空间、算子落盘空间、逻辑IO流量、逻辑IO次数和逻辑IO速率信息。其中，内存、CPU、IO相关监控项仅记录用户复杂作业的资源使用情况。 GS_WLM_USER_RESOURCE_HISTORY系统表的数据来源于PG_TOTAL_USER_RESOURCE_INFO视图。 表1 GS_WLM_USER_RESOURCE_HISTORY字段 名称 类型 描述 username text 用户名。 timestamp timestamp with time zone 时间戳。 used_memory int 用户使用的内存大小，单位为MB。 DN：显示当前DN上用户使用的内存大小。 CN：显示所有DN上用户使用内存的累积和。 total_memory int 资源池使用的内存大小，单位为MB。值为0表示未限制最大可用内存，其限制取决于数据库最大可用内存max_dynamic_memory。具体的计算公式为： total_memory = max_dynamic_memory * parent_percent * user_percent CN：显示所有DN上用户可用内存上限的累积和。 used_cpu real 正在使用的CPU核数。 total_cpu int 该机器节点上，用户关联控制组的CPU核数总和。 used_space bigint 已使用的存储空间大小，单位为KB。 total_space bigint 可使用的存储空间大小，单位为KB。值为-1表示未限制最大存储空间。 used_temp_space bigint 已使用的临时存储空间大小，单位为KB。 total_temp_space bigint 可使用的临时存储空间大小，单位为KB。值为-1表示未限制最大临时存储空间。 used_spill_space bigint 已使用的算子落盘存储空间大小，单位为KB。 total_spill_space bigint 可使用的算子落盘存储空间大小，单位为KB。值为-1表示未限制最大算子落盘存储空间。 read_kbytes bigint 监控周期内，读操作的字节流量，单位为KB。 write_kbytes bigint 监控周期内，写操作的字节流量，单位为KB。 read_counts bigint 监控周期内，读操作的次数。 write_counts bigint 监控周期内，写操作的次数。 read_speed real 监控周期内，读操作的字节速率，单位为KB/s。 write_speed real 监控周期内，写操作的字节速率，单位为KB/s。 send_speed double 监控周期内，网络发送速率，单位为KB/s。 recv_speed double 监控周期内，网络接收速率，单位为KB/s。 父主题： 系统表

transaction_sync_timeout 参数说明：为保证数据一致性，当本地事务与GTM上snapshot中状态不一样时会阻塞其他事务的运行，需要等待本地节点上事务状态与GTM状态一致后再运行。当CN上等待时长超过transaction_sync_timeout时会报错，回滚事务，避免由于sync lock等其他情况长时间进程停止响应造成对系统的阻塞。 参数类型：USERSET 取值范围：整型，最小值为0，单位为秒。 默认值：10min

transaction_sync_naptime 参数说明：为保证数据一致性，当本地事务与GTM上snapshot中状态不一样时会阻塞其他事务的运行，需要等待本地节点上事务状态与GTM状态一致后再运行。当CN上等待时长超过transaction_sync_naptime时会主动触发gs_clean进行清理，缩短不一致时的阻塞时长。 参数类型：USERSET 取值范围：整型，最小值为0，单位为秒。 默认值：5s 若该值设为0，则不会在阻塞达到时长时主动调用gs_clean进行清理，而是靠gs_clean_timeout间隔来调用gs_clean，默认是5分钟。

PG_AUTH_MEMBERS PG_AUTH_MEMBERS系统表存储显示角色之间的成员关系。 表1 PG_AUTH_MEMBERS字段 名称 类型 描述 roleid oid 拥有成员的角色ID。 member oid 属于ROLEID角色的成员角色ID。 grantor oid 赋予此成员关系的角色ID。 admin_option boolean 如果有权限可以把ROLEID角色的成员关系赋予其他角色，则为真。 父主题： 系统表

USER_CONS_COLUMNS USER_CONS_COLUMNS视图存储当前用户下表中约束列的信息。 名称 类型 描述 table_name character varying(64) 约束相关的表名。 column_name character varying(64) 约束相关的列名。 constraint_name character varying(64) 约束名。 position smallint 表中列的位置。 父主题： 系统视图

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 该节点关机前的最后一个事务号。 父主题： 系统视图

DBA_CONSTRAINTS DBA_CONSTRAINTS视图存储关于数据库表中约束的信息。需要有系统管理员权限才可以访问。 名称 类型 描述 constraint_name vcharacter varying(64) 约束名。 constraint_type text 约束类型。 c表示检查约束。 f表示外键约束。 p表示主键约束。 u表示唯一约束。 table_name character varying(64) 约束相关的表名。 index_owner character varying(64) 约束相关的索引的所有者（只针对唯一约束和主键约束）。 index_name character varying(64) 约束相关的索引名（只针对唯一约束和主键约束）。 父主题： 系统视图

ALL_CONS_COLUMNS ALL_CONS_COLUMNS视图存储当前用户可访问的约束字段的信息。 表1 ALL_CONS_COLUMNS字段 名称 类型 描述 table_name character varying(64) 约束相关的表名。 column_name character varying(64) 约束相关的列名。 constraint_name character varying(64) 约束名。 position smallint 表中列的位置。 父主题： 系统视图

USER_SYNONYMS USER_SYNONYMS视图存储当前用户可访问的同义词信息。 表1 USER_SYNONYMS字段 名称 类型 描述 schema_name text 同义词所属模式名。 synonym_name text 同义词的名称。 table_owner text 关联对象的所有者。 table_schema_name text 关联对象所属模式名。 table_name text 关联对象名。 父主题： 系统视图

PGXC_WLM_WORKLOAD_RECORDS PGXC_WLM_WORKLOAD_RECORDS视图显示当前用户在每个CN上执行作业时在CN上的状态信息。需要有系统管理员权限或预置角色gs_role_read_all_stats权限才可以访问此视图。该视图仅在动态负载功能开启，即enable_dynamic_workload为on时有效。 表1 PGXC_WLM_WORKLOAD_RECORDS字段 名称 类型 描述 node_name text 作业执行所在的CN的名称。 thread_id bigint 后端线程ID。 processid integer 线程的lwpid。 timestamp bigint 语句执行的开始时间。 username name 登录到该后端的用户名。 memory integer 语句所需的内存大小。 active_points integer 语句在资源池上消耗的资源点数。 max_points integer 资源在资源池上的最大资源数。 priority integer 作业的优先级。 resource_pool text 作业所在资源池。 status text 作业执行的状态，包括： pending： 阻塞状态。 running：执行状态。 finished：结束状态。 aborted：终止状态。 unkown：未知状态。 control_group text 作业所使用的Cgroups enqueue text 作业的排队信息，包括： GLOBAL：全局排队。 RESPOOL：资源池排队。 ACTIVE：不排队。 query text 正在执行的语句。 父主题： 系统视图

DBA_SYNONYMS DBA_SYNONYMS视图存储关于数据库下的所有同义词信息。需要有系统管理员权限才可以访问。 表1 DBA_SYNONYMS字段 名称 类型 描述 owner text 同义词的所有者。 schema_name text 同义词所属模式名。 synonym_name text 同义词的名称。 table_owner text 关联对象的所有者。 table_schema_name text 关联对象所属模式名。 table_name text 关联对象名。 父主题： 系统视图

PG_ENUM PG_ENUM系统表包含显示每个枚举类型值和标签的记录。给定枚举类型的内部表示实际上是PG_ENUM里面相关行的OID。 表1 PG_ENUM字段 名称 类型 引用 描述 oid oid - 行标识符（隐藏属性，必须明确选择才会显示）。 enumtypid oid PG_TYPE.oid 包含此枚举值的pg_type项的OID。 enumsortorder real - 此枚举值在其枚举类型中的排序位置。 enumlabel name - 此枚举值的文本标签。 PG_ENUM行的OID值遵循一种特殊规则：OID的数值被保证按照其枚举类型一样的排序顺序排序。即如果两个偶数OID属于同一枚举类型，那么较小的OID必然具有较小enumsortorder值。奇数OID不需要遵循排序顺序。这种规则使得枚举比较例程在很多常见情况下可以避免系统目录查找。创建和修改枚举类型的例程尝试尽可能地为枚举值分配偶数OID。 当一个枚举类型被创建后，其成员会被分配排序顺序位置1到n。但是后面增加的成员可能会分配负值或者分数值的enumsortorder。对于这些值的唯一要求是它们必须被正确的排序且在每个枚举类型中保持唯一。 父主题： 系统表

PG_TS_PARSER PG_TS_PARSER系统表包含定义文本解析器的项。解析器负责分割输入文本为词位，并且为每个词位分配标记类型。因为解析器必须通过C语言级别的函数实现，所以新解析器必须由数据库系统管理员创建。 表1 PG_TS_PARSER字段 名字 类型 引用 描述 oid oid - 行标识符（隐藏属性，必须明确选择才会显示）。 prsname name - 文本搜索解析器名称。 prsnamespace oid PG_NAMESPACE.oid 解析器所在的命名空间的OID。 prsstart regproc PG_PROC.oid 解析器的启动函数的OID。 prstoken regproc PG_PROC.oid 解析器的下一个标记函数的OID。 prsend regproc PG_PROC.oid 解析器的关闭函数的OID。 prsheadline regproc PG_PROC.oid 解析器的标题函数的OID。 prslextype regproc PG_PROC.oid 解析器的lextype函数的OID。 父主题： 系统表

PG_QUERYBAND_ACTION PG_QUERYBAND_ACTION视图显示query_band关联行为和次序。 表1 PG_QUERYBAND_ACTION字段 名称 类型 描述 qband text query_band键值对。 respool_id oid query_band关联资源池OID。 respool text query_band关联资源池名。 priority text query_band关联队列内优先级。 qborder integer query_band搜索次序。 父主题： 系统视图

PG_TOTAL_MEMORY_DETAIL PG_TOTAL_MEMORY_DETAIL视图显示某个数据库节点内存使用情况。 表1 PG_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：通信库的内存峰值。 max_topsql_memory：TopSQL记录历史作业监控信息允许使用的最大内存。 topsql_used_memory：TopSQL记录历史作业监控信息已使用的内存大小。 topsql_peak_memory：TopSQL记录历史作业监控信息的内存峰值。 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。 父主题： 系统视图

GS_STAT_DB_CU GS_STAT_DB_CU视图查询集群各个节点，每个数据库的CU命中情况。可以通过gs_stat_reset()进行清零。 表1 GS_STAT_DB_CU字段 名称 类型 描述 node_name1 text 节点名称。 db_name text 数据库名称。 mem_hit bigint 内存命中次数。 hdd_sync_read bigint 硬盘同步读次数。 hdd_asyn_read bigint 硬盘异步读次数。 父主题： 系统视图

PG_STAT_ALL_INDEXES PG_STAT_ALL_INDEXES视图显示当前数据库中所有访问特定索引的统计信息。 索引可以通过简单的索引扫描或“位图”索引扫描进行使用。位图扫描中几个索引的输出可以通过AND或者OR规则进行组合， 因此当使用位图扫描的时候，很难将独立堆行抓取与特定索引进行组合， 因此，一个位图扫描增加pg_stat_all_indexes.idx_tup_read使用索引计数，并且增加pg_stat_all_tables.idx_tup_fetch表计数，但不影响pg_stat_all_indexes.idx_tup_fetch。 表1 PG_STAT_ALL_INDEXES字段 名称 类型 描述 relid oid 索引的表的OID。 indexrelid oid 索引的OID。 schemaname name 索引中模式名。 relname name 索引的表名。 indexrelname name 索引名。 idx_scan bigint 索引上开始的索引扫描数。 idx_tup_read bigint 通过索引上扫描返回的索引项数。 idx_tup_fetch bigint 通过使用索引的简单索引扫描抓取的活表行数。 父主题： 系统视图

password_encryption_type 参数说明：该字段决定采用何种加密方式对用户密码进行加密存储。 参数类型：SIGHUP 取值范围：整型，0、1、2 表1 取值说明 取值 密码存储格式 支持使用驱动 0 采用MD5方式对密码加密，密码存储方式为MD5加密后密文。 支持GaussDB自研驱动及开源驱动。 1 采用SHA256方式对密码加密，兼容postgres客户端的MD5用户认证方式。 密码存储方式为MD5+SHA256综合后的密文。 支持GaussDB自研驱动及开源驱动。 2 采用SHA256方式对密码加密，密码存储方式为SHA256加密后密文。 支持GaussDB自研驱动。 MD5为不安全的加密算法，不建议用户使用。 在password_encryption_type参数值为2时创建的用户，密码已使用SHA256算法保存，此时切换参数值并不会改变数据库内的密码存储方式，因此，这种情况下若使用MD5的开源客户端可能仍无法连接。 password_encryption_type参数值为1时，pg_hba认证方式设置为MD5或者SHA256都会进行两种加密方式的判断，确保功能兼容。 默认值：1

failed_login_attempts 参数说明：在任意时候，如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定，password_lock_time秒后被自动解锁。 例如，登录时输入密码失败，ALTER USER时修改密码失败等。 参数类型：SIGHUP 取值范围：整型，0~1000 0表示自动锁定功能不生效。 正整数表示当错误密码次数达到failed_login_attempts设定的值时，当前账户将被锁定。 默认值：10 failed_login_attempts和password_lock_time必须都为正数时锁定和解锁功能才能生效。 failed_login_attempts会与客户端SSL连接模式共同决定用户的密码错误次数。当PGSSLMODE取值是allow或prefer时，客户的一次密码连接请求会生成两次连接请求：一次是尝试SSL连接，另一次是尝试非SSL连接。此时，用户感知到的密码错误次数是failed_login_attempts除以2。

password_lock_time 参数说明：该参数指定账户被锁定后自动解锁的时间。 参数类型：SIGHUP password_lock_time和failed_login_attempts必须都为正数时锁定和解锁功能才能生效。 参数password_lock_time的整数部分表示天数，小数部分可以换算成时、分、秒。 取值范围：浮点型，0~365，单位为天。 0表示密码验证失败时，自动锁定功能不生效。 正数表示账户被锁定后，当锁定时间超过password_lock_time设定的值时，账户将会被自行解锁。 默认值：1

session_timeout 参数说明：表明与服务器建立连接后，不进行任何操作的最长时间。 参数类型：USERSET 取值范围：整型，0-86400，最小单位为秒（s），0表示关闭超时设置。 默认值：10min GaussDB(DWS) gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。 pooler连接池到其它CN和DN的连接，不受session_timeout参数控制。

ssl_ciphers 参数说明：指定SSL支持的加密算法列表。 参数类型：POSTMASTER 取值范围：字符串，如果指定多个加密算法，加密算法之间需要以分号分割。 默认值：ALL 配置参数ssl_ciphers的默认值为ALL，表示支持下列所有加密算法。如果对加密算法没有特殊要求，建议用户使用该默认值。 TLS1_3_RFC_AES_128_GCM_SHA256 TLS1_3_RFC_AES_256_GCM_SHA384 TLS1_3_RFC_CHACHA20_POLY1305_SHA256 TLS1_3_RFC_AES_128_CCM_SHA256 TLS1_3_RFC_AES_128_CCM_8_SHA256 SSL连接认证目前只支持配置标准协议TLS1.3的加密算法，TLS1.3的性能更优、安全性更好。同时也兼容与标准协议TLS1.2的客户端之间的SSL连接认证。

password_reuse_time 参数说明：在使用ALTER USER或者ALTER ROLE修改用户密码时，该参数指定是否对新密码进行可重用天数检查。 参数类型：SIGHUP 修改密码时会检查配置参数password_reuse_time和password_reuse_max。 当password_reuse_time和password_reuse_max都为正数时，只要满足其中任一个，即可认为密码可以重用。 当password_reuse_time为0时，表示不限制密码重用天数，仅限制密码重用次数。 当password_reuse_max为0时，表示不限制密码重用次数，仅限制密码重用天数。 当password_reuse_time和password_reuse_max都为0时，表示不对密码重用进行限制。 取值范围：浮点型，0~3650，单位为天。 0表示不检查密码可重用天数。 正数表示新密码不能为该值指定的天数内使用过的密码。 默认值：60

ssl_renegotiation_limit 参数说明：指定在会话密钥重新协商之前，通过SSL加密通道可以传输的流量。这个重新协商流量限制机制可以减少攻击者针对大量数据使用密码分析法破解密钥的几率，但是也带来较大的性能损失。流量是指发送和接收的流量总和。 参数类型：USERSET 参数建议保持默认设置，即禁用重协商机制。不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置ssl_renegotiation_limit参数，即使设置也不会生效。 取值范围：整型，0~INT_MAX，单位为KB。其中0表示禁用重新协商机制。 默认值：0

password_reuse_max 参数说明：在使用ALTER USER或者ALTER ROLE修改用户密码时，该参数指定是否对新密码进行可重用次数检查。 参数类型：SIGHUP 修改密码时会检查配置参数password_reuse_time和password_reuse_max。 当password_reuse_time和password_reuse_max都为正数时，只要满足其中任一个，即可认为密码可以重用。 当password_reuse_time为0时，表示不限制密码重用天数，仅限制密码重用次数。 当password_reuse_max为0时，表示不限制密码重用次数，仅限制密码重用天数。 当password_reuse_time和password_reuse_max都为0时，表示不对密码重用进行限制。 取值范围：整型，0~1000 0表示不检查密码可重用次数。 正整数表示新密码不能为该值指定的次数内使用过的密码。 默认值：0

expand_hashtable_ratio 参数说明：控制Hash Agg和Hash Join算子执行过程中hash表的大小扩大比例。 参数类型：USERSET 取值范围：浮点型，0, 0.5~10 默认值设置为0时表示hash表大小会根据当前内存进行自适应扩展。 默认值设置为0.5~10之间时，显式的是指定hash表扩大的倍数，通常hash表越大性能越好，但会占用更多内存空间，在内存不足场景可能造成数据提前下盘，带来性能劣化。 默认值：0

stream_ctescan_max_estimate_mem 参数说明：当enable_stream_ctescan开启时，控制CTE的最大估算内存值。该参数需与stream_ctescan_refcount_threshold共同使用。当CTE的估算内存大于stream_ctescan_max_estimate_mem且引用次数小于stream_ctescan_refcount_threshold时，将使用inline方式执行；反之，则使用sharescan方式执行。该参数仅8.2.1及以上集群版本支持。 参数类型：SUSET 取值范围：整型，32 * 1024(32MB)~INT_MAX，单位KB 默认值：256MB

stream_ctescan_refcount_threshold 参数说明：当enable_stream_ctescan开启时，控制CTE的最大引用次数。该参数需与stream_ctescan_max_estimate_mem共同使用。当CTE的估算内存大于stream_ctescan_max_estimate_mem且引用次数小于stream_ctescan_refcount_threshold时，将使用inline方式执行；反之，则使用share scan方式执行。该参数仅8.2.1及以上集群版本支持。 参数类型：SUSET 取值范围：整型，0~INT_MAX 默认值：4 该参数仅在取值大于0时生效，取值为0时仅依赖stream_ctescan_max_estimate_mem控制inline行为。