第4章 客户端命令行操作

4.1 命令行语法(重要)

命令基本语法	功能描述
help	显示所有操作命
ls path	使用 ls 命令来查看当前 znode 的子节点 [可监听] -w 监听子节点变化 -s 附加次级信息
create	普通创建 -s 含有序列 -e 临时（重启或者超时消失）
get path	获得节点的值 [可监听] -w 监听节点内容变化 -s 附加次级信息
set	设置节点的具体值
stat	查看节点状态
delete	删除节点
deleteall	递归删除节点

• (1) 启动本机客户端

[xqzhao@hadoop100 zookeeper-3.5.7]$ bin/zkCli.sh

• (2) 启动集群客户端

[xqzhao@hadoop100 zookeeper-3.5.7]$ bin/zkCli.sh -server hadoop100:2181

• (3) 显示所有操作命令

[zk: hadoop100:2181(CONNECTED) 1] help

• (4) 退出客户端：

[zk: hadoop100:2181(CONNECTED) 0] quit

---

4.2 znode结点数据信息(了解)

4.2.1 查看当前znode中所包含的内容

[zk: hadoop100:2181(CONNECTED) 0] ls /
[zookeeper]

4.2.2 查看当前节点详细数据

[zk: hadoop100:2181(CONNECTED) 5] ls -s /
[zookeeper]cZxid = 0x0
ctime = Thu Jan 01 08:00:00 CST 1970
mZxid = 0x0
mtime = Thu Jan 01 08:00:00 CST 1970
pZxid = 0x0
cversion = -1
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 0
numChildren = 1

• (1) czxid：创建节点的事务 zxid
  每次修改 ZooKeeper 状态都会产生一个 ZooKeeper 事务 ID。事务 ID 是 ZooKeeper 中所有修改总的次序。每次修改都有唯一的 zxid，如果 zxid1 小于 zxid2，那么 zxid1 在 zxid2 之前发生。
• (2) ctime：znode 被创建的毫秒数（从 1970 年开始）
• (3) mzxid：znode 最后更新的事务 zxid
• (4) mtime：znode 最后修改的毫秒数（从 1970 年开始）
• (5) pZxid：znode 最后更新的子节点 zxid
• (6) cversion：znode 子节点变化号，znode 子节点修改次数
• (7) dataversion：znode 数据变化号
• (8) aclVersion：znode 访问控制列表的变化号
• (9) ephemeralOwner：如果是临时节点，这个是 znode 拥有者的 session id。如果不是临时节点则是 0。
• (10) dataLength：znode 的数据长度
• (11) numChildren：znode 子节点数量

---

4.3 创建节点

4.3.1 节点类型（持久/短暂/有序号/无序号）

4.3.2 分别创建2个普通节点（永久节点 + 不带序号）

[zk: hadoop100:2181(CONNECTED) 1] create /sanguo "diaochan"
Created /sanguo

[zk: hadoop100:2181(CONNECTED) 2] ls /
[sanguo, zookeeper]

[zk: hadoop100:2181(CONNECTED) 3] create /sanguo/shuguo "liubei"
Created /sanguo/shuguo
# 注意：创建节点时，要赋值

4.3.3 获得节点的值

[zk: hadoop100:2181(CONNECTED) 4] get -s /sanguo
diaochan
cZxid = 0x300000008
ctime = Mon Jul 19 09:07:11 PDT 2021
mZxid = 0x300000008
mtime = Mon Jul 19 09:07:11 PDT 2021
pZxid = 0x300000009
cversion = 1
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 8
numChildren = 1

4.3.3 创建带序号的节点（永久节点 + 带序号）

• (1) 先创建一个普通的根节点/sanguo/weiguo

[zk: hadoop100:2181(CONNECTED) 5] create /sanguo/weiguo "caocao"
Created /sanguo/weiguo

• (2) 创建带序号的节点

[zk: hadoop100:2181(CONNECTED) 6] create -s /sanguo/weiguo/zhangliao "zhangliao"
Created /sanguo/weiguo/zhangliao0000000000
[zk: hadoop100:2181(CONNECTED) 7] ls /sanguo/weiguo
[zhangliao0000000000]

