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

投影

投影以优化查询执行的格式存储数据,该功能对于以下情况非常有用:

  • 在不属于主键的列上运行查询
  • 预聚合列,这将减少计算和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] - 从磁盘删除投影文件而不删除描述。实现为 突变

ADDDROPCLEAR 命令是轻量级的,因为它们仅更改元数据或删除文件。

此外,它们是复制的,通过 ClickHouse Keeper 或 ZooKeeper 同步投影元数据。

备注

仅支持对具有 *MergeTree 引擎的表(包括 复制的 变体)进行投影操作。