DCF参数设置
enable_dcf
参数说明：是否开启DCF模式。
参数类型：布尔型
参数单位：无
取值范围：
- on：表示当前日志复制模式为DCF模式。
- off：表示当前日志复制模式为非DCF模式。
默认值：off
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：需要使用DCF日志复制模式时，请将enable_dcf设置为on。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_ssl
参数说明：此参数不再使用，DCF复用GUC参数ssl。详情请参见安全和认证。
参数类型：布尔型
参数单位：无
取值范围：
- on：表示使用SSL。
- off：表示不使用SSL。
默认值：on
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_config
参数说明：DCF数据库实例配置信息，安装阶段由OM配置，安装后不允许修改。
参数类型：字符串
参数单位：无
取值范围：字符串
默认值：安装时由OM配置。
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：该参数不允许用户进行设置，只能查看。
设置不当的风险与影响：无
dcf_data_path
参数说明：DCF数据路径，安装阶段由OM配置，安装后不允许修改。
参数类型：字符串
参数单位：无
取值范围：合法目录路径。
默认值：DN数据目录下的dcf_data目录。
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：该参数不允许用户进行设置，只能查看。
设置不当的风险与影响：无
dcf_log_path
参数说明：DCF日志路径，安装阶段由OM配置，安装后不允许修改。
参数类型：字符串
参数单位：无
取值范围：合法目录路径。
默认值：DN数据目录下的dcf_log目录。
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：该参数不允许用户进行设置，只能查看。
设置不当的风险与影响：无
dcf_node_id
参数说明：DCF所在DN节点ID，用户安装和模式切换时自定义。
参数类型：整型
参数单位：无
取值范围：1 ~ 2147483647
默认值：安装时用户自定义配置。
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_max_workers
参数说明：DCF回调函数线程最大个数。DCF通过回调函数调用到DN向DCF注册的函数时，需要申请共享内存以及信号量等。
参数类型：整型
参数单位：个
取值范围：0 ~ 262143
默认值：40
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致资源不足，集群安装失败。
dcf_truncate_threshold
参数说明：DN对DCF日志进行truncate的门限阈值。
参数类型：整型
参数单位：无
取值范围：1 ~ 2147483647
默认值：100000
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：阈值过大可能会导致日志长期不被truncate从而挤占内存。
dcf_election_timeout
参数说明：DCF leader和follower选举超时时间。选举超时时间数值依赖于当前DN之间的网络状况，在超时时间较小且网络极差的情形下，会有超时选举发生，待网络恢复选举恢复正常。建议根据当前网络状态合理设置超时时间。对DCF节点时钟的约束：DCF节点间最大时钟差异小于选举超时时间的一半。在DCF手动选举模式下，为了不影响CM及时仲裁选举，禁止对该参数配置修改，按默认选举超时时间设置即可。
参数类型：整型
参数单位：秒（s）
取值范围：1 ~ 600
默认值：3
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值60，表示dcf_election_timeout为60s；带单位取值1min，表示dcf_election_timeout为1min（60s）。取值如果要加上单位，必须为“s”，“min”。
设置建议：根据当前网络状态合理设置超时时间。
设置不当的风险与影响：网络环境不佳且超时时间较小的情况下，可能会发生超时选举。
dcf_enable_auto_election_priority
参数说明：DCF优先级选主是否允许内部自动调整优先级值。
参数类型：整型
参数单位：无
取值范围：
- 0：表示不允许。
- 1：表示允许内部自动调整。
默认值：1
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_election_switch_threshold
参数说明：DCF防频繁切主门限。推荐根据用户业务可接受的最大故障时间配置。
参数类型：整型
参数单位：秒（s）
取值范围：0 ~ 2147483647
默认值：0
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。
设置建议：根据业务可接受的最大故障时间配置。
设置不当的风险与影响：设置过大可能会导致业务长时间不可用。
dcf_run_mode
参数说明：DCF选举模式。包含自动选举模式、手动选举模式和去使能选举模式。目前去使能选举模式只限定少数派恢复场景使用，修改会导致数据库实例不可用。
实例在正常状态下进行工作模式切换才能保证切换后工作正常。GUC参数设置和cm_ctl设置的DCF工作模式需要保持一致，即两者需要同步设置为DCF手动或自动模式。
cm_ctl set --param --server -k dn_arbitrate_mode=quorum cm_ctl reload --param --server gs_guc reload -Z datanode -I all -N all -c "dcf_run_mode=1"
cm_ctl set --param --server -k dn_arbitrate_mode=paxos cm_ctl reload --param --server gs_guc reload -Z datanode -I all -N all -c "dcf_run_mode=0"
参数类型：枚举类型
参数单位：无
取值范围：0、1、2
- 0：表示自动选举模式。
- 1：表示手动选举模式。
- 2：表示去使能选举模式。
默认值：1
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：目前去使能选举模式只限定少数派恢复场景使用，修改会导致数据库实例不可用。
dcf_log_level
参数说明：DCF日志级别。
参数类型：字符串
参数单位：无
取值范围：
- 关闭日志：“NONE”，NONE表示关闭日志打印，不能与以下日志级别混合使用。
- 开启日志：“RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER”
日志级别可以从上述字符串中选取字符串并使用竖线组合使用，不能配置空字符串。
默认值："RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE"
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：日志级别设置过低可能会导致日志信息缺失。
dcf_log_backup_file_count
参数说明：DCF运行日志备份保留个数。
参数类型：整型
参数单位：个
取值范围：1 ~ 1000
默认值：100
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设定值过小会导致备份较少、日志丢失。
dcf_max_log_file_size
参数说明：DCF运行日志单个文件最大大小。
参数类型：整型
参数单位：MB
取值范围：1 ~ 1000
默认值：10
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值10，表示dcf_max_log_file_size为10MB；带单位取值10MB，表示dcf_max_log_file_size为10MB。取值如果要加上单位，必须为“MB”。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致单个日志文件打开、查询效率降低。
dcf_socket_timeout
参数说明：DCF通信模块连接socket超时时间，参数重启生效。对于网络环境比较差的环境，若配置很小的超时时间，可能会导致建立连接不成功，此时需要适当增大此值。
参数类型：整型
参数单位：毫秒（ms）
取值范围：10 ~ 600000（10min）
默认值：5000
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值5000，表示dcf_socket_timeout为5000ms；带单位取值1min，表示dcf_socket_timeout为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”。
设置建议：推荐使用默认值。
设置不当的风险与影响：网络环境不佳时，配置过小的超时时间可能导致建立连接不成功。
dcf_connect_timeout
参数说明：DCF通信模块建立连接超时时间，参数重启生效。对于网络环境比较差的环境，若配置很小的超时时间，可能会导致建立连接不成功，此时需要适当增大此值。
参数类型：整型
参数单位：毫秒（ms）
取值范围：10 ~ 600000（10min）
默认值：60000
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值5000，表示dcf_connect_timeout为5000ms；带单位取值1min，表示dcf_connect_timeout为1min（60000ms）。取值如果要加上单位，必须为“ms”，“s”，“min”。
设置建议：推荐使用默认值。
设置不当的风险与影响：网络环境不佳时，配置过小的超时时间可能导致建立连接不成功。
dcf_mec_fragment_size
参数说明：DCF通信模块fragment大小，参数重启生效。
参数类型：整型
参数单位：kB
取值范围：32 ~ 10240
默认值：64
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_stg_pool_max_size
参数说明：DCF存储模块内存池最大值，参数重启生效。
参数类型：整型
参数单位：MB
取值范围：32 ~ 2147483647
默认值：2048
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值2048，表示dcf_stg_pool_max_size为2048MB；带单位取值5GB，表示dcf_stg_pool_max_size为5GB（5120MB）。取值如果要加上单位，必须为“MB”、“GB”。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致内存资源紧张，设置过小可能会导致存储模块资源不足。
dcf_stg_pool_init_size
参数说明：DCF存储模块内存池最小值，参数重启生效。
参数类型：整型
参数单位：MB
取值范围：32 ~ 2147483647
默认值：32
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值2048，表示dcf_stg_pool_init_size为2048MB；带单位取值5GB，表示dcf_stg_pool_init_size为5GB（5120MB）。取值如果要加上单位，必须为“MB”、“GB”。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致内存资源紧张，设置过小可能会导致存储模块资源不足。
dcf_mec_pool_max_size
参数说明：DCF通信模块内存池最大值，参数重启生效。
参数类型：整型
参数单位：MB
取值范围：32 ~ 2147483647
默认值：200
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值2048，表示dcf_mec_pool_max_size为2048MB；带单位取值5GB，表示dcf_mec_pool_max_size为5GB（5120MB）。取值如果要加上单位，必须为“MB”、“GB”。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致内存资源紧张，设置过小可能会导致通信模块资源不足。
dcf_flow_control_disk_rawait_threshold
参数说明：DCF流控功能的磁盘等待阈值。
参数类型：整型
参数单位：微秒（us）
取值范围：0 ~ 2147483647
默认值：100000
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致性能劣化，内存升高。
dcf_flow_control_net_queue_message_num_threshold
参数说明：DCF流控功能的网络队列消息数阈值。
参数类型：整型
参数单位：无
取值范围：0 ~ 2147483647
默认值：1024
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过小可能会导致性能劣化严重。
dcf_flow_control_cpu_threshold
参数说明：DCF CPU流控阈值。
参数类型：整型
参数单位：无
取值范围：0 ~ 2147483647
默认值：100
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过小可能会导致性能劣化严重。
dcf_mec_batch_size
参数说明：DCF通信批量消息数，数值为0时，DCF会根据网络以及写入数据量自适应调整，参数重启生效。
参数类型：整型
参数单位：无
取值范围：0 ~ 1024
默认值：0
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过小会导致节点间通信效率下降。
dcf_mem_pool_max_size
参数说明：DCF内存最大值，参数重启生效。
参数类型：整型
参数单位：MB
取值范围：32 ~ 2147483647
默认值：2048
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值2048，表示dcf_mem_pool_max_size为2048MB；带单位取值5GB，表示dcf_mem_pool_max_size为5GB（5120MB）。取值如果要加上单位，必须为“MB”、“GB”。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过小会导致集群安装失败。
dcf_mem_pool_init_size
参数说明：DCF内存初始化大小，参数重启生效。
参数类型：整型
参数单位：MB
取值范围：32 ~ 2147483647
默认值：32
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值2048，表示dcf_mem_pool_init_size为2048MB；带单位取值5GB，表示dcf_mem_pool_init_size为5GB（5120MB）。取值如果要加上单位，必须为“MB”、“GB”。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过小会导致集群安装失败。
dcf_compress_algorithm
参数说明：DCF运行日志传输压缩算法。
参数类型：整型
参数单位：无
取值范围：
- 0：表示不压缩。
- 1：表示LZ4压缩算法。
默认值：0
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：如果需要开启LZ4压缩算法，则将dcf_compress_algorithm置为1。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_compress_level
参数说明：DCF日志传输压缩级别，此参数生效前提必须配置有效的压缩算法，即设置合法的dcf_compress_algorithm参数。
参数类型：整型
参数单位：无
取值范围：1 ~ 22。若不开启压缩，配置的压缩级别将不生效。
默认值：1
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_mec_channel_num
参数说明：DCF通信通道数量，参数重启生效。
参数类型：整型
参数单位：个
取值范围：1 ~ 64
默认值：1
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过小可能会导致节点间通信效率下降。
dcf_rep_append_thread_num
参数说明：DCF日志复制线程数量，参数重启生效。
参数类型：整型
参数单位：个
取值范围：1 ~ 1000
默认值：2
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致线程空闲，资源利用率下降。
dcf_mec_agent_thread_num
参数说明：DCF通信工作线程数量，参数重启生效。dcf_mec_agent_thread_num值建议不少于2*节点数*dcf_mec_channel_num。
参数类型：整型
参数单位：个
取值范围：1 ~ 1000
默认值：10
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：建议不少于2*节点数*dcf_mec_channel_num。
设置不当的风险与影响：设置过大可能会导致线程空闲，资源利用率下降。
dcf_mec_reactor_thread_num
参数说明：DCF使用reactor线程数量，参数重启生效。dcf_mec_reactor_thread_num与dcf_mec_agent_thread_num比例建议为1:40。
参数类型：整型
参数单位：个
取值范围：1 ~ 100
默认值：1
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：dcf_mec_reactor_thread_num与dcf_mec_agent_thread_num比例建议为1:40。
设置不当的风险与影响：设置过大可能会导致线程空闲，资源利用率下降。
dcf_log_file_permission
参数说明：DCF运行日志文件属性，参数重启生效，参数安装阶段配置，后续不支持修改。若用户需要支持同组的其他用户访问日志，首先需要所有的父目录都支持同组的其他用户也能访问。即若参数dcf_log_path_permission配置为750，dcf_log_file_permission只能为600或者640。若参数dcf_log_path_permission配置为700，dcf_log_file_permission只能为600。
参数类型：枚举类型
参数单位：无
取值范围：600、640
默认值：600
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：dcf_log_path_permission的权限需要大于dcf_log_file_permission。
设置不当的风险与影响：设置不当可能导致用户无法访问。
dcf_log_path_permission
参数说明：DCF运行日志目录属性，参数重启生效，参数安装阶段配置，后续不支持修改。若用户需要支持同组的其他用户访问日志路径，需选择参数750，否则选择700。
参数类型：枚举类型
参数单位：无
取值范围：700、750
默认值：700
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。
设置建议：若用户需要支持同组的其他用户访问日志路径，需选择参数750，否则选择700。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_majority_groups
参数说明：DCF策略化多数派功能设置。对于需要配置此参数的group，该group内至少有一台备机收到日志。即该group内存在一台同步备机。若对DCF实例内做了增删节点或者对实例内节点group值进行了调整修改，需同步修改此配置。修改此参数时需保证group数值实际存在且有效。
参数类型：字符串
参数单位：无
取值范围：
- 关闭：""，空字符串表示策略化多数派功能关闭。
- 开启： 配置有效的group值，使用逗号分隔，group值需在dcf_config中存在。例如将group值分别为1和2，加入DCF的策略化多数派配置时，可以设置为"1,2"；若配置了dcf_config中不存在的group值或者其他字符，DCF将认为该配置的group无效。
默认值：""
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
若配置了参数后某一group内所有节点均故障，在对其中某个节点做涉及节点build相关操作（节点修复、不换ip的节点替换）时，需要将该group从此参数列表中移除，待节点恢复正常后可将该group再次配置到此参数。
dcf_node_id_map
参数说明：DN备机名称与DCF node_id映射字典，参数重启生效，参数需要在安装阶段配置，后续不支持修改。在DCF数据库实例安装、升级、节点替换场景会涉及使用此参数。GUC参数synchronous_standby_names中配置的standby_name需包含在此字典内。
参数类型：字符串
参数单位：无
取值范围：配置格式例如：'standby_name1:dcf_node_id1,standby_name2:dcf_node_id2'，DN备机名称对应的DCF node_id数值，且使用逗号分隔。
默认值：""
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置不当可能会导致集群安装、升级失败。
dcf_candidate_names
参数说明：DCF候选者列表参数。即有可能被选为主机的DN节点名称。DCF自动模式下选举策略受此参数控制，不在此列表内的DN无法当选为主机。
参数类型：字符串
参数单位：无
取值范围：配置格式例如：'dn_name1,dn_name2,dn_name3'。参数依赖dcf_node_id_map，DN名称必须位于dcf_node_id_map中，且使用逗号分隔。
默认值：""
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_thread_effective_time
参数说明：DCF刷盘线程存活有效时间。参数用于判断磁盘是否处于I/O hang，若超过此时间DCF控制日志无法刷新，无法访问I/O资源则认为线程I/O hang，则会触发降备动作。参数配置为0表示关闭I/O hang检测。
参数类型：整型
参数单位：秒（s）
取值范围：0 ~ 1000
默认值：160
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。
dcf_pri_leader_timeout
参数说明：优先级选主超时时间。DCF自动模式下，开启优先级选主功能后，备机触发优先级选主，如果超出此超时时间仍然未当选为主，则放弃此轮选举。参数配置为0表示优先级选主会一直等待选举成功为止。
参数类型：整型
参数单位：秒（s）
取值范围：0 ~ 3600
默认值：60
设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致集群长时间处于无主状态。
dcf_static_leader_timeout
参数说明：优选旧主超时时间。DCF自动模式下，重启数据库实例后优先选举旧主为新主，超出此超时时间仍然未成功则放弃此轮选举。
参数类型：整型
参数单位：秒（s）
取值范围：0 ~ 600
默认值：60
设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值不能带单位。
设置建议：推荐使用默认值。
设置不当的风险与影响：设置过大可能会导致集群长时间处于无主状态。
