Python操作Redis，你要的都在这了！

水深无声 2022-12-17 10:57 164阅读 0赞

Redis是一个基于内存的高效的键值型非关系型数据库，存取效率极高，而且支持多种存储数据结构，使用也非常简单。本节中，我们就来介绍一下Python的Redis操作，主要介绍RedisPy这个库的用法。

## 1. 准备工作 ##

在开始之前，请确保已经安装好了Redis及RedisPy库。如果要做数据导入/导出操作的话，还需要安装RedisDump。

## 2. Redis 和 StrictRedis ##

RedisPy库提供两个类`Redis`和`StrictRedis`来实现Redis的命令操作。

`StrictRedis`实现了绝大部分官方的命令，参数也一一对应，比如`set()`方法就对应Redis命令的`set`方法。而`Redis`是`StrictRedis`的子类，它的主要功能是用于向后兼容旧版本库里的几个方法。为了做兼容，它将方法做了改写，比如`lrem()`方法就将`value`和`num`参数的位置互换，这和Redis命令行的命令参数不一致。

官方推荐使用`StrictRedis`，所以本节中我们也用`StrictRedis类`的相关方法作演示。

## 3. 连接Redis ##

现在我们已经在本地安装了Redis并运行在6379端口，密码设置为foobared。那么，可以用如下示例连接Redis并测试：

from redis import StrictRedis
    
    redis = StrictRedis(host='localhost', port=6379, db=0, password='foobared')
    redis.set('name', 'Bob')
    print(redis.get('name'))

这里我们传入了Redis的地址、运行端口、使用的数据库和密码信息。在默认不传的情况下，这4个参数分别为`localhost`、`6379`、`0`和`None`。首先声明了一个`StrictRedis`对象，接下来调用`set()`方法，设置一个键值对，然后将其获取并打印。

运行结果如下：

b'Bob'

这说明我们连接成功，并可以执行`set()`和`get()`操作了。

当然，我们还可以使用`ConnectionPool`来连接，示例如下：

from redis import StrictRedis, ConnectionPool
    
    pool = ConnectionPool(host='localhost', port=6379, db=0, password='foobared')
    redis = StrictRedis(connection_pool=pool)

这样的连接效果是一样的。观察源码可以发现，`StrictRedis`内其实就是用`host`和`port`等参数又构造了一个`ConnectionPool`，所以直接将`ConnectionPool`当作参数传给`StrictRedis`也一样。

另外，`ConnectionPool`还支持通过URL来构建。URL的格式支持有如下3种：

redis://[:password]@host:port/db
    rediss://[:password]@host:port/db
    unix://[:password]@/path/to/socket.sock?db=db

这3种URL分别表示创建Redis TCP连接、Redis TCP+SSL连接、Redis UNIX socket连接。我们只需要构造上面任意一种URL即可，其中`password`部分如果有则可以写，没有则可以省略。下面再用URL连接演示一下：

url = 'redis://:foobared@localhost:6379/0'
    pool = ConnectionPool.from_url(url)
    redis = StrictRedis(connection_pool=pool)

这里我们使用第一种连接字符串进行连接。首先，声明一个Redis连接字符串，然后调用`from_url()`方法创建`ConnectionPool`，接着将其传给`StrictRedis`即可完成连接，所以使用URL的连接方式还是比较方便的。

## 4. 键操作 ##

下表总结了键的一些判断和操作方法。

