华为云用户手册

PG_JOB PG_JOB视图存储用户创建的定时任务的任务详细信息。 PG_JOB视图用于代替历史版本的PG_JOB系统表，提供对之前版本的前向兼容。原PG_JOB系统表已经变更为PG_JOBS系统表，关于PG_JOBS系统表的描述详见PG_JOBS。 表1 PG_JOB字段 名字 类型 描述 job_id bigint 作业ID。 current_postgres_pid bigint 如果当前任务正在被执行，那么此处记录运行此任务的postgres线程ID。默认为-1，表示此任务未被执行或已执行完毕。 log_user name 创建者的UserName。 priv_user name 作业执行者的UserName。 dbname name 标识作业执行的数据库名。 node_name name 标识当前作业是在哪个CN上创建和执行。 job_status text 当前任务的执行状态，取值范围：('r', 's', 'f', 'd','p','w','l')，默认为's'，取值含义： r=running s=successfully finished f=job failed d=disable p=pending w=waiting l=launching 说明： 当用户将定时任务关闭（即job_queue_processes为0时），由于监控job执行的线程不会启动，所以job_status不会根据job的实时状态进行设置，用户不需要关注job_status。 只有当开启定时任务功能（job_queue_processes为非0时），系统才会根据当前job的实时状态刷新job_status的值。 start_date timestamp without time zone 作业第一次开始执行时间，时间精确到毫秒。 next_run_date timestamp without time zone 下次定时执行任务的时间，时间精确到毫秒。 failure_count smallint 连续失败计数。 interval text 作业执行的重复时间间隔。 last_start_date timestamp without time zone 上次运行开始时间，时间精确到毫秒。 last_end_date timestamp without time zone 上次运行的结束时间，时间精确到毫秒。 last_suc_date timestamp without time zone 上次成功运行的开始时间，时间精确到毫秒。 this_run_date timestamp without time zone 正在运行任务的开始时间，时间精确到毫秒。 nspname name 作业运行时所在的命名空间的名称。 what text 作业内容。 父主题： 系统视图

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

default_sequence_cache 参数说明：设置CREATE SEQUENCE时cache的默认取值。该参数仅9.1.0.100及以上集群版本支持。 参数类型：SIGHUP 取值范围：整型，1~16384 默认值： 新安装的9.1.0.100及以上集群版本，默认值为20。 从低版本升级到9.1.0.100及以上集群版本，默认值为1，表示一次只能生成一个值，即没有缓存。 该参数的设置不影响CREATE SEQUENCE时显式指定cache参数的方式创建的cache值，升级场景下不影响低版本CREATE SEQUENCE方式创建的cache值。

approx_count_distinct_precision 参数说明：该参数表示HyperLogLog++ (HLL++)算法中分桶个数，可以用来调整approx_count_distinct聚集函数的误差率。桶的个数会影响distinct值估算的精度，桶的个数越多，误差越小。误差范围为：[-1.04/2log2m*1/2,+1.04/2log2m*1/2]。 参数类型：USERSET 取值范围：整型，10~20。 默认值：17

full_group_by_mode 参数说明：结合behavior_compat_options中disable_full_group_by_mysql使用，用于控制disable_full_group_by_mysql语法开关打开后的两种不同行为。 参数类型：USERSET 取值范围：字符串 nullpadding表示对于非聚集列而言，对该列NULL值进行填充，取该列非NULL值，结果集可能为不同行。 notpadding表示对于非聚集列而言，不处理NULL值，取该行整行数据，非聚集列结果集为随机的一行。 默认值：notpadding 该参数生效前提为MySQL兼容库下打开disable_full_group_by_mysql，且查询中出现非聚集列场景生效。该参数的两种行为也仅针对查询中的非聚集列生效。

enable_cudesc_streaming 参数说明：在存算分离架构下，控制跨逻辑集群访问是否选择cudesc streaming路径（从表所在逻辑集群获取cudesc、delta表数据等信息）。该参数仅9.1.0及以上集群版本支持。 参数类型：SUSET 取值范围：枚举型 off表示关闭cudesc streaming。 on表示开启cudesc streaming。 only_read_on表示只在数据读取时支持cudesc streaming。 默认值： on

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

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

default_table_behavior 参数说明：支持设置默认表的行为类型，该参数仅8.2.1及以上集群版本支持。 参数类型：USERSET 取值范围：column_btree_index、column_high_compress、column_middle_compress、column_low_compress column_btree_index表示列存表默认创建索引为btree。 column_high_compress表示列存表默认压缩级别为high。 column_middle_compress表示列存表默认压缩级别为middle。 column_low_compress表示列存表默认压缩级别为low。 默认值：空字符串

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

