华为云用户手册

show_acce_estimate_detail 参数说明：在GaussDB(DWS)集群使用加速集群场景下（即acceleration_with_compute_pool设置为on），控制explain命令是否显示用于评估执行计划下推到加速集群的评估信息。评估信息一般用于运维人员在维护工作中使用，因此该参数默认关闭，此外为了避免这些信息干扰正常的explain信息显示，只有在explain命令的verbose选项打开的情况下才显示评估信息。 参数类型：USERSET 取值范围：布尔型 on表示可以在explain命令的输出中显示评估信息。 off表示不在explain命令的输出中显示评估信息。 默认值：off

analysis_options 参数说明：通过开启对应选项中所对应的功能选项使用相应的定位功能，包括数据校验，性能统计等，参见取值范围中的选项说明。 参数类型：USERSET 取值范围：字符串 LLVM_COMPILE表示在explain performance显示界面中显示每个线程的codegen编译时间。 HASH_CONFLICT表示在DN进程的pg_log目录中的log日志中显示hash表的统计信息，包括hash表大小，hash链长，hash冲突情况。 STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。 默认值：off(ALL)，不开启任何定位功能。

gc_fdw_verify_option 参数说明：在协同分析特性中，控制是否启用结果集行数校验逻辑。该参数仅8.1.3.310及以上集群版本支持。 参数类型：USERSET 取值范围：布尔型 on表示开启结果集行数校验逻辑，额外发送select count语句获取预期行数，与实际获取结果集进行比对。 off表示关闭结果集行数校验逻辑，仅获取所需结果集。 默认值：on 该参数开启时性能会有轻微劣化，性能敏感场景可通过关闭该参数提升性能。 结果集行数校验失败时会抛出异常，可通过设置参数log_min_messages=debug1和logging_module='on(COOP_ANALYZE)'来打开协同分析日志。

enable_row_fast_numeric 参数说明：标识行存表numeric数据落盘的格式。 参数类型：USERSET 取值范围：布尔型 on/true表示行存表numeric落盘格式为bigint格式。 off/false表示行存表numeric落盘格式为原始格式。 参数值设置为on时，建议同步打开enable_force_vector_engine, 可提升大数据集query的查询性能。但相比于原始格式，大概率会占用更多磁盘空间。以TPC-H测试集为例，大约多占7%空间（不同环境参考值可能有差异）。 默认值：off

hll_default_regwidth 参数说明：该参数可以指定hll数据结构每个桶的位数，该值越大，hll所占内存越高。hll_default_regwidth和hll_default_log2m可以决定当前hll能够计算的最大distinct value。具体对应关系可以参见表1 hll_default_log2m和hll_default_regwidth与当前能计算的最大distinct value值的关系。 参数类型：USERSET 取值范围：整型，1~5。 默认值：5 表1 hll_default_log2m和hll_default_regwidth与当前能计算的最大distinct value值的关系 log2m regwidth = 1 regwidth = 2 regwidth = 3 regwidth = 4 regwidth = 5 10 7.4e+02 3.0e+03 4.7e+04 1.2e+07 7.9e+11 11 1.5e+03 5.9e+03 9.5e+04 2.4e+07 1.6e+12 12 3.0e+03 1.2e+04 1.9e+05 4.8e+07 3.2e+12 13 5.9e+03 2.4e+04 3.8e+05 9.7e+07 6.3e+12 14 1.2e+04 4.7e+04 7.6e+05 1.9e+08 1.3e+13 15 2.4e+04 9.5e+04 1.5e+06 3.9e+08 2.5e+13

cost_model_version 参数说明：控制应用场景中估算时cost使用的模型。该参数的影响范围主要涵盖：表达式distinct估算、HashJoin代价模型、行数估算、重分布时分布键的选择及Aggregate的行数估算等。 参数类型：USERSET 取值范围：0、1、2、3、4 0表示使用原始的cost估算模型。 1表示在0的基础上，使用增强的表达式distinct估算、HashJoin代价模型、行数估算、重分布时分布键的选择及Aggregate的行数估算。 2表示在1的基础上，使用随机性更优的analyze采样算法，以提高统计信息准确性。 3表示在2的基础上，优化大集群场景下的broadcast代价估算，以便优化器选择更优计划。该选项仅8.3.0及以上集群版本支持。 4表示在3的基础上，优化了hashjoin并行化代价、倾斜代价、列存索引有序性代价的代价估算以及coalesce表达式的行数估算，并支持子查询常量输出列进行join时的倾斜优化识别。 默认值：1

