Zookeeper：命令行（CLI）

命令行界面（CLI）

ZooKeeper 命令行界面（CLI）用于与ZooKeeper集合进行交互以进行开发。它有助于调试和解决不同的选项。

• 要执行ZooKeeper CLI操作，首先打开ZooKeeper服务器（“bin/zkServer.sh start”），然后打开ZooKeeper客户端（“bin/zkCli.sh”）。

CLI 常用命令：

1. create：创建节点并赋值。

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

   • [-s] [-e]：-s 代表顺序节点，-e 代表临时节点，二者可以同时使用的，并且临时节点不能再创建子节点。
   • path：指定要创建节点的路径，比如 /runoob。
   • data：要在此节点存储的数据。
   • acl：访问权限相关，默认是 world：开放式权限（所有都可以访问）。

   示例：

   

2. get：获取节点数据和状态信息。

   get path [watch]
   

   • path：代表路径。
   • [watch]：对节点进行事件监听。

   示例：

   

3. set：修改节点存储的数据。

   set path data [version]
   

   • path：节点路径。
   • data：需要存储的数据。
   • [version]：可选项，版本号（可用作乐观锁）。【只有版本号正确操作才能成功】

   示例：

   

4. stat：查看节点状态信息。

   stat path [watch]
   

   • path：代表路径。
   • [watch]：对节点进行事件监听。

   示例：

   

5. delete：删除某节点（包括其子节点）。

   delete path [version]
   

   • path：节点路径。
   • [version]：可选项，版本号（同 set 命令）。

   示例：

   

6. rmr：删除某节点（只能删除不含子节点的节点）。

   rmr path [version]
   

   • path：节点路径。
   • [version]：可选项，版本号（同 set 命令）。
7. ls：查看某个路径下目录列表。

   ls path
   

   • path：代表路径。

   示例：

   

8. ls2：查看某个路径下目录列表。（比 ls 命令列出更多的详细信息）

   ls2 path
   

   • path：代表路径。

   示例：

   

四字命令【？？？】

zookeeper 支持某些特定的四字命令与其交互，用户获取 zookeeper 服务的当前状态及相关信息，用户在客户端可以通过 telenet 或者 nc（netcat） 向 zookeeper 提交相应的命令。

• 参考官方链接：https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_4lw。

安装 nc 命令：

$ yum install nc                # centos
或
$ sudo apt install netcat       # ubuntu

四字命令格式：

echo [command] | nc [ip] [port]

ZooKeeper 常用四字命令主要如下：

命令	描述
conf	3.3.0版本引入。打印出服务相关配置的详细信息。
cons	3.3.0版本引入。列出所有连接到这台服务器的客户端全部连接/会话详细信息。包括"接受/发送"的包数量、会话id、操作延迟、最后的操作执行等等信息。
crst	3.3.0版本引入。重置所有连接的连接和会话统计信息。
dump	列出那些比较重要的会话和临时节点。这个命令只能在leader节点上有用。
envi	打印出服务环境的详细信息。
reqs	列出未经处理的请求
ruok	测试服务是否处于正确状态。如果确实如此，那么服务返回"imok"，否则不做任何相应。
stat	输出关于性能和连接的客户端的列表。
srst	重置服务器的统计。
srvr	3.3.0版本引入。列出连接服务器的详细信息
wchs	3.3.0版本引入。列出服务器watch的详细信息。
wchc	3.3.0版本引入。通过session列出服务器watch的详细信息，它的输出是一个与watch相关的会话的列表。
wchp	3.3.0版本引入。通过路径列出服务器watch的详细信息。它输出一个与session相关的路径。
mntr	3.4.0版本引入。输出可用于检测集群健康状态的变量列表

使用：

1. stat命令：用于查看 zk 的状态信息，实例如下：

   $ echo stat | nc 192.168.3.38 2181
   

   

2. ruok命令：用于查看当前 zkserver 是否启动，若返回 imok 表示正常。实例如下：

   $ echo ruok | nc 192.168.3.38 2181
   

   

3. dump命令：用于列出未经处理的会话和临时节点。实例如下：

   $ echo dump | nc 192.168.3.38 2181
   

   

4. conf命令：用于查看服务器配置。实例如下：

   $ echo conf | nc 192.168.3.38 2181
   

   

5. cons命令：用于展示连接到服务器的客户端信息。实例如下：

   $ echo cons | nc 192.168.3.38 2181
   

   

6. envi命令：用于查看环境变量。实例如下：

   $ echo envi | nc 192.168.3.38 2181