What's new in Valkey 9.0? Discover new features and improvements. Read the announcement.

MOVE

Moves a key to another database.

Usage
MOVE key db [REPLACE replace]
Complexity
O(1)
Since
1.0.0
ACL Categories
@fast, @keyspace, @write
Command flags
WRITE, FAST

Move key from the currently selected database (see SELECT) to the specified destination database. When key already exists in the destination database, or it does not exist in the source database, it does nothing. It is possible to use MOVE as a locking primitive because of this.

The caller must have access to the current and the destination databases. See database permissions.

Replies

RESP2

One of the following:

  • Integer reply: 1 if key was moved.
  • Integer reply: 0 if key already exists in the destination database, or it does not exist in the source database.

RESP3

One of the following:

  • Integer reply: 1 if key was moved.
  • Integer reply: 0 if key already exists in the destination database, or it does not exist in the source database.

History

  • 10.0.0: added REPLACE option.
Slack Icon Slack GitHub Icon GitHub LinkedIn Icon LinkedIn X Icon X.com Mail Icon Connect
Code of Conduct Meetup Groups Forum About Leadership FAQ

© Valkey contributors.

Valkey and the Valkey logo are trademarks of LF Projects, LLC.

Trademark Policy. Privacy Policy. Terms of Use. For other policies, please see lfprojects.org.

Valkey includes certain 3-Clause BSD-licensed Redis code from Redis Ltd. and other source code. Redis Ltd. is not the source of that other source code. Redis is a registered trademark of Redis Ltd.

Logo design by Ziyang.