ZooKeeper的命令行工具类似于Linux Shell。当ZooKeeper服务启动以后,可以在其中一台运行ZooKeeper服务的服务器中输入以下命令(需要进入ZooKeeper安装目录执行),启动一个客户端,连接到ZooKeeper集群:
连接成功后,系统会输出ZooKeeper的运行环境及配置信息,并在屏幕输出“Welcome to ZooKeeper”等欢迎信息,之后就可以使用ZooKeeper命令行工具了。
以下是ZooKeeper命令行工具的一些简单操作示例。
使用ls命令,可以查看ZooKeeper相应路径下的所有znode节点。例如,列出ZooKeeper根目录下的所有znode节点:
可以看到,当前根目录有一个名称为“zookeeper”的znode节点。
使用create命令,可以创建一个新的znode节点。例如,在根目录创建一个名为“zk”的znode以及在它上面存放的元数据字符串为“myData”,命令及输出信息如下:
也可以在某个节点下创建子节点。例如,在/zk节点下创建新的节点node1,并关联其元数据为“childData”,命令及输出信息如下:
创建节点时必须指定节点中存放的元数据字符串,否则节点将创建失败。若执行创建命令没有返回任何信息,说明该命令执行失败。
使用get命令,可以查看某个znode的详细状态信息及其包含的元数据字符串。例如,查看znode节点/zk的详细信息,命令及输出信息如下:
上述返回结果中的状态属性解析如下:
ZooKeeper节点状态的每一次改变,都会产生一个唯一的zxid(用于递增的ZooKeeper事务id)形式的标记。如果zxid1小于zxid2,那么zxid1发生在zxid2之前。
ZooKeeper中每个znode的状态结构由以下字段组成。
使用set命令,可以修改znode节点的元数据字符串。例如,将znode节点/zk所关联的字符串修改为“myDataUpdate”,命令及输出信息如下:
使用delete命令,可以将某个znode节点删除。例如,删除上面创建的znode节点/zk,命令如下:
若被删除的节点有子节点,则需要先删除子节点。直接删除含有子节点的节点将删除失败。