ZooKeeper - 命令行界面 (CLI)

ZooKeeper 命令行界面 (CLI) 用于与 ZooKeeper 集群进行交互以进行开发。它对于调试和处理不同的选项非常有用。

要执行 ZooKeeper CLI 操作，首先启动 ZooKeeper 服务器（`bin/zkServer.sh start`），然后启动 ZooKeeper 客户端（`bin/zkCli.sh`）。客户端启动后，您可以执行以下操作：

创建 znode
获取数据
监视 znode 的变化
设置数据
创建 znode 的子节点
列出 znode 的子节点
检查状态
删除 znode

现在让我们逐一查看上面的命令及其示例。

创建 Znode

创建具有给定路径的 znode。**标志** 参数指定创建的 znode 是否为临时性、持久性或顺序性。默认情况下，所有 znode 都是持久性的。

**临时性 znode** (标志: e) 会在会话过期或客户端断开连接时自动删除。
**顺序性 znode** 保证 znode 路径的唯一性。
ZooKeeper 集群会在 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` 命令中分配了**监视器**选项（如之前的命令），则输出将类似于以下所示：

输出

[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 的**子节点**。

语法

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` (`delete /path`) 命令类似于 `remove` 命令，区别在于它仅适用于没有子节点的 znode。

打印页面