<table> 
 <thead> 
 <tr> 
 <th> 方法 </th> 
 <th> 作用 </th> 
 <th> 参数说明 </th> 
 <th> 示例 </th> 
 <th> 示例说明 </th> 
 <th> 示例结果 </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> exists(name) </td> 
 <td> 判断一个键是否存在 </td> 
 <td> name：键名 </td> 
 <td> redis.exists('name') </td> 
 <td> 是否存在name这个键 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> delete(name) </td> 
 <td> 删除一个键 </td> 
 <td> name：键名 </td> 
 <td> redis.delete('name') </td> 
 <td> 删除name这个键 </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> type(name) </td> 
 <td> 判断键类型 </td> 
 <td> name：键名 </td> 
 <td> redis.type('name') </td> 
 <td> 判断name这个键类型 </td> 
 <td> b'string' </td> 
 </tr> 
 <tr> 
 <td> keys(pattern) </td> 
 <td> 获取所有符合规则的键 </td> 
 <td> pattern：匹配规则 </td> 
 <td> redis.keys('n*') </td> 
 <td> 获取所有以n开头的键 </td> 
 <td> [b'name'] </td> 
 </tr> 
 <tr> 
 <td> randomkey() </td> 
 <td> 获取随机的一个键 </td> 
 <td>&nbsp;</td> 
 <td> randomkey() </td> 
 <td> 获取随机的一个键 </td> 
 <td> b'name' </td> 
 </tr> 
 <tr> 
 <td> rename(src, dst) </td> 
 <td> 重命名键 </td> 
 <td> src：原键名；dst：新键名 </td> 
 <td> redis.rename('name', 'nickname') </td> 
 <td> 将name重命名为nickname </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> dbsize() </td> 
 <td> 获取当前数据库中键的数目 </td> 
 <td>&nbsp;</td> 
 <td> dbsize() </td> 
 <td> 获取当前数据库中键的数目 </td> 
 <td> 100 </td> 
 </tr> 
 <tr> 
 <td> expire(name, time) </td> 
 <td> 设定键的过期时间，单位为秒 </td> 
 <td> name：键名；time：秒数 </td> 
 <td> redis.expire('name', 2) </td> 
 <td> 将name键的过期时间设置为2秒 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> ttl(name) </td> 
 <td> 获取键的过期时间，单位为秒，-1表示永久不过期 </td> 
 <td> name：键名 </td> 
 <td> redis.ttl('name') </td> 
 <td> 获取name这个键的过期时间 </td> 
 <td> -1 </td> 
 </tr> 
 <tr> 
 <td> move(name, db) </td> 
 <td> 将键移动到其他数据库 </td> 
 <td> name：键名；db：数据库代号 </td> 
 <td> move('name', 2) </td> 
 <td> 将name移动到2号数据库 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> flushdb() </td> 
 <td> 删除当前选择数据库中的所有键 </td> 
 <td>&nbsp;</td> 
 <td> flushdb() </td> 
 <td> 删除当前选择数据库中的所有键 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> flushall() </td> 
 <td> 删除所有数据库中的所有键 </td> 
 <td>&nbsp;</td> 
 <td> flushall() </td> 
 <td> 删除所有数据库中的所有键 </td> 
 <td> True </td> 
 </tr> 
 </tbody> 
</table>

**5. 字符串操作**

Redis支持最基本的键值对形式存储，用法总结如下表所示。