analysis_options 参数说明：设置是否开启对应的功能选项使用其定位功能，包括数据校验，性能统计等。 参数类型：USERSET 取值范围：字符串 LLVM_COMPILE，表示在explain performance显示界面中显示每个线程的codegen编译时间。 HASH_CONFLICT，表示在DN进程的pg_log目录中的log日志中显示hash表的统计信息，包括hash表大小、hash链长及hash冲突情况。 STREAM_DATA_CHECK，表示对网络传输前后的数据进行CRC校验。 TURBO_DATA_CHECK，表示对turbo的ScalarVector和VectorBatch的算子的数据上下文进行校验。该选项仅8.3.0.100及以上集群支持。 KEEP_SAMPLE_DATA，表示以临时表的形式保留每次analyze操作中使用的采样数据。该选项仅9.1.0及以上集群版本支持。 BLOCK_RULE，表示在explain performance显示界面中显示查询过滤器检查耗时。该选项仅9.1.0.100及以上集群版本支持。 默认值：off(ALL)，不开启任何定位功能。

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

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

default_orientation 参数说明：创建表时，当不指定存储方式时，根据该GUC参数的值创建对应类型的表。使用时，各节点值需要保持一致。 参数类型：SUSET 取值范围：row、column、column enabledelta、column enablehstore、column enablehstoreopt、column enablehstorebinlog、column_enablehstoreopt_v3和column enablehstoreoptonlycol。 row表示创建行存表。 column表示创建列存表。 column enabledelta表示创建开启delta表的列存表。 column enablehstore表示创建HStore表。 column enablehstoreopt表示创建HStore Opt表。 column enablehstorebinlog表示创建HStore Binlog表 column_enablehstoreopt_v3表示创建HStore Opt的V3表 column enablehstoreoptonlycol表示只对列存表创建HStore Opt表。 默认值：row

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

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

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

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

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

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

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

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

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

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

PG_INHERITS PG_INHERITS系统表记录关于表继承层次的信息。数据库里每个直接的子系表都有一条记录。间接的继承可以通过追溯记录链来判断。 表1 PG_INHERITS字段 名字 类型 引用 描述 inhrelid oid PG_CLASS.oid 子表的OID。 inhparent oid PG_CLASS.oid 父表的OID。 inhseqno integer - 如果一个子表存在多个直系父表（多重继承），这个数字表示此继承字段的排列顺序。计数从1开始。 父主题： 系统表

ALL_SEQUEN CES 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表示不是循环序列。 父主题： 系统视图

PG_STATIO_USER_SEQUENCES PG_STATIO_USER_SEQUENCES视图显示命名空间中所有用户关系表类型为序列的IO状态信息。 表1 PG_STATIO_USER_SEQUENCES字段 名称 类型 描述 relid oid 序列OID。 schemaname name 序列中模式名。 relname name 序列名。 blks_read bigint 从序列中读取的磁盘块数。 blks_hit bigint 序列中缓存命中数。 父主题： 系统视图

transaction_isolation 参数说明：设置当前事务的隔离级别。 参数类型：USERSET 取值范围： read committed：读已提交隔离级别，只能读到已经提交的数据，而不会读到未提交的数据。这是缺省值。 read uncommitted：读未提交隔离级别，GaussDB(DWS)不支持read uncommitted，如果设置了read uncommitted，实际上使用的是read committed。 repeatable read：可重复读隔离级别，仅仅能看到事务开始之前提交的数据，不能看到未提交的数据，以及在事务执行期间由其它并发事务提交的修改。 serializable：事务可序列化，GaussDB(DWS)不支持SERIALIZABLE，如果设置了serializable，实际上使用的是repeatable read。 默认值：read committed

transaction_deferrable 参数说明：指定是否允许一个只读串行事务延迟执行，使其不会执行失败。该参数设置为on时，当一个只读事务发现读取的元组正在被其他事务修改，则延迟该只读事务直到其他事务修改完成。目前，GaussDB(DWS)暂时未用到这个参数。与该参数类似的还有一个default_transaction_deferrable，设置它来指定一个事务是否允许延迟。 参数类型：USERSET 取值范围：布尔型 on表示允许执行。 off表示不允许执行。 默认值：off