TiDB
社区
联系我们

备份与恢复 RawKV 数据

TiKV 有时可以独立于 TiDB，与 PD 构成 KV 数据库，此时的产品形态为 RawKV。Backup & Restore (BR) 支持对使用 RawKV 的产品进行备份和恢复，本文介绍如何备份和恢复 RawKV。

备份 RawKV

在某些使用场景下，TiKV 可能会独立于 TiDB 运行。考虑到这点，br 命令行工具提供跳过 TiDB 层直接备份 TiKV 数据的功能：

br backup raw --pd $PD_ADDR \
    --storage "local://$BACKUP_DIR" \
    --start 31 \
    --ratelimit 128 \
    --end 3130303030303030 \
    --format hex \
    --cf default

以上命令会将 default CF 上 [0x31, 0x3130303030303030) 之间的所有键备份到 $BACKUP_DIR。

这里，--start 和 --end 的参数会先依照 --format 指定的方式解码，再被发送到 TiKV 上去，目前支持以下解码方式：

  • "raw"：不进行任何操作，将输入的字符串直接编码为二进制格式的键。
  • "hex"：将输入的字符串视作十六进制数字。这是默认的编码方式。
  • "escaped"：对输入的字符串进行转义（backslash-escaped）之后，再编码为二进制格式，格式类似于 abc\xFF\x00\r\n。

恢复 RawKV

和备份 RawKV相似，恢复 RawKV 的命令如下：

br restore raw --pd $PD_ADDR \
    --storage "local://$BACKUP_DIR" \
    --start 31 \
    --end 3130303030303030 \
    --ratelimit 128 \
    --format hex \
    --cf default

以上命令会将范围在 [0x31, 0x3130303030303030) 的已备份键恢复到 TiKV 集群中。这里键的编码方式和备份时相同。

下载 PDF