direktori cari
Cluster cluster addslots(集群 槽位) cluster count failure reports(集群计数失败报告) cluster countkeysinslot cluster delslots cluster failover cluster forget cluster getkeysinslot cluster info cluster keyslot(集群键槽) cluster meet cluster nodes(集群节点) cluster replicate(集群复制) cluster reset(集群重置) cluster saveconfig cluster set config epoch cluster setslot cluster slaves cluster slots readonly readwrite Connection auth echo ping quit select swapdb Geo geoadd geodist geohash geopos georadius georadiusbymember Hashes hdel hexists hget hgetall hincrby hincrbyfloat hkeys hlen hmget hmset hscan hset hsetnx hstrlen hvals HyperLogLog pfadd pfcount pfmerge Keys del dump exists expire expireat keys migrate move object persist pexpire pexpireat pttl randomkey rename renamenx restore scan sort touch ttl type unlink wait Lists blpop brpop brpoplpush lindex linsert llen lpop lpush lpushx lrange lrem lset ltrim rpop rpoplpush rpush rpushx Pub/Sub psubscribe publish pubsub punsubscribe subscribe unsubscribe Scripting eval evalsha script debug script exists script flush script kill script load Server bgrewriteaof bgsave client getname client kill client list client pause client reply client setname command command count command getkeys command info config get config resetstat config rewrite config set dbsize debug object debug segfault flushall flushdb info lastsave monitor role save shutdown slaveof slowlog time Sets sadd scard sdiff sdiffstore sinter sinterstore sismember smembers smove spop srandmember srem sscan sunion sunionstore Sorted Sets zadd zcard zcount zincrby zinterstore zlexcount zrange zrangebylex zrangebyscore zrank zrem zremrangebylex zremrangebyrank zremrangebyscore zrevrange zrevrangebylex zrevrangebyscore zrevrank zscan zscore zunionstore Strings append bitcount bitfield bitop bitpos decr decrby get getbit getrange getset incr incrby incrbyfloat mget mset msetnx psetex set setbit setex setnx setrange strlen Transactions discard exec multi unwatch watch
watak

CLUSTER NODES

自3.0.0起可用。

时间复杂度: O(N)其中N是 Cluster 节点的总数

Redis 集群中的每个节点都有其当前集群配置的视图,由已知节点的集合给出,我们与这些节点的连接状态,它们的标志,属性和分配的槽等等。

CLUSTER NODES 以串行格式提供所有这些信息,即我们正在联系的节点的当前集群配置,该格式恰好与 Redis Cluster 自身使用的格式相同,以便在磁盘上存储集群状态(但磁盘群集状态在最后附加了一些附加信息)。

请注意,通常情况下,希望在 Cluster 哈希槽和节点地址之间获取映射的客户端应该使用 CLUSTER SLOTS。提供更多信息的 CLUSTER NODES 应该用于管理任务,调试和配置检查。它也用于redis-trib管理群集。

序列化格式

命令的输出只是一个空格分隔的 CSV 字符串,其中每行代表集群中的一个节点。以下是输出示例:

07c37dfeb235213a872192d90877d0cd55635b91 127.0.0.1:30004 slave e7d1eecce10fd6bb5eb35b9f99a514335d9ba9ca 0 1426238317239 4 connected
67ed2db8d677e59ec4a4cefb06858cf2a1a89fa1 127.0.0.1:30002 master - 0 1426238316232 2 connected 5461-10922
292f8b365bb7edb5e285caf0b7e6ddc7265d2f4f 127.0.0.1:30003 master - 0 1426238318243 3 connected 10923-16383
6ec23923021cf3ffec47632106199cb7f496ce01 127.0.0.1:30005 slave 67ed2db8d677e59ec4a4cefb06858cf2a1a89fa1 0 1426238316232 5 connected
824fe116063bc5fcf9f4ffd895bc17aee7731ac3 127.0.0.1:30006 slave 292f8b365bb7edb5e285caf0b7e6ddc7265d2f4f 0 1426238317741 6 connected
e7d1eecce10fd6bb5eb35b9f99a514335d9ba9ca 127.0.0.1:30001 myself,master - 0 0 1 connected 0-5460

每行由以下字段组成:

<id> <ip:port> <flags> <master> <ping-sent> <pong-recv> <config-epoch> <link-state> <slot> <slot> ... <slot>

每个字段的含义如下:

1. id:节点 ID,一个40个字符的随机字符串,当一个节点被创建时不会再发生变化(除非CLUSTER RESET HARD被使用)。

