ZooKeeper的命令行工具类似于Linux Shell。当ZooKeeper服务启动以后,可以在其中一台运行ZooKeeper服务的服务器中输入以下命令(需要进入ZooKeeper安装目录执行),启动一个客户端,连接到ZooKeeper集群:
$ bin/zkCli.sh -server centos01:2181
连接成功后,系统会输出ZooKeeper的运行环境及配置信息,并在屏幕输出“Welcome to ZooKeeper”等欢迎信息,之后就可以使用ZooKeeper命令行工具了。
以下是ZooKeeper命令行工具的一些简单操作示例。
使用ls命令,可以查看ZooKeeper相应路径下的所有znode节点。例如,列出ZooKeeper根目录下的所有znode节点:
[zk: centos01:2181(CONNECTED) 0] ls / [zookeeper]
可以看到,当前根目录有一个名为“zookeeper”的znode节点。
使用create命令,可以创建一个新的znode节点。例如,在根目录创建一个名为“zk”的znode以及在它上面存放的元数据字符串“myData”,命令及输出信息如下:
[zk: centos01:2181(CONNECTED) 1] create /zk "myData" Created /zk
也可以在某个节点下创建子节点。例如,在/zk节点下创建新的节点node1,并关联其元数据为“childData”,命令及输出信息如下:
[zk: centos01:2181(CONNECTED) 2] create /zk/node1 "childData" Created /zk/node1
创建节点时必须指定节点中存放的元数据字符串,否则节点将创建失败。若执行创建命令没有返回任何信息,说明该命令执行失败。
使用get命令,可以查看某个znode的详细状态信息及其包含的元数据字符串。例如,查看znode节点/zk的详细信息,命令及输出信息如下:
[zk: centos01:2181(CONNECTED) 3] get /zk myData cZxid = 0x200000005 ctime = Wed Aug 08 10:28:34 CST 2022 mZxid = 0x200000005 mtime = Wed Aug 08 10:28:34 CST 2022 pZxid = 0x200000005 cversion = 0 dataVersion = 0 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 6 numChildren = 0
上述返回结果中的状态属性解析如下:
ZooKeeper节点状态的每一次改变,都会产生一个唯一的zxid(用于递增的ZooKeeper事务id)形式的标记。如果zxid1小于zxid2,则说明zxid1发生在zxid2之前。
ZooKeeper中每个znode的状态结构由以下字段组成:
·cZxid:节点被创建时产生的zxid值。
·ctime:节点被创建的时间。
·mZxid:节点最后被修改时产生的zxid值。节点每次被修改,mZxid的值都会以递增的形式改变到下一个值。
·pZxid:节点的子节点最后被修改时产生的zxid值。节点的子节点每次被修改,pZxid的值都会以递增的形式改变到下一个值。
·mtime:节点最后一次被修改的时间。
·dataVersion:节点被修改的版本号,即节点被修改的次数。节点创建时版本号为0,每被修改一次,版本号递增1。
·cversion:节点的所有子节点被修改的版本号,即节点的子节点被修改的次数。这里仅指所有子节点被创建和删除的次数,子节点的元数据被修改的次数不会记录在内。
·ephemeralOwner:如果节点为临时节点,则值代表节点拥有者的会话id。如果节点不是临时节点,则值为0。
·dataLength:节点的元数据长度。
·numChildren:节点的子节点数量。
使用set命令,可以修改znode节点的元数据字符串。例如,将znode节点/zk所关联的字符串修改为“myDataUpdate”,命令及输出信息如下:
[zk: centos01:2181(CONNECTED) 4] set /zk "myDataUpdate" cZxid = 0x200000005 ctime = Wed Aug 08 10:28:34 CST 2022 mZxid = 0x200000006 mtime = Wed Aug 08 10:32:16 CST 2022 pZxid = 0x200000005 cversion = 0 dataVersion = 1 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 12 numChildren = 0
使用delete命令,可以将某个znode节点删除。例如,删除上面创建的znode节点/zk,命令如下:
[zk: centos01:2181(CONNECTED) 5] delete /zk
若被删除的节点有子节点,则需要先删除子节点。直接删除含有子节点的节点将删除失败。