投影
投影以优化查询执行的格式存储数据,该功能对于以下情况非常有用:
- 在不属于主键的列上运行查询
- 预聚合列,这将减少计算和IO
您可以为一个表定义一个或多个投影,在查询分析期间,ClickHouse将选择扫描数据最少的投影,而不会修改用户提供的查询。
投影将在内部创建一个新的隐藏表,这意味着将需要更多的IO和磁盘空间。 例如,如果投影定义了不同的主键,则原始表中的所有数据将被复制。
您可以在这个 页面 查看有关投影如何在内部工作的更多技术细节。
示例:不使用主键的过滤
创建表:
使用 ALTER TABLE
,我们可以向现有表添加投影:
插入数据:
投影将允许我们快速按 user_name
进行过滤,即使在原始表中 user_name
并未定义为 PRIMARY_KEY
。
在查询时,ClickHouse 确定如果使用该投影,将处理更少的数据,因为数据是按 user_name
排序的。
要验证查询是否使用了投影,我们可以查看 system.query_log
表。在 projections
字段中,我们可以看到所使用的投影名称,或者如果没有使用则为空:
示例:预聚合查询
使用投影创建表:
插入数据:
我们将执行一个第一次使用 GROUP BY
的查询,使用 user_agent
字段,该查询将不使用定义的投影,因为预聚合不匹配。
要使用投影,我们可以执行选择部分或全部预聚合和 GROUP BY
字段的查询。
如前所述,我们可以查看 system.query_log
表。在 projections
字段中,我们可以看到所使用的投影名称,或者如果没有使用则为空:
操作投影
以下操作适用于 投影:
ADD PROJECTION
ALTER TABLE [db.]name [ON CLUSTER cluster] ADD PROJECTION [IF NOT EXISTS] name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] )
- 向表元数据添加投影描述。
DROP PROJECTION
ALTER TABLE [db.]name [ON CLUSTER cluster] DROP PROJECTION [IF EXISTS] name
- 从表元数据中删除投影描述并从磁盘删除投影文件。实现为 突变。
MATERIALIZE PROJECTION
ALTER TABLE [db.]table [ON CLUSTER cluster] MATERIALIZE PROJECTION [IF EXISTS] name [IN PARTITION partition_name]
- 查询在分区 partition_name
中重建投影 name
。实现为 突变。
CLEAR PROJECTION
ALTER TABLE [db.]table [ON CLUSTER cluster] CLEAR PROJECTION [IF EXISTS] name [IN PARTITION partition_name]
- 从磁盘删除投影文件而不删除描述。实现为 突变。
ADD
、DROP
和 CLEAR
命令是轻量级的,因为它们仅更改元数据或删除文件。
此外,它们是复制的,通过 ClickHouse Keeper 或 ZooKeeper 同步投影元数据。
仅支持对具有 *MergeTree
引擎的表(包括 复制的 变体)进行投影操作。