Source: https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-peers/
Documentation version: v5.3.2

# SHOW PEERS

`SHOW PEERS`命令用于显示当前服务组中 Storage 服务上所有分片的副本信息。

下表展示返回的信息：

 | 列 | 描述
 | `partition_id` | 副本所属分片的 ID。
 | `host_address` | 存储该副本的 Storage 服务的主机地址。
 | `state` | 该副本的 Raft 状态，包括`LEADER`（Leader 副本）和`FOLLOWER`（Follower 副本）。
 当指定`LEADER`时（即`SHOW PEERS LEADER`），仅返回`LEADER`状态信息；否则，返回`LEADER`和`FOLLOWER`状态。
 | `term` | 副本的 Raft 任期。
 | `version` | 副本的成员变更版本。
 | `report_time` | 副本最后一次向 Meta 服务报告其 Raft 状态的时间。
 | `snapshot_status` | 当 Meta 服务收到快照请求时，快照处理的状态。
 | `stable_peers` | 当前 Raft 组中的稳定副本。
 | `unstable_peers` | 当前 Raft 组中的不稳定副本。

## 语法

语法图源码

 show_peers_command  

````
show_peers_command ::=
    'SHOW' 'PEERS' 'LEADER'?

````

## 参数

### `LEADER`

关键字`LEADER`是可选的。当指定时，仅返回状态为`LEADER`的副本信息。否则，返回状态为`LEADER`和`FOLLOWER`的副本信息。

## 示例

开发版的每个分片仅有 1 份副本。服务正常运行时，该副本的状态为`LEADER`，不会出现多副本部署中的`FOLLOWER`行。部署范围见[功能与限制](https://dev-docs.yueshu.com.cn/v5.3.2/intro/limitations/)。

### 显示所有副本信息

````
SHOW PEERS

````

### 仅显示 Leader 副本

````
SHOW PEERS LEADER

````

返回的主机地址、任期和报告时间以当前实例为准。