华为云用户手册

work_mem 参数说明：设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。ORDER BY，DISTINCT和merge joins都要用到排序操作。Hash表在散列连接、散列为基础的聚集、散列为基础的IN子查询处理中都要用到。 对于复杂的查询，可能会同时并发运行好几个排序或者散列操作，每个都可以使用此参数所声明的内存量，不足时会使用临时文件。同样，好几个正在运行的会话可能会同时进行排序操作。因此使用的总内存可能是work_mem的好几倍。 参数类型：USERSET 取值范围：整型，64~INT_MAX，单位为KB。 默认值：小规格内存为512MB， 大规格内存为2GB（max_process_memory大于等于30GB为大规格内存，否则为小规格内存）。 设置建议： 依据查询特点和并发来确定，一旦work_mem限定的物理内存不够，算子运算数据将写入临时表空间，带来5-10倍的性能下降，查询响应时间从秒级下降到分钟级。 对于串行无并发的复杂查询场景，平均每个查询有5-10关联操作，建议work_mem=50%内存/10。 对于串行无并发的简单查询场景，平均每个查询有2-5个关联操作，建议work_mem=50%内存/5。 对于并发场景，建议work_mem=串行下的work_mem/物理并发数。

query_max_mem 参数说明：设置执行作业所能够使用的最大内存。如果设置的query_max_mem值大于0，在生成执行计划时，优化器会根据该值来设置算子的可用内存。当作业执行时所使用内存超过该值时，将报错退出。 参数类型：USERSET 取值范围：整型，0，或大于32MB的整型，单位为KB。如果设置值为小于32MB，系统会自动将该参数设置为默认值0，此时优化器不会根据该值限制作业的内存使用。 默认值：0

max_process_memory 参数说明：设置一个数据库节点可用的最大物理内存。 参数类型：SIGHUP 取值范围：整型，2*1024*1024～INT_MAX/2，单位为KB。 默认值：非从备DN节点自动适配，一个机器部署多个DN情况下，公式为（物理内存大小）* 0.8 / (1+主DN个数)；一个机器部署单个DN情况下，公式为（物理内存大小）* 0.6；当结果不足2GB时，默认取2GB。从备DN默认为12GB。 设置建议： DN上该数值需要根据系统物理内存及单节点部署主DN个数决定的。一个机器部署多个DN情况下，max_process_memory计算公式如下：（物理内存大小 – vm.min_free_kbytes）* 0.8 / (n+主DN个数)；一个机器部署单个DN情况下，max_process_memory计算公式如下：（物理内存大小 – vm.min_free_kbytes）* 0.6。该参数目的是尽可能保证系统的可靠性，不会因数据库内存膨胀导致节点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：集群规划时分配给集群的最大使用内存。 GaussDB(DWS)从8.2.0版本开始，为了提升内存资源利用率，增大了单机器单DN部署形态的max_process_memory初始值，但当出现集群状态不均衡的情况下，两个主DN节点会同时在一个机器上，如果仍然使用max_process_memory初始值，机器可能出现OOM报错的情况。为此，8.2.0版本开始，max_process_memory参数更改为SIGHUP类型，可以通过手动设置的方式来动态调整；同时，新增max_process_memory_auto_adjust参数，当出现集群状态不均衡的情况下，CM会根据集群状态来动态调整max_process_memory，调整max_process_memory的计算公式为：（物理内存大小 – vm.min_free_kbytes）* 0.8 / 主DN个数。 GaussDB(DWS)从8.2.1版本开始，扩大了max_process_memory动态内存调整的适用范围，由原先仅支持一个机器部署单个DN的集群形态，变更为支持所有部署形态。 max_process_memory_auto_adjust为on时，max_process_memory将会在上限和下限两值之间动态调整；其中，max_process_memory下限值的计算公示为：（物理内存大小）* 0.8 / (1+主DN个数)；max_process_memory上限值由GUC参数max_process_memory_balanced设置（max_process_memory_balanced参数设置请联系技术支持工程师）。 集群在均衡模式下，max_process_memory将使用上限值，提高节点整体的内存资源利用率，相对之前版本，内存利用率会提升。 集群在非均衡模式下，max_process_memory将使用下限值，节点整体的内存资源利用率和8.2.1集群之前的版本一致。 升级场景下，该参数为保持前向兼容，系统不会设置max_process_memory_balanced，max_process_memory默认使用升级前设置的值。

