华为云用户手册

default_week_format 参数说明：用于week()函数的默认mode值，取值范围与表现如下表所示。 default_week_format 一周的第一天 范围 第1周定义 0 周日 0~53 今年第一个有周日的周。 1 周一 0~53 今年第一个有4天及以上天数的周。 2 周日 1~53 今年第一个有周日的周。 3 周一 1~53 今年第一个有4天及以上天数的周。 4 周日 0~53 今年第一个有4天及以上天数的周。 5 周一 0~53 今年第一个有周一的周。 6 周日 1~53 今年第一个有4天及以上天数的周。 7 周一 1~53 今年第一个有周一的周。 一年的第1周，其中的1代表序号值。根据week_format不同，如第三列所示，一年的第一个周序号可能为0。 参数类型：整型 参数单位：无 取值范围：-2147483648 ~ 2147483647 当取值小于0时，会被强制调整为0。 当取值大于7时，会被强制调整为7。 默认值：0 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据业务需要，选择合适的mode。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

lc_numeric 参数说明：设置数值的显示格式，影响to_char之类的函数的输出。 参数类型：字符串 参数单位：无 取值范围：取值范围与系统相关，可通过使用命令locale -a查看。 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 该参数通过执行gs_guc reload修改时，如果当前节点上的某个session的连接不是来自于客户端，而是来自于该节点所属集群上的其他节点，那么执行gs_guc reload后该参数在该session上不会立即生效，需与连接节点断开连接后重新连接才会生效。 默认值："C" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

lc_messages 参数说明：设置信息显示的语言。 参数类型：字符串 参数单位：无 取值范围：取值范围与系统相关，可通过使用命令locale -a查看。 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 在一些系统上，取值范围并不存在，不过仍然允许设置这个变量，只是不会有任何效果。同样，也有可能是所期望的语言的翻译信息不存在。在这种情况下，用户仍然能看到英文信息。 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 默认值："C" 设置方式：该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

lc_monetary 参数说明：设置货币值的显示格式，影响to_char()之类的函数的输出。可接受的值是系统相关的。 参数类型：字符串 参数单位：无 取值范围：取值范围与系统相关，可通过使用命令locale -a查看。 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 该参数通过执行gs_guc reload修改时，如果当前节点上的某个session的连接不是来自于客户端，而是来自于该节点所属集群上的其他节点，那么执行gs_guc reload后该参数在该session上不会立即生效，需与连接节点断开连接后重新连接才会生效。 默认值："C" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

lc_time 参数说明：设置时间和区域的显示格式，影响to_char()之类的函数的输出。 参数类型：字符串 参数单位：无 取值范围：取值范围与系统相关，可通过使用命令locale -a查看。 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 该参数通过执行gs_guc reload修改时，如果当前节点上的某个session的连接不是来自于客户端，而是来自于该节点所属集群上的其他节点，那么执行gs_guc reload后该参数在该session上不会立即生效，需与连接节点断开连接后重新连接才会生效。 默认值："C" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

lc_time_names 参数说明：控制用于显示日期和月份名称及缩写的语言。影响DATE_FORMAT()、DAYNAME()以及MONTHNAME()函数输出结果。不影响STR_TO_DATE()和GET_FORMAT()的表现。 参数类型：字符串 参数单位：无 取值范围：参数应当为简易格式的IETF语言标记，例如en_US、zh_CN等。 默认值："en_US" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据业务需要，切换合适的语言。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

DateStyle 参数说明：设置日期和时间值的显示格式，以及有歧义的输入值的解析规则。 这个变量包含两个独立的加载部分：输出格式声明（ISO、Postgres、SQL、German）和输入输出的年/月/日顺序（DMY、MDY、YMD、Euro、European、US、NonEuro、NonEuropean、Default）。两个部分可以独立设置或者一起设置。关键字Euro和European等价于DMY；关键字US、NonEuro、NonEuropean等价于MDY。 参数类型：字符串 参数单位：无 取值范围：输出格式声明与输入输出的年/月/日顺序的排列组合（两个部分也可以单独设置）。 输出格式声明：ISO、Postgres、SQL、German。 输入输出的年/月/日顺序：DMY（Euro、European）、MDY（US、NonEuro、NonEuropean）、YMD。 默认值："ISO, MDY" gs_initdb会将这个参数初始化成与lc_time一致的值。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。该参数通过执行gs_guc reload修改时，如果当前节点上的某个session的连接不是来自于客户端，而是来自于该节点所属集群上的其他节点，那么执行gs_guc reload后该参数在该session上不会立即生效，需与连接节点断开连接后重新连接才会生效。 设置建议：优先推荐使用ISO格式。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

