pika 支持的redis接口及兼容情况

pika当前支持的redis接口 pika支持redis五种类型（分别为string、hash、list、set、zset）的接口，先列出其对redis的五种数据结构兼容统计。

统计所用的标记含义如下：

图标	含义
o	该接口完全支持，使用方式与redis没有任何区别
！	功能支持，但使用或输出与redis有部分差异，需注意
×	当前还未支持

---

Keys

接口	DEL	DUMP	EXISTS	EXPIRE	EXPIREAT	KEYS	MIGRATE	MOVE	OBJECT
状态	o	x	o	o	o	o	x	x	x
接口	PERSIST	PEXPIRE	PEXPIREAT	PTTL	RANDOMKEY	RENAME	RENAMENX	RESTORE	SORT
状态	o	!	!	o	x	x	x	x	x
接口	TOUCH	TTL	TYPE	UNLINK	WAIT	SCAN
状态	x	o	!	o	x	!

备注:

• PEXPIRE：无法精确到毫秒，底层会自动截断按秒级别进行处理;

• PEXPIREAT：无法精确到毫秒，底层会自动截断按秒级别进行处理;

• SCAN：会顺序迭代当前db的快照，由于pika允许重名五次，所以scan有优先输出顺序，依次为：string -> hash -> list -> zset -> set;

• TYPE：另外由于pika允许重名五次，所以type有优先输出顺序，依次为：string -> hash -> list -> zset -> set，如果这个key在string中存在，那么只输出sting，如果不存在，那么则输出hash的，依次类推。

• KEYS: KEYS命令支持参数支持扫描指定类型的数据，用法如 "keys * [string, hash, list, zset, set]"

Strings

接口	APPEND	BITCOUNT	BITFIELD	BITOP	BITPOS	DECR	DECRBY	GET	GETBIT
状态	o	o	x	!	o	o	o	o	!
接口	GETRANGE	GETSET	INCR	INCRBY	INCRBYFLOAT	MGET	MSET	MSETNX	STRLEN
状态	o	o	o	o	o	o	o	o	o
接口	PSETEX	SET	SETBIT	SETEX	SETNX	SETRANGE
状态	o	o	!	o	o	o

备注:

• BIT操作：与Redis不同，Pika的bit操作范围为2^21， bitmap的最大值为256Kb。redis setbit 只是对key的value值更新。但是pika使用rocksdb作为存储引擎，rocksdb只会新写入数据并且只在compact的时候才从硬盘删除旧数据。如果pika的bit操作范围和redis一致都是2^32的话，那么有可能每次对同一个key setbit时，rocksdb都会存储一个512M大小的value。这会产生 严重的性能隐患。因此我们对pika的bit操作范围作了取舍。

Hashes

接口	HDEL	HEXISTS	HGET	HGETALL	HINCRBY	HINCRBYFLOAT	HKEYS	HLEN	HMGET	HMSET
状态	o	o	o	o	o	o	o	o	o	o
接口	HSET	HSETNX	HVALS	HSCAN	HSTRLEN
状态	!	o	o	o	o

备注:

• HSET操作：暂不支持单条命令设置多个field value，如有需求请用HMSET

Lists

接口	LINDEX	LINSERT	LLEN	LPOP	LPUSH	LPUSHX	LRANGE	LREM	LSET	LTRIM
状态	o	o	o	o	o	o	o	o	o	o
接口	RPOP	RPOPLPUSH	RPUSH	RPUSHX	BLPOP	BRPOP	BRPOPLPUSH
状态	o	o	o	o	o	o	x

Sets

接口	SADD	SCARD	SDIFF	SDIFFSTORE	SINTER	SINTERSTORE	SISMEMBER	SMEMBERS	SMOVE	SPOP
状态	o	o	o	o	o	o	o	o	o	o
接口	SRANDMEMBER	SREM	SUNION	SUNIONSTORE	SSCAN
状态	!	o	o	o	o

备注：

• SRANDMEMBER：时间复杂度O( n )，耗时较多

Sorted Sets

