05. Zookeeper shell客户端-常用命令

矫情吗；* 2022-03-18 02:24 624阅读 0赞

> zookeeper bin目录下提供了一个客户端连接脚本 zkCli.sh, 用于连接zookeeper 服务器, 并执行一些基本的操作.

## 1. zk客户端命令概述 ##

使用 zkCli.sh 执行命令时, 可进入交互时模式执行命令, 也可以不进入交互式方式, 直接执行单条命令.

### 1.1 交互式执行命令 ###

*  默认情况下, zkCli.sh 连接的是本地2181 zk服务器, 可通过-server 参数指定zk服务器的ip 和端口号.
 *  命令提示符格式: 命令提示符由zk服务ip, 端口号, 连接状态, 当前会话执行命令计数器组成.

**默认连接本地2181端口zk服务**

$ ./zkCli.sh
    Connecting to localhost:2181
    日志信息...
    
    [zk: localhost:2181(CONNECTED) 0]

**指定zk服务器ip和端口号**

$ ./zkCli.sh -server 192.168.1.100:2181
    Connecting to 192.168.1.100:2181
    日志信息...
    
    [zk: 192.168.1.100:2181(CONNECTED) 0]

### 1.2 非交互式执行命令 ###

zkcli.sh 脚本可直接跟需要执行的命令, 无须使用引号包裹, 但只能执行单挑命令.

$ ./zkCli.sh -server 172.22.85.226:2181 ls2 /zookeeper
    # 省略启动日志...
    
    [quota]
    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

## 2. 连接命令 ##

### 2.1 断开连接: close ###

[zk: localhost:2181(CONNECTED) 0] close
    2019-02-17 13:40:03,730 [myid:] - INFO  [main:ZooKeeper@687] - Session: 0x100092d5d8b0005 closed
    [zk: localhost:2181(CLOSED) 1] 2019-02-17 13:40:03,736 [myid:] - INFO  [main-EventThread:ClientCnxn$EventThread@520] - EventThread shut down for session: 0x100092d5d8b0005

### 2.2 连接zk服务器:connect ###

[zk: localhost:2181(CLOSED) 1] connect localhost 2181
    2019-02-17 13:40:14,742 [myid:] - INFO  [main:ZooKeeper@441] - Initiating client connection, connectString=localhost sessionTimeout=30000 watcher=org.apache.zookeeper.ZooKeeperMain$MyWatcher@73a28541
    ....
    
    WatchedEvent state:SyncConnected type:None path:null

### 2.3 退出shell终端:quit ###

[zk: localhost(CONNECTED) 2] quit
    Quitting...
    2019-02-17 13:40:21,719 [myid:] - INFO  [main:ZooKeeper@687] - Session: 0x100092d5d8b0006 closed
    $

## 3. 节点操作命令 ##

### 3.1 创建节点: create ###

*  zk节点类型从两个角度划分共分为四种类型: 持久型节点, 持久型有序节点, 短暂型节点, 短暂型有序节点. 创建节点时除了指定节点类型之外, 还可以指定节点权限, 可参看笔者的另一篇关于ACL 权限的文章.
 *  create 命令不能递归创建节点, 且创建节点时, 必须设置节点值.

[zk: localhost:2181(CONNECTED) 4] create /mynodes ""
    Created /mynodes
    
    # 创建普通节点, 默认为持久型节点, 无时序性
    [zk: localhost:2181(CONNECTED) 5] create /mynodes/node "node"
    Created /mynodes/node
    
    # 创建短暂型节点, 连接端口后, 自动销毁
    [zk: localhost:2181(CONNECTED) 6] create -e /mynodes/e-node "e-node"
    Created /mynodes/e-node
    
    # 创建持久型时序节点
    [zk: localhost:2181(CONNECTED) 7] create -s /mynodes/s-node "s-node"
    Created /mynodes/s-node0000000002
    
    # 创建短暂性时序节点
    [zk: localhost:2181(CONNECTED) 9] create -e -s /mynodes/es-node "es-node"
    Created /mynodes/es-node0000000003
    
    [zk: localhost:2181(CONNECTED) 10] ls /mynodes
    [node, s-node0000000002, e-node, es-node0000000003]

### 3.2 删除空节点: delete ###

*  delete 只能删除叶子节点, 即无子节点的节点
 *  delete 删除的时候可以指定删除的版本号 , 以防止在并发时进行误操作. 版本号默认从0 开始.

