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。