HSETNX

Syntax
HSETNX key field value
Available since:
Redis Open Source 2.0.0
Time complexity:
O(1)
ACL categories:
@write, @hash, @fast,
Compatibility:
Redis Software and Redis Cloud compatibility

Sets field in the hash stored at key to value, only if field does not yet exist. If key does not exist, a new key holding a hash is created. If field already exists, this operation has no effect.

Examples

HSETNX myhash field "Hello" HSETNX myhash field "World" HGET myhash field

Redis Software and Redis Cloud compatibility

Redis
Enterprise		 Redis
Cloud		 Notes
✅ Standard
✅ Active-Active		 ✅ Standard
✅ Active-Active

Return information

One of the following:

  • Integer reply: 0 if the field already exists in the hash and no operation was performed.
  • Integer reply: 1 if the field is a new field in the hash and the value was set.
RATE THIS PAGE
Back to top ↑