extra_float_digits 参数说明：这个参数为浮点数值调整显示的数据位数，浮点类型包括float4、float8以及几何数据类型。参数值加在标准的数据位数上（FLT_DIG或DBL_DIG，视情况而定）。 参数类型：整型 参数单位：无 取值范围：-15 ~ 3 设置为正数时，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。 设置为0或负数时，表示消除不需要的数据位。 M-Compatibility模式数据库下，extra_float_digits仅影响不带标度的float4数据类型显示的数据位数。float8数据类型及带标度的float4数据类型显示的数据位数不受该GUC影响。 默认值：0 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

client_encoding 参数说明：设置客户端的字符编码类型。 参数类型：字符串 参数单位：无 取值范围：兼容PG所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置；不同操作系统之间，或者相同操作系统的不同版本之间，排序规则可能存在差异和变化。当应用业务在上述这些操作系统之间进行逻辑迁移时，操作系统排序规则的差异和变化可能会导致索引、分区、排序算子等数据库功能行为的差异，如相同的范围查询语句返回的数据结果集不同、相同的排序查询语句返回的查询结果不同等。应用业务需要根据操作系统发布的locale差异，在业务上排查业务数据是否涉及相关的字符。 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 参数建议保持默认值，不建议通过gs_guc工具或其他方式直接在gaussdb.conf文件中设置client_encoding参数，即使设置也不会生效，以保证集群内部通信编码格式一致。 client_encoding支持设置为GB18030_2022字符编码，当client_encoding=gb18030_2022时，需要保证客户端操作系统支持的GB18030字符集已升级到2022版本。 当数据库字符集编码为UTF8，且当前系统支持的区域下相应的编码格式为GB18030时，若客户端操作系统支持的GB18030字符集已升级到2022版本，且数据库中存在客户端GB18030字符集升级前存入的历史数据，则存在以下情况： set client_encoding=gb18030时，UTF8数据库中的历史数据返回给客户端的字符编码与客户端字符集升级前保持一致，但字符集升级过程中发生映射关系改变的38个字符的字形显示与2022版本保持一致。 set client_encoding=gb18030_2022时，UTF8数据库中的历史数据返回给客户端的字符编码与客户端字符集升级后保持一致，字形与升级前保持一致。这是因为GB18030字符集自身的各版本间存在不完全兼容，可能导致数据不一致。因此，若客户端涉及GB18030字符集升级且存在历史数据的场景，在升级前应进行历史数据的升级转换。 client_encoding支持设置为ZHS16GBK字符编码，下表展示了ZHS16GBK、GB18030、GB18030_2022字符集所有转换关系对应的server_encoding与client_encoding设置方式： server_encoding client_encoding locale 设置方法 zhs16gbk utf8 utf8 数据库自动获取locale取值。 utf8 zhs16gbk gbk gsql通过用户手动执行：set client_encoding = zhs16gbk。 JDBC连接时通过url参数直接指定：characterEncoding=zhs16gbk。 zhs16gbk zhs16gbk gbk gsql连接时数据库自动获取locale取值，内部进行处理后自动设置client_encoding = zhs16gbk。 JDBC连接时通过url参数直接指定：characterEncoding=zhs16gbk。 zhs16gbk gb18030 gb18030 gsql连接时数据库自动获取locale取值。 JDBC连接时通过url参数直接指定：characterEncoding=gb18030。 gb18030 zhs16gbk gbk gsql不支持该设置。 JDBC连接时通过url参数直接指定characterEncoding=zhs16gbk。 zhs16gbk gb18030-2022 gb18030 gsql连接时，用户手动执行：set client_encoding = gb18030_2022。 JDBC连接时通过url参数直接指定：characterEncoding=gb18030_2022。 gb18030-2022 zhs16gbk gbk gsql不支持该设置。 JDBC连接时通过url参数直接指定characterEncoding=zhs16gbk。 gb18030 utf8 utf8 数据库自动获取locale取值。 utf8 gb18030 gb18030 数据库自动获取locale取值。 JDBC连接时通过url参数直接指定：characterEncoding=gb18030。 gb18030_2022 utf8 utf8 数据库自动获取locale取值。 utf8 gb18030_2022 gb18030 gsql连接时，用户手动执行：set client_encoding = gb18030_2022 JDBC连接时通过url参数直接指定：characterEncoding=gb18030_2022 gb18030 gb18030 gb18030 数据库自动获取locale取值。 JDBC连接时通过url参数直接指定：characterEncoding=gb18030。 gb18030_2022 gb18030_2022 gb18030 gsql连接时数据库自动获取locale取值，内部进行处理后自动设置client_encoding = gb18030_2022。 JDBC连接时通过url参数直接指定：characterEncoding=gb18030_2022。 默认值："UTF8" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：请根据前端业务的情况确定。尽量客户端编码和服务器端编码一致，提高效率。建议设置为“SQL_ASCII”或“UTF8”。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

