KeeperMap
这个引擎允许您将 Keeper/ZooKeeper 集群用作一致的键值存储,支持线性可写和顺序一致的读取。
要启用 KeeperMap 存储引擎,您需要使用 <keeper_map_path_prefix>
配置定义存储表的 ZooKeeper 路径。
例如:
其中路径可以是任何其他有效的 ZooKeeper 路径。
创建表
引擎参数:
root_path
- 存储table_name
的 ZooKeeper 路径。
该路径不应包含由<keeper_map_path_prefix>
配置定义的前缀,因为前缀会自动附加到root_path
。
此外,支持auxiliary_zookeeper_cluster_name:/some/path
格式,其中auxiliary_zookeeper_cluster
是在<auxiliary_zookeepers>
配置中定义的 ZooKeeper 集群。
默认情况下,使用在<zookeeper>
配置中定义的 ZooKeeper 集群。keys_limit
- 表中允许的键的数量。
此限制是一个软限制,在某些边缘情况下,表中可能会有更多键。primary_key_name
– 列表中的任何列名。- 必须指定
primary key
,它仅支持主键中的一列。主键将在 ZooKeeper 中以二进制形式序列化为node name
。 - 除主键外的列将按相应顺序序列化为二进制,并存储为由序列化键定义的结果节点的值。
- 带有键
equals
或in
过滤的查询将优化为从Keeper
中进行多键查找,否则将获取所有值。
示例:
使用
每个值,作为 (v1, v2, v3)
的二进制序列化,将存储在 Keeper
中的 /keeper_map_tables/keeper_map_table/data/serialized_key
内。
此外,键的数量将有一个软限制为 4。
如果在同一 ZooKeeper 路径上创建多个表,则值将保持持久,直到至少有 1 个表在使用它。
因此,在创建表时可以使用 ON CLUSTER
子句,并共享来自多个 ClickHouse 实例的数据。
当然,可以在不相关的 ClickHouse 实例上手动运行具有相同路径的 CREATE TABLE
,以获得相同的数据共享效果。
支持的操作
插入
当新行插入到 KeeperMap
时,如果键不存在,将为该键创建一个新条目。
如果键存在,并且设置 keeper_map_strict_mode
被设置为 true
,则抛出异常,否则,键的值将被覆盖。
示例:
删除
可以使用 DELETE
查询或 TRUNCATE
删除行。
如果键存在,并且设置 keeper_map_strict_mode
被设置为 true
,则仅在能够以原子方式执行时,获取和删除数据才会成功。
更新
可以使用 ALTER TABLE
查询更新值。主键无法更新。
如果设置 keeper_map_strict_mode
被设置为 true
,则仅在以原子方式执行时,获取和更新数据才会成功。