华为云用户手册

log_min_messages 参数说明：控制写到cm_agent日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 参数类型：枚举类型 参数单位：无 取值范围：有效值有debug5、debug1、log、warning、error、fatal。 默认值：warning 设置方式：该参数为CM参数，参数修改请参考表2中方式一、方式二进行设置。 设置建议：考虑硬盘大小后适当设置。 设置不当的风险与影响：设置级别低可能导致调试信息丢失。

agent_check_interval 参数说明：cm_agent查询DN、CN、GTM等实例状态的时间间隔。 参数类型：整型 参数单位：秒（s） 取值范围：1 ~ 2147483647 默认值：2 设置方式：该参数为CM参数，参数修改请参考表2中方式一、方式二进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过大会导致cm故障检测和恢复功能不及时，设置过小会导致cpu负载变高。

alarm_component 参数说明：设置用于处理告警内容的告警组件的位置。 参数类型：字符串 参数单位：无 取值范围：合法文件路径。 若前置脚本gs_preinstall中的--alarm-type参数设置为5，表示未对接第三方组件，告警写入system_alarm日志，此时GUC参数alarm_component的取值为“/opt/huawei/snas/bin/snas_cm_cmd”。 若前置脚本gs_preinstall中的--alarm-type参数设置为1，表示对接第三方组件，此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。 默认值："/opt/huawei/snas/bin/snas_cm_cmd" 设置方式：该参数为CM参数，参数修改请参考表2中方式一、方式二进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

UNION，CASE和相关构造解析 如果所有输入都是相同的类型，并且不是unknown类型，那么解析成这种类型。 如果所有输入都是unknown类型则解析成text类型（字符串类型范畴的首选类型）。否则，忽略unknown输入。 如果输入不属于同一个类型范畴，则失败。（unknown类型除外） 如果输入类型是同一个类型范畴，则选择该类型范畴的首选类型。（例外：union操作会选择第一个分支的类型作为所选类型。） 系统表pg_type中typcategory表示数据类型范畴， typispreferred表示是否是typcategory分类中的首选类型。 把所有输入转换为所选的类型（对于字符串保持原有长度）。如果从给定的输入到所选的类型没有隐式转换则失败。 若输入中含json、txid_snapshot、sys_refcursor或几何类型，则不能进行union。

对于case和coalesce，在TD兼容模式下的处理 如果所有输入都是相同的类型，并且不是unknown类型，那么解析成这种类型。 如果所有输入都是unknown类型则解析成text类型。 如果输入字符串（包括unknown，unknown当text来处理）和数字类型，那么解析成字符串类型，如果是其他不同的类型范畴，则报错。 如果输入类型是同一个类型范畴，则选择该类型的优先级较高的类型。 把所有输入转换为所选的类型。如果从给定的输入到所选的类型没有隐式转换则失败。

