华为云用户手册

log_line_prefix 参数说明：控制每条日志信息的前缀格式。日志前缀类似于printf风格的字符串，在日志的每行开头输出。用以%为开头的“转义字符”表示状态信息，具体请参见表1。 表1 转义字符表 转义字符 状态信息 %a 应用程序名称。 %u 用户名。 %d 数据库名。 %r 远端主机名或者IP地址以及远端端口，在不启动log_hostname时显示IP地址及远端端口。 %h 远端主机名或者IP地址，在不启动log_hostname时只显示IP地址。 %p 线程ID。 %t 时间戳（不带毫秒）。 %m 带毫秒的时间戳。 %n 表示指定错误上报的节点。 %i 命令标签：会话当前执行的命令类型。 %e SQLSTATE错误码。 %c 会话ID，详见说明。 %l 每个会话或线程的日志编号，从1开始。 %s 线程启动时间。 %v 虚拟事务ID（backendID/ localXID） %x 事务ID（0表示没有分配事务ID）。 %q 不产生任何输出。如果当前线程是后端线程，忽略这个转义序列，继续处理后面的转义序列；如果当前线程不是后端线程，忽略这个转义序列和它后面的所有转义序列。 %S 会话ID。 %T Trace ID。 %% 字符%。 转义字符%c打印的会话ID，由两个4字节的十六进制数组成，通过字符“.”分开。这两个十六进制数分别表示线程的启动时间及线程编号，所以%c也可以用作一种更节省空间的记录线程启动时间和编号的方式。比如，可以用下面的查询从pg_stat_activity中生成这种十六进制的会话ID： 1 2 3 SELECT to_hex(EXTRACT(EPOCH FROM backend_start)::integer) || '.' || to_hex(pid) FROM pg_stat_activity; 当log_line_prefix设置为非空值时，需要保证最后一个字符是一个空格，以此来直观地与后续的日志行进行区分，也可以使用一个标点符号。 Syslog会生成时间戳及线程ID信息，所以当登录日志时，不需要包含这些转义字符。 参数类型：字符串 参数单位：无 取值范围：字符串 默认值：%m %n %u %d %h %p %S %x %a %m %n %u %d %h %p %S %x %a 表示会话开始时间戳、错误上报节点、用户名、数据库名、远程主机名或IP、线程ID、会话ID、事务ID、应用程序名称。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据对日志状态信息的需求进行设置。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

debug_pretty_print 参数说明：打开此参数会对debug_print_parse、debug_print_rewritten和debug_print_plan产生的日志进行缩进，会生成易读且更长的输出格式。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：表示进行缩进。 off：表示不进行缩进。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

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

debug_print_plan 参数说明：用于设置是否将查询的执行计划打印到日志中。 参数类型：布尔型 参数单位：无 取值范围： on：表示将查询的执行计划打印到日志中。 off：表示不将查询的执行计划打印到日志中。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。 只有当日志的级别为log及以上时，debug_print_parse、debug_print_rewritten和debug_print_plan的调试信息才会输出。当这些选项打开时，调试信息只会记录在服务器的日志中，而不会输出到客户端的日志中。通过设置client_min_messages和log_min_messages参数可以改变日志级别。 在打开debug_print_plan开关的情况下需尽量避免调用gs_encrypt_aes128及gs_decrypt_aes128函数，避免敏感参数信息在日志中泄露的风险。同时建议用户在打开debug_print_plan开关生成的日志中对gs_encrypt_aes128及gs_decrypt_aes128函数的参数信息进行过滤后再提供给外部维护人员定位，日志使用完成后请及时删除。

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

count(*)和count(column)的区别是什么？ 答：count()函数用于计算行数的聚合函数，区别如下： count(*)统计包括了所有列的行数，在统计结果时不会忽略值为NULL的数据。 count(column)只包括列名那一列，在统计结果时会忽略值为NULL的数据。 --建表并插入数据。 gaussdb=# CREATE TABLE test(c1 int); gaussdb=# INSERT INTO test VALUES(1),(2),(3); gaussdb=# INSERT INTO test VALUES(NULL); --count(*)统计行数,不忽略值为NULL的数据。 gaussdb=# SELECT count(*) FROM test; count ------- 4 (1 row) --count(column)统计行数,忽略值为NULL的数据。 gaussdb=# SELECT count(c1) from test; count ------- 3 (1 row) --删除。 gaussdb=# DROP TABLE test; 父主题： FAQ

config_file 参数说明：设置主服务器配置文件名称（gaussdb.conf）。 参数类型：字符串 参数单位：无 取值范围：长度大于0的字符串。 默认值：gaussdb.conf（实际安装可能带有绝对目录）。 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

ident_file 参数说明：设置用于客户端认证的配置文件的名称（gs_ident.conf），仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：长度大于0的字符串。 默认值：gs_ident.conf（实际安装可能带有绝对目录）。 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：不建议修改配置文件参数。 设置不当的风险与影响：修改后可能会影响数据库实例升级、备份功能。

