ZooKeeper命令行工具zkCli.sh

Posted 2020-11-20 f-ck-need-u

ZooKeeper提供了一个非常简单的命令行客户端zkCli，它在ZooKeeper安装目录的bin目录下。

[[email protected] zk]# ls /usr/local/zookeeper/bin/
zkCleanup.sh  zkCli.sh  zkEnv.sh  zkServer.sh

先连接一个已经启动的ZooKeeper实例。例如：

zkCli.sh -server localhost:2181

连接过程中会输出一大堆信息。当连接成功后，将进入ZooKeeper的交互式模式：

WatchedEvent state:SyncConnected type:None path:null

[zk: localhost:2181(CONNECTED) 0]   # 在这里输入ZooKeeper允许的命令

例如，输入help输出帮助信息。

[zk: localhost:2181(CONNECTED) 0] help
ZooKeeper -server host:port cmd args
        stat path [watch]
        set path data [version]
        ls path [watch]
        delquota [-n|-b] path
        ls2 path [watch]
        setAcl path acl
        setquota -n|-b val path
        history 
        redo cmdno
        printwatches on|off
        delete path [version]
        sync path
        listquota path
        rmr path
        get path [watch]
        create [-s] [-e] path data acl
        addauth scheme auth
        quit 
        getAcl path
        close 
        connect host:port
[zk: localhost:2181(CONNECTED) 1] 

其中交互式命令提示符中有一个不断递增的数字，例如上面执行依次操作后，从0变成1。这个数字代表的是命令的历史编号。

也可以使用zkCli.sh的非交互式模式来执行一次性操作，格式为：

zkCli.sh -server IP:PORT COMMAND

例如help命令：

zkCli.sh -server localhost:2181 help

ZooKeeper的命令很少很简单，大致分为几个类型：

1. create：在树中的某个位置创建一个节点。
   
2. delete：删除一个节点。
   
3. exists：测试一个节点是否存在。
   
4. get data：读取节点数据。
   
5. set data：向节点中写入数据。
   
6. get children：检索某节点的子节点列表。
   
7. sync：等待要传播的数据。

注意，这只是命令的功能类型，并不意味着它们就是命令。

例如，创建一个znode节点：

[zk: localhost:2181(CONNECTED) 1] create /zk_test mydata1
Created /zk_test

其中/zk_test是节点名称，mydata1是该节点携带的数据。

创建一个子节点：

[zk: localhost:2181(CONNECTED) 2] create /zk_test/child_node1 "mydata2"
Created /zk_test/child_node1

查看某节点下的子节点。注意，不会递归检索。

[zk: localhost:2181(CONNECTED) 3] ls /
[zookeeper, zk_test]

[zk: localhost:2181(CONNECTED) 4] ls /zk_test
[child_node1]

获取节点数据、状态信息：

[zk: localhost:2181(CONNECTED) 6] get /zk_test
mydata1
cZxid = 0x4
ctime = Wed Jun 27 02:05:44 CST 2018
mZxid = 0x4
mtime = Wed Jun 27 02:05:44 CST 2018
pZxid = 0x5
cversion = 1
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 7
numChildren = 1

[zk: localhost:2181(CONNECTED) 7] get /zk_test/child_node1
mydata2
cZxid = 0x5
ctime = Wed Jun 27 02:29:12 CST 2018
mZxid = 0x5
mtime = Wed Jun 27 02:29:12 CST 2018
pZxid = 0x5
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 7
numChildren = 0

如果只是要获取节点的状态信息，可以使用stat命令：

[zk: localhost:2181(CONNECTED) 8] stat /zk_test
cZxid = 0x4
ctime = Wed Jun 27 02:05:44 CST 2018
mZxid = 0x4
mtime = Wed Jun 27 02:05:44 CST 2018
pZxid = 0x5
cversion = 1
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 7
numChildren = 1

ls2命令可以获取给定节点下的子节点，以及给定节点的状态信息：

[zk: localhost:2181(CONNECTED) 12] ls2 /
[zookeeper, zk_test]    # 子节点列表
cZxid = 0x0
ctime = Thu Jan 01 08:00:00 CST 1970
mZxid = 0x0
mtime = Thu Jan 01 08:00:00 CST 1970
pZxid = 0x4
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 0
numChildren = 2      # 子节点数量

set命令用于修改节点：

[zk: localhost:2181(CONNECTED) 13] set /zk_test "mydata2"
cZxid = 0x4
ctime = Wed Jun 27 02:05:44 CST 2018
mZxid = 0x9
mtime = Wed Jun 27 02:42:45 CST 2018
pZxid = 0x7
cversion = 2
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 7
numChildren = 0

delete可以删除节点。注意，它不会递归删除，所以要删除一个包含子节点的节点，需要先删除所有子节点。

[zk: localhost:2181(CONNECTED) 21] delete /zk_test
Node not empty: /zk_test

[zk: localhost:2181(CONNECTED) 22] delete /zk_test/child_node1

history命令可以列出最近操作的10条命令历史，并给出每个历史命令的编号。redo命令可以根据历史命令的编号重新调用这些命令。

[zk: localhost:2181(CONNECTED) 18] history
8 - stat /zk_test
9 - get /
10 - get child /
11 - get children /
12 - ls2 /
13 - ls /
14 - ls2 /zk_test
15 - get /
16 - help
17 - ls /zk
18 - history

重新执行编号为13的历史命令：

[zk: localhost:2181(CONNECTED) 27] redo 13
[zookeeper, zk_test]

quit命令退出ZooKeeper的交互式命令行。

[zk: localhost:2181(CONNECTED) 29] quit
Quitting...