<table> 
 <thead> 
 <tr> 
 <th> 方法 </th> 
 <th> 作用 </th> 
 <th> 参数说明 </th> 
 <th> 示例 </th> 
 <th> 示例说明 </th> 
 <th> 示例结果 </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> set(name, value) </td> 
 <td> 给数据库中键为name的string赋予值value </td> 
 <td> name: 键名；value: 值 </td> 
 <td> redis.set('name', 'Bob') </td> 
 <td> 给name这个键的value赋值为Bob </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> get(name) </td> 
 <td> 返回数据库中键为name的string的value </td> 
 <td> name：键名 </td> 
 <td> redis.get('name') </td> 
 <td> 返回name这个键的value </td> 
 <td> b'Bob' </td> 
 </tr> 
 <tr> 
 <td> getset(name, value) </td> 
 <td> 给数据库中键为name的string赋予值value并返回上次的value </td> 
 <td> name：键名；value：新值 </td> 
 <td> redis.getset('name', 'Mike') </td> 
 <td> 赋值name为Mike并得到上次的value </td> 
 <td> b'Bob' </td> 
 </tr> 
 <tr> 
 <td> mget(keys, *args) </td> 
 <td> 返回多个键对应的value </td> 
 <td> keys：键的列表 </td> 
 <td> redis.mget(['name', 'nickname']) </td> 
 <td> 返回name和nickname的value </td> 
 <td> [b'Mike', b'Miker'] </td> 
 </tr> 
 <tr> 
 <td> setnx(name, value) </td> 
 <td> 如果不存在这个键值对，则更新value，否则不变 </td> 
 <td> name：键名 </td> 
 <td> redis.setnx('newname', 'James') </td> 
 <td> 如果newname这个键不存在，则设置值为James </td> 
 <td> 第一次运行结果是True，第二次运行结果是False </td> 
 </tr> 
 <tr> 
 <td> setex(name, time, value) </td> 
 <td> 设置可以对应的值为string类型的value，并指定此键值对应的有效期 </td> 
 <td> name: 键名；time: 有效期； value：值 </td> 
 <td> redis.setex('name', 1, 'James') </td> 
 <td> 将name这个键的值设为James，有效期为1秒 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> setrange(name, offset, value) </td> 
 <td> 设置指定键的value值的子字符串 </td> 
 <td> name：键名；offset：偏移量；value：值 </td> 
 <td> redis.set('name', 'Hello') redis.setrange('name', 6, 'World') </td> 
 <td> 设置name为Hello字符串，并在index为6的位置补World </td> 
 <td> 11，修改后的字符串长度 </td> 
 </tr> 
 <tr> 
 <td> mset(mapping) </td> 
 <td> 批量赋值 </td> 
 <td> mapping：字典 </td> 
 <td> redis.mset({'name1': 'Durant', 'name2': 'James'}) </td> 
 <td> 将name1设为Durant，name2设为James </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> msetnx(mapping) </td> 
 <td> 键均不存在时才批量赋值 </td> 
 <td> mapping：字典 </td> 
 <td> redis.msetnx({'name3': 'Smith', 'name4': 'Curry'}) </td> 
 <td> 在name3和name4均不存在的情况下才设置二者值 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> incr(name, amount=1) </td> 
 <td> 键为name的value增值操作，默认为1，键不存在则被创建并设为amount </td> 
 <td> name：键名；amount：增长的值 </td> 
 <td> redis.incr('age', 1) </td> 
 <td> age对应的值增1，若不存在，则会创建并设置为1 </td> 
 <td> 1，即修改后的值 </td> 
 </tr> 
 <tr> 
 <td> decr(name, amount=1) </td> 
 <td> 键为name的value减值操作，默认为1，键不存在则被创建并将value设置为-amount </td> 
 <td> name：键名； amount：减少的值 </td> 
 <td> redis.decr('age', 1) </td> 
 <td> age对应的值减1，若不存在，则会创建并设置为-1 </td> 
 <td> -1，即修改后的值 </td> 
 </tr> 
 <tr> 
 <td> append(key, value) </td> 
 <td> 键为name的string的值附加value </td> 
 <td> key：键名 </td> 
 <td> redis.append('nickname', 'OK') </td> 
 <td> 向键为nickname的值后追加OK </td> 
 <td> 13，即修改后的字符串长度 </td> 
 </tr> 
 <tr> 
 <td> substr(name, start, end=-1) </td> 
 <td> 返回键为name的string的子串 </td> 
 <td> name：键名；start：起始索引；end：终止索引，默认为-1，表示截取到末尾 </td> 
 <td> redis.substr('name', 1, 4) </td> 
 <td> 返回键为name的值的字符串，截取索引为1~4的字符 </td> 
 <td> b'ello' </td> 
 </tr> 
 <tr> 
 <td> getrange(key, start, end) </td> 
 <td> 获取键的value值从start到end的子字符串 </td> 
 <td> key：键名；start：起始索引；end：终止索引 </td> 
 <td> redis.getrange('name', 1, 4) </td> 
 <td> 返回键为name的值的字符串，截取索引为1~4的字符 </td> 
 <td> b'ello' </td> 
 </tr> 
 </tbody> 
</table>

## 6. 列表操作 ##

Redis还提供了列表存储，列表内的元素可以重复，而且可以从两端存储，用法如下表所示。