示例 示例1：Union中的待定类型解析。unknown类型文本'b'将被解析成text类型。 1 2 3 4 5 6 gaussdb=# SELECT text 'a' AS "text" UNION SELECT 'b'; text ------ a b (2 rows) 示例2：简单Union中的类型解析。文本1.2的类型为numeric，而且integer类型的1可以隐含地转换为numeric，因此使用这个类型。 1 2 3 4 5 6 gaussdb=# SELECT 1.2 AS "numeric" UNION SELECT 1; numeric --------- 1 1.2 (2 rows) 示例3：转置Union中的类型解析。类型real不能被隐含转换成integer，但是integer可以隐含转换成real，那么联合的结果类型将是real。 1 2 3 4 5 6 gaussdb=# SELECT 1 AS "real" UNION SELECT CAST('2.2' AS REAL); real ------ 1 2.2 (2 rows) 示例4：TD模式下，coalesce参数输入int和varchar类型，那么解析成varchar类型。ORA模式下会报错。 --在Oracle模式下，创建Oracle兼容模式的数据库oracle_1。 gaussdb=# CREATE DATABASE oracle_1 dbcompatibility = 'ORA'; --切换数据库为oracle_1。 gaussdb=# \c oracle_1 --创建表t1。 oracle_1=# CREATE TABLE t1(a int, b varchar(10)); --查看coalesce参数输入int和varchar类型的查询语句的执行计划。 a_1=# EXPLAIN SELECT coalesce(a, b) FROM t1; ERROR: COALESCE types integer and character varying cannot be matched LINE 1: EXPLAIN SELECT coalesce(a, b) FROM t1; ^ CONTEXT: referenced column: coalesce --删除表。 oracle_1=# DROP TABLE t1; --切换数据库为testdb。 oracle_1=# \c testdb --在TD模式下，创建TD兼容模式的数据库td_1。 gaussdb=# CREATE DATABASE td_1 dbcompatibility = 'TD'; --切换数据库为td_1。 gaussdb=# \c td_1 --创建表t2。 td_1=# CREATE TABLE t2(a int, b varchar(10)); --查看coalesce参数输入int和varchar类型的查询语句的执行计划。 td_1=# EXPLAIN VERBOSE select coalesce(a, b) from t2; QUERY PLAN --------------------------------------------------------------------------------------- Data Node Scan (cost=0.00..0.00 rows=0 width=0) Output: (COALESCE((t2.a)::character varying, t2.b)) Node/s: All datanodes Remote query: SELECT COALESCE(a::character varying, b) AS "coalesce" FROM public.t2 (4 rows) --删除表。 td_1=# DROP TABLE t2; --切换数据库为testdb。 td_1=# \c testdb --删除Oracle和TD模式的数据库。 gaussdb=# DROP DATABASE oracle_1; gaussdb=# DROP DATABASE td_1; 示例5：ORA模式下，将整个表达式最终的返回值类型定为result1的数据类型，或者与result1同类型范畴的更高精度的数据类型。 --在ORA模式下，创建ORA兼容模式的数据库ora_1。 gaussdb=# CREATE DATABASE ora_1 dbcompatibility = 'A'; --切换数据库为ora_1。 gaussdb=# \c ora_1 --开启Decode兼容性参数。 set sql_beta_feature='a_style_coerce'; --创建表t1。 ora_1=# CREATE TABLE t1(c_int int, c_float8 float8, c_char char(10), c_text text, c_date date); --插入数据。 ora_1=# INSERT INTO t1 VALUES(1, 2, '3', '4', date '12-10-2010'); --result1类型为char，defresult类型为text，text精度更高，返回值的类型由char更新为text。 ora_1=# SELECT decode(1, 2, c_char, c_text) AS result, pg_typeof(result) FROM t1; result | pg_typeof --------+----------- 4 | text (1 row) --result1类型为int，属于数值类型范畴，返回值的类型置为numeric。 ora_1=# SELECT decode(1, 2, c_int, c_float8) AS result, pg_typeof(result) FROM t1; result | pg_typeof --------+----------- 2 | numeric (1 row) --不存在defresult数据类型向result1数据类型之间的隐式转换，报错处理。 ora_1=# SELECT decode(1, 2, c_int, c_date) FROM t1; ERROR: CASE types integer and timestamp without time zone cannot be matched LINE 1: SELECT decode(1, 2, c_int, c_date) FROM t1; ^ CONTEXT: referenced column: c_date --关闭Decode兼容性参数。 set sql_beta_feature='none'; --删除表。 ora_1=# DROP TABLE t1; DROP TABLE --切换数据库为testdb。 ora_1=# \c testdb --删除ORA模式的数据库。 gaussdb=# DROP DATABASE ora_1; DROP DATABASE

enable_imcvscan 参数说明：依赖HTAP特性开启状态，设置是否打开HTAP内存列扫描算子IMCVScan。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：布尔型 参数单位：无 取值范围： on：打开HTAP内存列扫描算子IMCVScan。当前版本下实际不生效。 off：关闭HTAP内存列扫描算子IMCVScan。当前版本下实际不生效。 默认值：on 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险与影响。

htap_flush_pagenum 参数说明：依赖HTAP特性开启状态，设置同步增量行存数据到IMCV行组的脏页阈值，脏页数量大于该值触发同步过程。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：整型 参数单位：无 取值范围：1~1000。 默认值：512 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险与影响。

htap_flush_interval 参数说明：依赖HTAP特性开启状态，设置同步增量行存数据到IMCV行组的最大时间间隔。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：整型 参数单位：秒 取值范围：1~36000。 默认值：300 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险与影响。

htap_flush_workers 参数说明：依赖HTAP特性开启状态，设置同步增量行存数据到IMCV行组的最大工作线程数。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：整型 参数单位：无 取值范围：1~100。 默认值：3 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险与影响。

