Zookeeper - CLI
ZooKeeper 命令行界面 (CLI) 用于与 ZooKeeper 集合进行交互以进行开发。 它对于调试和解决不同选项很有用。
要执行 ZooKeeper CLI 操作,首先打开 ZooKeeper 服务器 ("bin/zkServer.sh start"),然后打开 ZooKeeper 客户端 ("bin/zkCli.sh") . 客户端启动后,可以进行如下操作 −
- 创建 znodes
- 获取数据
- 观察 znode 的变化
- 设置数据
- 创建一个 znode 的子节点
- 列出 znode 的子节点
- 检查状态
- 移除/删除一个 znode
现在让我们通过一个例子来一一看上面的命令。
创建 Znodes
使用给定路径创建一个 znode。 flag 参数指定创建的 znode 是临时的、持久的还是顺序的。 默认情况下,所有 znode 都是持久的。
临时 znodes(标志:e)将在会话到期或客户端断开连接时自动删除。
顺序 znodes 保证 znode 路径是唯一的。
ZooKeeper 集合将向 znode 路径添加序列号和 10 位填充。 例如,znode 路径 /myapp 将转换为 /myapp0000000001,下一个序列号将是 /myapp0000000002。 如果没有指定标志,则 znode 被视为 persistent。
语法
create /path /data
示例
create /FirstZnode “Myfirstzookeeper-app”
输出
[zk: localhost:2181(CONNECTED) 0] create /FirstZnode “Myfirstzookeeper-app” Created /FirstZnode
要创建顺序节点,请添加 -s 标志,如下所示。
语法
create -s /path /data
示例
create -s /FirstZnode second-data
输出
[zk: localhost:2181(CONNECTED) 2] create -s /FirstZnode “second-data” Created /FirstZnode0000000023
要创建临时节点,请添加 -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 的子节点数据发生变化时,Watches 会显示通知。 您只能在 get 命令中设置 watch。
语法
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、数据长度和子 znode 等详细信息。
语法
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
移除一个 Znode
移除指定的 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) 命令类似于 remove 命令,不同之处在于它仅适用于没有子节点的 znode。