本文档介绍如何对 Kubernetes 上的 TiDB 集群进行数据备份和数据恢复。备份与恢复中所使用的工具有 Dumpling、TiDB Lightning 和 BR。
Dumpling 是一个数据导出工具,该工具可以把存储在 TiDB/MySQL 中的数据导出为 SQL 或者 CSV 格式,可以用于完成逻辑上的全量备份或者导出。
TiDB Lightning 是一个数据导入工具,该工具可以把 Dumpling 或 CSV 输出格式的数据快速导入到 TiDB 中,可以用于完成逻辑上的全量恢复或者导入。
BR 是 TiDB 分布式备份恢复的命令行工具,用于对 TiDB 集群进行数据备份和恢复。相比 Dumpling 和 Mydumper,BR 更适合大数据量的场景,BR 只支持 TiDB v3.1 及以上版本。如果需要对延迟不敏感的增量备份,请参阅 BR。如果需要实时的增量备份,请参阅 TiCDC。
如果你对数据备份有以下要求,可考虑使用 BR 对 TiDB 进行数据备份:
BR 相关使用文档可参考:
如果你对数据备份有以下要求,可考虑使用 Dumpling 对 TiDB 进行数据备份:
Dumpling 相关使用文档可参考:
如果你需要从由 BR 备份出的 SST 文件对 TiDB 进行数据恢复,则应使用 BR。相关使用文档可参考:
如果你需要从由 Dumpling 导出的或其他格式兼容的 SQL 或 CSV 文件对 TiDB 进行数据恢复,则应使用 TiDB Lightning。相关使用文档可参考:
为了对 Kubernetes 上的 TiDB 集群进行数据备份,用户需要创建一个自定义的 Backup Custom Resource (CR) 对象来描述一次备份,或者创建一个自定义的 BackupSchedule CR 对象来描述一个定时备份。
为了对 Kubernetes 上的 TiDB 集群进行数据恢复,用户可以通过创建一个自定义的 Restore CR 对象来描述一次恢复。
在创建完对应的 CR 对象后,TiDB Operator 将根据相应配置并选择对应的工具执行备份或恢复。
用户可以通过下述语句来删除对应的备份 CR 或定时全量备份 CR。
kubectl delete backup ${name} -n ${namespace} kubectl delete backupschedule ${name} -n ${namespace}
如果你使用 v1.1.2 及以前版本,或使用 v1.1.3 及以后版本并将 spec.cleanPolicy
设置为 Delete
时,TiDB Operator 在删除 CR 时会同时清理备份文件。
在满足上述条件时,如果需要删除 namespace,建议首先删除所有的 Backup/BackupSchedule CR,再删除 namespace。
如果直接删除存在 Backup/BackupSchedule CR 的 namespace,TiDB Operator 会持续尝试创建 Job 清理备份的数据,但因为 namespace 处于 Terminating
状态而创建失败,从而导致 namespace 卡在该状态。
这时需要通过下述命令删除 finalizers
:
kubectl patch -n ${namespace} backup ${name} --type merge -p '{"metadata":{"finalizers":[]}}'
TiDB Operator v1.2.3 及之前的版本,清理备份文件的方式为:循环删除备份文件,一次删除一个文件。
TiDB Operator v1.2.4 及以后的版本,清理备份文件的方式为:循环删除备份文件,一次批量删除多个文件。对于每次批量删除多个文件的操作,根据备份使用的后端存储类型的不同,删除方式不同。
对于 TiDB Operator v1.2.4 及以后的版本,你可以使用 Backup CR 中的以下字段控制清理行为:
.spec.cleanOption.pageSize
:指定每次批量删除的文件数量。默认值为 10000。
.spec.cleanOption.disableBatchConcurrency
:当设置为 true 时,TiDB Operator 会禁用并发批量删除方式,使用并发删除方式。
如果 S3 兼容的后端存储不支持 DeleteObjects
接口,默认的并发批量删除会失败,需要配置该字段为 true
来使用并发删除方式。
.spec.cleanOption.batchConcurrency
: 指定并发批量删除方式下启动的 Go 协程数量。默认值为 10。
.spec.cleanOption.routineConcurrency
: 指定并发删除方式下启动的 Go 协程数量。默认值为 100。