<table> 
 <thead> 
 <tr> 
 <th> 方法 </th> 
 <th> 作用 </th> 
 <th> 参数说明 </th> 
 <th> 示例 </th> 
 <th> 示例说明 </th> 
 <th> 示例结果 </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> rpush(name, *values) </td> 
 <td> 在键为name的列表末尾添加值为value的元素，可以传多个 </td> 
 <td> name：键名；values：值 </td> 
 <td> redis.rpush('list', 1, 2, 3) </td> 
 <td> 向键为list的列表尾添加1、2、3 </td> 
 <td> 3，列表大小 </td> 
 </tr> 
 <tr> 
 <td> lpush(name, *values) </td> 
 <td> 在键为name的列表头添加值为value的元素，可以传多个 </td> 
 <td> name：键名；values：值 </td> 
 <td> redis.lpush('list', 0) </td> 
 <td> 向键为list的列表头部添加0 </td> 
 <td> 4，列表大小 </td> 
 </tr> 
 <tr> 
 <td> llen(name) </td> 
 <td> 返回键为name的列表的长度 </td> 
 <td> name：键名 </td> 
 <td> redis.llen('list') </td> 
 <td> 返回键为list的列表的长度 </td> 
 <td> 4 </td> 
 </tr> 
 <tr> 
 <td> lrange(name, start, end) </td> 
 <td> 返回键为name的列表中start至end之间的元素 </td> 
 <td> name：键名；start：起始索引；end：终止索引 </td> 
 <td> redis.lrange('list', 1, 3) </td> 
 <td> 返回起始索引为1终止索引为3的索引范围对应的列表 </td> 
 <td> [b'3', b'2', b'1'] </td> 
 </tr> 
 <tr> 
 <td> ltrim(name, start, end) </td> 
 <td> 截取键为name的列表，保留索引为start到end的内容 </td> 
 <td> name：键名；start：起始索引；end：终止索引 </td> 
 <td> ltrim('list', 1, 3) </td> 
 <td> 保留键为list的索引为1到3的元素 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> lindex(name, index) </td> 
 <td> 返回键为name的列表中index位置的元素 </td> 
 <td> name：键名；index：索引 </td> 
 <td> redis.lindex('list', 1) </td> 
 <td> 返回键为list的列表索引为1的元素 </td> 
 <td> b’2’ </td> 
 </tr> 
 <tr> 
 <td> lset(name, index, value) </td> 
 <td> 给键为name的列表中index位置的元素赋值，越界则报错 </td> 
 <td> name：键名；index：索引位置；value：值 </td> 
 <td> redis.lset('list', 1, 5) </td> 
 <td> 将键为list的列表中索引为1的位置赋值为5 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> lrem(name, count, value) </td> 
 <td> 删除count个键的列表中值为value的元素 </td> 
 <td> name：键名；count：删除个数；value：值 </td> 
 <td> redis.lrem('list', 2, 3) </td> 
 <td> 将键为list的列表删除两个3 </td> 
 <td> 1，即删除的个数 </td> 
 </tr> 
 <tr> 
 <td> lpop(name) </td> 
 <td> 返回并删除键为name的列表中的首元素 </td> 
 <td> name：键名 </td> 
 <td> redis.lpop('list') </td> 
 <td> 返回并删除名为list的列表中的第一个元素 </td> 
 <td> b'5' </td> 
 </tr> 
 <tr> 
 <td> rpop(name) </td> 
 <td> 返回并删除键为name的列表中的尾元素 </td> 
 <td> name：键名 </td> 
 <td> redis.rpop('list') </td> 
 <td> 返回并删除名为list的列表中的最后一个元素 </td> 
 <td> b'2' </td> 
 </tr> 
 <tr> 
 <td> blpop(keys, timeout=0) </td> 
 <td> 返回并删除名称在keys中的list中的首个元素，如果列表为空，则会一直阻塞等待 </td> 
 <td> keys：键列表；timeout： 超时等待时间，0为一直等待 </td> 
 <td> redis.blpop('list') </td> 
 <td> 返回并删除键为list的列表中的第一个元素 </td> 
 <td> [b'5'] </td> 
 </tr> 
 <tr> 
 <td> brpop(keys, timeout=0) </td> 
 <td> 返回并删除键为name的列表中的尾元素，如果list为空，则会一直阻塞等待 </td> 
 <td> keys：键列表；timeout：超时等待时间，0为一直等待 </td> 
 <td> redis.brpop('list') </td> 
 <td> 返回并删除名为list的列表中的最后一个元素 </td> 
 <td> [b'2'] </td> 
 </tr> 
 <tr> 
 <td> rpoplpush(src, dst) </td> 
 <td> 返回并删除名称为src的列表的尾元素，并将该元素添加到名称为dst的列表头部 </td> 
 <td> src：源列表的键；dst：目标列表的key </td> 
 <td> redis.rpoplpush('list', 'list2') </td> 
 <td> 将键为list的列表尾元素删除并将其添加到键为list2的列表头部，然后返回 </td> 
 <td> b'2' </td> 
 </tr> 
 </tbody> 
</table>

## 7. 集合操作 ##

Redis还提供了集合存储，集合中的元素都是不重复的，用法如下表所示。