2. ip:port:客户端应该联系节点以运行查询的节点地址。

3. flags:逗号列表分隔的标志:myselfmasterslavefail?failhandshakenoaddrnoflags。标志在下一节详细解释。

4. master:如果节点是从属节点,并且主节点已知,则节点ID为主节点,否则为“ - ”字符。

5. ping-sent:以毫秒为单位的当前激活的ping发送的unix时间,如果没有挂起的ping,则为零。

6. pong-recv:毫秒 unix 时间收到最后一个乒乓球。

7. config-epoch:当前节点(或当前主节点,如果该节点是从节点)的配置时期(或版本)。每次发生故障切换时,都会创建一个新的,唯一的,单调递增的配置时期。如果多个节点声称服务于相同的哈希槽,则具有较高配置时期的节点将获胜。

8. link-state:用于节点到节点集群总线的链路状态。我们使用此链接与节点进行通信。可以是connecteddisconnected

9. slot:散列槽号或范围。从参数9开始,但总共可能有16384个条目(限制从未达到)。这是此节点提供的散列槽列表。如果条目仅仅是一个数字,则被解析为这样。如果它是一个范围,它是在形式start-end,并且意味着节点负责所有散列时隙从startend包括起始和结束值。

标志的含义(字段编号3):

  • myself:您正在联系的节点。

  • master:节点是主人。

  • slave:节点是从属的。

  • fail?:节点处于PFAIL状态。对于正在联系的节点无法访问,但仍然可以在逻辑上访问(不处于FAIL状态)。

  • fail:节点处于FAIL状态。对于将PFAIL状态提升为FAIL的多个节点而言,这是无法访问的。

  • handshake:不受信任的节点,我们握手。

  • noaddr:此节点没有已知的地址。

  • noflags:根本没有标志。

注意发布的配置时期

奴隶广播他们的主人的配置纪元(为了得到一个UPDATE消息,如果他们被发现是陈旧的),所以奴隶的真正配置时代(多少没有意义,因为他们不提供散列槽)只能是获得检查标记为的节点myself,这是我们要求生成 CLUSTER NODES 输出的节点的条目。其他从属时期反映了它们在心跳包中发布的内容,即它们当前正在复制的主时间的配置时期。

特殊插槽条目

通常,与给定节点相关联的散列槽是以下格式之一,如上所述:

1. Single number: 3894

2. Range: 3900-4000

但是,节点散列槽可以处于特殊状态,用于在节点重新启动后发送错误(AOF / RDB文件中的键与节点散列槽配置不匹配),或者存在重新分片操作时。这两个国家正在进口迁移

Redis 规范解释了这两种状态的含义,但是这两种状态的要点如下:

  • 导入插槽尚未成为节点散列槽的一部分,因此正在进行迁移。只有在使用ASK命令的情况下,节点才会接受有关这些插槽的查询。

  • 迁移插槽将分配给该节点,但正在迁移到某个其他节点。如果命令中的所有键已经存在,节点将接受查询,否则它将发出所谓的 ASK重定向,以直接在导入节点中强制创建新键。

导入和迁移插槽在 CLUSTER NODES 输出中发出,如下所示:

  • 导入插槽: [slot_number-<-importing_from_node_id]

  • 迁移插槽: [slot_number->-migrating_to_node_id]

以下是导入和迁移插槽的几个示例:

  • [93-<-292f8b365bb7edb5e285caf0b7e6ddc7265d2f4f]

  • [1002-<-67ed2db8d677e59ec4a4cefb06858cf2a1a89fa1]

  • [77->-e7d1eecce10fd6bb5eb35b9f99a514335d9ba9ca]

  • [16311->-292f8b365bb7edb5e285caf0b7e6ddc7265d2f4f]

请注意,该格式没有任何空格,因此 CLUSTER NODES 输出格式为纯 CSV 格式,即使在发布此特殊插槽时也会以空格作为分隔符。然而,一个完整的格式解析器应该能够处理它们。

注意:

1. 迁移和导入插槽仅添加到标记为的节点myself。该信息对于其自己的插槽是本地的节点。

2. 导入和迁移插槽作为附加信息提供。如果节点具有指定的给定散列槽,则它也将是散列槽列表中的普通数字,因此对散列槽迁移没有线索的客户端可以跳过这些特殊字段。

返回值

批量字符串回复:序列化群集配置。

Artikel sebelumnya: Artikel seterusnya: