zookeeper客户端命令详解

  今天同事突然向看一下zookeeper中都创建了哪些节点,而我本人对zookeeper的客服端命令了解的很少,有些操作竟然不知道怎么用,于是乎就索性整理一下zookeeper客服端命令的使用,并再此记录一下。

  想要用zkClient链接zookeeper,首先执行如下命令,连接到zookeeper server

./zkCli.sh -server localhost:2181

help命令

help命令用于查询客服端所支持的所用的命令,执行help,输入如下:

ZooKeeper -server host:port cmd args
    stat path [watch]
    set path data [version]
    ls path [watch]
    delquota [-n|-b] path
    ls2 path [watch]
    setAcl path acl
    setquota -n|-b val path
    history 
    redo cmdno
    printwatches on|off
    delete path [version]
    sync path
    listquota path
    get path [watch]
    create [-s] [-e] path data acl
    addauth scheme auth
    quit 
    getAcl path
    close 
    connect host:port

connect命令

  连接zk服务端,与close命令配合使用可以连接或者断开zk服务端

connect 127.0.0.1:2181

close命令

  close命令用于关闭与服务端的链接

get命令

  get命令用于获取节点的信息,注意节点的路径必须是以/开头的绝对路径。如get /

cZxid = 0x0
ctime = Thu Jan 01 08:00:00 CST 1970
mZxid = 0x0
mtime = Thu Jan 01 08:00:00 CST 1970
pZxid = 0x1469
cversion = 3
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 0
numChildren = 4

其中:

cZxid:节点创建时的zxid

ctime:节点创建时间

mZxid:节点最近一次更新时的zxid

mtime:节点最近一次更新的时间

cversion:子节点数据更新次数

dataVersion:本节点数据更新次数

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

ephemeralOwner:如果该节点为临时节点,ephemeralOwner值表示与该节点绑定的session id. 如果该节点不是临时节点,ephemeralOwner值为0

dataLength:节点数据长度,本例中为hello world的长度

numChildren:子节点个数

stat命令

stat命令用于查看节点的状态信息,如stat /

cZxid = 0x0
ctime = Thu Jan 01 08:00:00 CST 1970
mZxid = 0x0
mtime = Thu Jan 01 08:00:00 CST 1970
pZxid = 0x1469
cversion = 3
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 0
numChildren = 4

该命令的结果参数说明同get命令

set命令

  set命令用于设置节点的数据,如:

set /usergrid hellUsergrid

ls命令

  ls命令用于获取路径下的节点信息,注意路径为绝对路径,如:ls /storm

[assignments, storms, errors, supervisors, workerbeats]

ls2命令

  ls2命令是ls命令的增强版,比ls命令多输出本节点信息,如:ls2 /storm

[assignments, storms, errors, supervisors, workerbeats]
cZxid = 0x1469
ctime = Tue Nov 14 11:32:09 CST 2017
mZxid = 0x1469
mtime = Tue Nov 14 11:32:09 CST 2017
pZxid = 0x1470
cversion = 5
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 1
numChildren = 5

listquota命令

  listquota命令用于显示配额,如listquota /storm

absolute path is /zookeeper/quota/storm/zookeeper_limits
quota for /storm does not exist.

setquota命令

  setquota命令用于设置节点个数以及数据长度的配额,如:

setquota –n 4 /zookeeper/node 设置/zookeeper/node子节点个数最大为4
setquota –b 100 /zookeeper/node 设置/zookeeper/node节点长度最大为100

 delquota命令

  delquota命令用于删除配额,-n为子节点个数,-b为节点数据长度,如:delquota –n 2

history命令

  history用于列出最近的命令历史,可以和redo配合使用。如history  

12 - get /usergrid
13 - help
14 - ls /
15 - ls /storm
16 - ls2 /storm
17 - help
18 - listquota /storm
19 - listquota /zookeeper
20 - help
21 - history
22 - history

redo命令

  redo命令用于再次执行某个命令,使用方式为redo cmdid 如 redo 20

  常与history配合使用

create命令

  create命令用于创建节点,其中-s为顺序充点,-e临时节点 

create /zookeeper/node1"test_create" world:anyone:fdsfds

delete命令

  delete命令用于删除节点,如delete /nodeDelete

addauth命令

  addauth命令用于节点认证,使用方式:如addauth digest username:password

setAcl命令

  setAcl命令用于设置节点Acl

  Acl由三部分构成:1为scheme,2为user,3为permission,一般情况下表示为scheme:id:permissions

getAcl命令

  获取节点的Acl,如getAcl /node1

scheme和id

world: 它下面只有一个id, 叫anyone, world:anyone代表任何人,zookeeper中对所有人有权限的结点就是属于world:anyone的

auth: 它不需要id, 只要是通过authentication的user都有权限(zookeeper支持通过kerberos来进行authencation, 也支持username/password形式的authentication)

digest: 它对应的id为username:BASE64(SHA1(password)),它需要先通过username:password形式的authentication

ip: 它对应的id为客户机的IP地址,设置的时候可以设置一个ip段,比如ip:192.168.1.0/16, 表示匹配前16个bit的IP段

super: 在这种scheme情况下,对应的id拥有超级权限,可以做任何事情(cdrwa)

permissions

CREATE(c): 创建权限,可以在在当前node下创建child node

DELETE(d): 删除权限,可以删除当前的node

READ(r): 读权限,可以获取当前node的数据,可以list当前node所有的child nodes

WRITE(w): 写权限,可以向当前node写数据

ADMIN(a): 管理权限,可以设置当前node的permission

sync命令

  sync命令用于强制同步,由于请求在半数以上的zk server上生效就表示此请求生效,那么就会有一些zk server上的数据是旧的。sync命令就是强制同步所有的更新操作。

printwatchers命令

  printWatchers命令用于设置和显示监视状态,值为on或则off

quit命令

  退出客户端

posted @ 2017-11-14 17:33  木易森林  阅读(38798)  评论(0编辑  收藏  举报