num_internal_lock_partitions 参数说明：控制内部轻量级锁分区的个数。主要用于各类场景的性能调优。 参数内容以关键字和数字的KV方式组织，各个不同类型锁之间以逗号隔开。 先后顺序对设置结果不影响。例如"C LOG _PART=256, CS NLOG_PART=512"等同于"CSNLOG_PART=512,CLOG_PART=256"。 重复设置同一关键字时，以最后一次设置为准。例如"CLOG_PART=256,CLOG_PART=2"，设置的结果为CLOG_PART=2。 参数类型：字符串 参数单位：无 取值范围： CLOG_PART：CLOG文件控制器的个数。最小值为1，最大值为256。 CSNLOG_PART：CSNLOG文件控制器的个数。最小值为1，最大值为512。 LOG2_LOCKTABLE_PART：常规锁表锁分区个数的2对数。最小值4，即锁分区数为16；最大值为16，即锁分区数为65536。 TWOPHASE_PART：两阶段事务锁的分区数。最小值为1，最大值为64。 FASTPATH_PART：每个线程可以不通过主锁表拿锁的最大锁个数。最小值为20，最大值为10000。 默认值："CLOG_PART=256,CSNLOG_PART=512,LOG2_LOCKTABLE_PART=4,TWOPHASE_PART=1,FASTPATH_PART=20" 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议： CLOG_PART：增大该值可以提高CLOG日志写入效率，提升事务提交性能，但是会增大内存使用；减小该值会减少相应内存使用，但可能使得CLOG日志写入冲突变大，影响性能。 CSNLOG_PART：增大该值可以提高CSNLOG日志写入效率，提升事务提交性能，但是会增大内存使用；减小该值会减少相应内存使用，但可能使得CSNLOG日志写入冲突变大，影响性能。 LOG2_LOCKTABLE_PART：增大该值可以提升正常流程常规锁获取锁的并行度，但是会增大内存使用，对于等待事件在LockMgrLock时，可以调大该锁增加性能。 TWOPHASE_PART：调大该值可以提高两阶段事务提交的并发数，但是会增大内存使用。 FASTPATH_PART：对于分区表读取、更新、插入、删除操作且等待事件在LockMgrLock时，可以通过调大该值避免获取LockMgrLock提升性能，建议调整数量大于等于分区数*（1+本地索引数量）+全局索引数量+10，调大该值可能增加锁转移和锁消除时的耗时，并会额外增加内存。fastpath增量内存=((fastpath增加量/20)*8 + fastpath增加量*12) * 线程池大小，单位是字节。 设置不当的风险与影响：设置不当可能会影响数据库性能。

enable_wait_exclusive_lock 参数说明：控制ProcArrayLock的排他锁hang死检测与治愈功能的开关。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启。 off：表示关闭。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

