Redis Hsetnx コマンド

Redis ハッシュ(Hash)

Redis Hsetnx コマンドは、ハッシュテーブル内に存在しないフィールドに値を設定するために使用されます。

ハッシュテーブルが存在しない場合は、新しいハッシュテーブルが作成され、HSET 操作が行われます。

フィールドがすでにハッシュテーブル内に存在する場合、操作は無効です。

key が存在しない場合、新しいハッシュテーブルが作成され、HSETNX コマンドが実行されます。

構文

redis Hsetnx コマンドの基本的な構文は次のとおりです:

redis 127.0.0.1:6379> HSETNX KEY_NAME FIELD VALUE

利用可能なバージョン

>= 2.0.0

戻り値

設定に成功すると、1 を返します。 指定されたフィールドがすでに存在し、操作が実行されなかった場合は、0 を返します。

例

redis 127.0.0.1:6379> HSETNX myhash field1 "foo"
(integer) 1
redis 127.0.0.1:6379> HSETNX myhash field1 "bar"
(integer) 0
redis 127.0.0.1:6379> HGET myhash field1
"foo"

redis 127.0.0.1:6379> HSETNX nosql key-value-store redis
(integer) 1

redis 127.0.0.1:6379> HSETNX nosql key-value-store redis       # 操作无效, key-value-store 已存在
(integer) 0

Redis ハッシュ(Hash)

その他の拡張