Redis Python 客户端

目录

文章目录

• 目录
• Python Redis
• • 链接池
  • 管道
  • String 操做
  • List 操做
  • Hash 操做
  • Set 操做
  • ZSet 操做
  • 常规操做

Python Redis

>>> import redis
>>> r = redis.Redis(host='localhost', port=6379, db=0)
>>> r.set('foo', 'bar')
True
>>> r.get('foo')
'bar'

链接池

redis-py 使用 Connection Pool 来管理实例对象对 Redis Server 的全部链接，避免多个实例对象屡次创建、释放链接的开销。能够直接创建一个链接池，而后做为参数创建 Redis 实例对象，这样就能够实现多个实例共享一个链接池。

#!/usr/bin/env python
# -*- coding:utf-8 -*-
 
import redis
 
pool = redis.ConnectionPool(host='192.168.18.11', port=6379)
 
r = redis.Redis(connection_pool=pool)
r.set('foo', 'Bar')
print r.get('foo')

管道

redis-py 默认执行每次请求都会建立（链接池申请链接）和断开（归还链接池）一次链接操做，若是想要在一次请求中执行多个命令，则可使用 Pipline 实现一次请求执行多个命令，而且默认的，一次 Pipline 是原子性操做。

#!/usr/bin/env python
# -*- coding:utf-8 -*-
 
import redis
 
pool = redis.ConnectionPool(host='10.211.55.4', port=6379)
 
r = redis.Redis(connection_pool=pool)
 
# pipe = r.pipeline(transaction=False)
pipe = r.pipeline(transaction=True)
pipe.multi()
pipe.set('name', 'alex')
pipe.set('role', 'sb')
 
pipe.execute()

String 操做

• 建立值：（默认）不存在则建立，存在则修改。

set(name, value, ex=None, px=None, nx=False, xx=False)

     ex，过时时间（秒）
     px，过时时间（毫秒）
     nx，若是设置为True，则只有name不存在时，当前set操做才执行
     xx，若是设置为True，则只有name存在时，岗前set操做才执行

• 批量建立：

mset(*args, **kwargs)

# e.g.
mset(k1='v1', k2='v2')
mset({'k1': 'v1', 'k2': 'v2'})

• 获取值：

get(name)

• 批量获取：

mget(keys, *args)

# e.g.
mget('ylr', 'zhaogongzi')
mget(['ylr', 'zhaogongzi'])

• 获取字符串长度：

strlen(name)

• 追加：在后面追加内容

append(name, value)

• 获取子序列（切片）

getrange(name, start, end)

• 修改子序列：修改字符串内容，从指定字符串索引开始向后替换，新值太长时，则向后添加。

setrange(name, offset, value)

• 建立新值并获取原来的值：

getset(name, value)

• 值自增（整型）：自增 name 对应的值，当 name 不存在时，则建立 name＝amount，不然，则自增。

incr(self, name, amount=1)

• 值自增（浮点型）：自增 name 对应的值，当 name 不存在时，则建立 name＝amount，不然，则自增。

incrbyfloat(self, name, amount=1.0)

• 自减：

decr(self, name, amount=1)

List 操做

• 建立 List 实例，并添加元素：

# 每一个新的元素都添加到列表的最左边
lpush(name, values)

# 每一个新的元素都添加到列表的最右边
rpush(name, values)

• 向已存在的 List 实例添加元素：

lpushx(name, value)
rpushx(name, value)

• 查看元素的个数：

llen(name)

• 插入元素：在某一个值前或后插入一个新值

linsert(name, where, refvalue, value))

• 获取某个 index 的值：

lindex(name, index)

• 修改某个 index 的值：

r.lset(name, index, value)

• 删除指定元素：

r.lrem(name, value, num)

• 弹出：

lpop(name)
rpop(name)

• 切片：

lrange(name, start, end)

• 排他：移除没有在 [start, end] 索引之间的值

ltrim(name, start, end)

Hash 操做

• 建立并添加元素：

hset(name, key, value)

• 批量添加：

hmset(name, mapping)

# e.g.
hmset('xx', {'k1':'v1', 'k2': 'v2'})

• 获取 key 映射的 value：

hget(name,key)

• 批量获取：

mget('xx', ['k1', 'k2'])
hmget('xx', 'k1', 'k2')

• 获取全部键值对：

hgetall(name)

• 获取键值对的个数：

hlen(name)

• 获取全部 keys：

hkeys(name)

• 获取全部 values：

hvals(name)

• 检查 key 是否存在：

hexists(name, key)

• 删除指定的键值对：

hdel(name, *keys)

• 自增（整型）：不存在则建立 key=amount

hincrby(name, key, amount=1)

• 自增（浮点型）：

hincrbyfloat(name, key, amount=1.0)

Set 操做

• 建立并添加元素：

sadd(name,values)

• 获取集合中元素的个数：

scard(name)

• 差集：在第一个 name 对应的集合中且不在其余 name 对应的集合的元素集合

sdiff(keys, *args)

• 导出差集：获取第一个 name 对应的集合中且不在其余 name 对应的集合，再将其新加入到 dest 对应的集合中

sdiffstore(dest, keys, *args)

• 并集：获取多个 name 对应集合的并集

sinter(keys, *args)

• 导出并集：获取多个 name 对应集合的并集，再讲其加入到 dest 对应的集合中

sinterstore(dest, keys, *args)

• 检查成员是否存在：

sismember(name, value)

• 获取全部成员：

smembers(name)

• 移动成员：

smove(src, dst, value)

• 弹出成员：

spop(name)

• 随机获取若干个成员：

srandmember(name, numbers)

• 删除指定成员：

srem(name, values)

• 交集：

sunion(keys, *args)

• 导出交集：

sunionstore(dest,keys, *args)

ZSet 操做

对于有序集合，每个元素有两个值，即：值和分数，分数专门用来作排序。

• 建立并添加有序集合：

zadd(name, *args, **kwargs)

# e.g.
zadd('zz', 'n1', 1, 'n2', 2)
zadd('zz', n1=1, n2=2)

• 获取指定成员数量：

zcard(name)

• 获取有序集合中分数在 [min,max] 之间的成员个数：

zcount(name, min, max)

• 删除指定成员：

zrem(name, values)

• 根据分数范围删除：

zremrangebyscore(name, min, max)

• 根据排行范围删除：

zremrangebyrank(name, min, max)

• 查当作员的分数：

zscore(name, value)

常规操做

• 删除：

delete(*names)

• 判断是否存在：

exists(name)

• 重命名：

rename(src, dst)

• 将对象移动到指定的 DB：

move(name, db))

• 判断对象类型：

type(name)