lockwait_timeout 参数说明：控制单个锁的最长等待时间。当申请的锁等待时间超过设定值时，系统会报错。该参数仅针对常规锁生效。 参数类型：整型 参数单位：ms（毫秒） 取值范围：0 ~ 2147483647 默认值：1200000（20min） 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值900，表示lockwait_timeout为900ms；带单位取值20min，表示lockwait_timeout为20min。取值如果要带单位，必须为ms、s、min、h、d。 设置建议：一般设置为默认值。根据业务需要，业务需要锁冲突超过多久，该参数就设置多少。 设置不当的风险与影响：设置过大时，锁冲突造成的阻塞时间更长；设置过小时，可能会出现更多的锁超时报错。

gs_clean_timeout 参数说明： GaussDB数据库 中事务处理使用的是两阶段提交方法，当有两阶段事务残留时，该事务通常会持有表级锁，导致其它连接无法加锁，此时需要调用gs_clean工具对集群中两阶段事务进行清理，gs_clean_timeout是控制Coordinator周期性调用gs_clean的时间。gs_clean也可用来定时清理残留临时表。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 2147483 默认值：60 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如：不带单位取值1，表示gs_clean_timeout为1s；带单位取值1min，表示gs_clean_timeout为1min。取值如果要带单位，必须为s、min、h、d。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过大时，会使两阶段事务和残留临时表清理周期延长，可能导致清理前其他连接无法加锁。

max_pred_locks_per_transaction 参数说明：当数据库连接数达到最大时，每个事务能够持有断定锁的平均数量。 这个参数并不严格限制每个事务最多可以持有多少断定锁。如果连接数没有达到最大值max_connections，那么每个事务能够持有断定锁的平均数量会增大。 参数类型：整型 参数单位：无 取值范围：10 ~ 2147483647‬ 默认值：64 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议： 共享的断定锁表的大小是以假设任意时刻最多只有max_pred_locks_per_transaction*(max_connections+max_prepared_transactions) 个独立的对象需要被锁住为基础进行计算的。不超过设定数量的多个对象可以在任一时刻同时被锁定。当在一个事务里面修改很多不同的表时，可能需要提高这个默认数值。只能在服务器启动的时候设置。 增大这个参数可能导致 GaussDB 请求更多的System V共享内存，有可能超过操作系统的缺省配置。 设置不当的风险与影响：设置过大时，可能导致数据库启动失败。

partition_lock_upgrade_timeout 参数说明：在执行某些查询语句的过程中，需要将分区表上的锁级别由允许读的ExclusiveLock级别升级到读写阻塞的AccessExclusiveLock级别。如果此时已经存在并发的读事务，那么该锁升级操作将阻塞等待。partition_lock_upgrade_timeout为尝试锁升级的等待超时时间。 举例：在分区表上进行MERGE PARTITION和CLUSTER PARTITION操作时，都利用了临时表进行数据重排和文件交换，为了最大程度提高分区上的操作并发度，在数据重排阶段给相关分区加锁ExclusiveLock，在文件交换阶段加锁AccessExclusiveLock。加锁方式是尝试性加锁，加锁成功了则立即返回，不成功则等待50ms后继续下次尝试，加锁超时时间使用会话级设置参数partition_lock_upgrade_timeout。 参数类型：整型 参数单位：s（秒） 取值范围：-1 ~ 3000。-1表示无限等待，即不停的尝试锁升级，直到加锁成功。 默认值：1800 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置为-1时，长时间无法升级锁可能导致业务阻塞。

update_lockwait_timeout 参数说明：在业务允许并发更新的情况下，该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时，系统会报错。该参数仅针对常规锁生效。 参数类型：整型 参数单位：ms（毫秒） 取值范围：0 ~ 2147483647 默认值：120000（2min） 设置方式：该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值900，表示update_lockwait_timeout为900ms；带单位取值2min，表示update_lockwait_timeout为2min。取值如果要带单位，必须为ms、s、min、h、d。 设置建议：设置值主要取决于并发更新同一行的事务的workload。一般TP业务，执行时间较短小于两分钟，因此等待并发更新事务提交时间较短，按默认值2min误报锁超时概率较小；如果业务出现大量并发更新同一行事务，执行时间超过两分钟，可以调大该参数避免等锁超时误报。 设置不当的风险与影响：设置过大时，并发更新同一行时锁冲突造成的阻塞时间更长；设置过小时，可能会出现更多的锁超时报错。