shared_buffers 参数说明：设置GaussDB(DWS)使用的共享内存大小。增加此参数的值会使GaussDB(DWS)比系统默认设置需要更多的System V共享内存。 参数类型：POSTMASTER 取值范围：整型，128～INT_MAX，单位为8KB。 改变BLCKSZ的值会改变最小值。 默认值：CN节点为DN节点值的1/2，DN节点取公式计算：POWER(2,ROUND(LOG(2,max_process_memory/18),0))。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 设置建议： 由于GaussDB(DWS)大部分查询下推，建议DN中此参数设置比CN大。 建议设置shared_buffers值为内存的40%以内。行存列存分开对待。行存设大，列存设小。列存：(单服务器内存/单服务器DN个数)*0.4*0.25。 如果设置较大的shared_buffers需要同时增加checkpoint_segments的值，因为写入大量新增、修改数据需要消耗更多的时间周期。

temp_buffers 参数说明：设置每个数据库会话使用的LOCAL临时缓冲区的大小。 参数类型：USERSET 取值范围：整型，800~INT_MAX/2，单位为8KB。 默认值：8MB 在每个会话的第一次使用临时表之前可以改变temp_buffers的值，之后的设置将是无效的。 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。

maintenance_work_mem 参数说明：设置在维护性操作（比如VACUUM、CREATE INDEX、ALTER TABLE ADD FOREIGN KEY等）中可使用的最大的内存。该参数的设置会影响VACUUM、VACUUM FULL、CLUSTER、CREATE INDEX的执行效率。 参数类型：USERSET 取值范围：整型，1024~INT_MAX，单位为KB。 默认值：小规格内存为512MB， 大规格内存为2GB（max_process_memory大于等于30GB为大规格内存，否则为小规格内存）。 设置建议： 建议设置此参数的值等于work_mem，可以改进清理和恢复数据库转储的速度。因为在一个数据库会话里，任意时刻只有一个维护性操作可以执行，并且在执行维护性操作时不会有太多的会话。 当自动清理进程运行时，autovacuum_max_workers倍数的内存将会被分配，所以此时设置maintenance_work_mem的值应该不小于work_mem。 如果进行大数据量的cluster等，可以在session中调大该值。

cstore_buffers 参数说明：设置列存和OBS、HDFS外表列存格式（orc、parquet、carbondata）所使用的共享缓冲区的大小。 参数类型：POSTMASTER 取值范围：整型，16384～INT_MAX，单位为KB。 默认值：CN为32MB，DN取公式计算：POWER(2,ROUND(LOG(2,max_process_memory/18),0)) 设置建议： 列存表使用cstore_buffers设置的共享缓冲区，几乎不用shared_buffers。因此在列存表为主的场景中，应减少shared_buffers，增加cstore_buffers。 OBS、HDFS外表使用cstore_buffers设置ORC、Parquet、Carbondata的元数据和数据的缓存，元数据缓存大小为cstore_buffers的1/4，最大不超过2GB，其余缓存空间为列存数据和外表列存格式数据共享使用。

max_process_memory_auto_adjust 参数说明：设置是否开启max_process_memory参数的自动调整功能（该参数仅8.2.0及以上集群版本支持）。对于单机器单DN部署形态的集群，开启情况下，CM会在主备切换情况下，动态调整对应DN节点上的max_process_memory参数值。 参数类型：SIGHUP 取值范围：布尔型 默认值：on 设置建议：建议设置为on，对于单机器单DN部署形态的集群，为提高内存资源利用率，max_process_memory参数的初始值在8.2.0集群版本开始进行了提升，但在主备切换场景下，两个主DN节点会同时在一个机器上，如果仍然使用max_process_memory初始值，机器可能出现OOM报错的情况，因此，需要CM介入来动态调整max_process_memory。

