LOCKLOSE 发表于 2016-12-20 09:11:53

Redis命令参考(Commands Reference)中文翻译【Hash部分】

  注意:此文档已经过期,请移步到 http://huangz.iyunv.com/blog/1123512 查看最新翻译。

HASH部分



HDEL key field 

    删除key储存的哈希表(hash)中的指定域(field)。

        复杂度:
            O(1)

        返回值:
            若域存在并被成功删除,返回1。 
            若key不存在或域不存在,返回0。




redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HGET hash_name jack
"Jack Sparrow"
redis> HDEL hash_name jack
(integer) 1
redis> HGET hash_name jack
(nil)


 



HGETALL key 

    返回key储存的哈希表中所有的域和值。
    在返回值里,每个域名(field name)之后是域的值(value),所以返回值的长度是哈希表大小的两倍。

        复杂度:
            O(N),N为哈希表的大小。

        返回值:
            以列表形式返回哈希表的域和值。
            若key不存在,返回空列表。




redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HGETALL hash_name
1) "jack"# 域
2) "Jack Sparrow"# 值
3) "gump"
4) "Forrest Gump"


 



HLEN key

    返回key储存的哈希表中域的数量。

        复杂度:
            O(1)

        返回值:
            哈希表中域的数量。
            当key不存在时,返回0。




redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HLEN hash_name
(integer) 2


 



HSET key field value 

    将key储存的哈希表中的field域设置为value值。
    如果key不存在,一个新的哈希表被创建并进行HSET操作。
    如果域已经存在于哈希表中,旧值将被覆盖。
    
        复杂度:
            O(1)

        返回值:
            如果一个哈希表中的新域被设置,返回1。
            如果哈希表中域已经存在且旧值已被新值覆盖,返回0。




redis> HSET website google "www.g.cn"
(integer) 1
redis> HSET website google "www.google.com"
(integer) 0


 


  


HEXISTS key field 

    查看key储存的哈希表中,指定域是否存在。

        复杂度:
            O(1)

        返回值:
            如果哈希表含有指定域,返回1。
            如果哈希表不含有指定域,或key不存在,返回0。




redis> HEXISTS phone myphone
(integer) 0
redis> HSET phone myphone nokia-1110
(integer) 1
redis> HEXISTS phone myphone
(integer) 1
 



HINCRBY key field increment

    将key所储存哈希表中的域的值加上increment。
    如果key不存在,一个新的哈希表被创建并执行HINCRBY操作。
    如果field域不存在,或域已有的字符串值不能表示为数字,那么在执行操作
前,域的值被设置为0。
    本操作只能对64位有符号数字使用。
    
        复杂度:
            O(1)

        返回值:
            HINCRBY操作完成之后,域的值。




redis> HEXISTS hash_count page_views
(integer) 0
redis> HINCRBY hash_count page_views 200
(integer) 200
redis> HINCRBY hash_count page_views 10
(integer) 210


 



HMGET key field  

    返回key所储存的哈希表中,多个给定域的关联值。
    如果指定的域不存在于哈希表,那么返回一个nil值。
    因为不存在的key被当作一个空哈希表来处理,所以对一个不存在的key进行HMGET操作将返回一个只带有nil值的表。

        复杂度:
            O(N),N为给定域的数量。

        返回值:
            一个包含多个给定域的关联值的表,表值的排列顺序和给定域参数的请求顺序一样。






redis> HMSET pet dog "doudou" cat "nounou"# 一次保存多个值
OK
redis> HMGET pet dog cat fake_pet# 返回值的顺序和传入参数的顺序一样。
1) "doudou"
2) "nounou"
3) (nil)# 不存在的域返回nil值



 



HSETNX key field value

    将给定key储存的哈希表中的域field的值设置为value,当且仅当域不存在。
    若域已经存在,该操作无效。    
    如果key不存在,一个新哈希表被创建并执行HSETNX操作。

        复杂度:
            O(1)

        返回值:
            设置成功,返回1。
            给定域已经存在且没有操作被执行,返回0。




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


 



HGET key field

    返回key所储存的哈希表中给定域关联的值。

        复杂度:
            O(1)

        返回值:
            给定域的值。
            当给定域不存在或是给定key不存在时,返回nil。




redis> HSET huangz blog www.SideEffect.me
(integer) 1
redis> HGET huangz blog
"www.SideEffect.me"


 

HKEYS key 

    返回key所储存的哈希表中的所有域。

        复杂度:
            O(N),N为哈希表的大小。

        返回值:
            一个包含哈希表中所有域的表。
            当key不存在时,返回一个空表。




redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HKEYS website
1) "google"
2) "yahoo"
redis> EXISTS fake_key
(integer) 0
redis> HKEYS fake_key# 对不存在的key进行HKEYS操作,返回一个空表
(empty list or set)


 



HMSET key field value  

    一次将多个键-值对设置到key所储存的哈希表中。
    此命令会覆盖哈希表中已存在的域。
    如果key不存在,一个空哈希表被创建并执行HMSET操作。




        复杂度:
            O(N),N为键-值对的数量。

        返回值:
            HMSET不可能失败,总是返回OK。






redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HGET website google
"www.google.com"
redis> HGET website yahoo
"www.yahoo.com"


 



HVALS key 

    返回key所储存的哈希表中的所有值。

        复杂度:
            O(N),N为哈希表的大小。

        返回值:
            一个包含哈希表中所有值的表。
            当key不存在时,返回一个空表。




redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HVALS website
1) "www.google.com"
2) "www.yahoo.com"


 
页: [1]
查看完整版本: Redis命令参考(Commands Reference)中文翻译【Hash部分】