python 操作 redis

一、简介

redis是一个key-value存储系统。和Memcached类似，它支持存储的value类型相对更多，包括string(字符串)、list(链表)、set(集合)、zset(sorted set --有序集合)和hash（哈希类型）。这些数据类型都支持push/pop、add/remove及取交集并集和差集及更丰富的操作，而且这些操作都是原子性的。在此基础上，redis支持各种不同方式的排序。与memcached一样，为了保证效率，数据都是缓存在内存中。区别的是redis会周期性的把更新的数据写入磁盘或者把修改操作写入追加的记录文件，并且在此基础上实现了(主从)同步。

二、redis 安装启动

1、redis 安装

wget http://download.redis.io/releases/redis-3.0.6.tar.gz
tar xzf redis-3.0.6.tar.gz
cd redis-3.0.6
make

　　

2、redis 启动

服务端

src/redis-server

#我安装时提示我src
make[1]: Leaving directory `/root/redis-3.0.6/src'

客户端

src/redis-cli
redis> set foo bar
OK
redis> get foo
"bar"

 

三、python 操作 redis

1、安装redis API

pip install redis
或者
easy_install redis

API的使用

API使用

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

连接方式
连接池
操作
String 操作
Hash 操作
List 操作
Set 操作
Sort Set 操作
管道
发布订阅

2、操作模式

redis API 提供两个类Redis和StringRedis用于Redis的命令，StringRedis用于大部分的官方命令的实现，并使用官方的语法，Redis是StringRedis的子类，用于向后兼容旧版本的redis API.

import redis
 
r = redis.Redis(host='192.168.8.246', port=6379)
r.set('foo', 'Bar')
print(r.get('foo'))

　

3、连接池

redis API 使用connection pool来管理一个redis server的所有链接，避免每次建立、释放的开销，默认情况下，每个redis实例都会维护一个自己的连接池。可以直接建立一个连接池，r案后作为redis的参数，这样就可以实现多个Redis实例共享一个连接池。

 
import redis
 
pool = redis.ConnectionPool(host='10.211.55.4', port=6379)
 
r = redis.Redis(connection_pool=pool)
r.set('foo', 'Bar')
print(r.get('foo'))

4、操作

String操作，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('k1', 'k2')
    或
    r.mget(['k1', 'k2'])

getset(name, value)

设置新值并获取原来的值

getrange(name, start, end)

获取子序列（根据字节获取，非字符）
参数：
    name，Redis 的 name
    start，起始位置（字节）
    end，结束位置（字节）

setrange(name, offset, value)

修改字符串内容，从指定字符串索引开始向后替换（新值的字节数大于旧字节时，则向后添加）
参数：
    offset，字符串的索引，字节
    value，要设置的值

setbit(name, offset, value)

对name对应值的二进制表示的位进行操作
 
参数：
    name，redis的name
    offset，位的索引（将值变换成二进制后再进行索引）
    value，值只能是 1 或 0

getbit(name, offset)

获取name对应的值的二进制表示中的某位的值 （0或1）

bitcount(key, start=None, end=None)

获取name对应的值的二进制表示中 1 的个数
参数：
    key，Redis的name
    start，位起始位置
    end，位结束位置

bitop(operation, dest, *keys)

获取多个值，并将值做位运算，将最后的结果保存至新的name对应的值
 
参数：
    operation,AND（并） 、 OR（或） 、 NOT（非） 、 XOR（异或）
    dest, 新的Redis的name
    *keys,要查找的Redis的name
 
如：
    bitop("AND", 'new_name', 'n1', 'n2', 'n3')
    获取Redis中n1,n2,n3对应的值，然后讲所有的值做位运算与，然后将结果保存 new_name 对应的值中

strlen(name)

返回name对应值的字节长度（不是字符的长度）

incr(self, name, amount=1)

自增 name对应的值，当name不存在时，则创建name＝amount，否则，则自增。
 
参数：
    name,Redis的name
    amount,自增数（必须是整数）
 
注：同incrby

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操作， redis中哈希存储形式 是 一个key 对应一个或多个哈希值

hset(name, key, value)

name对应的hash中设置一个键值对（不存在，则创建；否则，修改）
 
参数：
    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的值

hvals(name)

获取name对应的hash中所有的value的值

hexists(name, key)

检查name对应的hash是否存在当前传入的key

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，自增数（浮点数）
 
自增name对应的hash中的指定key的值，不存在则创建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, 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)，从右向左获取数据

brpoplpush(src, dst, timeout=0)

从一个列表的右侧移除一个元素并将其添加到另一个列表的左侧
 
参数：
    src，取出并要移除元素的列表对应的name
    dst，要插入元素的列表对应的name
    timeout，当src对应的列表中没有数据时，阻塞等待其有数据的超时时间（秒），0 表示永远阻塞