python——redis连接与使用

目录

一、python连接redis

 二、Redis API的使用

1、Strings操作

2、Hash操作

3、Lists操作

4、Set集合操作

5、Zset操作

 三、使用实例

---

一、python连接redis

在python中操作redis是通过python-redis模块来实现的。

1、首先是安装python-pip。pip是Python官方推荐的包管理工具(标准库管理器),它允许你安装和管理不属于 Python标准库的其它软件包。pip本身也属于python的一部分。

yum install python-pip

2、在python中安装redis模块,一般情况下

pip install redis

 二、Redis API的使用

redis-py 的API的使用可以分类为：

(1)普通连接
(2)连接池
(3)操作
    1）String 操作
    2）Hash 操作
    3）List 操作
    4）Set 操作
    5）Sort Set 操作
(4)管道
(5)发布订阅
前面通过一个连接实例来简述了python用过redis模块连接redis数据库的连接方式和连接池。

本文只贴一些常见的操作，更多操作见 python -- redis连接与使用 - txowner - 博客园 

1、Strings操作

redis中的String在在内存中按照一个name对应一个value来存储。如图：

set(name, value, ex=None, px=None, nx=False, xx=False)
　　在Redis中设置值，默认，不存在则创建，存在则修改
　　参数：
     　　ex，过期时间（秒）
     　　px，过期时间（毫秒）
     　　nx，如果设置为True，则只有name不存在时，当前set操作才执行
     　　xx，如果设置为True，则只有name存在时，岗前set操作才执行

setnx(name, value)
    #设置值，只有name不存在时，执行设置操作（添加）

setex(name, value, time)
　　# 设置值
　　# 参数：
        # time，过期时间（数字秒 或 timedelta对象）
psetex(name, time_ms, value)
　　# 设置值
　　# 参数：
　　　　# time_ms，过期时间（数字毫秒 或 timedelta对象）

mset(*args, **kwargs)
    批量设置值
　　如：
        mset(k1='v1', k2='v2')
        或
        mget({'k1': 'v1', 'k2': 'v2'})

get(name)
    获取值

mget(keys, *args)
    批量获取
　　 如：
        mget('name', 'root')
        或
        r.mget(['name', 'root'])

getset(name, value)
    设置新值并获取原来的值

getrange(key, start, end)
    # 获取子序列（根据字节获取，非字符）
　　# 参数：
        #name，Redis 的 name
        # start，起始位置（字节）
        # end，结束位置（字节）
　　# 如： "你好" ，0-3表示 "你"   (utf8中一个中文字符占三个字节)

setrange(name, offset, value)
    # 修改字符串内容，从指定字符串索引开始向后替换（新值太长时，则向后添加）
　　# 参数：
        # offset，字符串的索引，字节（一个汉字三个字节）
        # value，要设置的值

2、Hash操作

hash的存储结构如下：关于其操作用到的时候再搜或者参考文末链接。 

hset(name, key, value)
　　# name对应的hash中设置一个键值对（不存在，则创建；否则，修改）， 注意： 在python中，键值对是dict， 这里的name必须是dict格式。eg：xxx[]、　xxx[k]...     
　　# 参数：
        # name，redis的name
        #key，name对应的hash中的key
        # value，name对应的hash中的value
　　# 注：
        # hsetnx(name, key, value),当name对应的hash中不存在当前key时则创建（相当于添加）

hmset(name, mapping)
　　# 在name对应的hash中批量设置键值对 
　　# 参数：
        # name，redis的name
        # mapping，字典，如：{'k1':'v1', 'k2': 'v2'}
　　# 如：
        # r.hmset('xx', {'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
　　# 如：
        # r.mget('xx', ['k1', 'k2'])
        # 或
        # print r.hmget('xx', 'k1', 'k2')

hgetall(name)
　　#获取name对应hash的所有键值

hlen(name)
　　# 获取name对应的hash中键值对的个数

hkeys(name)
　　# 获取name对应的hash中所有的key的值

3、Lists操作

lists直译过来是列表，其实当成消息队列MQ更贴切

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, refvalue, value))
　　# 在name对应的列表的某一个值前或后插入一个新值
　　# 参数：
        # name，redis的name
        # where，BEFORE或AFTER
        # refvalue，标杆值，即：在它前后插入数据
        # value，要插入的数据

r.lset(name, index, value)
　　# 对name对应的list中的某一个索引位置重新赋值     
　　# 参数：
        # 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)，从右向左获取数据

4、Set集合操作

Set集合就是不允许重复的列表，和C++中的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对应的集合中删除某些值

5、Zset操作

zset就是我们说的有序集合了，在集合的基础上为每个元素排序。显然元素的排序需要一个根据一个分值score来进行，所以对于有序集合每一项都有两个值，即值value和分数score。

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 对应的分数

 三、使用实例

 这个实例是业务遇到的一个问题，就是将pic_download_failed_list这个列表中的数据导出到文本中。

3.1、导出list结构数据

#!/usr/bin/env python
# -*- coding:utf8 -*-
import redis
# 普通连接
conn = redis.Redis(host="10.101.XXX.XX", port=6379,password="XXXXXX")
#存一个数据然后取出来验证连接是否成功
conn.set("zs","shuozhuo",ex=20) # ex代表seconds,px代表ms
val = conn.get("zs")
print(val)

#pic_download_failed_list是一个列表类型
len = conn.llen("pic_download_failed_list")
print "Length of pic_download_failed_list is:{0}".format(len)
#lists的pop操作
item = conn.lpop("pic_download_failed_list")
print "Lpop:{0}".format(item)

#python写文件操作
filename = "faildata.txt"
file = open(filename,'a')
file.write(item)
file.write('\n')

#循环的pop列表并将得到的数据追加写入文档
while conn.llen("pic_download_failed_list") > 0:
    item = conn.lpop("pic_download_failed_list")
    file.write(item)
    file.write('\n')
    print "Lpop:{0}".format(item)

print "done"

3.2、导出string结构K-V对

#!/usr/bin/env python
# -*- coding:utf8 -*-

import redis
import time

# 普通连接
conn = redis.Redis(host="9.139.215.245", port=6379,password="redis@qidian")
conn.set("x1","hello",ex=20) # ex代表seconds，px代表ms
val = conn.get("x1")
print(val)

#start_time= 1717171200 #2024-06-01 00:00:00
#end_time = 1719763200 #2024-07-01 00:00:00
start_time = 1514736000 #2018-01-01 00:00:00
end_time = 1720800000 #2024-07-10 00:00:00

step = 86400

#输出文件
filename = "msgnumberdata.txt"
file = open(filename,'a')
file.write('\n')

for sec in range(start_time, end_time, step):
    timeArray = time.localtime(sec)
    num_key = "msg_num_" + time.strftime("%Y%m%d", timeArray)
    val = conn.get(num_key)
    if type(val) is type(None):
        val = '0'
    row = num_key + ' ' + val
    file.write(row)
    file.write('\n')