TiCDC is TiDB's change data capture framework. It supports replicating change data to various downstreams, including MySQL protocol-compatible databases, message queues via the open CDC protocol and other systems such as local file storage.
See a detailed introduction to the TiCDC architecture.
To check the source code, run test cases and build binaries, you can simply run:
$ make
$ make test
Note that TiCDC supports building with Go version Go >= 1.16
.
When TiCDC is built successfully, you can find binary in the bin
directory. Instructions for unit test and integration test can be found in Running tests.
You can setup a CDC cluster for replication test manually as following:
- Setup a TiDB cluster.
- Start a CDC cluster, which contains one or more CDC servers. The command to start on CDC server is
cdc server --pd https://10.0.10.25:2379
, wherehttps://10.0.10.25:2379
is the client-url of pd-server. - Start a replication changefeed by
cdc cli changefeed create --pd https://10.0.10.25:2379 --start-ts 413105904441098240 --sink-uri mysql:https://root:[email protected]:3306/
. The TSO is TiDBtimestamp oracle
. If it is not provided or set to zero, the TSO of start time will be used. Currently, we support MySQL protocol-compatible databases as downstream sinks only, and will add more sink types in the future.
For details, see Deploy TiCDC.
# Start TiDB cluster
$ docker-compose -f docker-compose-mysql.yml up -d
# Attach to control container to run TiCDC
$ docker exec -it ticdc_controller_1 sh
# Start to feed the changes on the upstream tidb, and sink to the downstream tidb
$ ./cdc cli changefeed create --pd https://upstream-pd:2379 --sink-uri mysql:https://root@downstream-tidb:4000/
# Exit the control container
$ exit
# Load data to the upstream tidb
$ sysbench --mysql-host=127.0.0.1 --mysql-user=root --mysql-port=4000 --mysql-db=test oltp_insert --tables=1 --table-size=100000 prepare
# Check sync progress
$ mysql -h 127.0.0.1 -P 5000 -u root -e "SELECT COUNT(*) FROM test.sbtest1"
Contributions are welcomed and greatly appreciated. See CONTRIBUTING.md for details on submitting patches and the contribution workflow.
TiCDC is under the Apache 2.0 license. See the LICENSE file for details.