接口	ZADD	ZCARD	ZCOUNT	ZINCRBY	ZRANGE	ZRANGEBYSCORE	ZRANK	ZREM	ZREMRANGEBYRANK	ZREMRANGEBYSCORE
状态	o	o	o	o	o	o	o	o	o	o
接口	ZREVRANGE	ZREVRANGEBYSCORE	ZREVRANK	ZSCORE	ZUNIONSTORE	ZINTERSTORE	ZSCAN	ZRANGEBYLEX	ZLEXCOUNT	ZREMRANGEBYLEX
状态	o	o	o	o	o	o	o	o	o	o
接口	ZPOPMAX	ZPOPMIN	ZREVERANGEBYLEX
状态	o	o	o

• ZADD 的选项 [NX|XX] [CH] [INCR] 暂不支持

HyperLogLog

接口	PFADD	PFCOUNT	PFMERGE
状态	o	o	o

备注：

• 50w以内误差均小于1%, 100w以内误差小于3%, 但付出了时间代价.

GEO

接口	GEOADD	GEODIST	GEOHASH	GEOPOS	GEORADIUS	GEORADIUSBYMEMBER
状态	o	o	o	o	o	o

BitMap

接口	SETBIT	GETBIT	BITPOS	BITOP	BITCOUNT
状态	o	o	o	o	o

Pub/Sub

接口	PSUBSCRIBE	PUBSUB	PUBLISH	PUNSUBSCRIBE	SUBSCRIBE	UNSUBSCRIBE
状态	o	o	o	o	o	o

ACL

接口	ACL CAT	ACL DELUSER	ACL DRYRUN	ACL GENPASS	ACL GETUSER	ACL LIST	ACL LOAD	ACL LOG	ACL SAVE	ACL SETUSER	ACL USERS	ACL HELP	ACL WHOAMI
状态	o	o	o	o	o	o	o	o	o	!	o	o	o

备注： redis中部分命令是有子命令的, 这些命令在pika中是一个命令, 在ACL划分权限时, 可能无法做到完全兼容redis.

Stream

接口	XADD	XDEL	XRANGE	XREVRANGE	XREAD	XLEN	XINFO	XTRIM	XACK	XGROUP DESTROY	XGROUP HELP	XCLAIM	XAUTOCLAIM	XREADGROUP
状态	o	o	o	o	o	o	o	o	o	x	x	x	x	x

备注：

• xread ：暂不支持阻塞等待的方式（类似于blpop）

管理命令（这里仅列出pika兼容的）

接口	INFO	CONFIG	CLIENT	PING	BGSAVE	SHUTDOWN	SELECT	TYPE	HELLO
状态	!	o	!	o	o	o	!	!	o

备注：

• 暂不支持keyspace notifications

• info：info支持全部输出，也支持匹配形式的输出，例如可以通过info stats查看状态信息，需要注意的是key space与redis不同，pika对于key space的展示选择了分类型展示而非redis的分库展示（因为pika没有库），pika对于key space的统计是被动的，需要手动触发，然后pika会在后台进行统计，pika的key space统计是精确的。触发方式为执行：keyspace命令即可，然后pika会在后台统计，此时可以使用：keyspace readonly命令来进行查看，readonly参数可以避免反复进行统计，如果当前数据为0，则证明还在统计中； info commandstats可以查询到各个命令的调用次数和统计用时以及平均用时，和redis不同的是我们统计耗时的时间单位是毫秒

• client：当前client命令支持client list及client kill还有client setname，client list显示的内容少于redis；

• select：该命令在3.1.0版前无任何效果，自3.1.0版开始与Redis一致;

• ping：该命令仅支持无参数使用，即使用PING，客户端返回PONG.

• type：pika不同类型的key name 是允许重复的，例如：string 类型里有 key1，hash list set zset类型可以同时存在 key1，在使用 type命令查询时，只能得到一个，如果要查询同一个 name 所有的类型，需要使用 ptype 命令查询

---

重要说明

• 重名问题：由于pika每个类型独立运作， 所以允许重名。例如在key abc在string中存在的时候也同样允许在hash中存在，一个key最多重名5次（5大类型），但在同一接口中是无法重名的。所以建议在使用的时候对于不同类型不要使用完全相同的key;

• 分库问题：pika自3.1.0版起支持多库，相关命令、参数的变化请参考Pika3.1.0多库版命令、参数变化参考文档

• 数据展示：pika对于keyspace的展示选择了分类型展示而非redis的分库展示（因为pika没有分库概念），pika对于keyspace的统计是被动的，需要手动触发并不会立即输出，命令为：info keyspace [ 0|1 ]，默认为0不触发，pika的keyspace统计是精确的。