Redis COPY 怎样把键复制到另一个数据库

如果你只是想把 Redis 里某个键复制成另一份，且源键和目标键仍然属于同一个 Redis 实例，优先看 COPY。它复制的是键保存的值，默认把目标键放在当前逻辑数据库；需要写入另一个逻辑数据库时加上 DB destination-db，目标键已经存在则要明确加 REPLACE。

官方地址：https://redis.io/docs/latest/commands/copy/

最容易记住的判断是：COPY source destination 只负责复制，DB 决定目标逻辑数据库，REPLACE 决定是否覆盖已有目标键；返回 0 不等于网络失败，通常意味着目标键已存在而你没有允许覆盖。

COPY 的 DB 和 REPLACE 到底改变什么

我第一次把一个临时配置键复制到备用名称时，真正容易混淆的不是命令本身，而是“另一个数据库”这个说法。Redis 的逻辑数据库是同一实例里的编号空间，不是另一台 Redis 服务。COPY 的基本语法如下：

# 准备一个字符串键，注释说明本段命令的示例目的
redis-cli SET user:1001 "Ada"
# 不指定 DB 时，目标键位于当前连接使用的逻辑数据库
redis-cli COPY user:1001 user:1001:backup
# 指定目标逻辑数据库为 2，并允许覆盖已经存在的目标键
redis-cli COPY user:1001 user:1001:backup DB 2 REPLACE
# 切换到逻辑数据库 2 读取复制后的目标键
redis-cli -n 2 GET user:1001:backup

DB 2 只改变目标键的逻辑数据库位置，源键仍从当前连接所在的数据库读取。REPLACE 只改变目标键已经存在时的处理方式：没有它，目标键存在时命令返回 0；有它，Redis 会先处理旧目标键，再写入复制内容。成功复制返回 1。

不要把返回 0 当成命令或网络故障

COPY 的返回值是一个非常实用的判断点。读取返回值时，我会先区分三种情况：

生产代码里不要无条件追加 REPLACE。如果目标键代表人工修改过的配置、缓存预热结果或另一个租约，覆盖动作应该是显式决策。只想“目标不存在才复制”时，省略 REPLACE 更安全；确实需要把目标刷新成源键当前值时，再把覆盖意图写进命令。

复制后的 TTL 和数据类型怎么理解

COPY 复制的是源键的值和相关对象状态，目标键不是一个指向源键的别名。复制完成后，两个键可以分别被修改。对带过期时间的键，不要把它当成永久备份使用：具体任务应以当前 Redis 版本和命令文档对 TTL 行为的说明为准，并在业务上重新设置目标键的生命周期。

字符串值的复制成本通常较低；列表、集合、有序集合和哈希等集合类型的成本会随着内部成员数量增加。大对象复制会占用 Redis 主线程处理时间，因此“只复制一次”不代表“任何大小都没有代价”。如果只是为了切换名称，先确认目标键不存在、数据量可接受，并把复制动作安排在可控时段。

# 用 TYPE 和 TTL 查看源键的类型与剩余生命周期
redis-cli TYPE user:1001
# TTL 返回剩余秒数；-1 表示没有过期时间，-2 表示键不存在
redis-cli TTL user:1001
# 复制前先确认目标键是否存在，避免误覆盖已有数据
redis-cli EXISTS user:1001:backup

集群环境要先看哈希槽边界

在 Redis Cluster 或兼容集群的环境里，源键和目标键不能只按“同一个实例”来理解。多键相关操作受到哈希槽约束，COPY 的源键和目标键需要满足当前集群环境的槽位要求；如果键名包含哈希标签，应该先设计好一致的标签，而不是等命令报错后再临时改名。

这也是 COPY 与跨实例迁移的边界：COPY 的 DB 参数指的是逻辑数据库编号，不是目标 Redis 服务的地址、端口或认证信息。要把键送到另一台 Redis，需要研究适合的迁移或复制方案，不能把 DB 2 当成“第二台服务器”。

按任务选择 COPY 的写法

几个容易混淆的问题

Redis COPY 会不会把源键删除？

不会。COPY 的语义是复制，源键仍然保留。需要移动而不是复制时，不能只靠 COPY 表达这个动作。

目标键存在时为什么没有覆盖？

因为默认不会覆盖已有目标键。确认覆盖是业务允许的，再显式加 REPLACE，并根据返回值记录结果。

DB 参数能不能把键复制到另一台 Redis？

不能。DB 只表示同一 Redis 服务内部的逻辑数据库编号；跨实例场景需要另外的迁移或复制方案。

总结一下：先确认源键和目标键属于哪个逻辑数据库，再决定是否允许覆盖；用返回值区分成功、目标冲突和参数错误；最后检查对象大小、TTL 和集群槽位。这样使用 COPY，命令短，但边界不会被“另一个数据库”这句话带偏。