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 相关的路径。