max_prepared_transactions 参数说明：设置可以同时处于"预备"状态的事务的最大数目。增加此参数的值会使GaussDB(DWS)比系统默认设置需要更多的System V共享内存。 当GaussDB(DWS)部署为主备双机时，在备机上此参数的设置必须要高于或等于主机上的，否则无法在备机上进行查询操作。 参数类型：POSTMASTER 取值范围：整型，0~536870911，其中CN取值为0表示关闭预备事务的特性。 默认值：CN节点为800， DN节点为800 为避免在准备步骤失败，此参数的值不能小于max_connections。

agg_max_mem 参数说明：设置执行作业中的Agg算子的聚集列超过5列时，该Agg算子所能够使用的最大内存。当agg_max_mem大于0时生效。（该参数仅8.1.3.200及以上集群版本支持） 参数类型：USERSET 取值范围：整型，0，或大于32MB的整型，单位为KB。如果设置值小于32MB，系统会自动将该参数设置为默认值0，此时不会根据该值限制Agg算子的内存使用。 默认值： 若当前集群为低版本升级到8.1.3及以上版本，继承升级前参数，默认值为INT_MAX。 若当前集群为新装的8.1.3及以上版本，默认值为2GB。

psort_work_mem 参数说明：设置列存表在进行局部排序中在开始写入临时磁盘文件之前使用的内存大小。带partial cluster key的表、带索引的表插入，创建表索引，删除表和更新表都会用到。 参数类型：USERSET 多个正在运行的会话可能会同时进行表的局部排序操作，因此使用的总内存可能是psort_work_mem的好几倍。 取值范围：整型，64~INT_MAX，单位为KB。 默认值：512MB

max_stack_depth 参数说明：设置GaussDB(DWS)执行堆栈的最大安全深度。需要这个安全界限是因为在服务器里，并非所有程序都检查了堆栈深度，只是在可能递规的过程，比如表达式计算这样的过程里面才进行检查。 参数类型：SUSET 设置原则： 此参数的最佳设置是等于操作系统内核允许的最大值（就是ulimit -s的设置）。 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。在GaussDB(DWS)能够检测内核限制的操作系统上（SLES上），将自动限制设置为一个不安全的值。 因为并非所有的操作都能够检测，所以建议用户在此设置一个明确的值。 取值范围：整型，100~INT_MAX，单位为KB。 默认值：2MB 默认值2MB，这个值相对比较小，不容易导致系统崩溃。但是可能会因为该值较小，导致无法执行复杂的函数。

enable_memory_limit 参数说明：启用逻辑内存管理模块。 参数类型：POSTMASTER 取值范围：布尔型 on表示启用逻辑内存管理模块。 off表示不启用逻辑内存管理模块。 默认值：on 若max_process_memory-max_shared_memory-cstore buffers少于2G，GaussDB(DWS)强制把enable_memory_limit设置为off。 max_shared_memory参数与shared_buffer、max_connections以及max_prepared_transactions参数强相关，如果max_shared_memory过大，可以通过调整这三个参数减小。 动态负载管理功能依赖内存管理功能，当关闭参数enable_memory_limit后，动态负载管理和TopSQL功能会失效。

PGXC_COMM_RECV_STREAM PGXC_COMM_RECV_STREAM视图展示所有DN上的通信库接收流状态。 表1 PGXC_COMM_RECV_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：表示将会关闭逻辑连接。 WRITING：表示正在写入数据。 query_id bigint 通信流对应的debug_query_id编号。 pn_id integer 通信流所执行查询的plan_node_id编号。 send_smp integer 通信流所执行查询send端的smpid编号。 recv_smp integer 通信流所执行查询recv端的smpid编号。 recv_bytes bigint 通信流接收的数据总量，单位为Byte。 time bigint 通信流当前生命周期使用时长，单位为毫秒。 speed bigint 通信流的平均接收速率，单位为Byte/s。 quota bigint 通信流当前的通信配额值，单位为Byte。 buff_usize bigint 通信流当前缓存的数据大小，单位为Byte。 父主题： 系统视图

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

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 集群中所有节点的日志目录。 父主题： 系统视图

