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 temporary 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