explain_perf_mode 参数说明：此参数用来指定explain的显示格式。 参数类型：USERSET 取值范围：normal、pretty、summary、run normal：代表使用默认的打印格式。 pretty：代表使用GaussDB(DWS)改进后的新显示格式。新的格式层次清晰，计划包含了plan node id，性能分析简单直接。 summary：是在pretty的基础上增加了对打印信息的分析。 run：在summary的基础上，将统计的信息输出到csv格式的文件中，以便于进一步分析。 默认值：pretty

cost_param 参数说明：该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 当cost_param & 1 不为0，表示对于求不等值连接选择率时选择一种改良机制，此方法在自连接（两个相同的表之间连接）的估算中更加准确，V300R002C00版本开始，已弃用cost_param & 1 不为0时的路径，默认选择更优的估算公式； 当cost_param & 2 不为0，表示求多个过滤条件（Filter）的选择率时，选择最小的作为总的选择率，而非两者乘积，此方法在过滤条件的列之间关联性较强时估算更加准确； 当cost_param & 4 不为0，表示在进行stream节点估算时，选用调试模型，该模型不推荐用户使用。 当cost_param & 16不为0，表示在计算两个及以上过滤条件或Join条件的综合选择率时，采用介于完全相关和完全不相关之间的一种模型，过滤条件较多时倾向于相关性较强的模型。 参数类型：USERSET 取值范围：整型，1～INT_MAX 默认值：16

join_num_distinct 参数说明：控制应用场景中Join列或表达式的默认distinct值。 参数类型：USERSET 取值范围：双精度浮点型，大于或等于-100，客户端显示小数时可能会有截断。 值大于0时，表示使用该值作为默认distinct值。 值大于等于-100且小于0时，表示估算默认distinct时使用的百分比。 值为0时，表示使用200作为默认distinct值。 默认值：-20

zero_damaged_pages 参数说明：控制检测导致GaussDB(DWS)报告错误的损坏的页头，中止当前事务。 参数类型：SUSET 取值范围：布尔型 on表示打开控制功能。 off表示关闭控制功能。 设置为on时，系统报告一个警告，把损坏的页面填充为零然后继续处理。该行为会破坏数据，即被损坏页面上的所有行。但是它允许绕开损坏页面然后从表中存在的未损坏页面上继续检索数据行。因此该参数在硬件或者软件错误导致的数据损坏中进行恢复是有作用的。通常不建议该参数设置为on，除非不需要从损坏的页面中恢复数据。 对于列存表，会将整个CU跳过然后继续处理。支持的场景包括crc校验失败、magic校验失败以及读取的CU长度错误。 默认值：off

ignore_checksum_failure 参数说明： 设置读取数据时是否忽略校验信息检查失败（但仍然会告警），继续执行。该参数仅在enable_crc_check为on时有效。继续执行可能导致崩溃，传播或隐藏损坏数据，无法从远程节点恢复数据及其他严重问题。不建议用户修改设置。 参数类型：SUSET 取值范围：布尔型 on表示忽略数据校验错误。 off表示数据校验错误正常报错。 默认值：off

qual_num_distinct 参数说明：控制应用场景中过滤列或表达式的默认distinct值。 参数类型：USERSET 取值范围：双精度浮点型，大于或等于-100，客户端显示小数时可能会有截断。 值大于0时，表示使用该值作为默认distinct值。 值大于等于-100且小于0时，表示估算默认distinct时使用的百分比。 值为0时，表示使用200作为默认distinct值。 默认值：200

enable_light_colupdate 参数说明：控制是否使用列存轻量化UPDATE。 参数类型：USERSET 取值范围：布尔型 on表示开启列存轻量化UPDATE。 off表示关闭列存轻量化UPDATE。 默认值：off 列存轻量化UPDATE与后台列存AUTOVACUUM并发会小概率报错，可以通过ALTER TABLE设置表级参数enable_column_autovacuum_garbage为off来避免。需要注意的是设置表级参数enable_column_autovacuum_garbage为off会关闭该表的后台列存AUTOVACUUM。

debug_assertions 参数说明：控制打开各种断言检查。能够协助调试，当遇到奇怪的问题或者崩溃，请把此参数打开，因为它能暴露编程的错误。要使用这个参数，必须在编译GaussDB(DWS)的时候定义宏USE_ASSERT_CHECKING（通过configure选项 --enable-cassert完成）。 参数类型：USERSET 取值范围：布尔型 on表示打开断言检查。 off表示不打开断言检查。 当启用断言选项编译GaussDB(DWS)时，debug_assertions缺省值为on 。 默认值：off

