redis

一.概述.

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

使用Redis有哪些好处？

(1) 速度快，因为数据存在内存中，类似于HashMap，HashMap的优势就是查找和操作的时间复杂度都是O(1)
(2) 支持丰富数据类型，支持string，list，set，sorted set，hash
(3) 支持事务，操作都是原子性，所谓的原子性就是对数据的更改要么全部执行，要么全部不执行
(4) 丰富的特性：可用于缓存，消息，按key设置过期时间，过期后将会自动删除

下载地址:http://www.runoob.com/redis/redis-install.html

二.操作

1.连接池

import redis
pool = redis.ConnectionPool(host='10.211.55.4', port=6379,decode_responses=True)
#decode_responses参数,显示的时候不显示字节的形式
r = redis.Redis(connection_pool=pool)

import redis
r = redis.Redis()

2.string操作

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('ylr', 'wupeiqi')
        或
        r.mget(['ylr', 'wupeiqi'])

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

getrange(key, 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
 
    # 注：如果在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','')
 
                        沛                           齐    

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对应值的字节长度（一个汉字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, 要追加的字符串

3.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 表示永远阻塞
        
自定义增量迭代
    # 由于redis类库中没有提供对列表元素的增量迭代，如果想要循环name对应的列表的所有元素，那么就需要：
        # 1、获取name对应的所有列表
        # 2、循环列表
    # 但是，如果列表非常大，那么就有可能在第一步时就将程序的内容撑爆，所有有必要自定义一个增量迭代的功能：
 
    def list_iter(name):
        """
        自定义redis列表增量迭代
        :param name: redis中的name，即：迭代name对应的列表
        :return: yield 返回 列表元素
        """
        list_count = r.llen(name)
        for index in xrange(list_count):
            yield r.lindex(name, index)
 
    # 使用
    for item in list_iter('pp'):
        print item

4.清除所有

r.delete(*r.key())

5.hash操作

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
        # key，name对应的hash中的key
        # value，name对应的hash中的value
 
    # 注：
        # hsetnx(name, key, value),当name对应的hash中不存在当前key时则创建（相当于添加）
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