keys
redis本质上一个key-value store,所以首先了解它的key。首先key也是字符串类型,但是key中不能包括边界字符。由于key不是binary safe的字符串,所以像”my key”和”mykey\n”这样包含空格和换行的key是不允许的。在redis内部并不限制使用binary字符,这是redis协议限制的。”\r\n”在协议格式中会作为特殊字符。redis 1.2以后的协议中部分命令已经开始使用新的协议格式了(比如MSET)。总之目前还是把包含边界字符当成非法的key吧,免得被bug纠缠。
另外关于key的一个格式约定介绍下,object-type:id:field。比如user:1000:password,blog:xxidxx:title。还有key的长度最好不要太长。道理很明显占内存啊,而且查找时候相对短key也更慢。不过也推荐过短的key,比如u:1000:pwd,这样的。显然没上面的ser:1000:password可读性好。
命令 | 解释 |
---|---|
exits key | 测试指定key是否存在,返回1表示存在,0不存在 |
del key1 key2 ….keyN | 删除给定key,返回删除key的数目,0表示给定key都不存在 |
type key返回给定key的value类型。返回 none 表示不存在key,string字符类型,list 链表类型 set 无序集合类型 | |
keys pattern | 返回匹配指定模式的所有key |
randomkey | 返回从当前数据库中随机选择的一个key,如果当前数据库是空的,返回空串 |
rename oldkey newkey | 原子的重命名一个key,如果newkey存在,将会被覆盖,返回1表示成功,0失败。可能是oldkey不存在或者和newkey相同 |
renamenx oldkey newkey | 同上,但是如果newkey存在返回失败 |
dbsize | 返回当前数据库的key数量 |
expire key seconds | 为key指定过期时间,单位是秒。返回1成功。 |
ttl key | 返回设置过过期时间的key的剩余过期秒数 -1表示key不存在或者没有设置过过期时间 |
select db-index | 将key从当前数据库移动到指定数据库。返回1成功。0 如果key不存在,或者已经在指定数据库中 |
move key db-index | 将key从当前数据库移动到指定数据库。返回1成功。0 如果key不存在,或者已经在指定数据库中 |
flushdb | 删除当前数据库中所有key,此方法不会失败。慎用 |
flushall | 删除所有数据库中的所有key,此方法不会失败。慎用 |
字符串(Strings)
字符串是一种最基本的Redis值类型。Redis字符串是二进制安全的,这意味着一个Redis字符串能包含任意类型的数据,例如: 一张JPEG格式的图片或者一个序列化的对象。
一个字符串类型的值最多能存储512M字节的内容。
string类型的定义:
struct sdshdr {
long len; --buf数组的长度
long free; --数组中剩余可用字节数
char buf[]; --存贮实际的字符串内容
}
可用的字符串命令:
命令 | 解释 |
---|---|
set key value | 设置key对应的值为string类型的value,返回1表示成功,0失败 |
setnx key value | 同上,如果key已经存在,返回0 。nx 是not exist的意思 |
get key | 获取key对应的string值,如果key不存在返回nil |
getset key value | 原子的设置key的值,并返回key的旧值。如果key不存在返回nil |
mget key1 key2 … keyN | 一次获取多个key的值,如果对应key不存在,则对应返回nil。 |
mset key1 value1 … keyN valueN | 一次设置多个key的值,成功返回1表示所有的值都设置了,失败返回0表示没有任何值被设置 |
msetnx key1 value1 … keyN valueN | 同上,但是不会覆盖已经存在的key |
incr key | 对key的值做加加操作,并返回新的值。注意incr一个不是int的value会返回错误,incr一个不存在的key,则设置key为1 |
decr key | 同上,但是做的是减减操作,decr一个不存在key,则设置key为-1 |
incrby key integer | 同incr,加指定值 ,key不存在时候会设置key,并认为原来的value是 0 |
decrby key integer | 同decr,减指定值。decrby完全是为了可读性,我们完全可以通过incrby一个负值来实现同样效果,反之一样。 |
append key value | 给指定key的字符串值追加value,返回新字符串值的长度。 |
substr key start end | 返回截取过的key的字符串值,注意并不修改key的值。下标是从0开始的 |
列表(Lists)
Redis列表是简单的字符串列表,按照插入顺序排序。 你可以添加一个元素到列表的头部(左边)或者尾部(右边)。
LPUSH命令插入一个新元素到列表头部,而RPUSH命令插入一个新元素到列表的尾部。当对一个空key执行其中某个命令时,将会创建一个新表。 类似的,如果一个操作要清空列表,那么key会从对应的key空间删除。这是个非常便利的语义, 因为如果使用一个不存在的key作为参数,所有的列表命令都会像在对一个空表操作一样。
一个列表最多可以包含2的32次方-1个元素(4294967295,每个表超过40亿个元素)。
从时间复杂度的角度来看,Redis列表主要的特性就是支持时间常数的 插入和靠近头尾部元素的删除,即使是需要插入上百万的条目。 访问列表两端的元素是非常快的,但如果你试着访问一个非常大 的列表的中间元素仍然是十分慢的,因为那是一个时间复杂度为 O(N) 的操作。
命令 | 解释 |
---|---|
lpush key string | 在key对应list的头部添加字符串元素,返回值为添加新元素后list的元素个数,0表示key存在且不是list类型 |
rpush key string | 同上,在尾部添加 |
llen key | 返回key对应list的长度,key不存在返回0,如果key对应类型不是list返回错误 |
lrange key start end | 返回指定区间内的元素,下标从0开始,负值表示从后面计算,-1表示倒数第一个元素 ,key不存在返回空列表 |
ltrim key start end | 截取list,保留指定区间内元素,成功返回1,key不存在返回错误 |
lindex key index | 返回名称为key的list中index位置的元素 |
lset key index value | 设置list中指定下标的元素值,成功返回1,key或者下标不存在返回错误 |
lrem key count value | 删除count个名称为key的list中值为value的元素。count为0,删除所有值为value的元素,count>0从头至尾删除count个值为value的元素,count<0从尾到头删除count个值为value的元素。 |
lpop key | 从list的头部删除元素,并返回删除元素。如果key对应list不存在或者是空返回nil,如果key对应值不是list返回错误 |
rpop key | 同上,但是从尾部删除 |
blpop key1…keyN timeout | lpop命令的block版本。即当timeout为0时,若遇到名称为key i的list不存在或该list为空,则命令结束。如果timeout>0,则遇到上述情况时,等待timeout秒,如果问题没有解决,则对keyi+1开始的list执行pop操作。 |
brpop | 同blpop,一个是从头部删除一个是从尾部删除 |
rpoplpush srckey destkey | 返回并删除名称为srckey的list的尾元素,并将该元素添加到名称为dstkey的list的头部.如果srckey是空或者不存在返回nil |
集合(Sets)
Redis集合是一个无序的字符串合集。你可以以O(1)的时间复杂度(无论集合中有多少元素时间复杂度都为常量)完成添加,删除以及测试元素是否存在的操作。
Redis集合有着不允许相同成员存在的优秀特性。向集合中多次添加同一元素,在集合中最终只会存在一个此元素。实际上这就意味着,在添加元素前,你并不需要事先进行检验此元素是否已经存在的操作。
一个集合最多可以包含2的32次方-1个元素(4294967295,每个集合超过40亿个元素)。
命令 | 解释 |
---|---|
sadd key member | 添加一个string元素到key对应的set集合中,成功返回1,如果元素以及在集合中返回0,key对应的set不存在返回错误 |
srem key member | 从key对应set中移除给定元素,成功返回1,如果member在集合中不存在或者key不存在返回0,如果key对应的不是set类型的值返回错误 |
spop key | 删除并返回key对应set中随机的一个元素,如果set是空或者key不存在返回nil |
srandmember key | 同spop,随机取set中的一个元素,但是不删除元素 |
smove srckey dstkey member | 从srckey对应set中移除member并添加到dstkey对应set中,整个操作是原子的。成功返回1,如果member在srckey中不存在返回0,如果key不是set类型返回错误 |
scard key | 返回set的元素个数,如果set是空或者key不存在返回0 |
sismember key member | 判断member是否在set中,存在返回1,0表示不存在或者key不存在 |
sinter key1 key2…keyN | 返回所有给定key的交集 |
sinterstore dstkey key1…keyN | 同sinter,但是会同时将交集存到dstkey下 |
sunion key1 key2…keyN | 返回所有给定key的并集 |
sunionstore dstkey key1…keyN | 同sunion,并同时保存并集到dstkey下 |
sdiff key1 key2…keyN | 返回所有给定key的差集 |
sdiffstore dstkey key1…keyN | 同sdiff,并同时保存差集到dstkey下 |
smembers key | 返回key对应set的所有元素,结果是无序的 |
哈希(Hashes)
Redis Hashes是字符串字段和字符串值之间的映射。一个key可对应多个field,一个field对应一个value。将一个对象存储为hash类型,较于每个字段都存储成string类型更能节省内存。新建一个hash对象时开始是用zipmap(又称为small hash)来存储的。这个zipmap其实并不是hash table,但是zipmap相比正常的hash实现可以节省不少hash本身需要的一些元数据存储开销。尽管zipmap的添加,删除,查找都是O(n),但是由于一般对象的field数量都不太多。所以使用zipmap也是很快的,也就是说添加删除平均还是O(1)。如果field或者value的大小超出一定限制后,Redis会在内部自动将zipmap替换成正常的hash实现。
命令 | 解释 |
---|---|
hset key field value | 设置hash field为指定值,如果key不存在,则先创建 |
hget key field | 获取指定的hash field |
hmget key filed1….fieldN | 获取全部指定的hash filed |
hmset key filed1 value1 … filedN valueN | 同时设置hash的多个field |
hincrby key field integer | 将指定的hash filed 加上给定值 |
hexists key field | 测试指定field是否存在 |
hdel key field | 删除指定的hash field |
hlen key | 返回指定hash的field数量 |
hkeys key | 返回hash的所有field |
hvals key | 返回hash的所有value |
hgetall | 返回hash的所有filed和value |
一个拥有少量(100个左右)字段的hash需要 很少的空间来存储,所有你可以在一个小型的 Redis实例中存储上百万的对象。
尽管Hashes主要用来表示对象,但它们也能够存储许多元素,所以你也可以用Hashes来完成许多其他的任务。
一个hash最多可以包含2的32次方-1 key-values(超过40亿)。
有序集合(Sorted sets)
Redis有序集合和Redis集合类似,是不包含相同字符串的合集。它们的差别是,每个有序集合的成员都关联着一个评分,这个评分用于把有序集合中的成员按最低分到最高分排列。
使用有序集合,你可以非常快地(O(log(N)))完成添加,删除和更新元素的操作。 因为元素是在插入时就排好序的,所以很快地通过评分(score)或者位次(position)获得一个范围的元素。 访问有序集合的中间元素同样也是非常快的,因此你可以使用有序集合作为一个没用重复成员的智能列表。 在这个列表中, 你可以轻易地访问任何你需要的东西: 有序的元素,快速的存在性测试,快速访问集合中间元素!
命令 | 解释 |
---|---|
zadd key score member | 添加元素到集合,元素在集合中存在则更新对应score |
zrem key member | 删除指定元素,1表示成功,如果元素不存在返回0 |
zincrby key incr member | 增加对应member的score值,然后移动元素并保持skip list保持有序。返回更新后的score值 |
zrank key member | 返回指定元素在集合中的排名(下标),集合中元素是按score从小到大排序的 |
zrevrank key member | 同上,但是集合中元素是按score从大到小排序 |
zrange key start end | 类似lrange操作从集合中去指定区间的元素。返回的是有序结果 |
zrevrange key start end | 同上,返回结果是按score逆序的 |
zrangebyscore key min max | 返回集合中score在给定区间的元素 |
zcount key min max | 返回集合中score在给定区间的数量 |
zcard key | 返回集合中元素个数 |
zscore key element | 返回给定元素对应的score |
zremrangebyrank key min max | 删除集合中排名在给定区间的元素 |
zremrangebyscore key min max | 删除集合中score在给定区间的元素 |
整理自网络
Svoid
2014-10-23