PG_REPLICATION_SLOTS PG_REPLICATION_SLOTS视图查看复制节点的信息。 表1 PG_REPLICATION_SLOTS字段 名称 类型 描述 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 复制节点是否为假备。 父主题： 系统视图

GS_REL_IOSTAT GS_REL_IOSTAT视图提供当前节点上磁盘读写的统计信息。当前版本中，每次读/写磁盘只读/写一页，所以读写次数与页数相等。 表1 GS_REL_IOSTAT字段 名称 类型 描述 phyrds bigint 读磁盘次数。 phywrts bigint 写磁盘次数。 phyblkrd bigint 读磁盘页数。 phyblkwrt bigint 写磁盘页数。 父主题： 系统视图

max_stream_pool 参数说明：设置stream线程池能够容纳stream线程的最大个数。 参数类型：SUSET 取值范围：整型，-1~INT_MAX，-1和0表示关闭stream线程池。 默认值： 新安装集群默认值计算公式为：max_stream_pool=MIN(max_connections, max_process_memory/16/5MB, 1024) 旧集群升级到8.3.100及以上新集群版本的默认值计算公式为：max_stream_pool=MIN(max_connections max_process_memory/16/5MB, 1024，旧集群值)，升级时也强制应用新装集群的设置值，但旧值小时取旧值。 支持实时减少线程池中stream线程的个数；若增大该参数值，stream线程的个数由业务驱动向上增长。 通常情况下不建议调整该参数值，因为stream线程池有自动清理功能。 如果stream空闲线程过多造成内存占用，可以调小此值以节约内存。

comm_cn_dn_logic_conn 参数说明：CN和DN间逻辑连接特性开关，重启集群生效。 参数类型：POSTMASTER 取值范围：布尔型 on/true表示CN和DN之间连接为逻辑连接，使用libcomm组件。 off/false表示CN和DN之间连接为物理连接，使用libpq组件。 如果CN设置comm_cn_dn_logic_conn为off，DN设置comm_cn_dn_logic_conn为on会导致集群不能正常通信，因此必须对该参数做CN和DN全局相同的配置，重启集群生效。 默认值：off

client_connection_check_interval 参数说明：客户端连接状态检测时间间隔。该参数仅8.2.0及以上集群版本支持。 参数类型：USERSET 取值范围：整型，0 ~ INT_MAX，单位为毫秒。0表示不检测客户端连接状态。 默认值：10000 通过gsql/jdbc/odbc等客户端直连CN执行长查询，在长查询执行期间： CN每隔client_connection_check_interval时间检测一次客户端连接状态，若检测到客户端与CN的连接已经断开，则服务端主动终止长查询的执行，释放相关资源，避免集群资源浪费。 DN每隔client_connection_check_interval时间检测一次CN与DN的连接状态，若检测到CN与DN的连接已经断开，则DN主动终止长查询的执行，释放相关资源，避免集群资源浪费。

comm_client_bind 参数说明：通信库客户端发起连接时是否使用bind绑定指定IP。 参数类型：USERSET 取值范围：布尔型 on表示绑定指定IP。 off表示不绑定指定IP。 如果集群某一节点存在多个IP处于同一通信网段时，需设置为on。此时将绑定本地listen_addresses指定的IP发起通信，随机端口号不能重复使用，集群并发数量会受到可用随机端口号数量的限制。 默认值：off

enable_stateless_pooler_reuse 参数说明：pooler复用切换开关，重启集群生效。 参数类型：POSTMASTER 取值范围：布尔型 on/true表示使用pooler复用模式。 off/false表示关闭pooler复用模式。 CN和DN需要同步设置。如果CN设置enable_stateless_pooler_reuse为off，DN设置enable_stateless_pooler_reuse为on会导致集群不能正常通信，因此必须对该参数做CN和DN全局相同的配置，重启集群生效。 默认值：off

