- 作者:邹祁峰
- 邮箱:[email protected]
- 博客:http://blog.csdn.net/qifengzou
- 日期:2014.10.11
- 转载请注明来自"祁峰"的CSDN博客
1 简单概述
String数据类型是Redis中最简单、最基础的数据类型,Redis中所有的KEY和VALUE都是String类型,且其他更为复杂的数据类型(LISTS、SETS、SORTED-SETS、HASHES)也均基于String数据类型来存储的。String数据类型是二进制安全的,也就是说String可以包含任何格式的数据,比如:JPG图片、序列化的对象等。
2 操作命令
表1 String类型操作命令
01 | APPEND key value |
功能描述:将KEY对应的VALUE值减1
返回结果:APPEND操作之后,KEY对应VALUE的最终长度 注意事项: 1)时间复杂度:O(1) 2)当KEY存在,且为STRING类型时,将会将value追加到原有值末尾; 3)如果KEY不存在,将会新建KEY/VALUE。 |
|
02 | DECR key |
功能描述:将KEY对应的VALUE原子性的减1
返回结果:返回执行减1操作后KEY对应的VALUE值 注意事项: 1)时间复杂度:O(1) 2)如果KEY对应VALUE能转化为数字,则执行减1操作; 3)如果KEY对应VALUE不能转化为数字,则返回错误信息; 4)该操作是原子性的。假设:当前KEY对应的VALUE值为100,当3个客户端同时执行该操作时,最终结果将会是97。 |
|
03 | INCR key |
功能描述:将KEY对应的VALUE原子性的加1
返回结果:返回执行加1操作后KEY对应的VALUE值 注意事项: 1)时间复杂度:O(1) 2)如果KEY对应VALUE能转化为数字,则执行加1操作; 3)如果KEY对应VALUE不能转化为数字,则返回错误信息; 4)该操作是原子性的。假设:当前KEY对应的VALUE值为100,当3个客户端同时执行该操作时,最终结果将会是103。 |
|
04 | DECRBY key decremen |
功能描述:将KEY对应的VALUE原子性的减decrement
返回结果:返回执行减操作后KEY对应的VALUE值 注意事项: 1)时间复杂度:O(1) 2)如果KEY对应VALUE能转化为数字,则执行减操作; 3)如果KEY对应VALUE不能转化为数字,则返回错误信息; 4)参数decrement不能为浮点数,只能为整数; 5)该操作是原子性的。 |
|
05 | INCRBY key increment |
功能描述:将KEY对应的VALUE原子性的加increment
返回结果:返回执行加操作后KEY对应的VALUE值 注意事项: 1)时间复杂度:O(1) 2)如果KEY对应VALUE能转化为数字,则执行加操作; 3)如果KEY对应VALUE不能转化为数字,则返回错误信息; 4)参数increment不能为浮点数,只能为整数; 5)该操作是原子性的。 |
|
06 | INCRBYFLOAT key increment |
功能描述:将KEY对应的VALUE原子性的加increment
返回结果:返回执行加操作后KEY对应的VALUE值 注意事项: 1)时间复杂度:O(1) 2)如果KEY对应VALUE能转化为数字,则执行加操作; 3)如果KEY对应VALUE不能转化为数字,则返回错误信息; 4)此命令的参数increment可以为浮点数,但是请注意此命令的计算精度; 5)暂时没有命令DECRBYFLOAT,如果想进行浮点数的减操作,可以模仿:INCRBYFLOAT key -5.9; 6)该操作是原子性的。 |
|
07 | SET key value [EX seconds] [PX milliseconds] [NX|XX] |
功能描述:设置KEY对应的VALUE
参数说明: 从 Redis 2.6.12 版本开始, SET 命令的行为可以通过一系列参数来修改: 1)EX second:设置键的过期时间为second秒 SET key value EX second 效果等同于 SETEX key second value。 2)PX millisecond:设置键的过期时间为millisecond毫秒 SET key value PX millisecond 效果等同于 PSETEX key millisecond value。 3)NX :只在键不存在时,才对键进行设置操作 SET key value NX 效果等同于 SETNX key value 4)XX :只在键已经存在时,才对键进行设置操作。 返回结果: 1)在2.6.12版本之前,总是返回OK; 2)在2.6.12版本开始,SET操作完成时才返回OK; 3)如果设置了 NX 或者 XX ,但因为条件没达到而造成设置操作未执行,那么命令返回空批量回复(NULL Bulk Reply)。 注意事项: 1)时间复杂度:O(1) 2)如果KEY已经存在,此操作将直接覆盖旧值,且无视类型; 3)对于某个原本带有生存时间(TTL)的键来说, 当 SET 命令成功在这个键上执行时, 这个键原有的 TTL 将被清除。 |
|
08 | GET key |
功能描述:获取指定KEY的VALUE
返回结果:指定KEY的VALUE 注意事项: 1)时间复杂度:O(1) 2)如果该KEY不存在,返回NIL; 3)如果该KEY不是String类型,将返回错误信息。 |
|
09 | GETSET key value |
功能描述:原子性的设置KEY的VALUE,同时获取该KEY的原VALUE
返回结果:该KEY的原VALUE 注意事项: 1)时间复杂度:O(1) 2)如果该KEY不存在,将新建KEY,并返回NIL; 3)如果该KEY不是String类型,将返回错误信息。 |
|
10 | STRLEN key |
功能描述:获取该KEY的VALUE长度
返回结果:该KEY的VALUE长度 注意事项: 1)时间复杂度:O(1) 2)如果该KEY不存在,将返回0; 3)如果该KEY不是String类型,将返回错误信息。 |
|
11 | SETEX key seconds value |
功能描述:设置KEY对应值为VALUE,同时设置该KEY的生存时间为SECONDS秒
返回结果:操作完成时才返回OK 注意事项: 1)时间复杂度:O(1) 2)如果KEY已经存在,此操作将直接覆盖旧值; 3)该命令类似如下两条命令: SET key value EXPIRE key seconds 不同的是,SETEX是原子性的。关联值和设置生存时间两个动作会在同一时间内完成,该命令在 Redis 用作缓存时,非常实用; 4)当 seconds 参数不合法时,返回错误。 |
|
12 | SETNX key value |
功能描述:当前仅当KEY不存在时,设置KEY对应值为VALUE
返回结果:设置成功返回1,设置失败返回0 注意事项: 1)时间复杂度:O(1) 2)将 key 的值设为 value ,当且仅当 key 不存在; 3)若给定的 key 已经存在,则 SETNX 不做任何动作; 4)SETNX 是"SET if Not eXists"(如果不存在,则 SET)的简写。 |
|
13 | SETBIT key offset value |
功能描述:对KEY所储存的字符串值,设置或清除指定偏移量上的位(bit)
返回结果:指定偏移量原来储存的位 注意事项: 1)时间复杂度:O(1) 2)位的设置或清除取决于 value 参数,可以是 0 也可以是 1; 3)当 key 不存在时,自动生成一个新的字符串值; 4)字符串会进行伸展(grown)以确保它可以将 value 保存在指定的偏移量上。当字符串值进行伸展时,空白位置以 0 填充; 5)offset 参数必须大于或等于 0 ,小于 2^32 (bit 映射被限制在 512 MB 之内); 6)对使用大的 offset 的SETBIT操作来说,内存分配可能造成 Redis 服务器被阻塞。具体参考SETRANGE |
|
14 | GETBIT key offset |
功能描述:对 key 所储存的字符串值,获取指定偏移量上的位(bit)
返回结果:指定偏移量上的位 注意事项: 1)时间复杂度:O(1) 2)当 offset 比字符串值的长度大,或者 key 不存在时,返回 0 ; 3)当KEY不存在时,进行GETBIT操作将返回0。 |
|
15 | SETRANGE key offset value |
功能描述:用 value 参数覆写(overwrite)给定 key 所储存的字符串值,从偏移量 offset 开始
返回结果:修改后的字符串长度 注意事项: 1)时间复杂度:对小的字符串,平摊复杂度O(1)。(关于什么字符串是”小”的,请参考 APPEND 命令) 否则为O(M), M 为 value 参数的长度 2)不存在的 key,则将其原值当作空白字符串处理; 3)SETRANGE 命令会确保字符串足够长以便将 value 设置在指定的偏移量上,如果给定 key 原来储存的字符串长度比偏移量小(比如字符串只有 5 个字符长,但你设置的 offset 是 10 ),那么原字符和偏移量之间的空白将用零字节(zerobytes, "\x00" )来填充; 4)注意你能使用的最大偏移量是 2^29-1(536870911) ,因为 Redis 字符串的大小被限制在 512 兆(megabytes)以内。如果你需要使用比这更大的空间,你可以使用多个 key ; 5)当生成一个很长的字符串时,Redis 需要分配内存空间,该操作有时候可能会造成服务器阻塞(block)。在2010年的Macbook Pro上,设置偏移量为 536870911(512MB 内存分配)耗费约 300 毫秒, 设置偏移量为 134217728(128MB 内存分配),耗费约 80 毫秒,设置偏移量 33554432(32MB 内存分配),耗费约 30 毫秒,设置偏移量为 8388608(8MB 内存分配),耗费约 8 毫秒。 注意若首次内存分配成功之后,再对同一个 key 调用 SETRANGE |
|
16 | GETRANGE key start end |
功能描述:截取 key 对应字串值的子串
返回结果:截取得出的子串 注意事项: 1)时间复杂度:O(N)(N表示要返回的字串长度) 2)字符串的截取范围由 start 和 end 两个偏移量决定(包括 start 和 end 在内); 3)负数偏移量表示从字符串最后开始计数, -1 表示最后一个字符, -2 表示倒数第二个,以此类推; 4)GETRANGE 通过保证子字符串的值域(range)不超过实际字符串的值域来处理超出范围的值域请求; 5)在 <= 2.0 的版本里,GETRANGE 被叫作 SUBSTR。 |
|
17 | MSET key value [key value ...] |
功能描述:同时设置1个或多个KEY-VALUE对
返回结果:总是返回 OK (因为 MSET 不可能失败) 注意事项: 1)时间复杂度:O(N)(N表示 key-value对的数量) 2)如果某个给定 key 已经存在,那么 MSET 会用新值覆盖原来的旧值,如果这不是你所希望的效果,请考虑使用 MSETNX 命令:它只会在所有给定 key 都不存在的情况下进行设置操作; 3)MSET 是一个原子性(atomic)操作,所有给定 key 都会在同一时间内被设置,某些给定 key 被更新而另一些给定 key 没有改变的情况,不可能发生。 |
|
18 | MSETNX key value [key value ...] |
功能描述:同时设置一个或多个 key-value 对,当且仅当所有给定 key 都不存在
返回结果:成功返回1,失败返回0 注意事项: 1)时间复杂度:O(N)(N表示 key-value对的数量) 2)即使只有一个给定 key 已存在, MSETNX 也会拒绝执行所有给定 key 的设置操作; 3)MSETNX 是原子性的,因此它可以用作设置多个不同 key 表示不同字段(field)的唯一性逻辑对象(unique logic object),所有字段要么全被设置,要么全不被设置。 |
|
19 | MGET key [key ...] |
功能描述:返回所有(一个或多个)给定 key 的值
返回结果:一个包含所有给定 key 的值的列表 注意事项: 1)时间复杂度:O(N)(N表示 key-value对的数量) 2)如果给定的 key 里面,有某个 key 不存在,那么这个 key 返回特殊值 nil 。因此,该命令永不失败。 |