# delete 删除非空节点报错
    [zk: localhost:2181(CONNECTED) 12] delete /mynodes
    Node not empty: /mynodes
    
    # 删除空节点
    [zk: localhost:2181(CONNECTED) 13] delete /mynodes/node
    
    # 删除指定版本的节点, 版本号不匹配时, 删除失败.
    [zk: localhost:2181(CONNECTED) 22] delete /mynodes/node 1
    version No is not valid : /mynodes/node
    
    [zk: localhost:2181(CONNECTED) 23] delete /mynodes/node 0

### 3.3 删除节点: rmr ###

rmr 可以删除空节点也可以删除非空节点, 但是不能指定版本号.

# 删除叶子节点
    [zk: localhost:2181(CONNECTED) 14] rmr /mynodes/s-node0000000002

### 3.4 修改节点数据: set ###

*  修改节点数据时, 节点中的信息dataVersion 和 dataLength 也会变更.
 *  修改节点数据时, 也可以指定节点版本号, 防止并发环境下的误操作.

# 创建节点
    [zk: localhost:2181(CONNECTED) 31] create /A "a"    
    Created /A
    
    # 修改节点数据
    [zk: localhost:2181(CONNECTED) 33] set /A "aaaa"

### 3.5 查看子节点列表: ls ###

*  ls 命令用于查看某节点拥有的子节点, 可添加watch 监控节点变化, 但是需要注意的时, shell 环境中只能监控一次变化. 当子节点

[zk: localhost:2181(CONNECTED) 44] ls /mynodes
    [node-1, node-2]
    
    # 监控节点变化, 笔者
    [zk: localhost:2181(CONNECTED) 45] ls /mynodes watch
    [node-1, node-2]
    [zk: localhost:2181(CONNECTED) 46] 
    WATCHER::
    
    WatchedEvent state:SyncConnected type:NodeChildrenChanged path:/mynodes

### 3.6 查看节点信息: stat ###

stat 命令获取节点的节点信息, 如版本号, 日期等, 但不包括节点数据. 也可以添加watch 监控

[zk: localhost:2181(CONNECTED) 6] stat /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

### 3.7 获取节点数据: get ###

get 命令除了获取节点存储的数据之外, 还会输出节点信息, 即stat 命令输出的信息

[zk: localhost:2181(CONNECTED) 11] get /mynodes
    my nodes
    cZxid = 0x19e
    ctime = Sun Feb 17 14:09:10 CST 2019
    mZxid = 0x1a6
    mtime = Sun Feb 17 14:45:58 CST 2019
    pZxid = 0x1a3
    cversion = 5
    dataVersion = 1
    aclVersion = 0
    ephemeralOwner = 0x0
    dataLength = 8
    numChildren = 3

### 3.8 查看子节点列表和节点信息: ls2 ###

ls2 命令相当于ls命令和stat 命令的组合, 会输出当前节点下的子节点列表和当前节点的节点信息.

[zk: localhost:2181(CONNECTED) 12] ls2 /mynodes
    [node-3, node-1, node-2]
    cZxid = 0x19e
    ctime = Sun Feb 17 14:09:10 CST 2019
    mZxid = 0x1a6
    mtime = Sun Feb 17 14:45:58 CST 2019
    pZxid = 0x1a3
    cversion = 5
    dataVersion = 1
    aclVersion = 0
    ephemeralOwner = 0x0
    dataLength = 8
    numChildren = 3

## 4. 历史命令 ##

zk shell客户端提供了记录会话操作历史功能, 可以查看当前会话执行的历史命令, 和快速执行历史命令.

### 4.1 查看历史命令: history ###

history 列出最近的10条历史命令.

[zk: localhost:2181(CONNECTED) 13] history
    3 - get /mynodes
    4 - ls /mynodes
    5 - ls2 /mynodes
    6 - stat /zookeeper
    7 - get /zookeeper
    8 - get /mynodes
    9 - get /mynodes/node-3
    10 - set /mynodes "my nodes"
    11 - get /mynodes
    12 - ls2 /mynodes
    13 - history

### 4.2 重复执行历史命令: redo ###

redo 的参数为历史命令的编号,每条命令执行的编号为命令执行时命令提示符的命令计数器当前值.

[zk: localhost:2181(CONNECTED) 33] redo 12
    [node-3, node-1, node-2]
    cZxid = 0x19e
    ctime = Sun Feb 17 14:09:10 CST 2019
    mZxid = 0x1a6
    mtime = Sun Feb 17 14:45:58 CST 2019
    pZxid = 0x1a3
    cversion = 5
    dataVersion = 1
    aclVersion = 0
    ephemeralOwner = 0x0
    dataLength = 8
    numChildren = 3