MSETNX
Syntax
MSETNX key value [key value ...]
- Available since:
- Redis Open Source 1.0.1
- Time complexity:
- O(N) where N is the number of keys to set.
- ACL categories:
-
@write,@string,@slow, - Compatibility:
- Redis Software and Redis Cloud compatibility
Sets the given keys to their respective values.
MSETNX will not perform any operation at all even if just a single key already
exists.
Because of this semantic MSETNX can be used in order to set different keys
representing different fields of a unique logic object in a way that ensures
that either all the fields or none at all are set.
MSETNX is atomic, so all given keys are set at once.
It is not possible for clients to see that some of the keys were updated while
others are unchanged.
Examples
Redis Software and Redis Cloud compatibility
| Redis Enterprise |
Redis Cloud |
Notes |
|---|---|---|
| ✅ Standard |
✅ Standard |
Return information
One of the following:
- Integer reply:
0if no key was set (at least one key already existed). - Integer reply:
1if all the keys were set.