string命令

秒速五厘米 2022-05-25 03:43 37阅读 0赞

set key value   
设置给定key的值。如果 key 已经存储其他值，SET 就覆写旧值且无视类型。  
mset key value \[key value ...\]  
同时设置一个或多个 key-value 对  
msetnx key value \[key value ...\]  
同时设置一个或多个key-value对，当且仅当所有给定 key 都不存在。  
setex key seconds value  
设置key-value并设置过期时间（单位：秒）  
psetex key milliseconds value  
以毫秒为单位设置 key 的生存时间  
setnx key value  
只有在key不存在时设置key的值。  
setrange key offset value  
这个命令的作用是覆盖key对应的string的一部分，从指定的offset处开始，覆盖value的长度。  
如果offset比当前key对应string还要长，那这个string后面就补0以达到offset。  
不存在的keys被认为是空字符串，所以这个命令可以确保key有一个足够大的字符串，能在offset处设置value。  
  
incr key  
将 key 中储存的数字值原子增一。如果key不存在，那么key的值会先被初始化为0，然后再执行 INCR 操作  
incrby key increment  
将key中储存的数字原子加上指定的增量值。  
incrbyfloat key increment  
执行原子增加一个浮点数  
decr key  
整数原子减1  
decrby key decrement  
原子减指定的整数  
  
strlen key  
返回 key 所储存的字符串值的长度。  
  
get key  
获取指定key的值。如果key不存在，返回 nil。如果key 储存的值不是字符串类型，返回一个错误  
getrange key start end  
获取存储在指定 key 中字符串的子字符串。字符串的截取范围由start和end两个偏移量决定(包括 start和end 在内)。  
getset key value  
将给定key的值设为value，并返回key的旧值(old value)。  
mget key \[key ...\]  
返回所有(一个或多个)给定key的值。如果给定的key里面，有某个key不存在，那么这个key返回特殊值nil。  
  
append key value  
追加一个值到key上  
如果key已经存在并且是一个字符串，APPEND命令将value追加到key原来的值的末尾。  
如果key不存在，APPEND 就简单地将给定key设为value 就像执行SET key value 一样。

位操作

setbit key offset value  
设置或者清空key的value(字符串)在offset处的bit值。  
那个位置的bit要么被设置，要么被清空，这个由value（只能是0或者1）来决定。  
当key不存在的时候，就创建一个新的字符串value。要确保这个字符串大到在offset处有bit值。参数offset需要大于等于0，并且小于232(限制bitmap大小为512)。  
当key对应的字符串增大的时候，新增的部分bit值都是设置为0。

返回值在offset处原来的bit值

getbit key offset  
返回key对应的string在offset处的bit值   
当offset超出了字符串长度的时候，这个字符串就被假定为由0比特填充的连续空间。

当key不存在的时候，它就认为是一个空字符串，所以offset总是超出范围，然后value也被认为是由0比特填充的连续空间。

