动物园管理员 - CLI
ZooKeeper 命令行界面 (CLI) 用于与 ZooKeeper 整体进行交互以实现开发目的。它对于调试和使用不同的选项非常有用。
要执行 ZooKeeper CLI 操作,首先打开 ZooKeeper 服务器(“bin/zkServer.sh start”),然后打开 ZooKeeper 客户端(“bin/zkCli.sh”)。客户端启动后,您可以执行以下操作 -
- 创建 znode
- 获取数据
- 观察 znode 的变化
- 设置数据
- 创建 znode 的子节点
- 列出 znode 的子节点
- 检查状态
- 移除/删除 znode
现在让我们通过一个例子来一一看看上面的命令。
创建Z节点
使用给定路径创建一个 znode。flag参数指定创建的 znode 是短暂的、持久的还是顺序的。默认情况下,所有 znode 都是持久的。
当会话过期或客户端断开连接时,临时 znode (标志:e)将被自动删除。
顺序 znodes保证 znode 路径是唯一的。
ZooKeeper ensemble 将向 znode 路径添加序列号和 10 位数字填充。例如,znode 路径/myapp 将转换为 /myapp0000000001,下一个序列号将是/myapp0000000002。如果未指定标志,则该 znode 被视为持久节点。
句法
create /path /data
样本
create /FirstZnode “Myfirstzookeeper-app”
输出
[zk: localhost:2181(CONNECTED) 0] create /FirstZnode “Myfirstzookeeper-app” Created /FirstZnode
要创建顺序 znode,请添加-s 标志,如下所示。
句法
create -s /path /data
样本
create -s /FirstZnode second-data
输出
[zk: localhost:2181(CONNECTED) 2] create -s /FirstZnode “second-data” Created /FirstZnode0000000023
要创建临时 Znode,请添加-e 标志,如下所示。
句法
create -e /path /data
样本
create -e /SecondZnode “Ephemeral-data”
输出
[zk: localhost:2181(CONNECTED) 2] create -e /SecondZnode “Ephemeral-data” Created /SecondZnode
请记住,当客户端连接丢失时,临时 znode 将被删除。您可以通过退出 ZooKeeper CLI 然后重新打开 CLI 来尝试。
获取数据
它返回znode的关联数据和指定znode的元数据。您将获得诸如数据上次修改时间、修改位置以及有关数据的信息等信息。此 CLI 还用于分配监视以显示有关数据的通知。
句法
get /path
样本
get /FirstZnode
输出
[zk: localhost:2181(CONNECTED) 1] get /FirstZnode “Myfirstzookeeper-app” cZxid = 0x7f ctime = Tue Sep 29 16:15:47 IST 2015 mZxid = 0x7f mtime = Tue Sep 29 16:15:47 IST 2015 pZxid = 0x7f cversion = 0 dataVersion = 0 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 22 numChildren = 0
要访问顺序 znode,您必须输入 znode 的完整路径。
样本
get /FirstZnode0000000023
输出
[zk: localhost:2181(CONNECTED) 1] get /FirstZnode0000000023 “Second-data” cZxid = 0x80 ctime = Tue Sep 29 16:25:47 IST 2015 mZxid = 0x80 mtime = Tue Sep 29 16:25:47 IST 2015 pZxid = 0x80 cversion = 0 dataVersion = 0 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 13 numChildren = 0
手表
当指定的 znode 或 znode 的子节点数据发生更改时,监视会显示通知。您只能在get命令中设置监视。
句法
get /path [watch] 1
样本
get /FirstZnode 1
输出
[zk: localhost:2181(CONNECTED) 1] get /FirstZnode 1 “Myfirstzookeeper-app” cZxid = 0x7f ctime = Tue Sep 29 16:15:47 IST 2015 mZxid = 0x7f mtime = Tue Sep 29 16:15:47 IST 2015 pZxid = 0x7f cversion = 0 dataVersion = 0 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 22 numChildren = 0
输出与普通get命令类似,但它会在后台等待 znode 更改。<从这里开始>
设置数据
设置指定znode的数据。完成此设置操作后,您可以使用get CLI 命令检查数据。
句法
set /path /data
样本
set /SecondZnode Data-updated
输出
[zk: localhost:2181(CONNECTED) 1] get /SecondZnode “Data-updated” cZxid = 0x82 ctime = Tue Sep 29 16:29:50 IST 2015 mZxid = 0x83 mtime = Tue Sep 29 16:29:50 IST 2015 pZxid = 0x82 cversion = 0 dataVersion = 1 aclVersion = 0 ephemeralOwner = 0x15018b47db00000 dataLength = 14 numChildren = 0
如果您在get命令中指定了watch选项(如上一个命令),那么输出将类似于如下所示 -
输出
[zk: localhost:2181(CONNECTED) 1] get /FirstZnode “Mysecondzookeeper-app” WATCHER: : WatchedEvent state:SyncConnected type:NodeDataChanged path:/FirstZnode cZxid = 0x7f ctime = Tue Sep 29 16:15:47 IST 2015 mZxid = 0x84 mtime = Tue Sep 29 17:14:47 IST 2015 pZxid = 0x7f cversion = 0 dataVersion = 1 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 23 numChildren = 0
创建子节点/子节点
创建子节点类似于创建新的 znode。唯一的区别是子 znode 的路径也将具有父路径。
句法
create /parent/path/subnode/path /data
样本
create /FirstZnode/Child1 firstchildren
输出
[zk: localhost:2181(CONNECTED) 16] create /FirstZnode/Child1 “firstchildren” created /FirstZnode/Child1 [zk: localhost:2181(CONNECTED) 17] create /FirstZnode/Child2 “secondchildren” created /FirstZnode/Child2
列出孩子
该命令用于列出并显示znode 的子节点。
句法
ls /path
样本
ls /MyFirstZnode
输出
[zk: localhost:2181(CONNECTED) 2] ls /MyFirstZnode [mysecondsubnode, myfirstsubnode]
检查状态
状态描述了指定znode的元数据。它包含时间戳、版本号、ACL、数据长度和子节点等详细信息。
句法
stat /path
样本
stat /FirstZnode
输出
[zk: localhost:2181(CONNECTED) 1] stat /FirstZnode cZxid = 0x7f ctime = Tue Sep 29 16:15:47 IST 2015 mZxid = 0x7f mtime = Tue Sep 29 17:14:24 IST 2015 pZxid = 0x7f cversion = 0 dataVersion = 1 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 23 numChildren = 0
删除一个Z节点
删除指定的 znode 并递归删除其所有子节点。仅当这样的 znode 可用时才会发生这种情况。
句法
rmr /path
样本
rmr /FirstZnode
输出
[zk: localhost:2181(CONNECTED) 10] rmr /FirstZnode [zk: localhost:2181(CONNECTED) 11] get /FirstZnode Node does not exist: /FirstZnode
删除(delete /path)命令与删除命令类似,但它仅适用于没有子节点的 znode。