r = redis.Redis(ip, port, index)如此实例化一个redis对象，index取值0-15，一个redis对象有16个库。
Keys
函数 | 功能 | 返回值 | 备注 |
keys(self, pattern='*') | 返回匹配pattern的keys列表，不存在则返回空列表 | 返回匹配pattern的keys列表，不存在则返回空列表 | |
randomkey(self) | 随机返回一个键，如果数据库为空则返回None | 随机返回一个键，如果数据库为空则返回None | |
delete(self, *names) | 删除一个或几个键，忽略不存在的键 | 被删除 key 的数量 | |
exists(self, name) | 判断某个键是否存在 | 存在返回True，否则返回Fasle | |
ttl(self, name) | 返回过期时间，以秒为单位 | 返回生存时间或者None | |
expire(self, name, time) | 设置生存时间，接受timedelta对象或者整型（代表秒数） | 返回True or False | |
expireat(self, name, when) | 设置过期时间点，接受datetime对象或者整型（代表秒数） | 返回True or False | |
persist(self, name) | 移除过期时间 | 返回True or False | |
rename(self, src, dst) | 将src改名为dst，若src不存在引发一个异常， 若dst存在则覆盖dst | 返回True or False | |
renamenx(self, src, dst) | 同rename，若dst存在则返回False | 返回True or False | |
move(self, name, db) | 将当前数据库的 key 移动到给定的数据库 db 当中 | 返回True or False 如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定key ，或者 key 不存在于当前数据库，那么 MOVE 没有任何效果 | |
sort(self, name, start=None, num=None, by=None, get=None, desc=False, alpha=False, store=None, groups=False) | 对list,set,sorted-set进行排序，设置很多 | 没有使用 STORE 参数，返回列表形式的排序结果。 使用 STORE 参数，返回排序结果的元素数量 | |
type(self, name) | 返回key关联值的类型 | 返回值的类型 |
defdump(self, name): # 序列化一个键的值
"""
Return a serialized version of the value stored at the specified key.
If key does not exist a nil bulk reply is returned.
"""
returnself.execute_command('DUMP', name)序列化生成的值有以下几个特点：
- 它带有 64 位的校验和，用于检测错误， RESTORE 在进行反序列化之前会先检查校验和。
- 值的编码格式和 RDB 文件保持一致。
- RDB 版本会被编码在序列化值当中，如果因为 Redis 的版本不同造成 RDB 格式不兼容，那么 Redis 会拒绝对这个值进行反序列化操作。
defrestore(self, name, ttl, value): # 反序列化一个键值
"""
Create a key using the provided serialized value, previously obtained
using DUMP.
"""
returnself.execute_command('RESTORE', name, ttl, value)
- 反序列化给定的序列化值，并将它和给定的 key 关联。
- 参数 ttl 以毫秒为单位为 key 设置生存时间；如果 ttl 为 0 ，那么不设置生存时间
- 如果序列化值不对，会报错
defttl(self, name): # 返回过期时间，以秒为单位
"Returns the number of seconds until the key ``name`` will expire"
returnself.execute_command('TTL', name)- 当 key 不存在时，返回 -2 。
- 当 key 存在但没有设置剩余生存时间时，返回 -1 。
- 否则，以秒为单位，返回 key 的剩余生存时间。
defpttl(self, name): # 同ttl，以毫秒为单位
"Returns the number of milliseconds until the key ``name`` will expire"
returnself.execute_command('PTTL', name)
defpexpire(self, name, time): # 同expire，以毫秒为时间
"""
Set an expire flag on key ``name`` for ``time`` milliseconds.
``time`` can be represented by an integer or a Python timedelta
object.
"""
ifisinstance(time, datetime.timedelta):
ms =int(time.microseconds /1000)
time = (time.seconds + time.days *24*3600) *1000+ ms
returnself.execute_command('PEXPIRE', name, time)
defpexpireat(self, name, when): # 同expireat，以毫秒为时间
"""
Set an expire flag on key ``name``. ``when`` can be represented
as an integer representing unix time in milliseconds (unix time * 1000)
or a Python datetime object.
"""
ifisinstance(when, datetime.datetime):
ms =int(when.microsecond /1000)
when =int(mod_time.mktime(when.timetuple())) *1000+ ms
returnself.execute_command('PEXPIREAT', name, when)
stringredis-2.4.9
函数 | 功能 | 返回值 | 备注 |
append(key, value) | 追加字符串，不存在就创建 | 追加后key值的长度 | |
incr(self, name, amount=1) | 将key中储存的数字值增一 | 执行 INCR 命令之后 key 的值(如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCR 操作。) | 如果值的类型不对，那么返回一个错误 |
incrby(self, name, amount=1) | 将key中存储的数字增加amount | 执行incrby之后的key值，其他情况同incr | |
decr(self, name, amount=1) | 把key值中的数字减一 | 返回key的值，若key不存在，则初始化key值为0，再执行decr操作，最后返回 0-amount | 如果值的类型不对，那么返回一个错误 |
set(self, name, value) | 将字符串值 value 关联到 key | 总是返回True | |
setnx(self, name, value) | 将 key 的值设为 value ，当且仅当 key 不存在 | 设置成功返回True 设置失败返回False | |
get(self, name) | 读取key的值 | 返回key关联的值，若key不存在返回None | |
getset(self, name, value | 将给定 key 的值设为 value ，并返回 key 的旧值(old value)。 当 key 存在但不是字符串类型时，返回一个错误。 | 返回给定 key 的旧值。 当 key 没有旧值时，也即是， key 不存在时，返回 none | |
mset(self, *args, **kwargs) | 同时设置多个key值 | 总是返回True | 接受字典这样的映射 |
msetnx(self, *args, **kwargs) | 当且仅当原key都不存在的进行批量设置 | 成功设置返回True，若有一个以上的key存在，返回False | |
mget(self, keys, *args | 返回所有(一个或多个)给定 key 的值 | 返回所有key值的列表，如果某个key不存在，它的值用None代替 | |
setbit(self, name, offset, value) | 对 key 所储存的字符串值，设置指定偏移量上的位 | 返回原来位上的值（True or False） | |
strlen(self, name) | 返回 key 所储存的字符串值的长度 当 key 储存的不是字符串值时，返回一个错误 | 字符串值的长度。 当 key 不存在时，返回 0 | |
setex(self, name, time, value) | 将值 value 关联到 key ，并将 key 的生存时间设为 seconds (以秒为单位)。 如果 key 已经存在， SETEX 命令将覆写旧值。 | 设置成功时返回 OK 。 当 seconds 参数不合法时，返回一个错误。 | |
setrange(self, name, offset, value) | 用 value 参数覆写(overwrite)给定 key 所储存的字符串值 | 被 SETRANGE 修改之后，字符串的长度 |
redis>2.4.9
函数 | 功能 | 返回值 | 备注 |
bitcount(self, key, start=None, end=None) | 计算给定字符串中，被设置为 1 的比特位的数量 | 返回1的数量 | 2.6及以上支持 |
bitop(self, operation, dest, *keys) | 对一个或多个保存二进制位的字符串 key 进行位元操作，并将结果保存到 dest 上 | 保存到 dest 的字符串的长度，和输入 key 中最长的字符串长度相等 | 2.6及以上支持 |
getbit(self, name, offset | 对 key 所储存的字符串值，获取指定偏移量上的位(bit) | 字符串值指定偏移量上的位(bit) | 2.6及以上支持 |
getrange(self, key, start, end) | 返回 key 中字符串值的子字符串，字符串的截取范围由 start 和 end 两个偏移量决定(包括 start 和 end 在内) | 截取得出的子字符串 | 在 <= 2.4 的版本里，GETRANGE 被叫作 SUBSTR |
| | | |
