Skip to main content

Configuration Instructions

This document provides the configurations that need to be adjusted or paid attention to when using CCR.

FE Configuration​

Configured in fe.conf, for example, restore_reset_index_id = true.

NameDescriptionDefault ValueVersion
restore_reset_index_idIf inverted index or bitmap index is used in the synchronized table, it should be set to false.falseStarting from 2.1.8 and 3.0.4.
ignore_backup_tmp_partitionsTo avoid synchronization interruption caused by upstream creating tmp partition, it should be set to true.falseStarting from 2.1.8 and 3.0.4.
max_backup_restore_job_num_per_dbLimit on the number of backup/restore jobs per DB in memory, it is recommended to set it to 2.10All versions.
label_num_thresholdControls the number of TXN Labels to prevent transaction recovery from being too fast; too large may occupy more memory, too small may cause data duplication in exceptional situations, the default value is sufficient in most cases.2000Starting from 2.1.
restore_job_compressed_serializationIt is recommended to configure as true when the number of tablets exceeds 100,000.
Before downgrading, turn off the configuration and ensure FE completes a checkpoint.
When upgrading from 2.1 to 3.0, at least upgrade to 3.0.3.
falseStarting from 2.1.8 and 3.0.3.
backup_job_compressed_serializationIt is recommended to configure as true when the number of tablets exceeds 100,000.
Before downgrading, turn off the configuration and ensure FE completes a checkpoint.
When upgrading from 2.1 to 3.0, at least upgrade to 3.0.3.
falseStarting from 2.1.8 and 3.0.3.
backup_job_default_timeout_msTimeout for backup/restore jobs, both source and target cluster FE need to be configured.NoneSet according to requirements
enable_restore_snapshot_rpc_compressionEnable snapshot info compression to reduce RPC message size, it is recommended to set it to true.trueStarting from 2.1.8 and 3.0.3.

BE​

Configured in be.conf, for example, thrift_max_message_size = 2000000000.

NameDescriptionDefault ValueVersion
thrift_max_message_sizeBE thrift server single RPC packet limit, it is recommended to set to 2000000000 when the number of tablets involved in CCR jobs is large.100MBAll versions
be_thrift_max_pkg_bytesBE Thrift RPC message package size limit.20MBSpecific to 2.0.
max_download_speed_kbpsDownload speed limit for each download worker in downstream BE, default is 50MB/s per thread.50MB/sAll versions
download_worker_countNumber of threads for download jobs, set according to network card, disk, and load.1All versions

Table Attributes​

Set in Create Table or Alter Table.

NameDescriptionDefault ValueVersion
binlog.max_bytesMaximum memory usage for binlog, it is recommended to keep at least 4GB.UnlimitedAll versions
binlog.ttl_secondsRetention time for binlog.Unlimited before 2.0.5, starting from 2.0.5 it is 1 day (86400)All versions