Zookeeper常用Shell命令
一、节点增删改查
1.1 启动服务和连接服务
1 | 启动服务 |
1.2 help命令
使用 help 可以查看所有命令及格式。
1.3 查看节点列表
查看节点列表有 ls path 和 ls2 path 两个命令，后者是前者的增强，不仅可以查看指定路径下的所有节点，还可以查看当前节点的信息。
1 | [zk: localhost:2181(CONNECTED) 0] ls / |
1.4 新增节点
1 | create [-s] [-e] path data acl #其中-s 为有序节点，-e 临时节点 |
创建节点并写入数据：
1 | create /hadoop 123456 |
创建有序节点，此时创建的节点名为指定节点名 + 自增序号：
1 | [zk: localhost:2181(CONNECTED) 23] create -s /a "aaa" |
创建临时节点，临时节点会在会话过期后被删除：
1 | [zk: localhost:2181(CONNECTED) 26] create -e /tmp "tmp" |
1.5 查看节点
1. 获取节点数据
1 | 格式 |
1 | [zk: localhost:2181(CONNECTED) 31] get /hadoop |
节点各个属性如下表。其中一个重要的概念是 Zxid(ZooKeeper Transaction Id)，ZooKeeper 节点的每一次更改都具有唯一的 Zxid，如果 Zxid1 小于 Zxid2，则 Zxid1 的更改发生在 Zxid2 更改之前。
| 状态属性 | 说明 |
|---|---|
| cZxid | 数据节点创建时的事务 ID |
| ctime | 数据节点创建时的时间 |
| mZxid | 数据节点最后一次更新时的事务 ID |
| mtime | 数据节点最后一次更新时的时间 |
| pZxid | 数据节点的子节点最后一次被修改时的事务 ID |
| cversion | 子节点的更改次数 |
| dataVersion | 节点数据的更改次数 |
| aclVersion | 节点的 ACL 的更改次数 |
| ephemeralOwner | 如果节点是临时节点，则表示创建该节点的会话的 SessionID；如果节点是持久节点，则该属性值为 0 |
| dataLength | 数据内容的长度 |
| numChildren | 数据节点当前的子节点个数 |
2. 查看节点状态
可以使用 stat 命令查看节点状态，它的返回值和 get 命令类似，但不会返回节点数据。
1 | [zk: localhost:2181(CONNECTED) 32] stat /hadoop |
1.6 更新节点
更新节点的命令是 set，可以直接进行修改，如下：
1 | [zk: localhost:2181(CONNECTED) 33] set /hadoop 345 |
也可以基于版本号进行更改，此时类似于乐观锁机制，当你传入的数据版本号 (dataVersion) 和当前节点的数据版本号不符合时，zookeeper 会拒绝本次修改：
1 | [zk: localhost:2181(CONNECTED) 34] set /hadoop 678 0 |
1.7 删除节点
删除节点的语法如下：
1 | delete path [version] |
和更新节点数据一样，也可以传入版本号，当你传入的数据版本号 (dataVersion) 和当前节点的数据版本号不符合时，zookeeper 不会执行删除操作。
1 | [zk: localhost:2181(CONNECTED) 36] delete /hadoop 0 |
要想删除某个节点及其所有后代节点，可以使用递归删除，命令为 rmr path。
二、监听器
2.1 get path [watch]
使用 get path [watch] 注册的监听器能够在节点内容发生改变的时候，向客户端发出通知。需要注意的是 zookeeper 的触发器是一次性的 (One-time trigger)，即触发一次后就会立即失效。
1 | [zk: localhost:2181(CONNECTED) 4] get /hadoop watch |
2.2 stat path [watch]
使用 stat path [watch] 注册的监听器能够在节点状态发生改变的时候，向客户端发出通知。
1 | [zk: localhost:2181(CONNECTED) 7] stat /hadoop watch |
2.3 ls\ls2 path [watch]
使用 ls path [watch] 或 ls2 path [watch] 注册的监听器能够监听该节点下所有子节点的增加和删除操作。
1 | [zk: localhost:2181(CONNECTED) 9] ls /hadoop watch |
三、 zookeeper 四字命令
| 命令 | 功能描述 |
|---|---|
| conf | 打印服务配置的详细信息。 |
| cons | 列出连接到此服务器的所有客户端的完整连接/会话详细信息。包括接收/发送的数据包数量，会话 ID，操作延迟，上次执行的操作等信息。 |
| dump | 列出未完成的会话和临时节点。这只适用于 Leader 节点。 |
| envi | 打印服务环境的详细信息。 |
| ruok | 测试服务是否处于正确状态。如果正确则返回“imok”，否则不做任何相应。 |
| stat | 列出服务器和连接客户端的简要详细信息。 |
| wchs | 列出所有 watch 的简单信息。 |
| wchc | 按会话列出服务器 watch 的详细信息。 |
| wchp | 按路径列出服务器 watch 的详细信息。 |
更多四字命令可以参阅官方文档：https://zookeeper.apache.org/doc/current/zookeeperAdmin.html
使用前需要使用 yum install nc 安装 nc 命令，使用示例如下：
1 | [root@hadoop001 bin]# echo stat | nc localhost 2181 |
