Zookeeper CLI

ZooKeeper 命令行界面 (CLI) 用于与 ZooKeeper 集成交互以实现开发目的。 它对于调试和使用不同的选项很有用。

要执行 ZooKeeper CLI 操作，首先打开 ZooKeeper 服务器（“bin/zkServer.sh start”），然后打开 ZooKeeper 客户端（“bin/zkCli.sh”）。 客户端启动后，你可以执行以下操作 -

• 创建 znode
• 获取数据
• 观察 znode 的变化
• 设置数据
• 创建一个 znode 的子节点
• 列出 znode 的子节点
• 检查状态
• 移除/删除一个 znode

现在让我们通过一个例子来一一看看上面的命令。

创建 znode

使用给定的路径创建一个 znode。 flag 参数指定创建的 znode 是临时的、持久的还是顺序的。 默认情况下，所有 znode 都是持久的。

当会话过期或客户端断开连接时，临时 znode（标志：e）将被自动删除。

顺序 znode 保证 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 或 znode 的子节点数据更改时，Watch 会显示通知。 我们只能在 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。 唯一的区别是子 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 子节点

此命令用于列出和显示 znode 的子节点。

语法

ls /path

示例

ls /MyFirstZnode

输出

[zk: localhost:2181(CONNECTED) 2] ls /MyFirstZnode
[mysecondsubnode, myfirstsubnode]

检查状态

Status 描述了指定 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）命令类似于删除命令，除了它只适用于没有子节点的 znodes。