【TcaplusDB知识库】TcaplusDB-tcapulogmgr工具介绍（一）

tcapulogmgr主要用于对binlog进行操作，在数据回档时，如果需要回档到精确时间点，就需要使用该工具来达到目的。进入工具所在目录，执行 ./tcapulogmgr -h 即可获得各个子命令的介绍与用法，tcapulogmgr工具支持以下命令：

• 1. query

• 1. listfile

• 1. restorealldatafiles

• 1. updatefields

注意：

1. 在使用工具时，工具的版本必须和svr的版本一致

2. 在复制或备份引擎文件时，必须先正确停止对应的svr进程

3. 在使用工具对引擎文件或ulog文件进行操作前，请注意备份

4. 建议将命令需要的文件与工具置于同一目录下，或使用绝对路径的方式指定文件

1. query

query命令用于查询binlog流水，命令格式为 ./tcapulogmgr query -d dirtory -f file -b tbus_id [-a app_id -z zone_id -t table_name -s shard_id --keyonly --startseq startseq --endseq endseq --starttime starttime --endtime endtime]，其中，前三个必填参数的含义分别为：

• -d 表示binlog文件所在的目录

• -f 表示要查询的binlog文件

• -b 表示tbus id，实际上就是生成该binlog文件的tcapsvr进程的进程id， 如1.2.2.1

方括号中的可选参数可用于过滤，其含义如下：

• -a 表示业务id

• -z 表示区服id

• -t 表示数据表名

• -s 表示shard id

• --keyonly 表示只查询key字段

• --startseq 表示起始的binlog记录序列号

• --endseq 表示结束的binlog记录序列号

• --starttime 表示binlog记录起始时间，格式为YYYYMMDDHHMMSS

• --endtime 表示binlog记录结束时间，格式为YYYYMMDDHHMMSS

需要注意的是，如果要根据业务id，区服id，数据表名和shard id来过滤的话，那么这个四个参数都必须给出，否则无法按要求进行过滤。

示例：./tcapulogmgr query -d /data/tcaplus/data/ulog/1.2.2.1 -f tcapsvr_1.2.2.1_00000661.ulog -b 1.2.2.1 -a 2 -z 3 -t table_generic -s 304

2. listfile

listfile命令用于输出binlog的文件信息，包括文件名，最小序列号，最大序列号等，命令格式为 ./tcapulogmgr listfile -d directory -b tbus_id [--startseq startseq --endseq endseq]，各个参数的含义与query命令相同。

示例：./tcapulogmgr listfile -d /data/tcaplus/data/ulog/1.2.2.1 -b 1.2.2.1

3. restorealldatafiles

restorealldatafiles命令用于将指定svr上的所有数据回档到指定时间点，通常适用于使用冷备文件与binlog进行回档的场景。命令格式为 ./tcapulogmgr restorealldatafiles --directory= --tbusid= --engine-directory= [--endtime= --seqcontinuous]，其中，前三个必填参数的含义分别为：

• --directory 表示ulog所在的目录

• --tbusid 表示要执行回档操作的svr_id，用于从directory中过滤出对应的ulog文件

• --engine-directory 表示冷备文件存放的目录

方括号中的参数为可选项：

• --endtime 表示要回档到的时间点，格式为YYYYMMDDHHMMSSmmm，mmm表示毫秒

• --seqcontinuous 表示binlog的序号必须连续，不连续则报错

示例：./tcapulogmgr restorealldatafiles --directory=/data1/ulog/1.2.2.1/ --tbusid=1.2.2.1 --endtime=20201201163000000 --engine-directory=/txh/ --seqcontinuous

更多信息请关注TcaplusDB微信公众号，风里雨里，我们一直在等你！

TcaplusDB是腾讯出品的分布式NoSQL数据库，存储和调度的代码完全自研。具备缓存+落地融合架构、PB级存储、毫秒级时延、无损水平扩展和复杂数据结构等特性。同时具备丰富的生态、便捷的迁移、极低的运维成本和五个九高可用等特点。客户覆盖游戏、互联网、政务、金融、制造和物联网等领域。