redis是一个key-value存储系统，与memcached类似，它支持存储到value类型相对更多，包括string（字符串），list（列表），set（集合），zset(sorted set --有序集合）和hash(哈希类型），这些数据类型都支持push/pop,add/remove及取交集和并集和差集及更丰富的操作，而且这些操作都是原子性的，在此基础上，redis支持各种不同方式的排序，与memcached一样，为了保证效率，数据都是缓存在内存中，区别是redis会周期性的把更新的数据写入磁盘或者把修改操作写入追加的纪录文件，并且在此基础上，实现了master-slave主从同步
1.启动客户端
redis默认端口6379
通过shell命令redis-cli
1 127.0.0.1:6379> set name hello 2 OK 3 127.0.0.1:6379> get name 4 "hello"
通过python操作
pip install redis
1 import redis 2 3 r = redis.Redis(host="127.0.0.1", port=6379) 4 r.set("user", "zengchunyun") 5 user = r.get("user") # 获取KEY为user的值 6 print(user) # python3获取的是bytes类型数据,使用时需要准换成UTF8类型
上面这种方式每次操作redis都需要进行一次连接操作，资源浪费严重，所以一般操作时都采取连接池方式
redis-py使用connection pool来管理对一个redis server的所有连接，避免每次建立释放连接的开销，默认，每个redis实例都会维护一个自己的连接池，可以直接建立一个连接池，然后作为参数redis，这样可以实现多个redis实例共享一个连接池
1 pool = redis.ConnectionPool(host="127.0.0.1", port=6379) 2 r = redis.Redis(connection_pool=pool) 3 r.set("user", "python") 4 user = r.get("user") 5 print(user) 6 7 # b'python'
2.操作
string操作，redis中的string在内存中按照一个name对应一个value来存储
1 SET key value [EX seconds] [PX milliseconds] [NX|XX] 2 summary: Set the string value of a key 3 since: 1.0.0 4 group: string
1 r.set(name="user", value="zengchunyun", ex=100, px=None, nx=True, xx=False) 2 user = r.get("user") 3 print(user) 4 # 当nx为True时,则只有不存在name时,set操作才会执行 5 r.set(name="user", value="zengchunyun", ex=100, px=None, nx=False, xx=True) 6 user = r.get("user") 7 print(user) 8 9 # 当 xx为True时,只有name存在时,set操作才会执行 10 r.set(name="pwd", value="zengchunyun", ex=100, px=None, nx=True, xx=True) 11 user = r.get("pwd") 12 print(user) 13 # 当nx,xx同时为True时,结果为None
setnx
1 r.setnx(name="age", value=10) 2 age = r.get("age") 3 print(age) # 打印10 4 r.setnx(name="age", value=100) 5 age = r.get("age") 6 print(age) # 打印10 7 # setnx只有name不存在时,才执行操作
setex
1 import datetime 2 3 date = datetime.timedelta(seconds=100) 4 print(date) 5 r.setex(name="user", value=111, time=date) 6 print(r.get("user"))
psetex
1 date = datetime.timedelta(milliseconds=100) 2 r.psetex(name="user", time_ms=date, value=121) 3 print(r.get("user"))
mset
1 r.mset(k1=110, k2=119) # 设置多个值 2 r.mset({"k1": 120, "k2": 121}) 3 print(r.mget("k2")) # 取单个值 4 print(r.mget("k1", "k2")) # 取多个值,返回的都是列表类型 5 print(r.mget(["k1", "k2"]))
getset
1 r.set(name="user", value="zcy") 2 print(r.get("user")) # 获取键值 3 print(r.getset(name="user", value="newzcy")) # 设置新值,并获取原来的值,不存在则为none 4 print(r.get("user")) # 打印新值 5 # b'zcy' 6 # b'zcy' 7 # b'newzcy'
getrange
1 user = r.getrange(key="user", start=0, end=-1) 2 print(user) 3 user = r.getrange(key="user", start=0, end=-2) 4 print(user) 5 user = r.getrange(key="user", start=1, end=-1) 6 print(user) # 从第1位,也就是下标为1的元素,结束为最后一位 7 user = r.getrange(key="user", start=0, end=1) 8 print(user) # 包括开始位置,以及结束位置 9 # b'newzcy' 10 # b'newzc' 11 # b'ewzcy' 12 # b'ne'
setrange
1 print(r.get("user")) 2 r.setrange(name="user", offset=1, value=22) # 从下标1开始修改user的值, 3 print(r.get("user")) 4 # b'n22zcy' 5 # b'n22zcy'
1 print(r.get("user")) 2 r.setrange(name="user", offset=1, value="我") # 从下标1开始修改user的值,如果是汉字,泽占三个字节 3 print(r.get("user")) 4 # b'n222222' 5 # b'nxe6x88x91222'
setbit
1 r.set(name="user", value="110") # 字符串表示法 2 user = r.get("user") # 打印字符串内容为110 3 print(user) 4 user_li = list(map(lambda x: ord(x), str(user, "utf8"))) 5 print(user_li) # 打印每个字符在计算机中实际的十进制数值 [49, 49, 48] 6 print(list(map(lambda x: bin(x), user_li))) # 打印每个字符在计算机中代表的实际二进制位 ['0b110001', '0b110001', '0b110000'] 7 print("-" * 20) 8 print(r.getbit(name="user", offset=9)) # 查看第二个字节对第二位,也就是下标为1的位,这位显示为0 9 r.setbit(name="user", offset=9, value=1) # 计算机中每个字符范围-127~127, 10 # 即11111111~01111111,最高位也就是下标为0的位代表一个数的正负符号,为1则代表负数,为0则为正数 11 # 故而如果修改一个二进制数的最高位则表示去修改他的正负符号位,字符串是没有符号的,只有整数才有符号之分 12 # ,所以如果使用符号方式,是不能进行将一个负的二进制转换成字符 13 print("xb1") # 表示+-符号 14 user = r.get("user") # 这里我们修改第二个字节的第二位也就是下标为1,原来这位为0,也就是这位现在的十进制由49变成了 15 # ,64+49=113,第二位二进制表示的十进制数为64,十进制的113对应的字符为q 16 print(user) # 所以这里打印的是1q0 17 user_li = list(map(lambda x: ord(x), str(user, "utf8"))) 18 print(user_li) # [49, 113, 48] 19 print("-" * 20) 20 print(list(map(lambda x: bin(x), user_li))) # ['0b110001', '0b1110001', '0b110000'] 21 print(r.getbit(name="user", offset=9)) # 查看第二个字节对第二位,也就是下标为1的位,也就是我们刚才设置的位由0变成了1
bitcount
1 r.setbit(name="count", offset=1, value=1) 2 r.setbit(name="count", offset=2, value=1) 3 r.setbit(name="count", offset=3, value=1) 4 print(r.bitcount(key="count")) # 统计一个二进制数有多少位是1
strlen
1 r.set(name="user", value="曾") 2 print(r.strlen(name="user")) 3 r.set(name="user", value="1") 4 print(r.strlen(name="user")) 5 r.set(name="user", value=12) 6 print(r.strlen(name="user"))
incr
1 r.set(name="user", value=1) 2 r.incr(name="user", amount=1) 3 print(r.get("user")) 4 r.incr(name="user", amount=1) 5 print(r.get("user")) 6 r.incr(name="user", amount=1) 7 print(r.get("user")) 8 # b'2' 9 # b'3' 10 # b'4'
incrbyfloat
1 r.set(name="user", value=1.1) 2 r.incrbyfloat(name="user", amount=1.2) 3 print(r.get("user")) 4 r.incrbyfloat(name="user", amount=1) 5 print(r.get("user")) 6 r.incrbyfloat(name="user", amount=1) 7 print(r.get("user")) 8 # b'2.3' 9 # b'3.3' 10 # b'4.3'
decr
1 r.set(name="user", value=3) 2 r.decr(name="user", amount=1) 3 print(r.get("user")) 4 r.decr(name="user", amount=1) 5 print(r.get("user")) 6 r.decr(name="user", amount=1) 7 print(r.get("user")) 8 # b'2' 9 # b'1' 10 # b'0'
append
1 r.set(name="user", value="1") 2 r.append(key="user", value="21") # 将21追加到到键值 3 print(r.get("user"))
hset
1 r.hset(name="info", key="name", value="zengchunyun") 2 print(r.hget(name="info", key="name")) 3 r.hmset(name="info",mapping={"k1": 1, "k2": 23}) 4 print(r.hmget(name="info", keys="k1")) 5 print(r.hmget("info", ["k1", "k2", "k3"])) 6 print(r.hgetall(name="info")) 7 print(r.hlen(name="info")) 8 print(r.hkeys("info")) 9 print(r.hvals("info")) 10 print(r.exists("hello")) 11 print(r.exists("info")) 12 print(r.hdel("info","k3")) # 删除指定键 13 print(r.hkeys("info")) 14 print(r.hincrby(name="info", key="count", amount=1)) 15 print(r.hincrby(name="info", key="count", amount=1)) 16 print(r.hincrbyfloat(name="info", key="count_f", amount=1.1)) 17 print(r.hincrbyfloat(name="info", key="count_f", amount=1.1)) 18 print(r.hincrbyfloat(name="info", key="count_f", amount=1.1)) 19 print(r.hscan(name="info")) 20 print(r.hscan(name="info", count=2, match="k2")) 21 22 23 # b'zengchunyun' 24 # [b'1'] 25 # [b'1', b'23', None] 26 # {b'k2': b'23', b'k1': b'1', b'count': b'15', b'count_f': b'19.8', b'name': b'zengchunyun'} 27 # 5 28 # [b'name', b'k1', b'k2', b'count', b'count_f'] 29 # [b'zengchunyun', b'1', b'23', b'15', b'19.8'] 30 # False 31 # True 32 # 0 33 # [b'name', b'k1', b'k2', b'count', b'count_f'] 34 # 16 35 # 17 36 # 20.9 37 # 22.0 38 # 23.1 39 # (0, {b'k2': b'23', b'k1': b'1', b'count': b'17', b'count_f': b'23.1', b'name': b'zengchunyun'}) 40 # (0, {b'k2': b'23'})
lpush，列表基本操作
1 print(r.delete("oo")) # 返回删除的列表个数 2 print(r.lpush('oo', 11,22,33)) # 返回的是列表的长度,从右向左添加每个元素,也就是['33', '22', '11'] 3 print(r.lrange(name="oo", start=0, end=-1)) 4 5 print(r.lpushx(name="oo", value=44)) # 在对应的列表中添加元素,如果name已经存在,则添加到列表的最左边,[b'44', b'33', b'22', b'11'] 6 print(r.lrange(name="oo", start=0, end=-1)) 7 8 print(r.llen(name="oo")) 9 print(r.rpush("oo", 55, 66)) # 在列表oo中从左向右添加元素, [b'44', b'33', b'22', b'11', b'55', b'66'] 10 print(r.lrange(name="oo", start=0, end=-1)) 11 12 print(r.rpushx(name="oo", value=41)) # 只有name存在时,则在列表从左向右添加数据, [b'44', b'33', b'22', b'11', b'55', b'66', b'41'] 13 print(r.lrange(name="oo", start=0, end=-1)) 14 15 print(r.rpushx(name="too", value=41)) # 只有name存在时,则在列表从左向右添加数据 16 print(r.lrange(name="too", start=0, end=-1)) 17 18 print(r.linsert(name="oo", where="BEFORE", refvalue="41", value=12)) # 在列表oo里,如果存在41这个元素,则在第一次找到的41元素前 19 # 插入新元素12,不存在则返回-1, [b'44', b'33', b'22', b'11', b'55', b'66', b'12', b'41'] 20 print(r.lrange(name="oo", start=0, end=-1)) 21 22 print(r.linsert(name="oo", where="AFTER", refvalue="41", value=12)) # 在列表oo里,如果存在41这个元素,则在第一次找到的41元素后 23 # 插入新元素12,不存在则返回-1, [b'44', b'33', b'22', b'11', b'55', b'66', b'12', b'41', b'12'] 24 print(r.lrange(name="oo", start=0, end=-1)) 25 26 print(r.lset(name="oo", index=2, value=13)) # 对列表oo下标为2的元素修改值为13,修改成功为True,否则异常, 27 # [b'44', b'33', b'13', b'11', b'55', b'66', b'12', b'41', b'12'] 28 print(r.lrange(name="oo", start=0, end=-1)) 29 30 print(r.lrem(name="oo", value=41, num=1)) # 找到列表元素为41的对象,num=0,则删除所有元素为41的对象,num=3,则表示从前到后删除3个元素 31 # num=-3表示从后向前删除3个,返回删除的个数,[b'44', b'33', b'13', b'11', b'55', b'66', b'12', b'12'] 32 print(r.lrange(name="oo", start=0, end=-1)) 33 34 print(r.lpop(name="oo")) # 在列表中,从左侧获取第一个元素从列表移除,返回第一个移除的元素 35 print(r.lrange(name="oo", start=0, end=-1)) # [b'33', b'13', b'11', b'55', b'66', b'12', b'12'] 36 37 print(r.rpop(name="oo")) # 在列表中,从右侧获取最后一个元素从列表移除,返回最后一个元素 38 print(r.lrange(name="oo", start=0, end=-1)) # [b'33', b'13', b'11', b'55', b'66', b'12'] 39 40 41 print(r.lindex(name="oo", index=2)) # 获取列表里下标为2的元素 42 print(r.lrange(name="oo", start=0, end=-1)) # [b'33', b'13', b'11', b'55', b'66', b'12'] 43 44 45 print(r.ltrim(name="oo", start=1, end=4)) # 移除下标为1元素之前的元素,不包括下标1,以及移除下标4之后的元素,但不包括下标4 46 print(r.lrange(name="oo", start=0, end=-1)) # [b'13', b'11', b'55', b'66']
blpop
1 print(r.delete("userli")) 2 print(r.delete("newli")) 3 print(r.lpush("userli", 11, 22, 33, 44, 33, 22)) # 从右向左添加元素,[b'22', b'33', b'44', b'33', b'22', b'11'] 4 print(r.lrange(name="userli", start=0, end=-1)) 5 6 print(r.lpush("newli", 23)) 7 8 print(r.rpoplpush(src="userli", dst="newli")) # 从一个列表移除最右边的元素,添加到另一个列表的最左边,同时返回移除的元素 9 print(r.lrange(name="userli", start=0, end=-1)) # [b'22', b'33', b'44', b'33', b'22'] 10 print(r.lrange(name="newli", start=0, end=-1)) # [b'11', b'23'] 11 12 13 print(r.blpop(keys="userli", timeout=100)) # 删除和获取列表中第一个元素,或阻塞直到有可用, (b'userli', b'22') 14 print(r.lrange(name="userli", start=0, end=-1)) # [b'33', b'44', b'33', b'22'] 15 16 print(r.brpop(keys="userli", timeout=0)) # 删除并获取列表最后一个元素,或阻塞直到有可用元素,(b'userli', b'22') 17 print(r.lrange(name="userli", start=0, end=-1)) # [b'33', b'44', b'33'] 18 print(r.blpop(keys="userl", timeout=5)) # 删除和获取列表中第一个元素,或阻塞直到有可用, (b'userl', b'33') 19 print(r.lrange(name="userl", start=0, end=-1)) 20 21 print(r.brpoplpush(src="userli", dst="userl", timeout=0)) # 取出列表最右侧的元素并移除返回,增加到目标列表 22 print(r.lrange(name="userli", start=0, end=-1)) # [b'33', b'44'] 23 print(r.lrange(name="userl", start=0, end=-1)) # [b'33'] 24 25 26 # 1 27 # 1 28 # 6 29 # [b'22', b'33', b'44', b'33', b'22', b'11'] 30 # 1 31 # b'11' 32 # [b'22', b'33', b'44', b'33', b'22'] 33 # [b'11', b'23'] 34 # (b'userli', b'22') 35 # [b'33', b'44', b'33', b'22'] 36 # (b'userli', b'22') 37 # [b'33', b'44', b'33'] 38 # (b'userl', b'33') 39 # [] 40 # b'33' 41 # [b'33', b'44'] 42 # [b'33']
集合
1 r.delete("s") 2 r.delete('s2') 3 print(r.sadd("s", "a", 'b')) # 添加数据到集合's' 4 print(r.smembers('s')) # 查看集合成员 5 print(r.scard('s')) # 判定集合长度,不存在则为0 6 print(r.sismember('s', 'a')) # 判定对象是否存在集合里 7 print(r.sadd('s2', 'a')) 8 print(r.sinter('s', 's2')) # 获取两个集合的交集,{b'a'} 9 print(r.sinterstore('s3', 's', 's2')) # 求交集,并把结果付给s3,返回交集个数 10 print(r.smembers('s3')) 11 12 print(r.smembers('s')) # {b'b', b'a'} 13 print(r.smembers('s2')) # {b'a'} 14 print(r.sunion('s', 's2')) # {b'b', b'a'}求并集,返回两个集合的所有元素,不重复 15 16 print(r.sunionstore('s4', 's', 's2')) # 将两个集合的并集赋值给s4 17 print(r.smembers('s4')) 18 19 print(r.sdiff('s', 's2')) # 求集合s里有,但是集合s2里没有的元素 20 print(r.sdiffstore('s5', 's', 's2')) # 将两个集合的差集赋值给S5 21 print(r.smembers('s5')) 22 23 print(r.srandmember('s')) # 取随机元素 24 25 print(r.smove(src='s', dst='s6', value='b')) # 将集合成员b移到另一个集合,成功为True,否则False 26 print(r.smembers('s6')) 27 print(r.smembers('s')) 28 29 print(r.sadd('s', 11, 33, 44)) 30 print(r.smembers('s')) 31 print(r.spop('s')) # 移除尾部一个成员,并将其返回 32 print(r.srem('s', 11)) # 删除集合成员11 33 print(r.smembers('s')) 34 35 36 # 2 37 # {b'a', b'b'} 38 # 2 39 # True 40 # 1 41 # {b'a'} 42 # 1 43 # {b'a'} 44 # {b'a', b'b'} 45 # {b'a'} 46 # {b'a', b'b'} 47 # 2 48 # {b'a', b'b'} 49 # {b'b'} 50 # 1 51 # {b'b'} 52 # b'a' 53 # True 54 # {b'b'} 55 # {b'a'} 56 # 3 57 # {b'11', b'a', b'44', b'33'} 58 # b'44' 59 # 1 60 # {b'a', b'33'}
1 print(r.sadd('s', 11, 22, 33, 11, 10)) 2 print(r.sscan(name='s', count=1, match="1*")) # 匹配集合1*的成员 3 print(r.sscan_iter('s', match='1*')) # 返回一个迭代器,用于增量分批获取元素,避免内存消耗太大
有序集合
1 print(r.delete('zs')) 2 print(r.zadd('zs', 'h1', 1, 'h2', 2)) 3 print(r.zadd('zs', n1=11, n2=22)) 4 5 print(r.zcard('zs')) # 获取集合长度,也就是成员个数 6 print(r.zcount('zs', 1, 23)) # 获取集合分数在1到23之间,包含1和23的个数 7 8 print(r.zincrby('zs', 11, amount=1)) # 自增集合对应成员的有序集合的对应分数 9 print(r.zincrby('zs', 11, amount=1)) 10 print(r.zrange(name='zs', start=0, end=-1)) # 获取集合范围内的有序集合成员 11 # 参数： 12 # name，redis的name 13 # start，有序集合索引起始位置（非分数） 14 # end，有序集合索引结束位置（非分数） 15 # desc，排序规则，默认按照分数从小到大排序 16 # withscores，是否获取元素的分数，默认只获取元素的值 17 # score_cast_func，对分数进行数据转换的函数 18 19 print(r.zrevrange(name='zs', start=0, end=-1)) # 按照分数从大到小排序集合 20 21 print(r.zrangebyscore(name='zs', min=1, max=11)) # 获取集合分数内的成员 22 print(r.zrevrangebyscore(name='zs', max=13, min=1)) # 按照分数从大到小排序集合成员 23 24 print(r.zrank(name='zs', value='h2')) # 获取某个成员在集合中的排行 25 print(r.zrevrank(name='zs', value='n1')) # 从大到小排序,获取某个成员排行位置 26 27 28 print(r.zrem('zs', 'n1')) # 删除集合对应的成员 29 print(r.zrange('zs', 0, -1)) 30 31 print(r.zremrangebyrank(name='zs', min=1, max=2)) # 删除指定排序范围成员,即删除下标1,不包含1,到下标2,包含2 32 print(r.zrange('zs', 0, -1))
1 print(r.zremrangebyscore(name='zs', min=1, max=20)) # 删除指定分数范围内的集合成员 2 print(r.zrange(name='zs', start=0, end=-1)) 3 4 print(r.zscore(name='zs', value='n2')) # 返回集合成员对应的分数,浮点数 5 6 r.delete('s2') 7 print(r.zadd('s2', n3=222, n2=222)) 8 print(r.zinterstore(dest='news', keys=['zs', 's2'])) # 求两个有序集合的并集 9 print(r.zrange(name='news', start=0, end=-1)) 10 11 print(r.zunionstore(dest='nn', keys=['zs', 's2'])) # 求两个集合的并集,如果遇到不同值分数,则按照aggregate进行操作 12 # aggregate值为:SUM,MIN,MAX 13 print(r.zrange(name='nn', start=0, end=-1)) 14 15 print(r.zscan(name='zs', count=1)) # 同字符串类似,新增score_cast_func用来进行对分数进行操作 16 17 18 print(r.delete('test')) # 删除任意数据类型 19 print(r.exists(name="test")) # 判断name是否存在 20 21 print(r.keys(pattern="*")) # 打印所有匹配对KEY 22 # KEYS * 匹配数据库中所有 key 。 23 # KEYS h?llo 匹配 hello ， hallo 和 hxllo 等。 24 # KEYS h*llo 匹配 hllo 和 heeeeello 等。 25 # KEYS h[ae]llo 匹配 hello 和 hallo ，但不匹配 hillo 26 print(r.expire(name='zs', time=2)) # 为某个name设置超时时间 27 28 print(r.rename(src='zs', dst='ns')) # 重命名某个name 29 30 print(r.move(name='zs', db=2)) # 将某个name移到到指定DB下,前提name存在,否则返回False 31 32 print(r.randomkey()) # 随机获取一个name,不删除 33 34 print(r.type("zs")) # 获取name对应对类型
管道
redis-py默认值执行每次请求都会创建连接池申请连接，和断开连接池一次连接操作，如果想要在一次请求中指定多个命令，则可以使用pipline实现一次请求指定多个命令，并且默认情况下，一次pipline是原子性操作
1 import redis 2 pool = redis.ConnectionPool(host="127.0.0.1", port=6379) 3 r = redis.Redis(connection_pool=pool) 4 pipe = r.pipeline(transaction=True) 5 r.set('name', 'zengchunyun') 6 r.set('role', 'master') 7 pipe.execute()
发布订阅
创建redis_common.py
1 #!/usr/bin/env python3 2 # -*- coding: utf-8 -*- 3 """ 4 @author: zengchunyun 5 """ 6 import redis 7 8 9 class RedisHelper(object): 10 def __init__(self): 11 self.__conn = redis.Redis(host="127.0.0.1") 12 self.chan_pub = 'fm104.5' 13 self.chan_sub = 'fm104.5' 14 15 def public(self, msg): 16 self.__conn.publish(self.chan_pub, message=msg) 17 return True 18 19 def subscribe(self): 20 pub = self.__conn.pubsub() 21 pub.subscribe(self.chan_sub) 22 pub.parse_response() 23 return pub
创建发布者redis_pub.py
1 #!/usr/bin/env python3 2 # -*- coding: utf-8 -*- 3 """ 4 @author: zengchunyun 5 """ 6 from redis_common import RedisHelper 7 8 obj = RedisHelper() 9 obj.public('hello') # 发布一条消息到频道fm104.5
创建订阅者redis_sub.py
1 #!/usr/bin/env python3 2 # -*- coding: utf-8 -*- 3 """ 4 @author: zengchunyun 5 """ 6 from redis_common import RedisHelper 7 8 obj = RedisHelper() 9 redis_sub = obj.subscribe() 10 11 while True: 12 msg = redis_sub.parse_response() # 此时一直阻塞状态,直到能接收到数据, 13 print(msg)
更多信息参考
https://github.com/andymccurdy/redis-py/
http://doc.redisfans.com/