external_pid_file 参数说明：声明可被服务器管理程序使用的额外PID文件，仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：合法文件名称。 默认值："" 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 该参数只能在数据库服务重新启动后生效。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

data_directory 参数说明：设置 GaussDB 的数据目录（data目录），仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：合法目录路径。 默认值：安装时指定，如果在安装时不指定，则默认不初始化数据库。 设置方式：此参数可以通过如下方式设置： 在安装GaussDB时设置。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

hba_file 参数说明：设置基于主机认证（HBA）的配置文件（gs_hba.conf）。此参数只能在配置文件gaussdb.conf中指定，仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：长度大于0的字符串。 默认值：gs_hba.conf（实际安装可能带有绝对目录）。 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：不建议修改配置文件参数。 设置不当的风险与影响：修改后可能会影响数据库实例升级、备份功能。

ai_watchdog_oom_malloc_failures 参数说明：容忍的最大连续内存分配失败数量，超过该数量可能会触发OOM探测功能。 参数类型：整型 参数单位：个 取值范围：1 ~ 32000 默认值：50 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过小，会导致频繁报警；设置过大，会导致无法及时发现异常。

ai_watchdog_wait_time 参数说明：为了避免数据库频繁进行自愈操作，会在数据库启动后一段时间进行等待，该值即用来调整等待时间。 参数类型：整型 参数单位：秒（s） 取值范围：0 ~ 36000 默认值：1800 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过小，可能会导致数据库刚启动时误报；设置过大，可能会导致无法发现等待时间内的异常。

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

ai_watchdog_warning_retention 参数说明：AI Watchdog在dbe_perf.ai_watchdog_detection_warnings视图中保留的告警记录数上限。 参数类型：整型 参数单位：个 取值范围：0 ~ 32000 默认值：20 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

ai_watchdog_max_cpu_usage 参数说明：预期的数据库CPU使用率上限，该值会根据多核情况进行归一化。该参数值设置为0时，表示不判断CPU使用率情况。 参数类型：浮点型 参数单位：无 取值范围：0 ~ 1 默认值：0.8 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过大，可能会导致无法及时发现异常。

ai_watchdog_oom_process_threshold 参数说明：预期的数据库进程使用占max_process_memory的使用比例，到达该阈值时，会触发内存泄漏判断。 参数类型：浮点型 参数单位：无 取值范围：0 ~ 10 默认值：分为以下2种情况： 如果该参数是通过OM安装进行设置，其默认值为1； 如果该参数不通过OM安装进行设置，其默认值为1.1。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

ai_watchdog_tolerance_times 参数说明：AI Watchdog启动自愈前最多能容忍多少次连续异常事件，通过该参数可以避免错误操作。 参数类型：整型 参数单位：次 取值范围：0 ~ 100 默认值：4 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

ai_watchdog_oom_other_used_memory_threshold 参数说明：预期的数据库的其他部分内存使用上限。 参数类型：整型 参数单位：MB 取值范围：-1 ~ 1048576 默认值：分为以下2种情况： 如果该参数是通过OM安装进行设置，其默认值为-1； 当参数值为-1时，对其他部分内存使用上限按照如下规则判断是否发生泄露： 若max_process_memory小于300GB，则其他部分内存使用上限为20GB； 若max_process_memory大于等于300GB小于600GB，则其他部分内存使用上限为40GB； 若max_process_memory大于等于600GB，则其他部分内存使用上限为60GB。 若用户未采用默认值-1，则其他部分内存使用上限将采用用户设置的参数。 如果该参数不通过OM安装进行设置，其默认值为20480。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过小，会导致频繁报警；设置过大，会导致无法及时发现异常。

ai_watchdog_rto_restriction_time 参数说明：AI Watchdog自愈功能的RTO限制，超过该RTO阈值，则不进行自愈操作。 参数类型：整型 参数单位：秒（s） 取值范围：0 ~ 36000 默认值：600 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

feedback_model_expired_time 参数说明：该参数用于设置基数反馈模型超时时间，过期的模型会定期被清理。 参数类型：整型 参数单位：毫秒（ms） 取值范围：500 ~ 2147483647 默认值：86400000（即1d） 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值6000，表示feedback_model_expired_time为6000ms；带单位取值1min，表示feedback_model_expired_time为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”，“h”，“d”。 设置建议：推荐使用默认值。 设置不当的风险与影响：如果超时时间设置过长会造成系统性能下降；如果设置过短会导致模型被清理频率过高而影响功能。

