ZooKeeper zkCli.sh常用命令

总览

先看一下zkCli的版本和支持的命令

随便敲一个不被识别的指令，例如h即可

[zk: localhost:2181(CONNECTED) 0] h
ZooKeeper -server host:port -client-configuration properties-file cmd args
        addWatch [-m mode] path # optional mode is one of [PERSISTENT, PERSISTENT_RECURSIVE] - default is PERSISTENT_RECURSIVE
        addauth scheme auth
        close
        config [-c] [-w] [-s]
        connect host:port
        create [-s] [-e] [-c] [-t ttl] path [data] [acl]
        delete [-v version] path
        deleteall path [-b batch size]
        delquota [-n|-b|-N|-B] path
        get [-s] [-w] path
        getAcl [-s] path
        getAllChildrenNumber path
        getEphemerals path
        history
        listquota path
        ls [-s] [-w] [-R] path
        printwatches on|off
        quit
        reconfig [-s] [-v version] [[-file path] | [-members serverID=host:port1:port2;port3[,...]*]] | [-add serverId=host:port1:port2;port3[,...]]* [-remove serverId[,...]*]
        redo cmdno
        removewatches path [-c|-d|-a] [-l]
        set [-s] [-v version] path data
        setAcl [-s] [-v version] [-R] path acl
        setquota -n|-b|-N|-B val path
        stat [-w] path
        sync path
        version
        whoami
Command not found: Command not found h
[zk: localhost:2181(CONNECTED) 1] version
ZooKeeper CLI version: 3.8.1-74db005175a4ec545697012f9069cb9dcc8cdda7, built on 2023-01-25 16:31 UTC

version命令可以查看本文用的zookeeper CLI的版本是3.8.1

config

查看集群配置

与/zookeeper/config的数据相同

create

create [-s] [-e] [-c] [-t ttl] path [data] [acl]

• -s: 创建顺序节点，且节点名称自动进行顺序自增。利用zk的顺序节点性质，可以制作分布式主键生成器。
• -e: 创建临时节点，zookeeper的临时节点在客户端失联后会自动被删除。
• -c: 创建容器节点，容器节点主要用来容纳子节点，如果没有给其创建子节点，容器节点表现和持久化节点一样；如果给容器节点创建了子节点，后续又把子节点清空，容器节点也会被zookeeper删除。
• -t: 创建带有过期时间的节点，
• path: 创建的节点路径
• data: 创建节点的数据内容
• acl: 节点的访问控制

delete

• delete [-v version] path 删除节点数据，如果节点含有子节点，则无法删除。
• deleteall path [-b batch size] 删除所有节点及子节点。
• delquota [-n|-b|-N|-B] path 删除配额设置

 get

• get [-s] [-w] path  获取节点的数据。
• getAcl [-s] path 获取节点访问控制权限信息
• getAllChildrenNumber path 获取所有子节点数量
• getEphemerals path 获取临时节点

 

history和redo

• history列出历史命令
• redo 重新执行指定历史命令

ls

• ls [-s] [-w] [-R] path  获取节点的子节点列表
• -R: 递归列出路径下所有子节点

set

• set [-s] [-v version] path data 修改节点数据
• setAcl [-s] [-v version] [-R] path acl 设置访问控制权限
• setquota -n|-b|-N|-B val path 设置节点配额，

   -n表示限制子节点的个数，-b表示限制数据值的长度。假设配额超限了之后，zookeeper只会在日志中进行警告记录，而不会抛出异常。listquota path 可查看节点的配额情况。 

 stat

• stat [-w] path 获取节点的状态.

在zookeeper中，每一次对数据节点的写操作（如创建一个节点）被认为是一次事务，对于每一个事务系统都会分配一个唯一的id来标识这个事务，

• cZxid：表示事务id，表示该节点是在哪个事务中创建的；
• ctime：表示节点创建的时间；
• mZxid：最后一次更新时的事务id；
• mtime：最后一次更新时的时间;
• pZxid：表示该节点的子节点列表（非子节点内容）最后一次被修改的事务的id;
• cversion = -2：表示子节点列表的版本；
• dataVersion = 0：表示数据内容的版本；
• aclVersion = 0：表示acl的版本;
• ephemeralOwner：用于临时节点，表示创建该临时节点的事务id，如果当前节点是永久节点，这个值是固定的，为0x0;
• datalength：表示当前节点存放的数据的长度;
• numChildren：表示当前节点拥有的子节点的个数;

quit

• 退出CLI