enable_crc_check 参数说明：设置是否允许开启数据校验功能。写入表数据时生成校验信息，读取表数据时检查校验信息。不建议用户修改设置。 参数类型：POSTMASTER 取值范围：布尔型 on表示允许开启对表数据校验功能。 off表示不允许开启对表数据校验功能。 默认值：on 如果开启了CRC，在检查点之后第一次修改页面上元组hint bits时，要求将整个页面的全部内容写到WAL日志中，这会引起检查点后第一次查询性能的下降。

enable_force_vector_engine 参数说明：对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。当打开enable_force_vector_engine开关时，无论是行存表、列存表或者是行列混存，如果plantree中不包含不支持向量化的场景，则强制走向量化执行引擎。 参数类型：USERSET 取值范围：布尔型 默认值：off

enable_limit_stop 参数说明：控制LIMIT语句是否启用early stop优化。对于LIMIT n语句，若使用early stop优化则CN收取到n条数据后会传递请求使DN提前结束执行，适用于复杂查询且带有LIMIT的场景。该参数仅8.1.3.320及以上集群版本支持。 参数类型：USERSET 取值范围：布尔型 on表示允许LIMIT语句使用early stop优化。 off表示不允许LIMIT语句使用early stop优化。 默认值：on

distribute_test_param 参数说明：控制分布式测试框架打桩点是否生效。通常开发人员在进行故障注入测试时会在代码中预埋一些打桩点，使用唯一的名称进行标识，使用此参数可以控制代码中预埋的打桩点是否生效。参数采用逗号分隔的三元组形式，分别指定线程级别、测试桩名称和注入故障的错误级别。 参数类型：USERSET 取值范围：字符串，任一个已预埋的测试桩名称。 默认值：-1, default, default

ALL_SEQUENCES ALL_SEQUENCES视图存储当前用户能够访问的所有序列。 表1 ALL_SEQUENCES字段 名称 类型 描述 sequence_owner name 序列所有者。 sequence_name name 序列的名称。 min_value bigint 序列最小值。 max_value bigint 序列最大值。 increment_by bigint 序列的增量。 cycle_flag character(1) 表示序列是否是循环序列，取值为Y或N。 Y表示是循环序列。 N表示不是循环序列。 父主题： 系统视图

DBA_IND_EXPRESSIONS DBA_IND_EXPRESSIONS视图存储了数据库中的表达式索引的信息。需要有系统管理员权限才可以访问。 名称 类型 描述 index_owner character varying(64) 索引的所有者。 index_name character varying(64) 索引名。 table_owner character varying(64) 表的所有者。 table_name character varying(64) 表名。 column_expression text 定义列的基于函数的索引表达式。 column_position smallint 索引中列的位置。 父主题： 系统视图

PG_SHSECLABEL PG_SHSECLABEL系统表存储在共享数据库对象上的安全标签。安全标签可以用SECURITY LABEL命令操作。 查看安全标签的简单点的方法，请参阅PG_SECLABELS。 PG_SECLABEL的作用类似，只是它是用于在单个数据库内部的对象的安全标签的。 不同于大多数的系统表，PG_SHSECLABEL在一个集群中的所有数据库中共享：每个数据库集群只有一个PG_SHSECLABEL，而不是每个数据库一个。 表1 PG_SHSECLABEL字段 名字 类型 引用 描述 objoid oid 任意OID属性 此安全标签所属对象的OID。 classoid oid PG_CLASS.oid 对象所属系统目录的OID。 provider text - 与此标签关联的标签提供者。 label text - 应用于该对象的安全标签。 父主题： 系统表

PG_CONVERSION PG_CONVERSION系统表描述编码转换信息。 表1 PG_CONVERSION字段 名称 类型 引用 描述 oid oid - 行标识符（隐藏属性，必须明确选择才会显示）。 conname name - 转换名（在一个命名空间里唯一）。 connamespace oid PG_NAMESPACE.oid 包含此转换的命名空间的OID。 conowner oid PG_AUTHID.oid 编码转换的属主。 conforencoding integer - 源编码ID。 contoencoding integer - 目的编码ID。 conproc regproc PG_PROC.oid 转换过程。 condefault boolean - 如果为缺省转换则为真。 父主题： 系统表

USER_IND_PARTITIONS USER_IND_PARTITIONS视图存储当前用户下的索引分区信息。 名称 类型 描述 index_owner character varying(64) 索引分区所属分区表索引的所有者的名称。 schema character varying(64) 索引分区所属分区表索引的模式。 index_name character varying(64) 索引分区所属分区表索引的名称。 partition_name character varying(64) 索引分区的名称。 index_partition_usable boolean 索引分区是否可用。 high_value text 索引分区所对应的表分区的边界（范围分区为上边界，列表分区为边界值集合）。 前向兼容的保留字段，8.1.3集群版本新增pretty_high_value用于记录此信息。 pretty_high_value text 索引分区所对应的表分区的边界（范围分区为上边界，列表分区为边界值集合）。 查询结果为表分区对应边界表达式的即时反编译输出。该字段的输出比high_value的信息更详细，根据实际使用场景可输出collaton、字段数据类型等信息。 def_tablespace_name name 索引分区的表空间名称。 父主题： 系统视图

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。 父主题： 系统视图