adaptive_cost_min_time 参数说明：该参数用于设置基数反馈收集的SQL时间阈值，只有执行时间大于该值的语句反馈会被收集。该参数可在PDB级别设置。 参数类型：整型 参数单位：毫秒（ms） 取值范围：0 ~ 2147483647 默认值：1000。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值6000，表示adaptive_cost_min_time为6000ms；带单位取值1min，表示adaptive_cost_min_time为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”，“h”，“d”。 设置建议：建议设置为需要调优的慢查询执行时长的20%。 设置不当的风险与影响：如果时间参数设置过短，最严重造成1-2%系统性能下降；如果设置过长则会导致能够被自动调优的查询不在功能生效范围内。

maximal_feedback_model_num 参数说明：该参数用于设置基数反馈模型数量上限，超过此上限后不再训练新的模型。 参数类型：整型 参数单位：个 取值范围：-1 ~ 1000000。值为-1表示无上限。 默认值：10000 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：如果基数反馈模型数量上限设置过小，可能会因无法训练新的模型而导致反馈基数估计功能失效；如果数量上限设置过大，可能会占用过多的磁盘空间，造成性能下降。

adaptive_cardest_strategy 参数说明：该参数用于设置选择基数估计模型偏好。该参数可在PDB级别设置。 参数类型：枚举类型 参数单位：无 取值范围："auto"、"use_statistics"、"use_feedback" "auto"：自适应模式，自动根据估计的历史准确性判断是使用统计方法还是反馈方法。 "use_statistics"：优先使用统计信息做基数估计。 "use_feedback"：优先使用反馈模型做基数估计。 默认值："auto"。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：运行过程中修改该参数有计划劣化风险。

enable_ai_watchdog_forcible_oom_detection 参数说明：强制开启或关闭AI Watchdog的OOM探测功能，若关闭该参数，则会自动根据当前数据库的规格判断是否需要启动OOM探测功能。自动判断模式下，对于max_process_memory设置为64GB及以上的场景，才会启动OOM探测功能。由于OOM探测功能依赖内存管理模块获取的信息，因此，如果内存管理模块未开启或失效，则OOM探测功能也不会启用。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启。 off：表示关闭。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：功能打开会占用系统资源。

enable_feedback_cardest 参数说明：该参数为另外设置的基于反馈的优化器基数和代价矫正功能的开关，用于开发人员诊断模型相关问题。当enable_adaptive_cost参数设置为off，该参数设置为on时，算子信息仍会被收集，反馈基数估计接口仍会被调用，但此时后端自动模型维护的线程不会被启用，开发人员可以通过gs_acm_analyze_workload_manual()函数手动训练模型诊断问题。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：算子信息会被收集，且反馈基数估计接口仍会被调用，但后端自动模型维护的线程并不会被启用。 off：控制完全交由enable_adaptive_cost参数控制。 默认值： on：新安装的数据库的默认值 off：505.1.0版本之前的数据库升级后的默认值 在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

feedback_collection_expired_time 参数说明：该参数用于设置基数反馈模型超时时间，过期的算子模型会定期被清理。 参数类型：整型 参数单位：毫秒（ms） 取值范围：50 ~ 2147483647 默认值：3600000（即1h） 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值6000，表示feedback_collection_expired_time为6000ms；带单位取值1min，表示feedback_collection_expired_time为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”，“h”，“d”。 设置建议：推荐使用默认值。 设置不当的风险与影响：如果超时时间设置过长会造成系统性能下降；如果设置过短会导致反馈数据被清理频率过高而影响功能。

adaptive_costest_strategy 参数说明：该参数用于设置代价评估使用新/旧代价的策略。该参数可在PDB级别设置。 参数类型：枚举类型 参数单位：无 取值范围： L0：只有在基数估计正确（比如使用反馈基数估计）的时候才会触发新代价。 L1：优先使用新的代价模型计算。 默认值：L0。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议设置为默认值，推荐只在session或者hint内修改该参数设置。 设置不当的风险与影响：参数设置为L1时有严重的计划劣化风险。

adaptive_costmodel_calibration_interval 参数说明：该参数用于设置代价模型矫正逻辑的间隔时间。 参数类型：整型 参数单位：毫秒（ms） 取值范围：0 ~ 2147483647。0表示关闭自动触发代价模型矫正功能。 默认值：3600000（即1h） 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值6000，表示adaptive_costmodel_calibration_interval为6000ms；带单位取值1min，表示adaptive_costmodel_calibration_interval为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”，“h”，“d”。 设置建议：推荐使用默认值。 设置不当的风险与影响：如果该参数设置过小会导致代价模型经常触发矫正功能从而造成系统性能劣化；如果设置过大会导致模型矫正不及时从而使功能优化效果不佳。

unix_socket_directory 参数说明：用于指定unix_socket通信方式中，文件存放的路径。此参数只能在配置文件gaussdb.conf中指定。在启动fenced模式前需要设定该GUC参数。 参数类型：字符串 参数单位：无 取值范围：合法目录路径。 默认值："" 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。