COPY
Syntax
COPY source destination [DB destination-db] [REPLACE]
- Available since:
- Redis Open Source 6.2.0
- Time complexity:
- O(N) worst case for collections, where N is the number of nested items. O(1) for string values.
- ACL categories:
-
@keyspace,@write,@slow, - Compatibility:
- Redis Software and Redis Cloud compatibility
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.
Examples
SET dolly "sheep"
COPY dolly clone
GET clone
Redis Software and Redis Cloud compatibility
| Redis Enterprise |
Redis Cloud |
Notes |
|---|---|---|
| ✅ Standard |
✅ Standard |
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. |
Return information
One of the following:
- Integer reply:
1if source was copied. - Integer reply:
0if source was not copied.