Python redis模块哈希操作

在 Redis 中,哈希就是键值对组成的集合。相较于字符串,值为集合,而且集合的每个元素包含两个部分,第一部分为键,第二部分为值。

或者说,该类型的值就是一个小的 Redis 集合,可以用图 1 来表示这种关系。


图 1 哈希数据类型

下面介绍常用的哈希数据的操作。

1) hset(键,子键,值):该函数用于添加或修改指定子键的值。如果指定的键不存在,就创建该键;如果指定的子键不存在,就创建该子键。否则修改该键下面的子键的值。如果是添加操作,那么返回 1,否则返回 0。
>>> r.exists("key1")
0
>>> r.hset("key1", "key1.1", "val1.1")
1
>>> r.exists("key1")
1
>>> r.type("key1")
b'hash'
>>> r.hset("key1", "key1.2", "val1.2")
1
>>> r.hset("key1", "key1.3", "val1.3")
1
>>> r.hset("key1", "key1.4", "val1.4")
1

2) hget(键,子键):该函数用于得到指定键下某个子键的值如果该键或者子键不存在,那么返回 None。
>>> r.hget('key1', 'key1.1')            # 指定了键和子键
b'val1.1'
>>> x = r.hget('key1', 'key1.100')        # 子键不存在
>>> x is None                            # 返回值为None
True
>>> x = r.hget('key100', 'key1.1')        # 键不存在
>>> x is None                        # 返回值为None
True

3) hkeys(键):该函数用于得到指定键下所有的子键。
>>> r.hkeys("key1")
[b'key1.1', b'key1.2', b'key1.3', b'key1.4']

4) hlen(键):该函数用于统计指定键下所有的子键个数。
>>> r.hlen("key1")
4

hexists(键,子键):该函数用于判断是否存在某个子键。返回值是一个布尔型的,True 表示在指定键下有该子键;False 表示没有该键或者该键下面没有该子键。
>>> r.hexists("key1", "key1.2")    # 是否在键key1下存在子键key1.2
True                                # 存在
>>> r.hexists("key100", "key1.10")    # 指定的键不存在,返回False
False
>>> r.hexists("key1", "key1.10")    # 指定的键存在,但是该键下没有指定的子键
False

5) hmget(键,多个子键):该函数用于返回一个或多个指定键的值。多个子键可以用列表来表示,或者用多个参数来表示,也可以混着使用。返回值是一个列表,该列表的顺序和子键的顺序一致。
>>> r.hmget("key1", 'key1.1', 'key1.2')        # 用多个参数表示
[b'val1.1', b'val1.2']
>>> r.hmget("key1", ['key1.1', 'key1.2'])        # 用列表表示多个子键
[b'val1.1', b'val1.2']
>>> r.hmget("key1", ['key1.1', 'key1.2'], 'key1.3')    # 混合表示
[b'val1.1', b'val1.2', b'val1.3']

6) hmset(键,子键值字典):该函数用于批量设置指定键下面的子键和值。需要将子键和值放到字典中。
>>> hval = {"key1.10": "val1.10", "key1.11": "val1.11"}   # 子键值字典
>>> r.hmset('key1', hval)                        # 批量设置
True
>>> r.hget('key1', 'key1.10')                    # 查看是否设置成功
b'val1.10'
>>> r.hget('key1', 'key1.11')
b'val1.11'

7) hvals(键):该函数返回指定键下面的所有值。返回值是一个列表。
>>> r.hvals("key1")
[b'val1.1', b'val1.2', b'val1.3', b'val1.4']

8) hkeys(键):该函数返回指定键下面的所有子键。返回值是一个列表。
>>> r.hkeys("key1")
[b'key1.1', b'key1.2', b'key1.3', b'key1.4']

9)hgetall(键):该函数返回指定键下面所有的子键和值。返回值是一个字典,里面的键就是哈希的子键,值就是哈希的值。
>>> r.hgetall("key1")
{b'key1.1': b'val1.1', b'key1.2': b'val1.2', b'key1.3': b'val1.3',
     b'key1.4': b'val1.4'}
如果该键不存在,返回一个空的字典。
>>> r.exists("key2")
0
>>> r.hgetall("key2")
{}