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

允我心安 提交于 2020-02-13 23:21:36

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 常用四字命令:

 
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 相关的路径。
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!