ZooKeeper实践三：客户端脚本

ZooKeeper是通过客户端脚本来操作的。客户端脚本：zkCli.sh，存放在ZooKeeper的bin目录下。

默认连接本地的ZooKeeper服务器：

#zkCli.sh

连接指定的ZooKeeper服务器：

#zkCli.sh –server  Server IP:port

(注：Server IP代表服务器IP)

1) 启动客户端脚本
本次环境: ZooKeeper 单机模式，并启动服务器

# zkCli.sh 
Connecting to localhost:2181
…………………………..
2015-02-11 11:08:18,470 [myid:] - INFO  [main:ZooKeeper@438] - Initiating client connection, connectString=localhost:2181 sessionTimeout=30000 watcher=org.apache.zookeeper.ZooKeeperMain$MyWatcher@1c507aaf
Welcome to ZooKeeper!   注1
2015-02-11 11:08:18,517 [myid:] - INFO  [main-SendThread(localhost:2181):ClientCnxn$SendThread@966] - Opening socket connection to server localhost/127.0.0.1:2181. Will not attempt to authenticate using SASL (unknown error)  注2
2015-02-11 11:08:18,527 [myid:] - INFO  [main-SendThread(localhost:2181):ClientCnxn$SendThread@849] - Socket connection established to localhost/127.0.0.1:2181, initiating session
JLine support is enabled   注3
2015-02-11 11:08:18,550 [myid:] - INFO  [main-SendThread(localhost:2181):ClientCnxn$SendThread@1207] - Session establishment complete on server localhost/127.0.0.1:2181, sessionid = 0x14b769a51fe0001, negotiated timeout = 30000  注4

WATCHER::

WatchedEvent state:SyncConnected type:None path:null  注5
[zk: Server IP:2181(CONNECTED) 0]

注1：客户端启动初始化连接
注2：客户端尝试连接到ZooKeeper服务器
注3：连接成功，服务器创建一个session
注4：session创建成功
注5：服务器向客户端返回一个SyncConnected事件

其中注2中” Will not attempt to authenticate using SASL (unknown error)”，网上说是解析不对，但是在hosts文件中添加解析后依然如此，看ZooKeeper书籍中也是如此：

暂时无法知晓原因，以及是否会产生影响。

2) 可输入help查看命令帮助

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

---

常用命令演示
1) ls
使用ls命令，可以列出ZooKeeper指定节点下的所有的子节点，不过只能看到指定节点下第一级所有子节点。用法如下：

ls path [watch]

其中，path表示的是指定数据节点的节点路径
执行如下命令：

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

第一次部署的ZooKeeper，默认在根节点”/”下面有一个叫做[zookeeper]的保留节点

2) create
使用create命令，可以创建一个ZooKeeper节点。用法如下：

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

其中：-s或-e分别指定节点特性：顺序或临时节点。默认情况下，即不添加-s或-e参数的，创建的是持久节点。data代表节点的数据内容。acl是进行权限控制，缺省情况下，不做任何权限控制。
执行如下命令创建一个新节点：

[zk: localhost:2181(CONNECTED) 1] create /example "演示创建节点命令"
Created /example

3) get
使用get命令，可以获取ZooKeeper指定节点的数据内容和属性信息。用法如下：

get path [watch]

执行如下命令：

[zk: localhost:2181(CONNECTED) 2] get /example
"演示创建节点命令"
cZxid = 0x4
ctime = Wed Feb 11 15:33:19 CST 2015
mZxid = 0x4
mtime = Wed Feb 11 15:33:19 CST 2015
pZxid = 0x4
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 26
numChildren = 0

4) set
使用set命令，可以更新指定节点的数据内容。用法如下：

set path data [version]

其中，data就是要更新的数据新内容。version参数用于指定本次更新操作是基于ZNode的哪一个数据版本进行的。ZooKeeper中，节点的数据是有版本概念的。
执行如下命令：

[zk: localhost:2181(CONNECTED) 3] set /example "演示更新数据内容命令"
cZxid = 0x4
ctime = Wed Feb 11 15:33:19 CST 2015
mZxid = 0x7
mtime = Wed Feb 11 15:43:33 CST 2015
pZxid = 0x4
cversion = 0
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 32
numChildren = 0

使用get命令查看：

[zk: localhost:2181(CONNECTED) 4] get /example
"演示更新数据内容命令"
cZxid = 0x4
ctime = Wed Feb 11 15:33:19 CST 2015
mZxid = 0x7
mtime = Wed Feb 11 15:43:33 CST 2015
pZxid = 0x4
cversion = 0
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 32
numChildren = 0

使用set命令时带上版本参数：

[zk: localhost:2181(CONNECTED) 5] set /example "演示带版本参数更新" 1
cZxid = 0x4
ctime = Wed Feb 11 15:33:19 CST 2015
mZxid = 0xb
mtime = Wed Feb 11 15:46:33 CST 2015
pZxid = 0x4
cversion = 0
dataVersion = 2
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 29
numChildren = 0

使用get命令查看：

[zk: localhost:2181(CONNECTED) 6] get  /example
"演示带版本参数更新"
cZxid = 0x4
ctime = Wed Feb 11 15:33:19 CST 2015
mZxid = 0xb
mtime = Wed Feb 11 15:46:33 CST 2015
pZxid = 0x4
cversion = 0
dataVersion = 2
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 29
numChildren = 0

可以看到mtime, dataVersion, dataLength会随之变化。

5) delete
使用delete命令，可以删除ZooKeeper上的指定节点。用法如下：

delete path [version]

其中，version参数和set命令中version参数的作用是一致的。
执行如下命令：

[zk: localhost:2181(CONNECTED) 7] delete /example
[zk: localhost:2181(CONNECTED) 8] ls /
[zookeeper]
[zk: localhost:2181(CONNECTED) 9] 

需要注意：被删除的节点，该节点必须没有子节点存在，否则会出现出错信息：

Node not empty: /example

执行如下命令：

[zk: localhost:2181(CONNECTED) 6] create /example/test "演示非空删除"
Created /example/test
[zk: localhost:2181(CONNECTED) 7] ls /
[example, zookeeper]
[zk: localhost:2181(CONNECTED) 8] ls /example
[test]
[zk: localhost:2181(CONNECTED) 9]
[zk: localhost:2181(CONNECTED) 10] delete /example
Node not empty: /example
[zk: localhost:2181(CONNECTED) 11]