### 1. 使用 Keeper 设置来配置节点
1. 在 3 台主机 (`chnode1`、`chnode2`、`chnode3`) 上安装 3 个 ClickHouse 实例。 (有关 ClickHouse 的安装详情，请参阅[快速入门](/zh/get-started/setup/install)。)
2. 在每个节点上，添加以下配置项，以允许通过网络接口进行对外通信。
```xml theme={null}
` 设置；例如，`chnode1` 应设为 `1`，`chnode2` 应设为 `2`，依此类推。
```xml theme={null}
9181
1
/var/lib/clickhouse/coordination/log
/var/lib/clickhouse/coordination/snapshots
10000
30000
warning
1
chnode1.domain.com
9234
2
chnode2.domain.com
9234
3
chnode3.domain.com
9234
```
以下是上文中使用的基本设置：
| 参数 | 描述 | 示例 |
| ---------------------- | -------------------------------------- | --------------------------------- |
| tcp\_port | Keeper 客户端使用的端口 | 9181，默认对应 ZooKeeper 中的 2181 |
| server\_id | Raft 配置中每个 ClickHouse Keeper 服务器使用的标识符 | 1 |
| coordination\_settings | 协调相关参数部分，例如超时 | timeouts: 10000, log level: trace |
| server | 参与节点的服务器定义 | 各服务器定义的列表 |
| raft\_configuration | Keeper 集群中各服务器的配置 | 每个服务器的 server 和 settings |
| id | Keeper 服务中服务器的数字 ID | 1 |
| hostname | Keeper 集群中各服务器的主机名、IP 或 FQDN | `chnode1.domain.com` |
| port | 用于服务器间 Keeper 连接监听的端口 | 9234 |
4. 启用 ZooKeeper 组件。它将使用 ClickHouse Keeper 引擎：
```xml theme={null}
chnode1.domain.com
9181
chnode2.domain.com
9181
chnode3.domain.com
9181
```
以上是前面用到的基本设置：
| 参数 | 描述 | 示例 |
| ---- | ------------------------------------- | ---------------------- |
| node | 用于 ClickHouse Keeper 连接的节点列表 | 为每台服务器配置一个 settings 条目 |
| host | 每个 ClickHouse Keeper 节点的主机名、IP 或 FQDN | `chnode1.domain.com` |
| port | ClickHouse Keeper 客户端端口 | 9181 |
5. 重启 ClickHouse，并验证每个 Keeper 实例都在运行。在每台服务器上执行以下命令。如果 Keeper 正在运行且状态正常，`ruok` 命令将返回 `imok`：
```bash theme={null}
# echo ruok | nc localhost 9181; echo
imok
```
6. `system` 数据库中有一张名为 `zookeeper` 的表，包含你的 ClickHouse Keeper 实例的详细信息。我们来查看这张表：
```sql theme={null}
SELECT *
FROM system.zookeeper
WHERE path IN ('/', '/clickhouse')
```
表如下所示：
```response theme={null}
┌─name───────┬─value─┬─czxid─┬─mzxid─┬───────────────ctime─┬───────────────mtime─┬─version─┬─cversion─┬─aversion─┬─ephemeralOwner─┬─dataLength─┬─numChildren─┬─pzxid─┬─path────────┐
│ clickhouse │ │ 124 │ 124 │ 2022-03-07 00:49:34 │ 2022-03-07 00:49:34 │ 0 │ 2 │ 0 │ 0 │ 0 │ 2 │ 5693 │ / │
│ task_queue │ │ 125 │ 125 │ 2022-03-07 00:49:34 │ 2022-03-07 00:49:34 │ 0 │ 1 │ 0 │ 0 │ 0 │ 1 │ 126 │ /clickhouse │
│ tables │ │ 5693 │ 5693 │ 2022-03-07 00:49:34 │ 2022-03-07 00:49:34 │ 0 │ 3 │ 0 │ 0 │ 0 │ 3 │ 6461 │ /clickhouse │
└────────────┴───────┴───────┴───────┴─────────────────────┴─────────────────────┴─────────┴──────────┴──────────┴────────────────┴────────────┴─────────────┴───────┴─────────────┘
```
### 2. 在 ClickHouse 中配置集群
1. 我们来配置一个简单集群：在其中 2 个节点上设置 2 个分片，且每个分片只有 1 个副本。第三个节点将用于满足 ClickHouse Keeper 的法定人数要求。更新 `chnode1` 和 `chnode2` 上的配置。以下集群在每个节点上定义了 1 个分片，总共 2 个分片，且不使用复制。在此示例中，部分数据会位于一个节点上，另一部分数据会位于另一个节点上：
```xml theme={null}
chnode1.domain.com
9000
default
ClickHouse123!
chnode2.domain.com
9000
default
ClickHouse123!
```
| 参数 | 描述 | 示例 |
| -------- | ------------------------------ | -------------------- |
| shard | 集群定义中的副本列表 | 每个分片的副本列表示例 |
| replica | 每个副本的设置列表 | 每个副本的设置项 |
| host | 承载副本分片的服务器的 hostname、IP 或 FQDN | `chnode1.domain.com` |
| port | 使用原生 TCP 协议通信的端口 | 9000 |
| user | 用于向集群实例进行身份验证的用户名 | default |
| password | 允许连接到集群实例的用户密码 | `ClickHouse123!` |
2. 重启 ClickHouse 并验证集群已创建：
```sql theme={null}
SHOW clusters;
```
你应该会看到你的集群：
```response theme={null}
┌─cluster───────┐
│ cluster_2S_1R │
└───────────────┘
```
### 3. 创建并测试分布式表
1. 在 `chnode1` 上使用 ClickHouse client，在新集群中创建一个新数据库。`ON CLUSTER` 子句会自动在两个节点上创建该数据库。
```sql theme={null}
CREATE DATABASE db1 ON CLUSTER 'cluster_2S_1R';
```
2. 在 `db1` 数据库中创建一个新表。同样，`ON CLUSTER` 会在两个节点上创建该表。
```sql theme={null}
CREATE TABLE db1.table1 on cluster 'cluster_2S_1R'
(
`id` UInt64,
`column1` String
)
ENGINE = MergeTree
ORDER BY column1
```
3. 在 `chnode1` 节点上插入两行数据：
```sql theme={null}
INSERT INTO db1.table1
(id, column1)
VALUES
(1, 'abc'),
(2, 'def')
```
4. 在 `chnode2` 节点上再插入两行数据：
```sql theme={null}
INSERT INTO db1.table1
(id, column1)
VALUES
(3, 'ghi'),
(4, 'jkl')
```
5. 请注意，在每个节点上执行 `SELECT` 语句时，只会看到该节点上的数据。例如，在 `chnode1` 上：
```sql theme={null}
SELECT *
FROM db1.table1
```
```response theme={null}
Query id: 7ef1edbc-df25-462b-a9d4-3fe6f9cb0b6d
┌─id─┬─column1─┐
│ 1 │ abc │
│ 2 │ def │
└────┴─────────┘
2 rows in set. Elapsed: 0.006 sec.
```
在 `chnode2` 上：
6. ```sql theme={null}
SELECT *
FROM db1.table1
```
```response theme={null}
Query id: c43763cc-c69c-4bcc-afbe-50e764adfcbf
┌─id─┬─column1─┐
│ 3 │ ghi │
│ 4 │ jkl │
└────┴─────────┘
```
7. 你可以创建一个 `Distributed` 表，用来表示这两个分片上的数据。使用 `Distributed` 表引擎的表本身不存储任何数据，但支持在多个服务器上进行分布式查询处理。读取会访问所有分片，写入也可以分发到各个分片。请在 `chnode1` 上运行以下查询：
```sql theme={null}
CREATE TABLE db1.dist_table (
id UInt64,
column1 String
)
ENGINE = Distributed(cluster_2S_1R,db1,table1)
```
8. 可以看到，查询 `dist_table` 会返回来自这两个分片的全部四行数据：
```sql theme={null}
SELECT *
FROM db1.dist_table
```
```response theme={null}
Query id: 495bffa0-f849-4a0c-aeea-d7115a54747a
┌─id─┬─column1─┐
│ 1 │ abc │
│ 2 │ def │
└────┴─────────┘
┌─id─┬─column1─┐
│ 3 │ ghi │
│ 4 │ jkl │
└────┴─────────┘
4 rows in set. Elapsed: 0.018 sec.
```
### 摘要
本指南介绍了如何使用 ClickHouse Keeper 搭建集群。借助 ClickHouse Keeper，您可以配置集群，并定义可在各个分片之间复制的分布式表。
## 使用唯一路径配置 ClickHouse Keeper
本页不适用于 [ClickHouse Cloud](https://clickhouse.com/cloud)。本文所述流程在 ClickHouse Cloud 服务中已实现自动化。
### 说明
本文介绍如何使用内置的 `{uuid}` 宏设置，
在 ClickHouse Keeper 或 ZooKeeper 中创建唯一的条目。唯一的
路径 在频繁创建和 drop 表时很有帮助，因为
这样可以避免每次都要等待几分钟，让 Keeper 的垃圾回收
删除 路径 条目；这是因为每次创建 路径 时，都会在该
路径 中使用新的 `uuid`；路径 永远不会被重复使用。
### 示例环境
一个三节点集群，配置为在全部三个节点上运行 ClickHouse Keeper，
并在其中两个节点上运行 ClickHouse。这样一来，
ClickHouse Keeper 将拥有三个节点 (包括一个仲裁节点) ，并且
ClickHouse 只有一个分片，由两个副本组成。
| node | description |
| ----------------------- | ------------------------- |
| `chnode1.marsnet.local` | 数据节点 - 集群 `cluster_1S_2R` |
| `chnode2.marsnet.local` | 数据节点 - 集群 `cluster_1S_2R` |
| `chnode3.marsnet.local` | ClickHouse Keeper 仲裁节点 |
集群配置示例：
```xml theme={null}
chnode1.marsnet.local
9440
default
ClickHouse123!
1
chnode2.marsnet.local
9440
default
ClickHouse123!
1
```
### 将表配置为使用 `{uuid}` 的步骤
1. 在每台服务器上配置宏
服务器 1 的示例：
```xml theme={null}
1
replica_1
```
请注意，我们为 `shard` 和 `replica` 定义了宏，但 `{uuid}` 并未在此定义——它是内置的，无需单独定义。
2. 创建数据库
```sql theme={null}
CREATE DATABASE db_uuid
ON CLUSTER 'cluster_1S_2R'
ENGINE Atomic;
```
```response theme={null}
CREATE DATABASE db_uuid ON CLUSTER cluster_1S_2R
ENGINE = Atomic
Query id: 07fb7e65-beb4-4c30-b3ef-bd303e5c42b5
┌─host──────────────────┬─port─┬─status─┬─error─┬─num_hosts_remaining─┬─num_hosts_active─┐
│ chnode2.marsnet.local │ 9440 │ 0 │ │ 1 │ 0 │
│ chnode1.marsnet.local │ 9440 │ 0 │ │ 0 │ 0 │
└───────────────────────┴──────┴────────┴───────┴─────────────────────┴──────────────────┘
```
3. 使用宏和 `{uuid}` 在集群中创建表
```sql theme={null}
CREATE TABLE db_uuid.uuid_table1 ON CLUSTER 'cluster_1S_2R'
(
id UInt64,
column1 String
)
ENGINE = ReplicatedMergeTree('/clickhouse/tables/{shard}/db_uuid/{uuid}', '{replica}' )
ORDER BY (id);
```
```response theme={null}
CREATE TABLE db_uuid.uuid_table1 ON CLUSTER cluster_1S_2R
(
`id` UInt64,
`column1` String
)
ENGINE = ReplicatedMergeTree('/clickhouse/tables/{shard}/db_uuid/{uuid}', '{replica}')
ORDER BY id
Query id: 8f542664-4548-4a02-bd2a-6f2c973d0dc4
┌─host──────────────────┬─port─┬─status─┬─error─┬─num_hosts_remaining─┬─num_hosts_active─┐
│ chnode1.marsnet.local │ 9440 │ 0 │ │ 1 │ 0 │
│ chnode2.marsnet.local │ 9440 │ 0 │ │ 0 │ 0 │
└───────────────────────┴──────┴────────┴───────┴─────────────────────┴──────────────────┘
```
4. 创建分布式表
```sql theme={null}
CREATE TABLE db_uuid.dist_uuid_table1 ON CLUSTER 'cluster_1S_2R'
(
id UInt64,
column1 String
)
ENGINE = Distributed('cluster_1S_2R', 'db_uuid', 'uuid_table1' );
```
```response theme={null}
CREATE TABLE db_uuid.dist_uuid_table1 ON CLUSTER cluster_1S_2R
(
`id` UInt64,
`column1` String
)
ENGINE = Distributed('cluster_1S_2R', 'db_uuid', 'uuid_table1')
Query id: 3bc7f339-ab74-4c7d-a752-1ffe54219c0e
┌─host──────────────────┬─port─┬─status─┬─error─┬─num_hosts_remaining─┬─num_hosts_active─┐
│ chnode2.marsnet.local │ 9440 │ 0 │ │ 1 │ 0 │
│ chnode1.marsnet.local │ 9440 │ 0 │ │ 0 │ 0 │
└───────────────────────┴──────┴────────┴───────┴─────────────────────┴──────────────────┘
```
### 测试
1. 向第一个节点插入数据 (例如 `chnode1`)
```sql theme={null}
INSERT INTO db_uuid.uuid_table1
( id, column1)
VALUES
( 1, 'abc');
```
```response theme={null}
INSERT INTO db_uuid.uuid_table1 (id, column1) FORMAT Values
Query id: 0f178db7-50a6-48e2-9a1b-52ed14e6e0f9
Ok.
1 row in set. Elapsed: 0.033 sec.
```
2. 向第二个节点插入数据 (例如，`chnode2`)
```sql theme={null}
INSERT INTO db_uuid.uuid_table1
( id, column1)
VALUES
( 2, 'def');
```
```response theme={null}
INSERT INTO db_uuid.uuid_table1 (id, column1) FORMAT Values
Query id: edc6f999-3e7d-40a0-8a29-3137e97e3607
Ok.
1 row in set. Elapsed: 0.529 sec.
```
3. 通过分布式表查看记录
```sql theme={null}
SELECT * FROM db_uuid.dist_uuid_table1;
```
```response theme={null}
SELECT *
FROM db_uuid.dist_uuid_table1
Query id: 6cbab449-9e7f-40fe-b8c2-62d46ba9f5c8
┌─id─┬─column1─┐
│ 1 │ abc │
└────┴─────────┘
┌─id─┬─column1─┐
│ 2 │ def │
└────┴─────────┘
2 rows in set. Elapsed: 0.007 sec.
```
### 备选方案
默认的复制路径可以预先通过宏定义，也可以使用 `{uuid}`
1. 在每个节点上为表设置默认值
```xml theme={null}
/clickhouse/tables/{shard}/db_uuid/{uuid}
{replica}
```
如果某些数据库使用了节点，你也可以在每个节点上定义宏 `{database}`。
2. 创建表时不显式指定参数：
```sql theme={null}
CREATE TABLE db_uuid.uuid_table1 ON CLUSTER 'cluster_1S_2R'
(
id UInt64,
column1 String
)
ENGINE = ReplicatedMergeTree
ORDER BY (id);
```
```response theme={null}
CREATE TABLE db_uuid.uuid_table1 ON CLUSTER cluster_1S_2R
(
`id` UInt64,
`column1` String
)
ENGINE = ReplicatedMergeTree
ORDER BY id
Query id: ab68cda9-ae41-4d6d-8d3b-20d8255774ee
┌─host──────────────────┬─port─┬─status─┬─error─┬─num_hosts_remaining─┬─num_hosts_active─┐
│ chnode2.marsnet.local │ 9440 │ 0 │ │ 1 │ 0 │
│ chnode1.marsnet.local │ 9440 │ 0 │ │ 0 │ 0 │
└───────────────────────┴──────┴────────┴───────┴─────────────────────┴──────────────────┘
2 rows in set. Elapsed: 1.175 sec.
```
3. 验证其是否使用了默认配置中的设置
```sql theme={null}
SHOW CREATE TABLE db_uuid.uuid_table1;
```
```response theme={null}
SHOW CREATE TABLE db_uuid.uuid_table1
CREATE TABLE db_uuid.uuid_table1
(
`id` UInt64,
`column1` String
)
ENGINE = ReplicatedMergeTree('/clickhouse/tables/{shard}/db_uuid/{uuid}', '{replica}')
ORDER BY id
1 row in set. Elapsed: 0.003 sec.
```
### 故障排查
获取表信息和 UUID 的示例命令：
```sql theme={null}
SELECT * FROM system.tables
WHERE database = 'db_uuid' AND name = 'uuid_table1';
```
获取 ZooKeeper 中上述表 (含 UUID) 信息的示例命令
```sql theme={null}
SELECT * FROM system.zookeeper
WHERE path = '/clickhouse/tables/1/db_uuid/9e8a3cc2-0dec-4438-81a7-c3e63ce2a1cf/replicas';
```
数据库必须使用 `Atomic`；如果是从早期版本升级，
`default` 数据库很可能是 `Ordinary` 类型。
检查方法如下：
例如，
```sql theme={null}
SELECT name, engine FROM system.databases WHERE name = 'db_uuid';
```
```response theme={null}
SELECT
name,
engine
FROM system.databases
WHERE name = 'db_uuid'
Query id: b047d459-a1d2-4016-bcf9-3e97e30e49c2
┌─name────┬─engine─┐
│ db_uuid │ Atomic │
└─────────┴────────┘
1 row in set. Elapsed: 0.004 sec.
```
## ClickHouse Keeper 动态重新配置
本页不适用于 [ClickHouse Cloud](https://clickhouse.com/cloud)。本文所述流程在 ClickHouse Cloud 服务中已实现自动化。
### 说明
如果启用了 `keeper_server.enable_reconfiguration`，ClickHouse Keeper 会部分支持 ZooKeeper 的 [`reconfig`](https://zookeeper.apache.org/doc/r3.5.3-beta/zookeeperReconfig.html#sc_reconfig_modifying)
命令，以实现集群的动态重新配置。
如果此设置已关闭，你可以通过手动修改副本的 `raft_configuration`
部分来重新配置集群。请确保编辑所有副本上的文件，因为只有 leader 会应用更改。
或者，你也可以通过任何兼容 ZooKeeper 的客户端发送 `reconfig` 查询。
虚拟节点 `/keeper/config` 包含最近一次已提交的集群配置，格式如下：
```text theme={null}
server.id = server_host:server_port[;server_type][;server_priority]
server.id2 = ...
...
```
* 每个 server 条目以换行符分隔。
* `server_type` 的值可以是 `participant` 或 `learner` ([learner](https://github.com/eBay/NuRaft/blob/master/docs/readonly_member.md) 不参与 leader 选举) 。
* `server_priority` 是一个非负整数，用于指定[在 leader 选举中应优先选择哪些节点](https://github.com/eBay/NuRaft/blob/master/docs/leader_election_priority.md)。
优先级为 0 表示该 server 永远不会成为 leader。
示例：
```sql theme={null}
:) get /keeper/config
server.1=zoo1:9234;participant;1
server.2=zoo2:9234;participant;1
server.3=zoo3:9234;participant;1
```
你可以使用 `reconfig` 命令来添加新服务器、移除现有服务器，以及调整现有服务器的优先级。以下是一些示例 (使用 `clickhouse-keeper-client`) ：
```bash theme={null}
# 添加两个新服务器
reconfig add "server.5=localhost:123,server.6=localhost:234;learner"
# 移除另外两个服务器
reconfig remove "3,4"
# 将现有服务器的优先级更改为 8
reconfig add "server.5=localhost:5123;participant;8"
```
以下是 `kazoo` 的示例：
```python theme={null}
# 添加两台新服务器，移除另外两台服务器
reconfig(joining="server.5=localhost:123,server.6=localhost:234;learner", leaving="3,4")
# 将现有服务器的优先级更改为 8
reconfig(joining="server.5=localhost:5123;participant;8", leaving=None)
```
`joining` 中的服务器应采用上文所述的 server 格式。各服务器条目之间应以逗号分隔。
添加新服务器时，可以省略 `server_priority` (默认值为 1) 和 `server_type` (默认值
为 `participant`) 。
如果要更改现有服务器的优先级，请将该服务器及目标优先级一起添加到 `joining` 中。
服务器主机、端口和类型必须与现有服务器配置相同。
服务器会按照它们在 `joining` 和 `leaving` 中出现的顺序添加和移除。
`joining` 中的所有更新都会先于 `leaving` 中的更新处理。
Keeper 重新配置的实现有一些注意事项：
* 仅支持增量重新配置。带有非空 `new_members` 的请求会被拒绝。
ClickHouse Keeper 的实现依赖 NuRaft API 动态更改成员关系。NuRaft 只能一次
添加一台服务器或移除一台服务器，每次只能处理一个。这意味着对配置的每次更改
(`joining` 中的每一项、`leaving` 中的每一项) 都必须单独决定。因此不提供批量
重新配置，因为这会对最终用户造成误导。
同样也无法更改服务器类型 (participant/learner) ，因为 NuRaft 不支持这一点，而
唯一的办法是先移除再添加服务器，这同样会造成误导。
* 不能使用返回的 `znodestat` 值。
* `from_version` 字段不会被使用。所有设置了 `from_version` 的请求都会被拒绝。
这是因为 `/keeper/config` 是一个虚拟节点，也就是说它不会存储在
持久化存储中，而是会针对每个请求根据指定的节点配置动态生成。
作出这一决定是为了避免数据重复，因为 NuRaft 已经存储了该配置。
* 与 ZooKeeper 不同，无法通过提交 `sync` 命令来等待集群重新配置完成。
新配置最终会生效，但不保证具体时间。
* `reconfig` 命令可能会因各种原因失败。你可以检查集群的状态，查看更新
是否已应用。
## 将单节点 keeper 转换为集群
有时需要将实验性的 keeper 节点扩展为集群。下面是将其逐步扩展为 3 节点集群的方案：
* **重要**：新增节点必须分批添加，且每批数量必须小于当前 法定人数，否则它们会自行选举出一个 leader。本例中按每次一个节点添加。
* 现有 keeper 节点必须开启 `keeper_server.enable_reconfiguration` 配置参数。
* 使用 keeper 集群的完整新配置启动第二个节点。
* 节点启动后，使用 [`reconfig`](#reconfiguration) 将其添加到节点 1。
* 然后启动第三个节点，并使用 [`reconfig`](#reconfiguration) 将其添加进来。
* 更新 `clickhouse-server` 配置，将新的 keeper 节点添加进去，然后重启以应用更改。
* 更新节点 1 的 raft 配置，并可选择重启它。
为了更好地熟悉这一过程，这里有一个 [sandbox 仓库](https://github.com/ClickHouse/keeper-extend-cluster)。
## 不支持的功能
虽然 ClickHouse Keeper 的目标是与 ZooKeeper 完全兼容，但仍有一些功能尚未实现 (不过相关开发仍在持续进行) ：
* [`create`](https://zookeeper.apache.org/doc/r3.9.1/apidocs/zookeeper-server/org/apache/zookeeper/ZooKeeper.html#create\(java.lang.String,byte%5B%5D,java.util.List,org.apache.zookeeper.CreateMode,org.apache.zookeeper.data.Stat\)) 不支持返回 `Stat` 对象
* [`create`](https://zookeeper.apache.org/doc/r3.9.1/apidocs/zookeeper-server/org/apache/zookeeper/ZooKeeper.html#create\(java.lang.String,byte%5B%5D,java.util.List,org.apache.zookeeper.CreateMode,org.apache.zookeeper.data.Stat\)) 不支持 [生存时间 (TTL)](https://zookeeper.apache.org/doc/r3.9.1/apidocs/zookeeper-server/org/apache/zookeeper/CreateMode.html#PERSISTENT_WITH_TTL)
* [`addWatch`](https://zookeeper.apache.org/doc/r3.9.1/apidocs/zookeeper-server/org/apache/zookeeper/ZooKeeper.html#addWatch\(java.lang.String,org.apache.zookeeper.Watcher,org.apache.zookeeper.AddWatchMode\)) 不支持 [`PERSISTENT`](https://zookeeper.apache.org/doc/r3.9.1/apidocs/zookeeper-server/org/apache/zookeeper/AddWatchMode.html#PERSISTENT) 监听
* 不支持 [`removeWatch`](https://zookeeper.apache.org/doc/r3.9.1/apidocs/zookeeper-server/org/apache/zookeeper/ZooKeeper.html#removeWatches\(java.lang.String,org.apache.zookeeper.Watcher,org.apache.zookeeper.Watcher.WatcherType,boolean\)) 和 [`removeAllWatches`](https://zookeeper.apache.org/doc/r3.9.1/apidocs/zookeeper-server/org/apache/zookeeper/ZooKeeper.html#removeAllWatches\(java.lang.String,org.apache.zookeeper.Watcher.WatcherType,boolean\))
* 不支持 `setWatches`
* 不支持创建 [`CONTAINER`](https://zookeeper.apache.org/doc/r3.5.1-alpha/api/org/apache/zookeeper/CreateMode.html) 类型的 znode
* 不支持 [`SASL 身份验证`](https://cwiki.apache.org/confluence/display/ZOOKEEPER/Zookeeper+and+SASL)