COPY

将键的值复制到新键。

语法

COPY source destination [DB destination-db] [REPLACE]

引入版本：6.2.0

复杂度摘要：O(N)

[!NOTE] 此命令的行为在集群 Redis 环境中有所不同。请参阅 多键操作 页面了解更多信息。

该命令将存储在 source 键的值复制到 destination 键。

默认情况下，destination 键是在连接使用的逻辑数据库中创建的。 DB 选项允许为目标键指定替代逻辑数据库索引。

当 destination 键已存在时，该命令返回零。 REPLACE 选项会在将值复制到 destination 键之前删除该键。

必需参数

source

复制的关键。

destination

复制到的键。

可选参数

DB destination-db

将键复制到给定数据库索引而不是当前索引。

REPLACE

如果目标键已存在，请将其替换。

示例

SET dolly "sheep"
COPY dolly clone
GET clone

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动*	✅ 标准 ✅ 主动-主动*	对于主动-主动或集群数据库，源键和目标键必须位于同一哈希槽中。 *流消费者组信息不支持。

返回值

RESP2

以下之一： * 整数回复：如果复制了 来源，则为 1。 * 整数回复：如果未复制 来源，则为 0。

RESP3

以下之一： * 整数回复：如果复制了 来源，则为 1。 * 整数回复：如果未复制 来源，则为 0。

资料来源：Redis 官方 COPY 文档；中文内容参考 Redis 文档许可。