system.hypothetical_projections - ClickHouse Documentation

描述

列出当前 session 中定义的所有假设性 (what-if) projection。参见 CREATE HYPOTHETICAL PROJECTION 和 EXPLAIN WHATIF。其内容的作用域限定在 session 级别：每个 connection 只能看到自身的假设性 projections；若当前 session 中尚未创建任何此类 projection，该表为空。当前的 (database, table) 会在 query time 通过 UUID 解析，因此能够反映 RENAME TABLE 的结果，并自动隐藏已 drop 表所对应的 entries。

列

database (String) — 数据库名称
table (String) — 表名
name (String) — PROJECTION 名称
type (Enum8(‘Normal’ = 0, ‘Aggregate’ = 1)) — PROJECTION 类型
sorting_key (Array(String)) — PROJECTION 的排序键
query (String) — PROJECTION 的 SELECT 查询；对于 INDEX … TYPE … 形式则为空
definition (String) — 按原始书写形式给出的完整 PROJECTION 声明
settings (Map(String, String)) — 来自 WITH SETTINGS 的 PROJECTION 设置

示例

CREATE HYPOTHETICAL PROJECTION p_by_b ON t (SELECT a, b ORDER BY b);
SELECT name, type, sorting_key FROM system.hypothetical_projections;

┌─name───┬─type───┬─sorting_key─┐
│ p_by_b │ Normal │ ['b']       │
└────────┴────────┴─────────────┘

另请参阅

最后修改于 2026年9月28日