content/commands/copy.md
{{< note >}} This command's behavior varies in clustered Redis environments. See the [multi-key operations]({{< relref "/develop/using-commands/multi-key-operations" >}}) page for more information. {{< /note >}}
This command copies the value stored at the source key to the destination
key.
By default, the destination key is created in the logical database used by the
connection. The DB option allows specifying an alternative logical database
index for the destination key.
The command returns zero when the destination key already exists. The
REPLACE option removes the destination key before copying the value to it.
SET dolly "sheep"
COPY dolly clone
GET clone
| Redis Software | Redis Cloud | <span style="min-width: 9em; display: table-cell">Notes</span> | |:----------------------|:-----------------|:------| | <span title="Supported">✅ Standard</span> <span title="Supported"><nobr>✅ Active-Active*</nobr></span> | <span title="Supported">✅ Standard</span> <span title="Supported"><nobr>✅ Active-Active*</nobr></span> | For Active-Active or clustered databases, the source and destination keys must be in the same hash slot.
*Not supported for stream consumer group info. |
{{< multitabs id="copy-return-info" tab1="RESP2" tab2="RESP3" >}}
One of the following:
1 if source was copied.0 if source was not copied.-tab-sep-
One of the following:
1 if source was copied.0 if source was not copied.{{< /multitabs >}}