由于部署架构的不同，相对标准架构来说，集群架构的实例在原生Redis命令的支持上有一定的区别，本文介绍集群架构实例的命令使用限制。

支持的命令

不支持的命令

  • SWAPDB
  • CLIENT ID

受限的命令

说明 如需在集群架构实例中执行下述受限制的命令，请使用hash tag确保命令所要操作的key都分布在1个hash slot中，hash tag的详细用法请参见Redis官方文档。
命令族 具体命令
HyperLogLog PFMERGE、PFCOUNT
Keys RENAME、RENAMENX、SORT
Lists RPOPLPUSH、BRPOP、BLPOP、BRPOPLPUSH
Scripting EVAL、EVALSHA、SCRIPT EXISTS、SCRIPT FLUSH、SCRIPT KILL、SCRIPT LOAD
Strings MSETNX
Transaction DISCARD、EXEC、MULTI、UNWATCH、WATCH

其他限制

  • 执行CLIENT LIST命令会列出所有连接到该代理节点的连接信息。返回结果解释如下：
    • id、age、idle、addr、fd、name、db、multi、omem、cmd字段和原生Redis的含义一致。
    • sub、psub在代理节点上没有区分，统一为1或0。
    • qbuf、qbuf-free、obl和oll字段目前没有具体意义。
  • CLIENT KILL命令目前支持的形式为：client kill ip:port和client kill addr ip:port。
  • 如果事务开始前没有使用WATCH命令，且事务中都是单key命令的场景，Redis不再要求所有key必须在同1个slot（槽）中，使用方式和直连Redis完全一致。其他场景下要求事务中所有命令的所有key必须在同1个slot中。
    • 多key命令包括：DEL、SORT、MGET、MSET、BITOP、EXISTS、MSETNX、RENAME、 RENAMENX、BLPOP、BRPOP、RPOPLPUSH、BRPOPLPUSH、SMOVE、SUNION、SINTER、SDIFF、SUNIONSTORE、SINTERSTORE、SDIFFSTORE、ZUNIONSTORE、ZINTERSTORE、 PFMERGE、PFCOUNT。
    • 不允许在事务中使用的命令为：WATCH、UNWATCH、RANDOMKEY、KEYS、SUBSCRIBE、 UNSUBSCRIBE、PSUBSCRIBE、PUNSUBSCRIBE、PUBLISH、PUBSUB、SCRIPT、EVAL、 EVALSHA、SCAN、ISCAN、DBSIZE、ADMINAUTH、AUTH、PING、ECHO、FLUSHDB、 FLUSHALL、MONITOR、IMONITOR、RIMONITOR、INFO、IINFO、RIINFO、CONFIG、 SLOWLOG、TIME、CLIENT。
  • Lua使用存在一定的限制：
    • 所有key需由KEYS数组来传递，redis.call/pcall中调用的Redis命令，key的位置必须是KEYS array（不能使用Lua变量替换KEYS），否则直接返回错误信息："-ERR bad lua script for redis cluster, all the keys that the script uses should be passed using the KEYS array\r\n"。
    • 所有key必须在1个slot上，否则返回错误信息："-ERR eval/evalsha command keys must be in same slot\r\n"。
    • 调用必须要带有key，否则直接返回错误信息： "-ERR for redis cluster, eval/evalsha number of keys can't be negative or zero\r\n"。
    • 不支持发布订阅命令，包括：PSUBSCRIBE、PUBSUB、PUBLISH、PUNSUBSCRIBE、SUBSCRIBE、UNSUBSCRIBE。
    • 不支持UNPACK函数。