bitcount key \[start end\]  
统计字符串被设置为1的bit数.  
一般情况下，给定的整个字符串都会被进行计数，通过指定额外的 start 或 end 参数，可以让计数只在特定的位上进行。  
start 和 end 参数的设置和 GETRANGE 命令类似，都可以使用负数值：比如 -1 表示最后一个位，而 -2 表示倒数第二个位，以此类推。  
不存在的 key 被当成是空字符串来处理，因此对一个不存在的 key 进行 BITCOUNT 操作，结果为 0 。  
  
  
**模式：使用 bitmap 实现用户上线次数统计**  
Bitmap 对于一些特定类型的计算非常有效。  
假设现在我们希望记录自己网站上的用户的上线频率，比如说，计算用户 A 上线了多少天，用户 B 上线了多少天，  
诸如此类，以此作为数据，从而决定让哪些用户参加 beta 测试等活动 —— 这个模式可以使用 SETBIT 和 BITCOUNT 来实现。  
比如说，每当用户在某一天上线的时候，  
我们就使用 SETBIT ，以用户名作为 key ，将那天所代表的网站的上线日作为 offset 参数，并将这个 offset 上的为设置为 1 。  
举个例子，如果今天是网站上线的第 100 天，而用户 peter 在今天阅览过网站，那么执行命令 SETBIT peter 100 1 ；  
如果明天 peter 也继续阅览网站，那么执行命令 SETBIT peter 101 1 ，以此类推。  
当要计算 peter 总共以来的上线次数时，就使用 BITCOUNT 命令：执行 BITCOUNT peter ，得出的结果就是 peter 上线的总天数。  
更详细的实现可以参考博文 Fast, easy, realtime metrics using Redis bitmaps (需要翻墙)  
性能  
前面的上线次数统计例子，即使运行 10 年，占用的空间也只是每个用户 10\*365 比特位(bit)，也即是每个用户 456 字节。对于这种大小的数据来说， BITCOUNT 的处理速度就像 GET 和 INCR 这种 O(1) 复杂度的操作一样快。  
如果你的 bitmap 数据非常大，那么可以考虑使用以下两种方法：  
将一个大的 bitmap 分散到不同的 key 中，作为小的 bitmap 来处理。使用 Lua 脚本可以很方便地完成这一工作。

使用 BITCOUNT 的 start 和 end 参数，每次只对所需的部分位进行计算，将位的累积工作(accumulating)放到客户端进行，并且对结果进行缓存 (caching)。

bitop operation destkey key \[key ...\]  
对一个或多个保存二进制位的字符串 key 进行位元操作，并将结果保存到 destkey 上。  
BITOP 命令支持 AND 、 OR 、 NOT 、 XOR 这四种操作中的任意一种参数：  
BITOP AND destkey srckey1 srckey2 srckey3 ... srckeyN ，对一个或多个 key 求逻辑并，并将结果保存到 destkey 。  
BITOP OR destkey srckey1 srckey2 srckey3 ... srckeyN，对一个或多个 key 求逻辑或，并将结果保存到 destkey 。  
BITOP XOR destkey srckey1 srckey2 srckey3 ... srckeyN，对一个或多个 key 求逻辑异或，并将结果保存到 destkey 。  
BITOP NOT destkey srckey，对给定 key 求逻辑非，并将结果保存到 destkey 。  
除了 NOT 操作之外，其他操作都可以接受一个或多个 key 作为输入。  
执行结果将始终保持到destkey里面。  
处理不同长度的字符串  
当 BITOP 处理不同长度的字符串时，较短的那个字符串所缺少的部分会被看作 0 。  
空的 key 也被看作是包含 0 的字符串序列。  
返回值  
Integer reply  
保存到 destkey 的字符串的长度，和输入 key 中最长的字符串长度相等。  
模式：使用 bitop 实现用户上线次数统计  
BITOP是对BITCOUNT命令一个很好的补充。  
不同的bitmaps进行组合操作可以获得目标bitmap以进行人口统计操作。  
Fast easy realtime metrics using Redis bitmaps这篇文章介绍了一个有趣的用例。  
性能  
BITOP可能是一个缓慢的命令，它的时间复杂度是O(N)。 在处理长字符串时应注意一下效率问题。

对于实时的指标和统计，涉及大输入一个很好的方法是 使用bit-wise操作以避免阻塞主实例。

bitpos key bit \[start\] \[end\]  
返回字符串里面第一个被设置为1或者0的bit位。  
返回一个位置，把字符串当做一个从左到右的字节数组，第一个符合条件的在位置0，其次在位置8，等等。  
默认情况下整个字符串都会被检索一次，只有在指定start和end参数(指定start和end位是可行的)，该范围被解释为一个字节的范围，而不是一系列的位。所以start=0 并且 end=2是指前三个字节范围内查找。  
注意，返回的位的位置始终是从0开始的，即使使用了start来指定了一个开始字节也是这样。  
  
bitfield key \[get type offset\] \[set type offset value\] \[incrby type offset increment\] \[overflow wrap|sat|fail\]  
不知道啥玩意