Redis ROLE命令

Redis ROLE命令用于查看当前Redis服务器的角色（role），根据返回值不同可以判断当前服务器是主节点、从节点还是哨兵节点。它是一个server级别的命令，可以在Redis服务器的控制台或者客户端中执行。

使用方法

在Redis服务器的控制台或者客户端中执行命令：ROLE

ROLE命令的返回值包含一个字符串和多个整数，其中字符串表示当前服务器的角色，整数表示不同角色对应的信息。具体的返回值如下：

• 如果当前服务器是主节点，则返回3个整数表示当前有多少个从节点、当前有多少个从节点正在执行SYNC同步命令以及执行SYNC同步命令的从节点ID；
• 如果当前服务器是从节点，则返回2个整数表示当前从主节点接收到的最后一条REPL复制消息的LSEQ值和当前从节点在复制缓冲区中的偏移量；
• 如果当前服务器是哨兵节点，则返回一个字符串表示哨兵节点当前监视哪个主节点以及多个整数表示该主节点的信息。

实例说明：

下面的例子演示了在Redis服务器控制台（命令行界面）中执行ROLE命令的结果：

127.0.0.1:6379> ROLE
"master"
1) (integer) 1
2) 1) "127.0.0.1"
   2) (integer) 6379
   3) "1"

解释：

当前服务器的角色是主节点（master），当前有1个从节点正在执行SYNC同步命令，从节点的IP地址为'127.0.0.1'，端口为'6379'，从节点执行SYNC同步命令的runID为'1'。

再看一个例子，演示如何在Python语言中使用redis-py库调用ROLE命令：

import redis

# 连接Redis服务器
client = redis.Redis(host='localhost', port=6379, db=0)

# 查看Redis服务器的角色（role）
role, *info = client.execute_command('ROLE')
print(role)
print(info)

解释：

以上Python代码首先连接Redis服务器，然后执行ROLE命令，将返回值分别赋值给变量role和info。执行结果如下：

b'master'
[b'1', [b'127.0.0.1', 6379, b'1']]

解释：

当前服务器的角色是主节点（master），当前有1个从节点正在执行SYNC同步命令，从节点的IP地址为'127.0.0.1'，端口为'6379'，从节点执行SYNC同步命令的runID为'1'。

另外一个例子是在redis-cli命令行客户端中查看从节点的信息：

127.0.0.1:6379> ROLE
"slave"
1) (integer) 425
2) (integer) 425

解释：

当前服务器的角色是从节点（slave），最后一条接收到的复制消息的LSEQ值和当前从节点在复制缓冲区中的偏移量相同，都为425。