COPY · Valkey

COPY

Copies the value of a key to a new key.

Usage

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

Description

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.

Reply

One of the following:

Complexity

O(N) worst case for collections, where N is the number of nested items. O(1) for string values.

ACL Categories

@keyspace @slow @write

Examples

SET dolly "sheep"
COPY dolly clone
GET clone

History

See also

DEL, DUMP, EXISTS, EXPIRE, EXPIREAT, EXPIRETIME, KEYS, MIGRATE, MOVE, OBJECT, OBJECT ENCODING, OBJECT FREQ, OBJECT HELP, OBJECT IDLETIME, OBJECT REFCOUNT, PERSIST, PEXPIRE, PEXPIREAT, PEXPIRETIME, PTTL, RANDOMKEY, RENAME, RENAMENX, RESTORE, SCAN, SORT, SORT_RO, TOUCH, TTL, TYPE, UNLINK, WAIT, WAITAOF.