redis
操作模式
redis-py提供两个类Redis和StrictRedis用于实现Redis的命令,StrictRedis用于实现大部分官方的命令,并使用官方的语法和命令,Redis是StrictRedis的子类,用于向后兼容旧版本的redis-py
import redis r = redis.Redis(host="localhost",port=6379) r.set("foo","Bar") print(r.get("foo"))
连接池
redis-py使用connection pool来管理对一个redis server的所有连接,避免每次建立、释放连接的开销。默认,每个Redis实例都会维护一个自己的连接池。可以直接建立一个连接池,然后作为参数Redis,这样就可以实现多个Redis实例共享一个连接池
String操作:在内存中按键值对来存储(key ----> value)
set(name, value, ex=None, px=None, nx=False, xx=False) # name不存在则创建,存在则修改 参数:(ex/px 或 nx/xx 同时出现时,后面的值会覆盖前面的值) ex:过期时间(秒) px:过期时间(毫秒) nx:如果设置为True,则只有name不存在时,当前set操作才执行 xx:如果设置为True,则只有name存在时,岗前set操作才执行 setnx(name,value) # 只有name不存在时,才会执行设置 setex(name,value,time) # 设置存活时间(秒) psetex(name, time_ms, value) # 设置存活时间(毫秒) mset(*args,**kwargs) # 批量设置 r.mset(name="alex",age=18,sex="m") r.mset({"name":"alex","age":18,"sex":"m"}) get(name) # 获取key值 mge(keys,*args) # 批量获取key值,返回值为列表 r.mget(["name","age","sex"]) r.mget("name","age","sex") getset(name,value) # 设置新值并返回原来的值,没有会创建并返回None getrange(key,start,end) # 获取key值的切片 (根据字节获取,非字符) r.getrange("name",0,2) # 取0-2的字节(取了一个汉字),汉字在utf-8中占3个字节 setrange(name, offset, value) # offset字符串索引从哪开始往后写 r.setrange("name",3,"武沛齐") setbit(name, offset, value) # 设置或清除name值中offset位的偏移(value为:0,1)
# 参数:
# name,redis的name # offset,位的索引(将值变换成二进制后再进行索引) # value,值只能是 1 或 0 # 注:如果在Redis中有一个对应: n1 = "foo", 那么字符串foo的二进制表示为:01100110 01101111 01101111 所以,如果执行 setbit('n1', 7, 1),则就会将第7位设置为1, 那么最终二进制则变成 01100111 01101111 01101111,即:"goo" # 扩展,转换二进制表示: # source = "武沛齐" source = "foo" for i in source: num = ord(i) print bin(num).replace('b','') 特别的,如果source是汉字 "武沛齐"怎么办? 答:对于utf-8,每一个汉字占 3 个字节,那么 "武沛齐" 则有 9个字节 对于汉字,for循环时候会按照 字节 迭代,那么在迭代时,将每一个字节转换 十进制数,然后再将十进制数转换成二进制 11100110 10101101 10100110 11100110 10110010 10011011 11101001 10111101 10010000 -------------------------- ----------------------------- ----------------------------- 武 沛 齐 getbit(name, offset) # 获取name对应的值的二进制表示中的某位的值 (0或1) bitcount(key, start=None, end=None) # 按字节算,获取key对应的值的二进制表示中1的个数 # 参数: # key,Redis的name # start,位起始位置(字节) # end,位结束位置(字节) strlen(name) # 返回name对应值的字节长度(一个汉字3个字节) incr(self, name, amount=1) # 自增 name对应的值,当name不存在时,则创建name=amount,否则,则自增。 # 参数: # name:Redis的name # amount:自增数(必须是整数) incrbyfloat(self, name, amount=1.0) # 自增 name对应的值,当name不存在时,则创建name=amount,否则,则自增。 # 参数: # name,Redis的name # amount,自增数(浮点型) decr(self, name, amount=1) # 自减 name对应的值,当name不存在时,则创建name=amount,否则,则自减。 # 参数: # name,Redis的name # amount,自减数(整数) append(key, value) # 在redis name对应的值后面追加内容 # 参数: # key, redis的name # value, 要追加的字符串
Hash操作:hash表现形式上有些像pyhton中的dict,可以存储一组关联性较强的数据
hset(name,key,value) # name对应的hash中设置一个键值对(不存在,则创建;否则,修改) # 参数:(当name对应的hash中不存当前key时则创建) # name:redis的name # key:name对应的hash中的key # value:name对应的hash中的value hmset(name, mapping) # 在name对应的hash中批量设置键值对 # 参数: # r.hmset('xx', {'k1':'v1', 'k2': 'v2'}) # name,redis的name # mapping,字典,如:{'k1':'v1', 'k2': 'v2'} hget(name,key) # 在name对应的hash中获取根据key获取value hmget(name, keys, *args) # 在name对应的hash中获取多个key的值 # 参数: # name,reids对应的name # keys,要获取key集合,如:['k1', 'k2', 'k3'] # *args,要获取的key,如:k1,k2,k3 hgetall(name) # 获取name对应hash的所有键值 hlen(name) # 获取name对应的hash中键值对的个数 hkeys(name) # 获取name对应的hash中所有的key的值 hvals(name) # 获取name对应的hash中所有的value的值 hexists(name, key) # 检查name对应的hash是否存在当前传入的key,返回True或False hdel(name,*keys) # 将name对应的hash中指定key的键值对删除,返回被删除的个数 hincrby(name, key, amount=1) # 自增name对应的hash中的指定key的值,不存在则创建key=amount,返回更改后的值 # 参数: # name:redis中的name # key:hash对应的key # amount:自增数(整数) hincrbyfloat(name, key, amount=1.0) # 自增name对应的hash中的指定key的值,不存在则创建key=amount,返回更改后的值 # 参数: # name:redis中的name # key:hash对应的key # amount:自增数(浮点数) hscan(name, cursor=0, match=None, count=None) # 增量式迭代获取,对于数据大的数据非常有用,hscan可以实现分片的获取数据,并非一次性将数据全部获取完,从而放置内存被撑爆 # 参数: # name,redis的name # cursor,游标(基于游标分批取获取数据) # match,匹配指定key,默认None 表示所有的key # count,每次分片最少获取个数,默认None表示采用Redis的默认分片个数 # 第一次:cursor1, data1 = r.hscan('xx', cursor=0, match=None, count=None) # 第二次:cursor2, data1 = r.hscan('xx', cursor=cursor1, match=None, count=None) # ... # 直到返回值cursor的值为0时,表示数据已经通过分片获取完毕 hscan_iter(name, match=None, count=None) # 利用yield封装hscan创建生成器,实现分批去redis中获取数据 # 参数: # match,匹配指定key,默认None 表示所有的key # count,每次分片最少获取个数,默认None表示采用Redis的默认分片个数 # for item in r.hscan_iter('xx'): # print item
List 操作:redis中的List在在内存中按照一个name对应一个List来存储
lpush(name,values) # 在name对应的list中添加元素,每个新的元素都添加到列表的最左边 # 如: # r.lpush('oo', 11,22,33) # 保存顺序为: 33,22,11 # 扩展: # rpush(name, values) 表示从右向左操作 lpushx(name,value) # 在name对应的list中添加元素,只有name已经存在时,值添加到列表的最左边 # 更多: # rpushx(name, value) 表示从右向左操作 llen(name) # name对应的list元素的个数 linsert(name,where,refvaule,value) # 在name对应的列表的某一个值前或后插入一个新值 # 如: # LINSERT list1 BEFORE "bar" "Yes" # 参数: # name,redis的name # where,BEFORE或AFTER # refvalue,标杆值,即:在它前后插入数据 # value,要插入的数据 r.lset(name, index, value) # 对name对应的list中的某一个索引位置重新赋值 # 如: # LSET name 0 "xiaobai" # 参数: # name:redis的name # index:list的索引位置 # value:要设置的值 r.lrem(name, value, num) # 在name对应的list中删除指定的值 # 参数: # name,redis的name # value,要删除的值 # num, num=0,删除列表中所有的指定值; # num=2,从前到后,删除2个; # num=-2,从后向前,删除2个 lpop(name) # 在name对应的列表的左侧获取第一个元素并在列表中移除,返回值则是第一个元素 # 更多: # rpop(name) 表示从右向左操作 lindex(name, index) # 在name对应的列表中根据索引获取列表元素 lrange(name, start, end) # 在name对应的列表分片获取数据 # 参数: # name,redis的name # start,索引的起始位置 # end,索引结束位置 ltrim(name, start, end) # 在name对应的列表中移除没有在start-end索引之间的值 # 参数: # name,redis的name # start,索引的起始位置 # end,索引结束位置 rpoplpush(src, dst) # 从一个列表取出最右边的元素,同时将其添加至另一个列表的最左边 # 参数: # src,要取数据的列表的name # dst,要添加数据的列表的name blpop(keys, timeout) # 将多个列表排列,按照从左到右去pop对应列表的元素 # 参数: # keys,redis的name的集合 # timeout,超时时间,当元素所有列表的元素获取完之后,阻塞等待列表内有数据的时间(秒), 0 表示永远阻塞 # 更多: # r.brpop(keys, timeout),从右向左获取数据 brpoplpush(src, dst, timeout=0) # 从一个列表的右侧移除一个元素并将其添加到另一个列表的左侧 # 参数: # src,取出并要移除元素的列表对应的name # dst,要插入元素的列表对应的name # timeout,当src对应的列表中没有数据时,阻塞等待其有数据的超时时间(秒),0 表示永远阻塞
Set集合操作:Set集合就是不允许重复的列表
sadd(name,values) # name对应的集合中添加元素 scard(name) # 获取name对应的集合中元素个数 sdiff(keys, *args) # 在第一个name对应的集合中且不在其他name对应的集合的元素集合 sdiffstore(dest, keys, *args) # 获取第一个name对应的集合中且不在其他name对应的集合,再将其新加入到dest对应的集合中 sinter(keys, *args) # 获取多一个name对应集合的交集 sinterstore(dest, keys, *args) # 获取多一个name对应集合的交集,加入到dest对应的集合中 sismember(name, value) # 检查value是否是name对应的集合的成员 smembers(name) # 获取name对应的集合的所有成员 smove(src, dst, value) # 将某个成员从一个集合中移动到另外一个集合 spop(name) # 从集合的右侧(尾部)移除一个成员,并将其返回 srandmember(name, numbers) # 从name对应的集合中随机获取 numbers 个元素 srem(name, values) # 在name对应的集合中删除某些值 sunion(keys, *args) # 获取多一个name对应的集合的并集 sunionstore(dest,keys, *args) # 获取多一个name对应的集合的并集,并将结果保存到dest对应的集合中 sscan(name, cursor=0, match=None, count=None) sscan_iter(name, match=None, count=None) # 同字符串的操作,用于增量迭代分批获取元素,避免内存消耗太大
有序集合
在集合的基础上,为每元素排序;元素的排序需要根据另外一个值来进行比较,所以,对于有序集合,每一个元素有两个值,即:值和分数,分数专门用来做排序
zadd(name, *args, **kwargs) # 在name对应的有序集合中添加元素 # 如: # zadd('zz', 'n1', 1, 'n2', 2) # 或 # zadd('zz', n1=11, n2=22) zcard(name) # 获取name对应的有序集合元素的数量 zcount(name, min, max) # 获取name对应的有序集合中分数 在 [min,max] 之间的个数 zincrby(name, value, amount) # 自增name对应的有序集合的 name 对应的分数 r.zrange( name, start, end, desc=False, withscores=False, score_cast_func=float) # 按照索引范围获取name对应的有序集合的元素 # 参数: # name,redis的name # start,有序集合索引起始位置(非分数) # end,有序集合索引结束位置(非分数) # desc,排序规则,默认按照分数从小到大排序 # withscores,是否获取元素的分数,默认只获取元素的值 # score_cast_func,对分数进行数据转换的函数 # 更多: # 从大到小排序 # zrevrange(name, start, end, withscores=False, score_cast_func=float) # 按照分数范围获取name对应的有序集合的元素 # zrangebyscore(name, min, max, start=None, num=None, withscores=False, score_cast_func=float) # 从大到小排序 # zrevrangebyscore(name, max, min, start=None, num=None, withscores=False, score_cast_func=float) zrank(name, value) # 获取某个值在 name对应的有序集合中的排行(从 0 开始) # 更多: # zrevrank(name, value),从大到小排序
zrem(name, values) # 删除name对应的有序集合中值是values的成员
# 如:
zrem('zz', ['s1', 's2'])
zremrangebyrank(name, min, max) # 根据排行范围删除
zremrangebyscore(name, min, max) # 根据分数范围删除
zscore(name, value) # 获取name对应有序集合中 value 对应的分数
zinterstore(dest, keys, aggregate=None) # 获取两个有序集合的交集,遇到相同值,分数按照aggregate进行操作
# aggregate的值为: SUM MIN MAX
zunionstore(dest, keys, aggregate=None) # 获取两个有序集合的并集,遇到相同值,分数按照aggregate进行操作
# aggregate的值为: SUM MIN MAX
zscan(name, cursor=0, match=None, count=None, score_cast_func=float)
zscan_iter(name, match=None, count=None,score_cast_func=float)
# 同字符串相似,相较于字符串新增score_cast_func,用来对分数进行操作
常用操作:
delete(*names) # 根据删除redis中的任意数据类型 exists(name) # 检测redis的name是否存在 keys(pattern='*') # 根据模型获取redis的name # 更多: # KEYS * 匹配数据库中所有 key 。 # KEYS h?llo 匹配 hello , hallo 和 hxllo 等。 # KEYS h*llo 匹配 hllo 和 heeeeello 等。 # KEYS h[ae]llo 匹配 hello 和 hallo ,但不匹配 hillo expire(name ,time) # 为某个redis的某个name设置超时时间 rename(src, dst) # 对redis的name重命名为 move(name, db) # 将redis的某个值移动到指定的db下 randomkey() # 随机获取一个redis的name(不删除) type(name) # 获取name对应值的类型 scan(cursor=0, match=None, count=None) scan_iter(match=None, count=None) # 同字符串操作,用于增量迭代获取key
redis发布订阅
1 import redis 2 3 class RedisHelper(object): 4 def __init__(self): 5 self.__conn = redis.Redis(host="localhost") # 创建redis连接名柄 6 self.chan_sub = "fm104.5" 7 self.chan_pub = "fm104.5" 8 def public(self,msg): 9 self.__conn.publish(self.chan_pub,msg) # 广播消息 10 return True 11 def subscribe(self): 12 pub = self.__conn.pubsub() # 订阅功能 13 pub.subscribe(self.chan_sub) # 订阅频道 14 #pub.psubscribe(self.chan_sub) # 同时订阅多个频道,要用psubscribe 15 #pub.parse_response(block=False,timeout=60) # 非阻塞模式 16 pub.parse_response() # 阻塞模式 17 return pub
发布者
from RedisHelper import RedisHelper obj = RedisHelper() obj.public("hello")
订阅者
from RedisHelper import RedisHelper obj = RedisHelper() redis_sub = obj.subscribe() #while True: # msg = redis_sub.parse_response() # print(msg) msg = redis_sub.parse_response() print(msg)
使用python连接redis有三种方式:
①使用库中的Redis类(或StrictRedis类,其实差不多);
②使用ConnectionPool连接池(可保持长连接);
③使用Sentinel类(如果有多个redis做集群时,程序会自己选择一个合适的连接)。我项目中的redis就是个集群,所以使用了第三种方式。
订阅方法:
连接好之后,可使用subscribe或psubscribe方法来订阅redis消息。
其中subscribe是订阅一个频道,psubscribe可订阅多个频道(这样写的时候,作为参数的频道应该是一个列表)。之后就可以开始监听了。
注意:
刚开始监听的时候,会收到一条消息,类似于 [b'psubscribe', b'#你订阅的频道#', 1] 这样。出现了这条消息,说明订阅成功了。
parse_response像这么使用的话,是非阻塞的,如果收不到消息,60秒收不到消息就会返回None。这俩参数可以不加,变成阻塞的。