enable_online_ddl_waitlock 参数说明：控制DDL是否会阻塞等待pg_advisory_lock/pgxc_lock_for_backup等集群锁。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启。 off：表示关闭。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：主要用于OM在线操作场景，不建议用户设置。 设置不当的风险与影响：修改该参数取值可能导致集群出现意料之外的结果，请保持默认值。

xloginsert_locks 参数说明：控制用于并发写预写式日志锁的个数。主要用于提高写预写式日志的效率。 参数类型：整型 参数单位：无 取值范围：1 ~ 1000。若CPU为NUMA架构，数值必须为NUMA节点数量的整数倍。 默认值：16 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：ARM CPU架构在并发压力大的场景下，可能因为原子操作的竞争而导致概率性的性能抖动，可以适当降低该参数值而获取相对稳定的运行性能。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

deadlock_timeout 参数说明：设置死锁超时检测时间。当申请的锁超过设定值时，系统会检查是否产生了死锁。该参数仅针对常规锁生效。 参数类型：整型 参数单位：ms（毫秒） 取值范围：1 ~ 2147483647 默认值：1000（即1s） 设置方式：该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。 设置建议： 死锁的检查代价是比较高的，服务器不会在每次等待锁的时候都运行这个过程。在系统运行过程中，不经常出现死锁情况，因此在检查死锁前只需等待一个相对较短的时间。deadlock_timeout增加，可以减少死锁检查浪费的时间，但是会减慢真正的死锁错误报告的速度。在负载过重的服务器上，用户可能需要增大deadlock_timeout。这个值的设置应该超过事务持续时间，这样可以减少在锁释放之前就开始死锁检查的问题。 当设置log_lock_waits为on时，deadlock_timeout决定一个等待时间来将查询执行过程中的锁等待耗时信息写入日志。如果要研究锁延时情况，可以设置deadlock_timeout值比正常情况小。 设置不当的风险与影响：设置过大时，会减慢死锁错误报告的速度；设置过小时，会出现锁释放前就开始检测死锁的问题。

基本语句 在编写PL/SQL过程中，会定义一些变量，给变量赋值，调用其他存储过程等。介绍PL/SQL中的基本语句，包括定义变量、赋值语句、调用语句以及返回语句。 尽量不要在存储过程中调用包含密码的SQL语句，因为存储在数据库中的存储过程文本可能被其他有权限的用户看到，从而导致密码信息泄漏。如果存储过程中包含其他敏感信息，也需要配置存储过程的访问权限，以保证敏感信息不会泄漏。 定义变量 赋值语句 调用语句 父主题： 存储过程

upgrade_mode 参数说明：升级模式。 参数类型：整型 参数单位：无 取值范围：0 ~ 2147483647‬ 0：表示不在升级过程中。 1：表示在就地升级过程中。 2：表示在灰度升级过程中。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：该参数属于升级参数，不建议用户自己修改。推荐使用默认值。 设置不当的风险与影响：严禁升级过程中自行修改该参数，将会导致升级失败且无法回滚的严重问题。非升级场景下，自行修改该参数会导致数据库使用报错或其他不可预知后果。 特殊情况：在使用灰度升级的情况下，若选择策略为大版本升级，即需要执行升级脚本和替换二进制包，会将upgrade_mode设置为2，选择策略为小版本升级，只替换二进制包，则不会设置upgrade_mode设置为2。

om_operation_mode 参数说明：集群处于运维或者正常运行状态。该参数用于内部组件交互，不允许用户使用。 参数类型：枚举类型 参数单位：无 取值范围：‬ upgrade_system_object_mode：表示升级正处于系统对象更新阶段。 running_mode：表示升级正常运行阶段。 默认值：running_mode 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：该参数配置为upgrade_system_object_mode，会导致不能重命名数据库名称。

