MSETNX

{{< note >}} This command's behavior varies in clustered Redis environments. See the [multi-key operations]({{< relref "/develop/using-commands/multi-key-operations" >}}) page for more information. {{< /note >}}

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-cli %}} MSETNX key1 "Hello" key2 "there" MSETNX key2 "new" key3 "world" MGET key1 key2 key3 {{% /redis-cli %}}

Redis Software and Redis Cloud compatibility

| Redis Software | Redis Cloud | <span style="min-width: 9em; display: table-cell">Notes</span> | |:----------------------|:-----------------|:------| | <span title="Supported">✅ Standard</span> <span title="Supported"><nobr>✅ Active-Active</nobr></span> | <span title="Supported">✅ Standard</span> <span title="Supported"><nobr>✅ Active-Active</nobr></span> | |

Return information

{{< multitabs id="msetnx-return-info" tab1="RESP2" tab2="RESP3" >}}

One of the following:

• Integer reply: 0 if no key was set (at least one key already existed).
• Integer reply: 1 if all the keys were set.

-tab-sep-

One of the following:

• Integer reply: 0 if no key was set (at least one key already existed).
• Integer reply: 1 if all the keys were set.

{{< /multitabs >}}