role - [ Redis中文开发手册 ] - 在线原生手册

简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)

目录搜索

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

文字

ROLE

自2.8.12起可用。

提供有关 Redis 实例在复制上下文中的角色的信息，如果实例当前是，或master，则返回。该命令还返回有关复制状态（如果角色是主控或从属角色）或监控主控名称列表（如果角色是标志）的其他信息。slavesentinel

输出格式

该命令返回一组元素。第一个元素是实例的角色，作为以下三个字符串之一：

"master"

"slave"

"sentinel"

数组的其他元素取决于角色。

主输出

在主实例中调用 ROLE 时的输出示例：

1) "master"
2) (integer) 3129659
3) 1) 1) "127.0.0.1"      
      2) "9001"      
      3) "3129242"   
   2) 1) "127.0.0.1"      
      2) "9002"      
      3) "3129543"

主输出由以下部分组成：

1. 字符串master。

2. 当前的主复制偏移量是主控和从属共享的偏移量，在部分重新同步中，副控制器需要提取的部分才能继续。

3. 由三个元素组成的数组表示连接的从站。每个子阵列都包含从站IP，端口和最后一个确认的复制偏移量。

从机输出

在从属实例中调用 ROLE 时的输出示例：

1) "slave"2) "127.0.0.1"3) (integer) 90004) "connected"5) (integer) 3167038

从站输出由以下部分组成：

1. 字符串slave。

2. 主设备的IP。

3. 主设备的端口号。

4. 从主设备的角度来看，复制的状态可以是connect（实例需要连接到它的主设备），connecting（从设备 - 主设备连接正在进行），sync（主设备和从设备正在尝试执行同步），connected（奴隶在线）。

5. 根据主复制偏移量，从从站接收的数据量。

哨兵输出

Sentinel 输出示例：

1) "sentinel"
2) 1) "resque-master"   
   2) "html-fragments-master"   
   3) "stats-master"   
   4) "metadata-master"

哨兵输出由以下部分组成：

1. 字符串sentinel。

2. 由此 Sentinel 实例监控的主名称数组。

返回值

阵列答复：其中所述第一元件是一个master，slave，sentinel和所述附加元件是如上示出的特定角色。

History

该命令是在 Redis 稳定版本中引入的，特别是在 Redis 2.8.12中。

例子

redis> ROLE 1) "master" 2) (integer) 0 3) (empty list or set)