DBA_IND_PARTITIONS DBA_IND_PARTITIONS视图存储数据库中所有索引分区的信息。数据库中每个分区表的每个索引分区（如果存在的话）在DBA_IND_PARTITIONS里都会有一行记录。需要有系统管理员权限才可以访问。 名称 类型 描述 index_owner character varying(64) 索引分区所属分区表索引的所有者的名称。 schema character varying(64) 索引分区所属分区表索引的模式。 index_name character varying(64) 索引分区所属分区表索引的名称。 partition_name character varying(64) 索引分区的名称。 index_partition_usable boolean 索引分区是否可用。 high_value text 索引分区所对应的表分区的边界（范围分区为上边界，列表分区为边界值集合）。 前向兼容的保留字段，8.1.3集群版本新增pretty_high_value用于记录此信息。 pretty_high_value text 索引分区所对应的表分区的边界（范围分区为上边界，列表分区为边界值集合）。 查询结果为表分区对应边界表达式的即时反编译输出。该字段的输出比high_value的信息更详细，根据实际使用场景可输出collaton、字段数据类型等信息。 def_tablespace_name name 索引分区的表空间名称。 父主题： 系统视图

PG_JOB_PROC PG_JOB_PROC视图用于代替之前版本的PG_JOB_PROC系统表，提供对之前版本的前向兼容。原PG_JOB_PROC系统表已经和原PG_JOB系统表一同并入当前版本的PG_JOBS系统表，关于PG_JOBS系统表的描述详见PG_JOBS。 表1 PG_JOB_PROC字段 名字 类型 描述 job_id bigint 作业ID。 what text 作业内容。 父主题： 系统视图

PV_FILE_STAT PV_FILE_STAT视图通过对数据文件IO的统计，反映数据的IO性能，用以发现IO操作异常等性能问题。 表1 PV_FILE_STAT字段 名称 类型 描述 filenum oid 文件标识。 dbid oid 数据库标识。 spcid oid 表空间标识。 phyrds bigint 读物理文件的数目。 phywrts bigint 写物理文件的数目。 phyblkrd bigint 读物理文件块的数目。 phyblkwrt bigint 写物理文件块的数目。 readtim bigint 读文件的总时长，单位为微秒。 writetim bigint 写文件的总时长，单位为微秒。 avgiotim bigint 读写文件的平均时长，单位为微秒。 lstiotim bigint 最后一次读文件时长，单位为微秒。 miniotim bigint 读写文件的最小时长，单位为微秒。 maxiowtm bigint 读写文件的最大时长，单位为微秒。 父主题： 系统视图

PV_SESSION_MEMORY PV_SESSION_MEMORY视图统计Session级别的内存使用情况，包含执行作业在数据节点上Postgres线程和Stream线程分配的所有内存。 表1 PV_SESSION_MEMORY字段 名称 类型 描述 sessid text 线程启动时间+线程标识。 init_mem integer 当前正在执行作业进入执行器前已分配的内存，单位为MB。 used_mem integer 当前正在执行作业已分配的内存，单位为MB。 peak_mem integer 当前正在执行作业已分配的内存峰值，单位为MB。 父主题： 系统视图

PG_SESSION_WLMSTAT PG_SESSION_WLMSTAT视图显示和当前用户执行作业正在运行时的负载管理相关信息。 表1 PG_SESSION_WLMSTAT字段 名称 类型 描述 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监控周期内逻辑读速率的平均值，单位为KB/s。 DN：显示当前DN上资源池逻辑读速率。 CN：显示所有DN上资源池逻辑读速率的累积和。 write_speed double 资源池5s监控周期内逻辑写速率平均值，单位为KB/s。 DN：显示当前DN上资源池逻辑写速率。 CN：显示所有DN上资源池逻辑写速率的累积和。 send_speed double 资源池5s监控周期内网络发送速率平均值，单位为KB/s。 DN：显示当前DN上资源池网络发送速率。 CN：显示所有DN上资源池网络发送速率的累积和。 recv_speed double 资源池5s监控周期内网络接收速率平均值，单位为KB/s。 DN：显示当前DN上资源池网络接收速率。 CN：显示所有DN上资源池网络接收速率的累积和。 父主题： 系统视图