ZooKeeper系列二：客户端命令详解

ZooKeeper客户端命令

 在使用命令行之前有必要了解一下客户端脚本的作用

zkCleanup： 清理Zookeeper历史数据，包括日志文件和快照数据文件

zkCli         ： Zookeeper的一个简易的可交互的客户端, 默认登录zookeeper服务器

zkEnv       ： 设置Zookeeper的环境变量

zkServer   ：  Zookeeper服务启停脚本

 

windows环境下：

启动ZooKeeper服务之后，我们可以使用如下命令连接到 ZooKeeper 服务：

zookeeper-3.4.8in>zkCli.cmd -server 127.0.0.1:2181

Linux环境下：

zkCli.sh -server 127.0.0.1:2181 

客户端常用命令，我们可以使用 help命令来查看帮助，命令行工具的一些常用操作命令如下：

ls

使用 ls 命令来查看某个目录包含的所有文件，例如：

 ls /

ls2

使用 ls2 命令来查看某个目录包含的所有文件，与ls不同的是它查看到time、version等信息

ls2 /

create

创建znode，并设置初始内容，例如

create /test "hello" 

创建一个新的 znode节点“ test ”以及与它关联的字符串

get

获取znode的数据，如下：

get /test

set

修改znode内容，例如：

set /test "ricky"

delete

删除znode

delete /test

quit

退出客户端

help

帮助命令

命令行的详解

• 创建 create [ -s ] [ -e ] path data acl

[ -s ] 创建顺序节点的 ，指定生效

[ -e ] 创建临时节点，需要指定生效，会话失效后，节点消失

path  创建节点的名称

data  该节点存取的数据

acl 权限控制，缺省下不做任何权限控制

关于acl的使用和分析，后边的文章会着重介绍，如下是简单使用不加-s  -e 则是永久节点

 

• 读取 ls  /  get  /  ls2  stat path [ watch ]  

watch 是注册一个事件，当其他客户端对当前节点进行更改时，这个事件会且只会生效一次进行通知提示

数据简单说明

• 第一行是我们存放的数据或者子节点

• cZxid 节点创建时的zxid

• ctime 节点创建时间戳

• mzxid 节点最新一次更新发生时的zxid.

• mtime 节点最新一次更新发生时的时间戳.

• pZxid 该节点子节点最近一次创建/删除的时间戳对应

• dataVersion 节点数据的更新次数.

• cversion 其子节点的更新次数.

• aclVersion 节点ACL(授权信息)的更新次数.

• ephemeralOwner 如果该节点为ephemeral节点, ephemeralOwner值表示与该节点绑定的session id. 如果该节点不是ephemeral节点, ephemeralOwner值为0. 至于什么是ephemeral节点, 请看后面的讲述.

• dataLength 节点数据的字节数.

• numChildren 子节点个数.

 

• 更新 set path data [ version ]

• 删除 delete path [ version ] /  rmr path

　　delete和rmr命令区别在于rmr会递归删除命令，当znode节点下有子节点时，rmr会首先去删除子节点，再删除znode，而delete必须要先手动删除znode节点下的子节点。

 

所谓配额：

就是对于节点进行限制，比如说-b 限制节点值的长度，-n 限制节点的个数，有兴趣的童鞋可以自己尝试一下。

• 显示配额  listquota path

• 设置配额   setquota -n | -b val path

• 删除配额  delquota [ -n  | -b ]  path

• 设置ACL权限控制

五种权限：

CREATE、READ、WRITE、DELETE、ADMIN 也就是 增、删、改、查、管理权限，这5种权限简写为crwda，这5种权限中，delete是指对子节点的删除权限，其它4种权限指对自身节点的操作权限

身份的认证有4种方式：

world：默认方式，相当于全世界都能访问

auth：代表已经认证通过的用户(cli中可以通过addauth digest user:pwd 来添加当前上下文中的授权用户)

digest：即用户名:密码这种方式认证，这也是业务系统中最常用的

ip：使用Ip地址认证

 

设置访问控制方式

方式一：（推荐）

1）增加一个认证用户

addauth digest 用户名:密码明文

2）设置权限

setAcl /path auth:用户名:密码明文:权限

3）查看Acl设置

getAcl  /path

 

方式二：

setAcl /path digest:用户名:密码密文:权限

注：这里的加密规则是SHA1加密，然后base64编码。

 

剩下的命令较为简单，这里不再介绍，有兴趣的童鞋可以度娘一下

• 强制同步 sync  path

• 设置和显示监视状态    printwatches on|off

• 显示历史命令列表  history

• 重复执行history列表中的指令  redo id

• 退出  quit

• 连接其他服务器  connect host：port

• 关闭连接 close

参考官方资料：
https://zookeeper.apache.org

ZooKeeper 常用四字命令：

 

ZooKeeper四字命令  功能描述
conf  　　输出相关服务配置的详细信息。
cons 　　 列出所有连接到服务器的客户端的完全的连接 / 会话的详细信息。包括“接受 / 发送”的包数量、会话 id 、操作延迟、最后的操作执行等等信息。
dump  　　列出未经处理的会话和临时节点。
envi  　　输出关于服务环境的详细信息（区别于 conf 命令）。
reqs 　　 列出未经处理的请求
ruok  　　测试服务是否处于正确状态。如果确实如此，那么服务返回“imok ”，否则不做任何相应。
stat 　　 输出关于性能和连接的客户端的列表。
wchs  　　列出服务器 watch 的详细信息。
wchc 　　 通过 session 列出服务器 watch 的详细信息，它的输出是一个与watch 相关的会话的列表。

 

ZooKeeper 支持某些特定的四字命令字母与其的交互。它们大多是查询命令，用来获取 ZooKeeper 服务的当前状态及相关信息。用户在客户端可以通过 telnet 或 nc 向 ZooKeeper 提交相应的命令

• 1. 可以通过命令：echo stat|nc 127.0.0.1 2181 来查看哪个节点被选择作为follower或者leader
• 2. 使用echo ruok|nc 127.0.0.1 2181 测试是否启动了该Server，若回复imok表示已经启动。
• 3. echo dump| nc 127.0.0.1 2181 ,列出未经处理的会话和临时节点。
• 4. echo kill | nc 127.0.0.1 2181 ,关掉server
• 5. echo conf | nc 127.0.0.1 2181 ,输出相关服务配置的详细信息。
• 6. echo cons | nc 127.0.0.1 2181 ,列出所有连接到服务器的客户端的完全的连接 / 会话的详细信息。
• 7. echo envi |nc 127.0.0.1 2181 ,输出关于服务环境的详细信息（区别于 conf 命令）。
• 8. echo reqs | nc 127.0.0.1 2181 ,列出未经处理的请求。
• 9. echo wchs | nc 127.0.0.1 2181 ,列出服务器 watch 的详细信息。
• 10. echo wchc | nc 127.0.0.1 2181 ,通过 session 列出服务器 watch 的详细信息，它的输出是一个与 watch 相关的会话的列表。
• 11. echo wchp | nc 127.0.0.1 2181 ,通过路径列出服务器 watch 的详细信息。它输出一个与 session 相关的路径。