enable_connect_standby 参数说明：设置CN连接DN备机。该参数仅8.3.0及以上集群版本支持。 参数类型：USERSET 取值范围：布尔型 on表示CN连接备机。 off表示CN连接DN主机。 默认值：off 不建议在日常业务中使用此参数，仅适用于运维操作，更不建议使用gs_guc工具进行全局设置。否则可能会导致数据不一致，结果集错误等问题。 已创建临时表的session打开此参数后将造成DN上的临时表数据丢失，后续无法进行临时表相关操作。

GS_WORKLOAD_TRANSACTION GS_WORKLOAD_TRANSACTION视图提供查询单CN上Workload控制组相关的事务信息。数据库记录每个Workload控制组事务提交和回滚的次数及事务提交和回滚的响应时间，单位为微秒。 表1 GS_WORKLOAD_TRANSACTION字段 名称 类型 描述 workload name Workload控制组名称。 commit_counter bigint 提交次数。 rollback_counter bigint 回滚次数。 resp_min bigint 最小响应时间。 resp_max bigint 最大响应时间。 resp_avg bigint 平均响应时间。 resp_total bigint 响应时间总和。 父主题： 系统视图

USER_COL_COMMENTS USER_COL_COMMENTS视图存储当前用户下表和视图的列注释信息。 名称 类型 描述 column_name character varying(64) 列名。 table_name character varying(64) 表名或视图名。 owner character varying(64) 表或视图的所有者。 comments text 注释。 父主题： 系统视图

PG_RELFILENODE_SIZE PG_RELFILENODE_SIZE系统表存储文件级空间统计信息，表中的每一条记录则对应磁盘上相应的物理文件和该文件的文件大小。 表1 PG_RELFILENODE_SIZE字段 名称 类型 描述 databaseid oid 物理文件所属database对应的OID。如果是跨库共享系统表，该值为0。 tablespaceid oid 物理文件所属表空间对应的OID。 relfilenode oid 物理文件的物理文件编号。 backendid integer 创建物理文件的后台线程号，通常为-1。 type integer 物理文件的文件类型。 0为数据类型。 1为FSM文件类型。 2为VM文件类型。 3为BCM文件类型。 大于4为列存表对应列的数据文件和BCM文件大小之和。 filesize bigint 物理文件的文件大小，单位为Byte。 父主题： 系统表

PG_COMM_SEND_STREAM PG_COMM_SEND_STREAM视图展示单个DN上所有的通信库发送流状态。 表1 PG_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：表示将会关闭逻辑连接。 WRITING：表示正在写入数据。 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值产生的额外时间开销，单位为毫秒。 父主题： 系统视图

应用示例 查询当前视图，统计OBS读流量和平均读带宽，统计结果按10分钟聚集。 1 2 3 4 5 select * from gs_obs_read_traffic; nodename | hostname | traffic_mb | bandwidth_mb_per_s | reqcount | logtime ----------+------------------+------------------+--------------------+----------+------------------------ dn_1 | rhel_10_90_45_56 | 101.959338188171 | 5.14830159670447 | 23 | 2022-11-26 09:50:00+08 (1 row)

default_with_oids 参数说明：在没有声明WITH OIDS和WITHOUT OIDS的情况下，这个选项控制在新创建的表中CREATE TABLE和CREATE TABLE AS是否包含一个OID字段。它还决定SELECT INTO创建的表里面是否包含OID 。 不推荐在用户表中使用OID，故默认设置为off。需要带有OID字段的表应该在创建时声明WITH OIDS 。 参数类型：USERSET 取值范围：布尔型 on表示在新创建的表中CREATE TABLE和CREATE TABLE AS可以包含一个OID字段。 off表示在新创建的表中CREATE TABLE和CREATE TABLE AS不可以包含一个OID字段。 默认值：off