查询规划 介绍查询优化器方法配置、开销常量、规划算法以及一些配置参数。 优化器中涉及的两个参数： INT_MAX数据类型INT的最大值，其值为2147483647。 DBL_MAX数据类型FLOAT的最大值。 全局设置查询规划相关参数除了客户业务外也会对数据库自身运维和监控业务造成影响，如WDR报告生成、扩容、重分布、数据导入导出等。 优化器方法配置 优化器开销常量 基因查询优化器 其他优化器选项 父主题： GUC参数说明

max_cn_temp_file_size 参数说明：指定SQL语句出错自动重试功能中CN端使用临时文件的最大值，设定为0表示不使用临时文件。 参数类型：整型 参数单位：kB 取值范围：0 ~ 10485760 默认值：5242880（即5GB） 设置方式：该参数属于SIGHUP类型参数，请参考17.2-表 GUC参数分类中对应设置方法进行设置。例如，设置为100，不带单位，表示100kB；设置为16MB，带单位，表示16MB。取值如果要带单位，必须为kB、MB、GB。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

data_sync_retry 参数说明：控制fsync到磁盘失败后是否继续运行数据库。在某些操作系统的场景下，fsync失败后，即使重试阶段再次fsync失败也不会报错，从而导致数据丢失。 参数类型：布尔型 参数单位：无 取值范围： on：表示fsync同步到磁盘失败后采取重试机制，继续运行数据库。 off：表示fsync同步到磁盘失败后直接报panic，停止数据库。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参考17.2-表 GUC参数分类中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

remote_read_mode 参数说明：远程读功能开关。读取主机上的页面失败时，可以从备机上读取对应的页面。 参数类型：枚举类型 参数单位：无 取值范围：off、non_authentication、authentication off：表示关闭远程读功能。 non_authentication：表示开启远程读功能，但不进行证书认证。 authentication：表示开启远程读功能，但要进行证书认证。 默认值：authentication 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

exit_on_error 参数说明：若打开该开关，ERROR级别报错会升级为PANIC报错，从而可以产生core堆栈。主要用于问题定位和业务测试。 参数类型：布尔型 参数单位：无 取值范围： on：表示ERROR级别报错会升级为PANIC报错。 off：表示不会对ERROR级别报错进行升级。 默认值：off 设置方式：该参数属于USERSET类型参数，请参考17.2-表 GUC参数分类中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

restart_after_crash 参数说明：若打开该开关，后端线程崩溃时，GaussDB将自动重新初始化此后端线程。 参数类型：布尔型 参数单位：无 取值范围： on：表示GaussDB能够在后端线程崩溃时自动重新初始化此后端线程。在某些情况（比如当采用管理工具（例如xCAT）管理GaussDB时），能够最大限度地提高数据库的可用性。 off：表示能够使得管理工具在后端线程崩溃时获取控制权并采取适当的措施进行处理。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考17.2-表 GUC参数分类中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

omit_encoding_error 参数说明：若打开该开关，数据库的客户端字符集编码为UTF-8时，出现的字符编码转换错误将打印在日志中，有转换错误的被转换字符会被忽略，以"?"代替。 参数类型：布尔型 参数单位：无 取值范围： on：表示有转换错误的字符将被忽略，以"?"代替，打印错误信息到日志中。 off：表示有转换错误的字符不能被转换，打印错误信息到终端。 默认值：off 设置方式：该参数属于USERSET类型参数，请参考17.2-表 GUC参数分类中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。 该参数通过执行gs_guc reload修改时，如果当前节点上某个session的连接不是来自于客户端，而是来自于该节点所属集群上的其他节点，那么执行gs_guc reload后该参数在该session上不会立即生效，需要与连接节点断开连接后重新连接才会生效。

cn_send_buffer_size 参数说明：指定CN端数据发送数据缓存区的大小。 参数类型：整型 参数单位：kB 取值范围：8 ~ 128 默认值：8 设置方式：该参数属于POSTMASTER类型参数，请参考17.2-表 GUC参数分类中对应设置方法进行设置。例如，设置为100，不带单位，表示100kB；设置为128kB，带单位，表示128kB。取值如果要带单位，必须为kB。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。