跳到主要内容
跳到主要内容

Redis

Not supported in ClickHouse Cloud

此引擎允许将 ClickHouse 与 Redis 集成。由于 Redis 采用键值(kv)模型,我们强烈建议您仅以点方式查询,如 where k=xxwhere k in (xx, xx)

创建表

引擎参数

  • host:port — Redis 服务器地址,您可以忽略端口,默认 Redis 端口为 6379。
  • db_index — Redis 数据库索引范围为 0 到 15,默认值为 0。
  • password — 用户密码,默认值为空字符串。
  • pool_size — Redis 最大连接池大小,默认值为 16。
  • primary_key_name - 列表中的任意列名。
序列化

PRIMARY KEY 仅支持一个列。主键将以二进制形式序列化为 Redis 键。 主键以外的列将按相应顺序以二进制形式序列化为 Redis 值。

参数也可以使用 命名集合 传递。在这种情况下,hostport 应该分别指定。推荐在生产环境中采用这种方法。目前,所有通过命名集合传递给 redis 的参数都是必需的。

过滤

使用 key equalsin filtering 的查询将优化为从 Redis 查找多个键。如果没有过滤键的查询将会导致全表扫描,这是一个重操作。

使用示例

使用 Redis 引擎和普通参数在 ClickHouse 中创建一个表:

或者使用 命名集合:

插入:

查询:

更新:

请注意,主键不能被更新。

删除:

截断:

异步刷新 Redis 数据库。Truncate 还支持 SYNC 模式。

连接:

与其他表连接。

限制

Redis 引擎还支持扫描查询,例如 where k > xx,但它有一些限制:

  1. 在非常罕见的情况下,扫描查询可能会产生一些重复的键,当它正在进行重新哈希时。详情请参阅 Redis Scan
  2. 在扫描过程中,可能会创建和删除键,因此结果数据集可能无法表示一个有效的时间点。