<table> 
 <thead> 
 <tr> 
 <th> 方法 </th> 
 <th> 作用 </th> 
 <th> 参数说明 </th> 
 <th> 示例 </th> 
 <th> 示例说明 </th> 
 <th> 示例结果 </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> sadd(name, *values) </td> 
 <td> 向键为name的集合中添加元素 </td> 
 <td> name：键名；values：值，可为多个 </td> 
 <td> redis.sadd('tags', 'Book', 'Tea', 'Coffee') </td> 
 <td> 向键为tags的集合中添加Book、Tea和Coffee这3个内容 </td> 
 <td> 3，即插入的数据个数 </td> 
 </tr> 
 <tr> 
 <td> srem(name, *values) </td> 
 <td> 从键为name的集合中删除元素 </td> 
 <td> name：键名；values：值，可为多个 </td> 
 <td> redis.srem('tags', 'Book') </td> 
 <td> 从键为tags的集合中删除Book </td> 
 <td> 1，即删除的数据个数 </td> 
 </tr> 
 <tr> 
 <td> spop(name) </td> 
 <td> 随机返回并删除键为name的集合中的一个元素 </td> 
 <td> name：键名 </td> 
 <td> redis.spop('tags') </td> 
 <td> 从键为tags的集合中随机删除并返回该元素 </td> 
 <td> b'Tea' </td> 
 </tr> 
 <tr> 
 <td> smove(src, dst, value) </td> 
 <td> 从src对应的集合中移除元素并将其添加到dst对应的集合中 </td> 
 <td> src：源集合；dst：目标集合；value：元素值 </td> 
 <td> redis.smove('tags', 'tags2', 'Coffee') </td> 
 <td> 从键为tags的集合中删除元素Coffee并将其添加到键为tags2的集合 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> scard(name) </td> 
 <td> 返回键为name的集合的元素个数 </td> 
 <td> name：键名 </td> 
 <td> redis.scard('tags') </td> 
 <td> 获取键为tags的集合中的元素个数 </td> 
 <td> 3 </td> 
 </tr> 
 <tr> 
 <td> sismember(name, value) </td> 
 <td> 测试member是否是键为name的集合的元素 </td> 
 <td> name：键值 </td> 
 <td> redis.sismember('tags', 'Book') </td> 
 <td> 判断Book是否是键为tags的集合元素 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> sinter(keys, *args) </td> 
 <td> 返回所有给定键的集合的交集 </td> 
 <td> keys：键列表 </td> 
 <td> redis.sinter(['tags', 'tags2']) </td> 
 <td> 返回键为tags的集合和键为tags2的集合的交集 </td> 
 <td> {b'Coffee'} </td> 
 </tr> 
 <tr> 
 <td> sinterstore(dest, keys, *args) </td> 
 <td> 求交集并将交集保存到dest的集合 </td> 
 <td> dest：结果集合；keys：键列表 </td> 
 <td> redis.sinterstore('inttag', ['tags', 'tags2']) </td> 
 <td> 求键为tags的集合和键为tags2的集合的交集并将其保存为inttag </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> sunion(keys, *args) </td> 
 <td> 返回所有给定键的集合的并集 </td> 
 <td> keys：键列表 </td> 
 <td> redis.sunion(['tags', 'tags2']) </td> 
 <td> 返回键为tags的集合和键为tags2的集合的并集 </td> 
 <td> {b'Coffee', b'Book', b'Pen'} </td> 
 </tr> 
 <tr> 
 <td> sunionstore(dest, keys, *args) </td> 
 <td> 求并集并将并集保存到dest的集合 </td> 
 <td> dest：结果集合；keys：键列表 </td> 
 <td> redis.sunionstore('inttag', ['tags', 'tags2']) </td> 
 <td> 求键为tags的集合和键为tags2的集合的并集并将其保存为inttag </td> 
 <td> 3 </td> 
 </tr> 
 <tr> 
 <td> sdiff(keys, *args) </td> 
 <td> 返回所有给定键的集合的差集 </td> 
 <td> keys：键列表 </td> 
 <td> redis.sdiff(['tags', 'tags2']) </td> 
 <td> 返回键为tags的集合和键为tags2的集合的差集 </td> 
 <td> {b'Book', b'Pen'} </td> 
 </tr> 
 <tr> 
 <td> sdiffstore(dest, keys, *args) </td> 
 <td> 求差集并将差集保存到dest集合 </td> 
 <td> dest：结果集合；keys：键列表 </td> 
 <td> redis.sdiffstore('inttag', ['tags', 'tags2']) </td> 
 <td> 求键为tags的集合和键为tags2的集合的差集并将其保存为inttag` </td> 
 <td> 3 </td> 
 </tr> 
 <tr> 
 <td> smembers(name) </td> 
 <td> 返回键为name的集合的所有元素 </td> 
 <td> name：键名 </td> 
 <td> redis.smembers('tags') </td> 
 <td> 返回键为tags的集合的所有元素 </td> 
 <td> {b'Pen', b'Book', b'Coffee'} </td> 
 </tr> 
 <tr> 
 <td> srandmember(name) </td> 
 <td> 随机返回键为name的集合中的一个元素，但不删除元素 </td> 
 <td> name：键值 </td> 
 <td> redis.srandmember('tags') </td> 
 <td> 随机返回键为tags的集合中的一个元素 </td> 
 <td>&nbsp;</td> 
 </tr> 
 </tbody> 
</table>

## 8. 有序集合操作 ##

有序集合比集合多了一个分数字段，利用它可以对集合中的数据进行排序，其用法总结如下表所示。

<table> 
 <thead> 
 <tr> 
 <th> 方法 </th> 
 <th> 作用 </th> 
 <th> 参数说明 </th> 
 <th> 示例 </th> 
 <th> 示例说明 </th> 
 <th> 示例结果 </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> zadd(name, *args, **kwargs) </td> 
 <td> 向键为name的zset中添加元素member，score用于排序。如果该元素存在，则更新其顺序 </td> 
 <td> name： 键名；args：可变参数 </td> 
 <td> redis.zadd('grade', 100, 'Bob', 98, 'Mike') </td> 
 <td> 向键为grade的zset中添加Bob（其score为100），并添加Mike（其score为98） </td> 
 <td> 2，即添加的元素个数 </td> 
 </tr> 
 <tr> 
 <td> zrem(name, *values) </td> 
 <td> 删除键为name的zset中的元素 </td> 
 <td> name：键名；values：元素 </td> 
 <td> redis.zrem('grade', 'Mike') </td> 
 <td> 从键为grade的zset中删除Mike </td> 
 <td> 1，即删除的元素个数 </td> 
 </tr> 
 <tr> 
 <td> zincrby(name, value, amount=1) </td> 
 <td> 如果在键为name的zset中已经存在元素value，则将该元素的score增加amount；否则向该集合中添加该元素，其score的值为amount </td> 
 <td> name：key名；value：元素；amount：增长的score值 </td> 
 <td> redis.zincrby('grade', 'Bob', -2) </td> 
 <td> 键为grade的zset中Bob的score减2 </td> 
 <td> 98.0，即修改后的值 </td> 
 </tr> 
 <tr> 
 <td> zrank(name, value) </td> 
 <td> 返回键为name的zset中元素的排名，按score从小到大排序，即名次 </td> 
 <td> name：键名；value：元素值 </td> 
 <td> redis.zrank('grade', 'Amy') </td> 
 <td> 得到键为grade的zset中Amy的排名 </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> zrevrank(name, value) </td> 
 <td> 返回键为name的zset中元素的倒数排名（按score从大到小排序），即名次 </td> 
 <td> name：键名；value：元素值 </td> 
 <td> redis.zrevrank('grade', 'Amy') </td> 
 <td> 得到键为grade的zset中Amy的倒数排名 </td> 
 <td> 2 </td> 
 </tr> 
 <tr> 
 <td> zrevrange(name, start, end, withscores=False) </td> 
 <td> 返回键为name的zset（按score从大到小排序）中index从start到end的所有元素 </td> 
 <td> name：键值；start：开始索引；end：结束索引；withscores：是否带score </td> 
 <td> redis.zrevrange('grade', 0, 3) </td> 
 <td> 返回键为grade的zset中前四名元素 </td> 
 <td> [b'Bob', b'Mike', b'Amy', b'James'] </td> 
 </tr> 
 <tr> 
 <td> zrangebyscore(name, min, max, start=None, num=None, withscores=False) </td> 
 <td> 返回键为name的zset中score在给定区间的元素 </td> 
 <td> name：键名；min：最低score；max：最高score； start：起始索引；num：个数；withscores：是否带score </td> 
 <td> redis.zrangebyscore('grade', 80, 95) </td> 
 <td> 返回键为grade的zset中score在80和95之间的元素 </td> 
 <td> [b'Bob', b'Mike', b'Amy', b'James'] </td> 
 </tr> 
 <tr> 
 <td> zcount(name, min, max) </td> 
 <td> 返回键为name的zset中score在给定区间的数量 </td> 
 <td> name：键名；min：最低score；max：最高score </td> 
 <td> redis.zcount('grade', 80, 95) </td> 
 <td> 返回键为grade的zset中score在80到95的元素个数 </td> 
 <td> 2 </td> 
 </tr> 
 <tr> 
 <td> zcard(name) </td> 
 <td> 返回键为name的zset的元素个数 </td> 
 <td> name：键名 </td> 
 <td> redis.zcard('grade') </td> 
 <td> 获取键为grade的zset中元素的个数 </td> 
 <td> 3 </td> 
 </tr> 
 <tr> 
 <td> zremrangebyrank(name, min, max) </td> 
 <td> 删除键为name的zset中排名在给定区间的元素 </td> 
 <td> name：键名；min：最低位次；max：最高位次 </td> 
 <td> redis.zremrangebyrank('grade', 0, 0) </td> 
 <td> 删除键为grade的zset中排名第一的元素 </td> 
 <td> 1，即删除的元素个数 </td> 
 </tr> 
 <tr> 
 <td> zremrangebyscore(name, min, max) </td> 
 <td> 删除键为name的zset中score在给定区间的元素 </td> 
 <td> name：键名；min：最低score；max：最高score </td> 
 <td> redis.zremrangebyscore('grade', 80, 90) </td> 
 <td> 删除score在80到90之间的元素 </td> 
 <td> 1，即删除的元素个数 </td> 
 </tr> 
 </tbody> 
</table>

## 9. 散列操作 ##

Redis还提供了散列表的数据结构，我们可以用`name`指定一个散列表的名称，表内存储了各个键值对，用法总结如下表所示。

<table> 
 <thead> 
 <tr> 
 <th> 方法 </th> 
 <th> 作用 </th> 
 <th> 参数说明 </th> 
 <th> 示例 </th> 
 <th> 示例说明 </th> 
 <th> 示例结果 </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> hset(name, key, value) </td> 
 <td> 向键为name的散列表中添加映射 </td> 
 <td> name：键名；key：映射键名；value：映射键值 </td> 
 <td> hset('price', 'cake', 5) </td> 
 <td> 向键为price的散列表中添加映射关系，cake的值为5 </td> 
 <td> 1，即添加的映射个数 </td> 
 </tr> 
 <tr> 
 <td> hsetnx(name, key, value) </td> 
 <td> 如果映射键名不存在，则向键为name的散列表中添加映射 </td> 
 <td> name：键名；key：映射键名；value：映射键值 </td> 
 <td> hsetnx('price', 'book', 6) </td> 
 <td> 向键为price的散列表中添加映射关系，book的值为6 </td> 
 <td> 1，即添加的映射个数 </td> 
 </tr> 
 <tr> 
 <td> hget(name, key) </td> 
 <td> 返回键为name的散列表中key对应的值 </td> 
 <td> name：键名；key：映射键名 </td> 
 <td> redis.hget('price', 'cake') </td> 
 <td> 获取键为price的散列表中键名为cake的值 </td> 
 <td> 5 </td> 
 </tr> 
 <tr> 
 <td> hmget(name, keys, *args) </td> 
 <td> 返回键为name的散列表中各个键对应的值 </td> 
 <td> name：键名；keys：映射键名列表 </td> 
 <td> redis.hmget('price', ['apple', 'orange']) </td> 
 <td> 获取键为price的散列表中apple和orange的值 </td> 
 <td> [b'3', b'7'] </td> 
 </tr> 
 <tr> 
 <td> hmset(name, mapping) </td> 
 <td> 向键为name的散列表中批量添加映射 </td> 
 <td> name：键名；mapping：映射字典 </td> 
 <td> redis.hmset('price', {'banana': 2, 'pear': 6}) </td> 
 <td> 向键为price的散列表中批量添加映射 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> hincrby(name, key, amount=1) </td> 
 <td> 将键为name的散列表中映射的值增加amount </td> 
 <td> name：键名；key：映射键名；amount：增长量 </td> 
 <td> redis.hincrby('price', 'apple', 3) </td> 
 <td> key为price的散列表中apple的值增加3 </td> 
 <td> 6，修改后的值 </td> 
 </tr> 
 <tr> 
 <td> hexists(name, key) </td> 
 <td> 键为name的散列表中是否存在键名为键的映射 </td> 
 <td> name：键名；key：映射键名 </td> 
 <td> redis.hexists('price', 'banana') </td> 
 <td> 键为price的散列表中banana的值是否存在 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> hdel(name, *keys) </td> 
 <td> 在键为name的散列表中，删除键名为键的映射 </td> 
 <td> name：键名；keys：映射键名 </td> 
 <td> redis.hdel('price', 'banana') </td> 
 <td> 从键为price的散列表中删除键名为banana的映射 </td> 
 <td> True </td> 
 </tr> 
 <tr> 
 <td> hlen(name) </td> 
 <td> 从键为name的散列表中获取映射个数 </td> 
 <td> name： 键名 </td> 
 <td> redis.hlen('price') </td> 
 <td> 从键为price的散列表中获取映射个数 </td> 
 <td> 6 </td> 
 </tr> 
 <tr> 
 <td> hkeys(name) </td> 
 <td> 从键为name的散列表中获取所有映射键名 </td> 
 <td> name：键名 </td> 
 <td> redis.hkeys('price') </td> 
 <td> 从键为price的散列表中获取所有映射键名 </td> 
 <td> [b'cake', b'book', b'banana', b'pear'] </td> 
 </tr> 
 <tr> 
 <td> hvals(name) </td> 
 <td> 从键为name的散列表中获取所有映射键值 </td> 
 <td> name：键名 </td> 
 <td> redis.hvals('price') </td> 
 <td> 从键为price的散列表中获取所有映射键值 </td> 
 <td> [b'5', b'6', b'2', b'6'] </td> 
 </tr> 
 <tr> 
 <td> hgetall(name) </td> 
 <td> 从键为name的散列表中获取所有映射键值对 </td> 
 <td> name：键名 </td> 
 <td> redis.hgetall('price') </td> 
 <td> 从键为price的散列表中获取所有映射键值对 </td> 
 <td> {b'cake': b'5', b'book': b'6', b'orange': b'7', b'pear': b'6'} </td> 
 </tr> 
 </tbody> 
</table>

## 10. RedisDump ##

RedisDump提供了强大的Redis数据的导入和导出功能，现在就来看下它的具体用法。

首先，确保已经安装好了RedisDump。

RedisDump提供了两个可执行命令：`redis-dump`用于导出数据，`redis-load`用于导入数据。

## redis-dump ##

首先，可以输入如下命令查看所有可选项：

redis-dump -h

运行结果如下：

Usage: redis-dump [global options] COMMAND [command options] 
        -u, --uri=S                      Redis URI (e.g. redis://hostname[:port])
        -d, --database=S                 Redis database (e.g. -d 15)
        -s, --sleep=S                    Sleep for S seconds after dumping (for debugging)
        -c, --count=S                    Chunk size (default: 10000)
        -f, --filter=S                   Filter selected keys (passed directly to redis' KEYS command)
        -O, --without_optimizations      Disable run time optimizations
        -V, --version                    Display version
        -D, --debug
            --nosafe

其中`-u`代表Redis连接字符串，`-d`代表数据库代号，`-s`代表导出之后的休眠时间，`-c`代表分块大小，默认是10000，`-f`代表导出时的过滤器，`-O`代表禁用运行时优化，`-V`用于显示版本，`-D`表示开启调试。

我们拿本地的Redis做测试，运行在6379端口上，密码为foobared，导出命令如下：

redis-dump -u :foobared@localhost:6379

如果没有密码的话，可以不加密码前缀，命令如下：

redis-dump -u localhost:6379

运行之后，可以将本地0至15号数据库的所有数据输出出来，例如：

{"db":0,"key":"name","ttl":-1,"type":"string","value":"James","size":5}
    {"db":0,"key":"name2","ttl":-1,"type":"string","value":"Durant","size":6}
    {"db":0,"key":"name3","ttl":-1,"type":"string","value":"Durant","size":6}
    {"db":0,"key":"name4","ttl":-1,"type":"string","value":"HelloWorld","size":10}
    {"db":0,"key":"name5","ttl":-1,"type":"string","value":"James","size":5}
    {"db":0,"key":"name6","ttl":-1,"type":"string","value":"James","size":5}
    {"db":0,"key":"age","ttl":-1,"type":"string","value":"1","size":1}
    {"db":0,"key":"age2","ttl":-1,"type":"string","value":"-5","size":2}

每条数据都包含6个字段，其中`db`即数据库代号，`key`即键名，`ttl`即该键值对的有效时间，`type`即键值类型，`value`即内容，`size`即占用空间。

如果想要将其输出为JSON行文件，可以使用如下命令：

redis-dump -u :foobared@localhost:6379 > ./redis_data.jl

这样就可以成功将Redis的所有数据库的所有数据导出成JSON行文件了。

另外，可以使用`-d`参数指定某个数据库的导出，例如只导出1号数据库的内容：

redis-dump -u :foobared@localhost:6379 -d 1 > ./redis.data.jl

如果只想导出特定的内容，比如想导出以`adsl`开头的数据，可以加入`-f`参数用来过滤，命令如下：

redis-dump -u :foobared@localhost:6379 -f adsl:* > ./redis.data.jl

其中`-f`参数即Redis的`keys`命令的参数，可以写一些过滤规则。

## redis-load ##

同样，我们可以首先输入如下命令查看所有可选项：

redis-load -h

运行结果如下：

redis-load --help
      Try: redis-load [global options] COMMAND [command options] 
        -u, --uri=S                      Redis URI (e.g. redis://hostname[:port])
        -d, --database=S                 Redis database (e.g. -d 15)
        -s, --sleep=S                    Sleep for S seconds after dumping (for debugging)
        -n, --no_check_utf8
        -V, --version                    Display version
        -D, --debug
            --nosafe

其中`-u`代表Redis连接字符串，`-d`代表数据库代号，默认是全部，`-s`代表导出之后的休眠时间，`-n`代表不检测UTF-8编码，`-V`表示显示版本，`-D`表示开启调试。

我们可以将JSON行文件导入到Redis数据库中：

< redis_data.json redis-load -u :foobared@localhost:6379

这样就可以成功将JSON行文件导入到数据库中了。

另外，下面的命令同样可以达到同样的效果：

cat redis_data.json | redis-load -u :foobared@localhost:6379

本节中，我们不仅了解了RedisPy对Redis数据库的一些基本操作，还演示了RedisDump对数据的导入导出操作。