htap_memctl_policy 参数说明：依赖HTAP特性开启状态，设置HTAP特性内存管理的策略模式。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：枚举类型 参数单位：无 取值范围： delete：表示当HTAP内存不足时，删除内存列内存数据，释放内存。HTAP内存上限由参数htap_max_mem_size设置。当前版本下实际不生效。 swap：表示当HTAP内存不足时，会发生数据交换，不常用数据落盘到本地磁盘中。当前版本，该功能暂不生效。 默认值：delete 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险与影响。

enable_parallel_populate 参数说明：依赖HTAP特性开启状态，设置是否开启存量行存转内存列IMCV的并行加载特性，以加速IMCV表创建流程。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：布尔型 参数单位：无 取值范围： on：并行加载数据。当前版本下实际不生效。 off：串行加载数据。当前版本下实际不生效。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险与影响。

htap_router_mode 参数说明：依赖HTAP特性开启状态，设置HTAP透明路由的模式。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：枚举类型 参数单位：无 取值范围： row：强制使查询负载选择行存计划。当前版本下实际不生效。 column：当查询请求中的列加载到IMCV时，无视代价高低，强制执行列存（IMCVScan）计划；若存在未加载到IMCV的列时，执行行存计划。当前版本下实际不生效。 auto：根据查询请求中的列是否加载到IMCV，以及行列计划代价高低，自动选择行、列、行列混合计划。当前版本下实际不生效。 默认值：row 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险与影响。

htap_max_mem_size 参数说明：依赖HTAP特性开启状态，设置HTAP特性可用的内存上限。当 GaussDB 动态内存使用达到上限后，即使HTAP内存使用未达到上限，也无法继续分配内存。由于依赖enable_htap，当前版本下设置该参数无效。 参数类型：int 参数单位：KB 取值范围：102400 ~ 1073741824。当前版本下实际不生效。 默认值：1GB 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：当前版本下无需设置该参数。 设置不当的风险与影响：无风险和影响。 最大动态内存和已使用的动态内存可以通过gs_total_memory_detail视图查询获得，最大动态内存为max_dynamic_memory，已使用的动态内存为dynamic_used_memory。

enable_htap 参数说明：是否开启HTAP特性，开启HTAP特性后，会加载COLVIEW关键字指定列的存量行存数据到内存IMCV（In-memory Column View，列式内存引擎）中，用于提高AP（Analytical Processing，分析处理）查询效率。当前版本不支持设置enable_htap为on。 参数类型：布尔型 参数单位：无 取值范围： on：打开HTAP特性，当前版本不支持设置为on。 off：关闭HTAP特性。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：当前版本不支持设置enable_htap为on。 设置不当的风险与影响：无风险与影响。

COMM_DELAY COMM_DELAY视图展示单个DN的TCP代理通信库时延状态，如表1所示。 表1 COMM_DELAY字段 名称 类型 描述 node_name text 节点名称。 remote_name text 连接对端节点名称。 remote_host text 连接对端IP地址。 stream_num integer 当前物理连接使用的stream逻辑连接数量。 min_delay integer 当前物理连接一分钟内探测到的最小时延（单位：微秒）。 说明： 负数结果无效，请重新等待时延状态更新后再执行。 average integer 当前物理连接一分钟内探测时延的平均值（单位：微秒）。 max_delay integer 当前物理连接一分钟内探测到的最大时延（单位：微秒）。 父主题： Comm

standby_read_use_az_info 参数说明：GTM-Lite备机读是否使用AZ信息，优先选择和CN相同的AZ的备机，默认关闭。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启。 off：表示关闭。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议根据实际业务需要进行设置，打开开关后，由于需要遍历所有可用备DN节点，再去从中选择，可能会导致查询性能下降。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

enable_standby_bufferpool 参数说明：启用极致RTO备机读独立缓冲区功能的开关。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启。 off：表示关闭。 默认值：on 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。 启用该功能开关时，开关生效需满足enable_incremental_checkpoint增量检查点打开，且参数standby_shared_buffers_fraction减去参数standby_bufferpool_scale的差值不小于0.1。

exrto_standby_read_opt 参数说明：支持极致RTO备机读优化。主机和备机间不同步该参数。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启优化。 off：表示关闭优化。 默认值：on 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

