ZooKeeper系列(2)：ZooKeeper命令列工具zkCli.sh

駿馬金龍發表於2018-06-27
命令列

ZooKeeper系列文章：https://www.cnblogs.com/f-ck-need-u/p/7576137.html#zk

 

1.簡介

ZooKeeper提供了一個非常簡單的命令列客戶端zkCli，它在ZooKeeper安裝目錄的bin目錄下。

[root@s1 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

在互動式環境中，可以使用TAB鍵補全，或列出可用的命令、路徑。就像bash一樣。

ZooKeeper的命令很少很簡單，大致分為幾個型別：

  1. create：在樹中的某個位置建立一個節點。
  2. delete：刪除一個節點。
  3. exists：測試一個節點是否存在。
  4. get data：讀取節點資料。
  5. set data：向節點中寫入資料。
  6. get children：檢索某節點的子節點列表。
  7. sync：等待要傳播的資料。

注意，這只是命令的功能型別，並不意味著它們就是命令。

2.建立znode

create [-s] [-e] path data acl

-s：建立的是帶序列號的節點，序列號用0填充節點路徑。
-e：建立的是臨時節點。
path：znode的路徑，ZooKeeper中沒有相對路徑，所有路徑都必須以`/`開頭。
data：znode攜帶的資料。
acl：這個節點的ACL。

例如，建立一個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

建立一個帶序列號的znode：

[zk: localhost:2181(CONNECTED) 31] create -s /test1 222
Created /test10000000003

注意，建立了帶序列號的znode後，以後只能使用帶序列號的路徑/test10000000003來引用這個znode，而不能用/test1來引用。

建立一個臨時znode：

[zk: localhost:2181(CONNECTED) 32] create -e /test2 333
Created /test2

臨時znode在會話退出時會自動刪除，所以不能在臨時節點上建立子節點。另外，雖然臨時節點屬於某會話，但所有客戶端都可以檢視、引用它。

3.檢視節點的資料和狀態資訊

獲取節點資料、狀態資訊：

[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命令是ls和stat兩個命令的結合體，可以獲取給定節點下的子節點，以及給定節點的狀態資訊：

[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      # 子節點數量

4.檢視子節點

ls命令檢視某節點下的子節點。注意，不會遞迴檢索。

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

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

5.修改節點資料

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

6.刪除節點

delete可以刪除節點。注意，它不會遞迴刪除，所以要刪除一個包含子節點的節點，需要先刪除所有子節點。

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

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

rmr命令可以遞迴刪除節點，所以也會刪除節點中的所有子節點。

[zk: localhost:2181(CONNECTED) 36] create /test/hello 2323
Created /test/hello
[zk: localhost:2181(CONNECTED) 37] create /test/hello/hello1 23233
Created /test/hello/hello1
[zk: localhost:2181(CONNECTED) 38] rmr /test
[zk: localhost:2181(CONNECTED) 39] ls /
[test2, mynode, zookeeper, test10000000003, zk_test]

7.history和redo

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]

8.connect和close

connect命令用於連線其它ZooKeeper伺服器，close用於關閉當前連線。就像ssh到其它伺服器，然後exit一樣。

# 注意下面的ZooKeeper shell提示符中地址和連線狀態的變化：
[zk: localhost:2181(CONNECTED) 40] connect 192.168.100.21:2181
[zk: 192.168.100.21:2181(CONNECTED) 41] close
[zk: 192.168.100.21:2181(CLOSED) 43]

需要注意，當connect到其它伺服器後，當前的連線就會斷開，當前會話中的臨時znode就會被刪除。以下是connect到其它伺服器時zookeeper.out中相關內容：

2018-06-27 04:36:16,734 [myid:] - INFO  [ProcessThread(sid:0 cport:2181)::PrepRequestProcessor@487] - Processed session termination for sessionid: 0x10007ee8bb20003
2018-06-27 04:36:16,737 [myid:] - INFO  [NIOServerCxn.Factory:0.0.0.0/0.0.0.0:2181:NIOServerCnxn@1040] - Closed socket connection for client /0:0:0:0:0:0:0:1:34376 which had sessionid 0x10007ee8bb20003

所以，上面執行了close後，不會切換回之前的連線，需要手動再連線。

[zk: 192.168.100.21:2181(CONNECTED) 41] close
[zk: 192.168.100.21:2181(CLOSED) 43] ls /
Not connected

[zk: 192.168.100.21:2181(CLOSED) 44] connect localhost:2181

[zk: localhost:2181(CONNECTED) 45] ls /
[mynode, zookeeper, test10000000003, zk_test]

9.quit

quit命令退出ZooKeeper的互動式命令列。

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

相關文章