新增离线版文档
This commit is contained in:
罗祥
265
offline-notes/Zookeeper常用Shell命令.md
Normal file
265
offline-notes/Zookeeper常用Shell命令.md
Normal file
@@ -0,0 +1,265 @@
|
||||
# Zookeeper常用Shell命令
|
||||
|
||||
<nav>
|
||||
<a href="#一节点增删改查">一、节点增删改查</a><br/>
|
||||
<a href="#11-启动服务和连接服务">1.1 启动服务和连接服务</a><br/>
|
||||
<a href="#12-help命令">1.2 help命令</a><br/>
|
||||
<a href="#13-查看节点列表">1.3 查看节点列表</a><br/>
|
||||
<a href="#14-新增节点">1.4 新增节点</a><br/>
|
||||
<a href="#15-查看节点">1.5 查看节点</a><br/>
|
||||
<a href="#16-更新节点">1.6 更新节点</a><br/>
|
||||
<a href="#17-删除节点">1.7 删除节点</a><br/>
|
||||
<a href="#二监听器">二、监听器</a><br/>
|
||||
<a href="#21-get-path-[watch]">2.1 get path [watch]</a><br/>
|
||||
<a href="#22-stat-path-[watch]">2.2 stat path [watch]</a><br/>
|
||||
<a href="#23-lsls2-path--[watch]">2.3 ls\ls2 path [watch]</a><br/>
|
||||
<a href="#三-zookeeper-四字命令">三、 zookeeper 四字命令</a><br/>
|
||||
</nav>
|
||||
|
||||
|
||||
## 一、节点增删改查
|
||||
|
||||
### 1.1 启动服务和连接服务
|
||||
|
||||
```shell
|
||||
# 启动服务
|
||||
bin/zkServer.sh start
|
||||
|
||||
#连接服务 不指定服务地址则默认连接到localhost:2181
|
||||
zkCli.sh -server hadoop001:2181
|
||||
```
|
||||
|
||||
### 1.2 help命令
|
||||
|
||||
使用 `help` 可以查看所有命令及格式。
|
||||
|
||||
### 1.3 查看节点列表
|
||||
|
||||
查看节点列表有 `ls path` 和 `ls2 path` 两个命令，后者是前者的增强，不仅可以查看指定路径下的所有节点，还可以查看当前节点的信息。
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 0] ls /
|
||||
[cluster, controller_epoch, brokers, storm, zookeeper, admin, ...]
|
||||
[zk: localhost:2181(CONNECTED) 1] ls2 /
|
||||
[cluster, controller_epoch, brokers, storm, zookeeper, admin, ....]
|
||||
cZxid = 0x0
|
||||
ctime = Thu Jan 01 08:00:00 CST 1970
|
||||
mZxid = 0x0
|
||||
mtime = Thu Jan 01 08:00:00 CST 1970
|
||||
pZxid = 0x130
|
||||
cversion = 19
|
||||
dataVersion = 0
|
||||
aclVersion = 0
|
||||
ephemeralOwner = 0x0
|
||||
dataLength = 0
|
||||
numChildren = 11
|
||||
```
|
||||
|
||||
### 1.4 新增节点
|
||||
|
||||
```shell
|
||||
create [-s] [-e] path data acl #其中-s 为有序节点，-e 临时节点
|
||||
```
|
||||
|
||||
创建节点并写入数据：
|
||||
|
||||
```shell
|
||||
create /hadoop 123456
|
||||
```
|
||||
|
||||
创建有序节点，此时创建的节点名为指定节点名 + 自增序号：
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 23] create -s /a "aaa"
|
||||
Created /a0000000022
|
||||
[zk: localhost:2181(CONNECTED) 24] create -s /b "bbb"
|
||||
Created /b0000000023
|
||||
[zk: localhost:2181(CONNECTED) 25] create -s /c "ccc"
|
||||
Created /c0000000024
|
||||
```
|
||||
|
||||
创建临时节点，临时节点会在会话过期后被删除：
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 26] create -e /tmp "tmp"
|
||||
Created /tmp
|
||||
```
|
||||
|
||||
### 1.5 查看节点
|
||||
|
||||
#### 1. 获取节点数据
|
||||
|
||||
```shell
|
||||
# 格式
|
||||
get path [watch]
|
||||
```
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 31] get /hadoop
|
||||
123456 #节点数据
|
||||
cZxid = 0x14b
|
||||
ctime = Fri May 24 17:03:06 CST 2019
|
||||
mZxid = 0x14b
|
||||
mtime = Fri May 24 17:03:06 CST 2019
|
||||
pZxid = 0x14b
|
||||
cversion = 0
|
||||
dataVersion = 0
|
||||
aclVersion = 0
|
||||
ephemeralOwner = 0x0
|
||||
dataLength = 6
|
||||
numChildren = 0
|
||||
```
|
||||
|
||||
节点各个属性如下表。其中一个重要的概念是 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` 命令类似，但不会返回节点数据。
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 32] stat /hadoop
|
||||
cZxid = 0x14b
|
||||
ctime = Fri May 24 17:03:06 CST 2019
|
||||
mZxid = 0x14b
|
||||
mtime = Fri May 24 17:03:06 CST 2019
|
||||
pZxid = 0x14b
|
||||
cversion = 0
|
||||
dataVersion = 0
|
||||
aclVersion = 0
|
||||
ephemeralOwner = 0x0
|
||||
dataLength = 6
|
||||
numChildren = 0
|
||||
```
|
||||
|
||||
### 1.6 更新节点
|
||||
|
||||
更新节点的命令是 `set`，可以直接进行修改，如下：
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 33] set /hadoop 345
|
||||
cZxid = 0x14b
|
||||
ctime = Fri May 24 17:03:06 CST 2019
|
||||
mZxid = 0x14c
|
||||
mtime = Fri May 24 17:13:05 CST 2019
|
||||
pZxid = 0x14b
|
||||
cversion = 0
|
||||
dataVersion = 1 # 注意更改后此时版本号为 1，默认创建时为 0
|
||||
aclVersion = 0
|
||||
ephemeralOwner = 0x0
|
||||
dataLength = 3
|
||||
numChildren = 0
|
||||
```
|
||||
|
||||
也可以基于版本号进行更改，此时类似于乐观锁机制，当你传入的数据版本号 (dataVersion) 和当前节点的数据版本号不符合时，zookeeper 会拒绝本次修改：
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 34] set /hadoop 678 0
|
||||
version No is not valid : /hadoop #无效的版本号
|
||||
```
|
||||
|
||||
### 1.7 删除节点
|
||||
|
||||
删除节点的语法如下：
|
||||
|
||||
```shell
|
||||
delete path [version]
|
||||
```
|
||||
|
||||
和更新节点数据一样，也可以传入版本号，当你传入的数据版本号 (dataVersion) 和当前节点的数据版本号不符合时，zookeeper 不会执行删除操作。
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 36] delete /hadoop 0
|
||||
version No is not valid : /hadoop #无效的版本号
|
||||
[zk: localhost:2181(CONNECTED) 37] delete /hadoop 1
|
||||
[zk: localhost:2181(CONNECTED) 38]
|
||||
```
|
||||
|
||||
要想删除某个节点及其所有后代节点，可以使用递归删除，命令为 `rmr path`。
|
||||
|
||||
## 二、监听器
|
||||
|
||||
### 2.1 get path [watch]
|
||||
|
||||
使用 `get path [watch]` 注册的监听器能够在节点内容发生改变的时候，向客户端发出通知。需要注意的是 zookeeper 的触发器是一次性的 (One-time trigger)，即触发一次后就会立即失效。
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 4] get /hadoop watch
|
||||
[zk: localhost:2181(CONNECTED) 5] set /hadoop 45678
|
||||
WATCHER::
|
||||
WatchedEvent state:SyncConnected type:NodeDataChanged path:/hadoop #节点值改变
|
||||
```
|
||||
|
||||
### 2.2 stat path [watch]
|
||||
|
||||
使用 `stat path [watch]` 注册的监听器能够在节点状态发生改变的时候，向客户端发出通知。
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 7] stat /hadoop watch
|
||||
[zk: localhost:2181(CONNECTED) 8] set /hadoop 112233
|
||||
WATCHER::
|
||||
WatchedEvent state:SyncConnected type:NodeDataChanged path:/hadoop #节点值改变
|
||||
```
|
||||
|
||||
### 2.3 ls\ls2 path [watch]
|
||||
|
||||
使用 `ls path [watch]` 或 `ls2 path [watch]` 注册的监听器能够监听该节点下所有**子节点**的增加和删除操作。
|
||||
|
||||
```shell
|
||||
[zk: localhost:2181(CONNECTED) 9] ls /hadoop watch
|
||||
[]
|
||||
[zk: localhost:2181(CONNECTED) 10] create /hadoop/yarn "aaa"
|
||||
WATCHER::
|
||||
WatchedEvent state:SyncConnected type:NodeChildrenChanged path:/hadoop
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 三、 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 命令，使用示例如下：
|
||||
|
||||
```shell
|
||||
[root@hadoop001 bin]# echo stat | nc localhost 2181
|
||||
Zookeeper version: 3.4.13-2d71af4dbe22557fda74f9a9b4309b15a7487f03,
|
||||
built on 06/29/2018 04:05 GMT
|
||||
Clients:
|
||||
/0:0:0:0:0:0:0:1:50584[1](queued=0,recved=371,sent=371)
|
||||
/0:0:0:0:0:0:0:1:50656[0](queued=0,recved=1,sent=0)
|
||||
Latency min/avg/max: 0/0/19
|
||||
Received: 372
|
||||
Sent: 371
|
||||
Connections: 2
|
||||
Outstanding: 0
|
||||
Zxid: 0x150
|
||||
Mode: standalone
|
||||
Node count: 167
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user