standby_read_use_load_balance 参数说明：GTM-Lite备机读是否使用负载均衡功能，随机挑选满足一致性点（和AZ信息）的DN，默认关闭。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启。 off：表示关闭。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议根据实际业务需要进行设置，打开开关后，由于需要遍历所有可用备DN节点，再去从中选择，可能会导致查询性能下降。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

standby_bufferpool_scale 参数说明：设置用于开启极致RTO备机读独立缓冲区功能后，独立缓冲区使用shared_buffers内存缓冲区大小的比例。 参数类型：浮点型 参数单位：无 取值范围：0.1-0.9 默认值：0.5 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：若该值设置不合理，会导致刷页速度加快。

walrcv_writer_crc_check_level 参数说明：支持流式容灾场景下，主备集群内备机侧的xLog校验，默认仅在灾备集群内开启。 参数类型：整型 参数单位：无 取值范围：0~3 0：关闭校验。 1：灾备集群内校验生效。 2：主集群内备机侧的校验生效。 3：主集群内的备机和灾备集群内节点全部生效。 默认值：1 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：容灾搭建流程会自动设置，无需用户手动设置。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

standby_max_query_time 参数说明：开启极致RTO功能后，支持备机上查询的最大时间，超过该时间会被取消。 何时取消查询受回收线程的时间间隔参数standby_recycle_interval和查询取快照的时间影响，因此备机上查询的实际执行时间要大于该参数。 参数类型：整型 参数单位：s（秒） 取值范围：0~86400‬ 默认值：600 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议根据实际业务需要进行调整。 设置不当的风险与影响：设置过高，出现回放和查询冲突后，会一直阻塞xlog回放，导致RTO/RPO升高。

max_keep_csn_info_size 参数说明：开启极致RTO功能后，备机上每个DN允许的csn info链表的最大存储空间。 参数类型：整型 参数单位：kB 取值范围：16384~131072 默认值：16384‬（16MB） 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

hot_standby_feedback 参数说明：将备机上执行查询的最小事务号反馈给主机，可以避免查询冲突。 参数类型：布尔型 参数单位：无 取值范围： on：表示允许将备机上执行查询的最小事务号反馈给主机。 off：表示不允许将备机上执行查询的最小事务号反馈给主机。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：当该参数为on时，主机的旧版本数据的清理会受限于备机正在读的事务，即主机只允许清理小于备机反馈的事务号所作的更改。因此若该参数开启时，会影响主机的性能。若备机回放与查询冲突，会出现查询报错，因此建议适当调大max_standby_streaming_delay。

max_standby_lsn_info_size 参数说明：开启极致RTO功能后，备机上允许lsn info类型文件的最大存储空间。 参数类型：整型 参数单位：kB 取值范围：1048576~562949953421311 默认值：268435456‬ （256 GB） 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据实际物理磁盘大小，对此参数进行设置。 设置不当的风险与影响：设置过小，会导致备机读报错概率增加。

standby_recycle_interval 参数说明：开启极致RTO功能后，备机读相关文件回收的时间间隔。备机读的资源回收线程，每间隔该参数值的时间，尝试清理一次备机读相关文件。 参数类型：整型 参数单位：s（秒） 取值范围：0~86400‬ 默认值：10 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置间隔过长，会导致历史页面回收不及时，可能会导致过多的磁盘占用。

wal_receiver_status_interval 参数说明：WAL日志接收线程的状态通知给主机的最大时间间隔。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 2147483 默认值：5 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：当该参数设置为0时，表示关闭备机向主机反馈日志接收位置等信息，可能会导致主机事务提交阻塞、switchover操作失败等异常现象。正常业务场景，不建议将该参数设置为0。

standby_force_recycle_ratio 参数说明：开启极致RTO功能后，备机读相关文件触发强制回收的比例。当base page文件总大小超过max_standby_base_page_size* standby_force_recycle_ratio，或者lsn info文件总大小超过max_standby_lsn_info_size* standby_force_recycle_ratio时，触发强制回收，会有查询被取消。当standby_force_recycle_ratio = 0时，不会启动强制回收，max_standby_base_page_size和max_standby_lsn_info_size也不会生效。 参数类型：浮点类型 参数单位：无 取值范围：0.0～1.0 默认值：0.8 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

wal_receiver_buffer_size 参数说明：备机接收xLog存放到内存缓冲区的大小。 参数类型：整型 参数单位：kB 取值范围：4096~1047552 默认值：65536（即64MB） 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。