[zk: hadoop100:2181(CONNECTED) 8] create -s /sanguo/weiguo/zhangliao "zhangliao"
Created /sanguo/weiguo/zhangliao0000000001

[zk: hadoop100:2181(CONNECTED) 9] create -s /sanguo/weiguo/xuchu "xuchu"
Created /sanguo/weiguo/xuchu0000000002

如果原来没有序号节点，序号从 0 开始依次递增。如果原节点下已有 2 个节点，则再排序时从 2 开始，以此类推。

4.3.4 创建短暂节点（短暂节点 + 不带序号 or 带序号）

• (1) 创建短暂的不带序号的节点

[zk: hadoop100:2181(CONNECTED) 10] create -e /sanguo/wuguo "zhouyu"
Created /sanguo/wuguo

• (2) 创建短暂的带序号的节点

[zk: hadoop100:2181(CONNECTED) 11] create -e -s /sanguo/wuguo "zhouyu"
Created /sanguo/wuguo0000000003

• (3) 在当前客户端是能查看到的

[zk: hadoop100:2181(CONNECTED) 12] ls /sanguo
[shuguo, weiguo, wuguo, wuguo0000000003]

• (4) 重启客户端之后就不存在了

# 重启客户端之后
[zk: localhost:2181(CONNECTED) 0] ls /sanguo
[shuguo, weiguo]

---

4.4 节点增删改查

• (1) 增加节点
  增加节点请看本博客第4.3小节的详细描述。

• (2) 删除节点

[zk: localhost:2181(CONNECTED) 4] delete /sanguo/jin

• (3) 递归删除节点

[zk: localhost:2181(CONNECTED) 15] deleteall /sanguo/shuguo

• (4) 修改节点数据值

[zk: localhost:2181(CONNECTED) 1] set /sanguo/weiguo "simayi"

• (5) 查看节点状态

[zk: localhost:2181(CONNECTED) 17] stat /sanguo
cZxid = 0x100000003
ctime = Wed Aug 29 00:03:23 CST 2018
mZxid = 0x100000011
mtime = Wed Aug 29 00:21:23 CST 2018
pZxid = 0x100000014
cversion = 9
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 4
numChildren = 1

---

4.5 监听器原理

• 客户端注册监听它关心的目录节点，当目录节点发生变化（数据改变、节点删除、子目录节点增加删除）时，ZooKeeper 会通知客户端。
  

4.5.1 节点的值变化监听

• (1) 在 hadoop102 主机上注册监听 /sanguo 节点数据变化

[zk: localhost:2181(CONNECTED) 4] get -w /sanguo
diaochan

• (2) 在 hadoop101 主机上修改 /sanguo 节点的数据

[zk: localhost:2181(CONNECTED) 2] set /sanguo "xishi"

• (3) 观察 hadoop102 主机收到数据变化的监听

[zk: localhost:2181(CONNECTED) 5] 
WATCHER::

WatchedEvent state:SyncConnected type:NodeDataChanged path:/sanguo

注意：在hadoop101再多次修改/sanguo的值，hadoop102上不会再收到监听。因为注册一次，只能监听一次。想再次监听，需要再次注册。

4.5.2 节点的子节点变化监听（路径变化）

• (1) 在 hadoop102 主机上注册监听 /sanguo 节点的子节点变化

[zk: localhost:2181(CONNECTED) 2] ls -w /sanguo
[shuguo, weiguo]

• (2) 在 hadoop101 主机/sanguo 节点上创建子节点

[zk: localhost:2181(CONNECTED) 3] create /sanguo/jin "simayi"
Created /sanguo/jin

• (3) 观察 hadoop102 主机收到子节点变化的监听

[zk: localhost:2181(CONNECTED) 3] 
WATCHER::

WatchedEvent state:SyncConnected type:NodeChildrenChanged path:/sanguo

注意：节点的路径变化，也是注册一次，生效一次。想多次生效，就需要多次注册。

---

声明：本文是学习时记录的笔记，如有侵权请告知删除！
原视频地址:https://www.bilibili.com/video/BV1to4y1C7gw