Redis API使用
通用的命令
- keys 遍历所有的key ,生产环境尽量不要使用，可以在从节点使用，或用scan 来查询
- dbszie 计算key的总数，可以在生产环境使用，时间复杂度O(1)
- exists key 检查key 是否存在
- del key 删除Key
- expire key seconds 设置过期时间
- ttl key 查看key的过期时间
- persist key 去掉key的过期时间
- type key 查看key 的类型
数据结构和内部编码
单线程为什么这么快
- redis单线程为什么这么快 纯内存操作
- 非阻塞式IO
- 避免线程切换和竞争消耗
注：由于redis 是单线程，一次只运行一条命令，因此尽量不要操作慢命令keys.flushall,flusdb,mutil/exec等命令，会阻塞线程，使主线程等待
String
| 命令原型 | 时间复杂度 | 命令描述 | 返回值 |
| APPEND | O(1) | 如果该Key已经存在，APPEND命令将参数Value的数据追加到已存在Value的末尾。如果该Key不存在，APPEND命令将会创建一个新的Key/Value。 | 追加后Value的长度。 |
| DECR | O(1) |
将指定Key的Value原子性的递减1。如果该Key不存在，其初始值为0，在decr之后其值为-1。如果Value的值不能转换为整型值，如Hello，该操作将执行失败 并返回相应的错误信息。注意：该操作的取值范围是64位有符号整型。 |
递减后的Value值。 |
| INCR | O(1) |
将指定Key的Value原子性的递增1。如果该Key不存在，其初始值为0，在incr之后其值为1。如果Value的值不能转换为整型值，如Hello，该操作将执行失败 并返回相应的错误信息。注意：该操作的取值范围是64位有符号整型。 |
递增后的Value值。 |
| DECRBY | O(1) |
将指定Key的Value原子性的减少decrement。如果该Key不存在，其初始值为0，在decrby之后其值为-decrement。如果Value的值不能转换为整型值， 如Hello，该操作将执行失败并返回相应的错误信息。注意：该操作的取值范围是64位有符号整型。 |
减少后的Value值。 |
| INCRBY | O(1) |
将指定Key的Value原子性的增加increment。如果该Key不存在，其初始值为0，在incrby之后其值为increment。如果Value的值不能转换为整型值，如Hello， 该操作将执行失败并返回相应的错误信息。注意：该操作的取值范围是64位有符号整型。 |
增加后的Value值。 |
| GET | O(1) | 获取指定Key的Value。如果与该Key关联的Value不是string类型，Redis将返回错误信息，因为GET命令只能用于获取string Value。 | 与该Key相关的Value，如果该Key不存在，返回nil。 |
| SET | O(1) | 设定该Key持有指定的字符串Value，如果该Key已经存在，则覆盖其原有值。 | 总是返回"OK"。 |
| GETSET | O(1) | 原子性的设置该Key为指定的Value，同时返回该Key的原有值。和GET命令一样，该命令也只能处理string Value，否则Redis将给出相关的错误信息。 | 返回该Key的原有值，如果该Key之前并不存在，则返回nil。 |
| STRLEN | O(1) | 返回指定Key的字符值长度，如果Value不是string类型，Redis将执行失败并给出相关的错误信息。 | 返回指定Key的Value字符长度，如果该Key不存在，返回0。 |
| SETEX | O(1) | 原子性完成两个操作，一是设置该Key的值为指定字符串，同时设置该Key在Redis服务器中的存活时间(秒数)。该命令主要应用于Redis被当做Cache服务器使用时。 | |
| SETNX | O(1) | 如果指定的Key不存在，则设定该Key持有指定字符串Value，此时其效果等价于SET命令。相反，如果该Key已经存在，该命令将不做任何操作并返回。 | 1表示设置成功，否则0。 |
| SETRANGE | O(1) |
替换指定Key的部分字符串值。从offset开始，替换的长度为该命令第三个参数value的字符串长度，其中如果offset的值大于该Key的原有值Value的字符串长度， Redis将会在Value的后面补齐(offset - strlen(value))数量的0x00，之后再追加新值。如果该键不存在，该命令会将其原值的长度假设为0，并在其后添补offset个 0x00后再追加新值。鉴于字符串Value的最大长度为512M，因此offset的最大值为536870911。最后需要注意的是，如果该命令在执行时致使指定Key的原有值 长度增加，这将会导致Redis重新分配足够的内存以容纳替换后的全部字符串，因此就会带来一定的性能折损。 |
修改后的字符串Value长度。 |
| GETRANGE | O(1) |
如果截取的字符串长度很短，我们可以该命令的时间复杂度视为O(1)，否则就是O(N)，这里N表示截取的子字符串长度。该命令在截取子字符串时，将以闭区间的方 式同时包含start(0表示第一个字符)和end所在的字符，如果end值超过Value的字符长度，该命令将只是截取从start开始之后所有的字符数据。 |
子字符串 |
| SETBIT | O(1) |
设置在指定Offset上BIT的值，该值只能为1或0，在设定后该命令返回该Offset上原有的BIT值。如果指定Key不存在，该命令将创建一个新值，并在指定 的Offset上设定参数中的BIT值。如果Offset大于Value的字符长度，Redis将拉长Value值并在指定Offset上设置参数中的BIT值，中间添加的BIT值为0。最后需要 说明的是Offset值必须大于0。 |
在指定Offset上的BIT原有值。 |
| GETBIT | O(1) | 返回在指定Offset上BIT的值，0或1。如果Offset超过string value的长度，该命令将返回0，所以对于空字符串始终返回0。 | 在指定Offset上的BIT值。 |
| MGET | O(N) | N表示获取Key的数量。返回所有指定Keys的Values，如果其中某个Key不存在，或者其值不为string类型，该Key的Value将返回nil。 | 返回一组指定Keys的Values的列表。 |
| MSET | O(N) | N表示指定Key的数量。该命令原子性的完成参数中所有key/value的设置操作，其具体行为可以看成是多次迭代执行SET命令。 | 该命令不会失败，始终返回OK。 |
| MSETNX | O(N) |
N表示指定Key的数量。该命令原子性的完成参数中所有key/value的设置操作，其具体行为可以看成是多次迭代执行SETNX命令。然而这里需要明确说明的是， 如果在这一批Keys中有任意一个Key已经存在了，那么该操作将全部回滚，即所有的修改都不会生效。 |
1表示所有Keys都设置成功，0则表示没有任何Key被修改。 |
命令示例：
ET/APPEND/STRLEN:
/> redis-cli //执行Redis客户端工具。
redis 127.0.0.1:6379> exists mykey //判断该键是否存在，存在返回1，否则返回0。
(integer) 0
redis 127.0.0.1:6379> append mykey "hello" //该键并不存在，则创建key，存在则将内容追加，append命令返回当前Value的长度。
(integer) 5
redis 127.0.0.1:6379> append mykey " world" //该键已经存在，因此返回追加后Value的长度。
(integer) 11
redis 127.0.0.1:6379> get mykey //通过get命令获取该键，以判断append的结果。
"hello world"
redis 127.0.0.1:6379> set mykey "this is a test" //通过set命令为键设置新值，并覆盖原有值。
OK
redis 127.0.0.1:6379> get mykey
"this is a test"
redis 127.0.0.1:6379> strlen mykey //获取指定Key的字符长度，等效于C库中strlen函数。
(integer) 14
2. INCR/DECR/INCRBY/DECRBY:
redis 127.0.0.1:6379> set mykey 20 //设置Key的值为20
OK
redis 127.0.0.1:6379> incr mykey //该Key的值递增1
(integer) 21
redis 127.0.0.1:6379> decr mykey //该Key的值递减1
(integer) 20
redis 127.0.0.1:6379> del mykey //删除已有键。
(integer) 1
redis 127.0.0.1:6379> decr mykey //对空值执行递减操作，其原值被设定为0，递减后的值为-1
(integer) -1
redis 127.0.0.1:6379> del mykey
(integer) 1
redis 127.0.0.1:6379> incr mykey //对空值执行递增操作，其原值被设定为0，递增后的值为1
(integer) 1
redis 127.0.0.1:6379> set mykey hello //将该键的Value设置为不能转换为整型的普通字符串。
OK
redis 127.0.0.1:6379> incr mykey //在该键上再次执行递增操作时，Redis将报告错误信息。
(error) ERR value is not an integer or out of range
redis 127.0.0.1:6379> set mykey 10
OK
redis 127.0.0.1:6379> decrby mykey 5
(integer) 5
redis 127.0.0.1:6379> incrby mykey 10
(integer) 15
3. GETSET/SETEX/SETNX：
redis 127.0.0.1:6379> incr mycounter //将计数器的值原子性的递增1
(integer) 1
//getset 在设置新值得同时，并返回原有值，这两个操作原子性的同时完成。
redis 127.0.0.1:6379> getset mycounter 0
"1"
redis 127.0.0.1:6379> get mycounter //查看设置后的结果。
"0"
//setex 设置指定Key的内容和过期时间。
redis 127.0.0.1:6379> setex mykey 10 "hello" //设置指定Key的过期时间为10秒。
OK
//通过ttl命令查看一下指定Key的剩余存活时间(秒数)，0表示已经过期，-1表示永不过期。
redis 127.0.0.1:6379> ttl mykey
(integer) 4
redis 127.0.0.1:6379> get mykey //在该键的存活期内我们仍然可以获取到它的Value。
"hello"
redis 127.0.0.1:6379> ttl mykey //该ttl命令的返回值显示，该Key已经过期。
(integer) 0
redis 127.0.0.1:6379> get mykey //获取已过期的Key将返回nil。
(nil)
//setnx 该键并不存在，因此该命令执行成功，存在则不执行命令。
redis 127.0.0.1:6379> del mykey //删除该键，以便于下面的测试验证。
(integer) 1
redis 127.0.0.1:6379> setnx mykey "hello" //该键并不存在，因此该命令执行成功，存在则不执行命令。
(integer) 1
redis 127.0.0.1:6379> setnx mykey "world" //该键已经存在，因此本次设置没有产生任何效果。
(integer) 0
redis 127.0.0.1:6379> get mykey //从结果可以看出，返回的值仍为第一次设置的值。
"hello"
4. SETRANGE/GETRANGE:
redis 127.0.0.1:6379> set mykey "hello world" //设定初始值。
OK
redis 127.0.0.1:6379> setrange mykey 6 dd //从第六个字节开始替换2个字节(dd只有2个字节)
(integer) 11
redis 127.0.0.1:6379> get mykey //查看替换后的值。
"hello ddrld"
redis 127.0.0.1:6379> setrange mykey 20 dd //offset已经超过该Key原有值的长度了，该命令将会在末尾补0。
(integer) 22
redis 127.0.0.1:6379> get mykey //查看补0后替换的结果。
"hello ddrld\x00\x00\x00\x00\x00\x00\x00\x00\x00dd"
redis 127.0.0.1:6379> del mykey //删除该Key。
(integer) 1
redis 127.0.0.1:6379> setrange mykey 2 dd //替换空值。
(integer) 4
redis 127.0.0.1:6379> get mykey //查看替换空值后的结果。
"\x00\x00dd"
redis 127.0.0.1:6379> set mykey "0123456789" //设置新值。
OK
redis 127.0.0.1:6379> getrange mykey 1 2 //截取该键的Value，从第一个字节开始，到第二个字节结束。
"12"
redis 127.0.0.1:6379> getrange mykey 1 20 //20已经超过Value的总长度，因此将截取第一个字节后面的所有字节。
"123456789"
5. SETBIT/GETBIT:
redis 127.0.0.1:6379> del mykey
(integer) 1
redis 127.0.0.1:6379> setbit mykey 7 1 //设置从0开始计算的第七位BIT值为1，返回原有BIT值0
(integer) 0
redis 127.0.0.1:6379> get mykey //获取设置的结果，二进制的0000 0001的十六进制值为0x01
"\x01"
redis 127.0.0.1:6379> setbit mykey 6 1 //设置从0开始计算的第六位BIT值为1，返回原有BIT值0
(integer) 0
redis 127.0.0.1:6379> get mykey //获取设置的结果，二进制的0000 0011的十六进制值为0x03
"\x03"
redis 127.0.0.1:6379> getbit mykey 6 //返回了指定Offset的BIT值。
(integer) 1
redis 127.0.0.1:6379> getbit mykey 10 //Offset已经超出了value的长度，因此返回0。
(integer) 0
6. MSET/MGET/MSETNX:
//mset 会用新值覆盖旧值，如不想覆盖的使用msetnx
redis 127.0.0.1:6379> mset key1 "hello" key2 "world" //批量设置了key1和key2两个键。
OK
//mget 键值存在时返回value,不存在时返回nil
redis 127.0.0.1:6379> mget key1 key2 //批量获取了key1和key2两个键的值。
1) "hello"
2) "world"
//msetnx 当设置的key不存在时，则设置value,存在则所有操作都不执行
redis 127.0.0.1:6379> msetnx key3 "stephen" key4 "liu" //批量设置了key3和key4两个键，因为之气那他们并不存在，所以命令执行成功并返回1
(integer) 1
redis 127.0.0.1:6379> mget key3 key4
1) "stephen"
2) "liu"
//批量设置了key3和key5两个键，但是key3已经存在，所以该命令执行失败并返回0。
redis 127.0.0.1:6379> msetnx key3 "hello" key5 "world"
(integer) 0
//批量获取key3和key5，由于key5没有设置成功，所以返回nil。
redis 127.0.0.1:6379> mget key3 key5
1) "stephen"
2) (nil)Hash
- 数据结构
| 命令原型 | 时间复杂度 | 命令描述 | 返回值 |
| HGET | O(1) | hget key field value 获取hash key 对应的field的value | value值 |
| HSET | O(1) |
hset key field value 设置hash key 对应的field的value |
value值 |
| HDEL | O(1) |
hdel key field vale 删除hash key 对应的field 的value |
value值 |
| HGETALL | O(n) |
HGETALL key 获取在哈希表中指定 key 的所有字段和值 |
所有key/value值 |
| HMSET | O(n) |
HMSET key field1 value1 [field2 value2 ] 同时将多个 field-value (域-值)对设置到哈希表 key 中 |
OK |
| HSETNX | O(1) |
HSETNX key field value 只有在字段 field 不存在时，设置哈希表字段的值 |
0 |
List
lpush key value[value...]
将一个或多个value插入到列表的表头；例：lpush fruit apple。
lpushx key value
和lpush类似，但是lpushx会校验key是否存在，若key不存在则不进行任何操作；例：lpushx fruit orange。
lpop key
移除并返回列表key的头元素（后进先出），若key不存在返回nil；例：lpop fruit。
blpop key[key...] timeout
lpop的阻塞版本，当指定的列表中没有任何元素可供弹出时，链接会被blpop命令阻塞，直到等待超时（单位：秒）或发现可弹出元素时为止，若发现其中任何一个列表中有值则返回列表key和第一个元素的值，例：blpop editor fruit 30 返回：
1) fruit
2) apple
rpush key value[value...]
和lpush类似，但是它是将数据插入到表尾（最右边）；例：rpush fruit apple。
rpushx key value
和rpush和lpushx类似，它会将数据插入到表尾并且检查key是否存在；例：rpushx fruit apple。
rpop key
移除并返回列表的末尾，若key不存在则返回nil；例：rpop fruit。
brpop key[key...] timeout
rpop的阻塞版本，参见blpop。
rpoplpush source destination
顾名思义，执行两个操作 rpop+lpush：
- 将列表source中的数据末尾元素弹出，并返回给客户端；
- 将source中取出的元素插入到destination中。
brpoplpush source destination
rpoplpush的阻塞版本，参见brpop。
lset key index value
将列表中指定位置的值改为指定的值，若key不存在或index超出索引时，返回错误；例：lset fruit 0 orange。
linsert key before|after pivot value
在指定pivot之前或者之后插入一个值并返回元素的个数，当key不存在时不执行任何操作，当pivot不存在时不执行任何操作，若pivot有多个按从左到右以第一个为准，例：linsert fruit after apple orange。
llen key
返回列表的长度；例：llen fruit。
lindex key index
返回列表中index元素的值。index从0开始，若为负数则表示从右测读取，如-1表示倒数第一个元素，-2表示倒数第二个元素，当index超出索引时返回null；例：lindex fruit 0。
lrange key start stop
取指定区间的列表数据，start和stop都以0为底，也可以为负数-1表示倒数第一个元素，-2表示倒数第二个元素，以此类推。若stop超出界限则会返回界限内的值，若start超出界限则会返回空列表，若start比end大则会交换列表的值；例：lrange fruit 1 5。
ltrim key start stop
移除列表指定区间左右两边的数据，只保留区间内的数据。若start>stop会返回空表；若stop比list还要大则将stop置为end；例：ltrim fruit 2 4。
lrem key count value
移除列表中与value相等的元素，若count>0从左到右移除与count个与value相等的元素；若count<0从右向左移除count个与value相等的元素；若count==0移除所有与value相等的元素；例：lrem fruit 2 orange。
Set
1、【sadd】向集合(不存在会创建)中添加元素
sadd myset a b c d
2、【srem】删除集合中的元素
srem myset a 删除一个元素
srem myset b c 删除多个元素
3、【smembers】查看集合中的元素
smembers myset
4、【sismember】查看某元素是否在集合中(存在返回1，不存在返回0)
sismember myset a
5、【sdiff】差运算，返回差集（前面的－后面的）
sadd set a b c d
sadd set2 c d e f
sdiff set set2
set 集合减去 set2 集合，返回 a b
6、【sinter】交运算，返回集合都有的元素
sadd set a b c d
sadd set2 c d e f
sinter set set2
返回 set 和 set2 集合都有的元素，即 c d
7、【sunion】并运算，返回两个集合所有的元素
sadd set a b c d
sadd set2 c d e f
sinter set set2
返回 set 和 set2 集合所有的元素，即 a f e d b c
8、【scard】返回 set 的长度
scard myset
9、【srandmember】返回集合中随机一个元素
srandmember myset
10、【sdiffstore】将两个集合的差集放到一个新的集合里
sadd set a b c d
sadd set2 c d e f
sdiffstore newset set set2
最终 newset 结果为 a b
11、【sinterstore】将两个集合的交集放到一个新的集合里
sadd set a b c d
sadd set2 c d e f
sinterstore newset set set2
最终 newset 结果为 c d
12、【sunionstore】将两个集合的交集放到一个新的集合里
sadd set a b c d
sadd set2 c d e f
sunionstore newset set set2
最终 newset 结果为 c d
Sorted-set
Redis 有序集合和集合一样也是string类型元素的集合,且不允许重复的成员。
不同的是每个元素都会关联一个double类型的分数。redis正是通过分数来为集合中的成员进行从小到大的排序。
有序集合的成员是唯一的,但分数(score)却可以重复。
集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是O(1)。
1、【zadd】添加一个元素
格式：zdd score value 其中 score 表示权值
zadd mysort 78 李明
zadd mysort 90 言曌
zadd mysort 98 罗琪
2、【zscore】查询指定元素的分数
zscore mysort 言曌
3、【zrem】删除指定元素
zrem mysort 李明
4、【zcard】查询集合的元素个数
zcard mysort
5、【zrange】范围查找，排序由小到大
zrange mysort 0 -1 查询所有的元素值
zrange mysort 0 -1 withscores查询所有的元素值和对应的分数
6、【zrevrange】范围查找，排序有大到小
zrevrange mysort 0 -1 查询所有的元素值
zrevrange mysort 0 -1 withscores查询所有的元素值和对应的分数
7、【zremrangebyrank】按照排名删除
zremrangebyrank mysort 0 2 删除排名前三的(从小到大的顺序)
8、【zremrangebyscore】按照分数范围删除
zremrangebyscore mysort 80 100 删除 0-60 分的元素
9、【zrangebyscore】查询分数范围内的元素
zrangebyscore mysort 0 60 查询分数在 0-60 分的元素
zrangebyscore mysort 0 60 limit 0 2 查询分数在 0-60 分的元素，返回 前 2 个
10、【zincrby】给指定的元素的分数增加分数
格式：zincrby key increment member
zincrby mysort 5 言曌 给言曌加5分
11、【zcount】返回指定分数范围内的元素个数
zcount mysourt 10 100 返回 10-100 分内的元素个数