COPY

Copies the value of a key to a new key.

Usage: COPY source destination [DB destination-db] [REPLACE replace]
Complexity: O(N) worst case for collections, where N is the number of nested items. O(1) for string values.
Since: 6.2.0
ACL Categories: @keyspace, @slow, @write
Command flags: WRITE, DENYOOM

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 REPLACE option removes the destination key before copying the value to it.

The command returns zero when the source key does not exist or when the destination key already exists and the REPLACE option is not specified.

Examples

SET dolly "sheep"
COPY dolly clone
GET clone

Replies

RESP2

One of the following:

Integer reply: 1 if source was copied.
Integer reply: 0 if source was not copied when the destination key already exists.

RESP3

One of the following:

Integer reply: 1 if source was copied.
Integer reply: 0 if source was not copied when the destination key already exists.

Examples

Replies

RESP2

RESP3

Subscribe for updates, event info, and the latest Valkey news