ZooKeeper系列二：客户端命令详解
ZooKeeper客户端命令
在使用命令行之前有必要了解一下客户端脚本的作用
zkCleanup： 清理Zookeeper历史数据，包括日志文件和快照数据文件
zkCli ： Zookeeper的一个简易的可交互的客户端, 默认登录zookeeper服务器
zkEnv ： 设置Zookeeper的环境变量
zkServer ： Zookeeper服务启停脚本
windows环境下：
启动ZooKeeper服务之后，我们可以使用如下命令连接到 ZooKeeper 服务：
zookeeper-3.4.8\bin>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 常用四字命令：
conf 输出相关服务配置的详细信息。
cons 列出所有连接到服务器的客户端的完全的连接 / 会话的详细信息。包括“接受 / 发送”的包数量、会话 id 、操作延迟、最后的操作执行等等信息。
dump 列出未经处理的会话和临时节点。
envi 输出关于服务环境的详细信息（区别于 conf 命令）。
reqs 列出未经处理的请求
ruok 测试服务是否处于正确状态。如果确实如此，那么服务返回“imok ”，否则不做任何相应。
stat 输出关于性能和连接的客户端的列表。
wchs 列出服务器 watch 的详细信息。
wchc 通过 session 列出服务器 watch 的详细信息，它的输出是一个与watch 相关的会话的列表。
- 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 相关的路径。
