投影

概述

在 AIR 中，投影是一种核心的查询加速数据表，旨在提升明细查询和聚合查询的性能。系统在执行查询时，会自动识别并匹配可用的投影数据，直接读取预处理结果，从而跳过部分计算过程，显著降低查询耗时。

点击导航栏中“数据整合”下的“投影”，即可进入投影管理页面。投影_image_1.png

支持基于基础视图和逻辑视图创建投影，下文以逻辑视图为例创建投影。点击“视图”，选择单个视图后，选择“投影”tab，再点击“新建投影”

投影_image_8

新建投影包含基础配置和高级配置，具体说明见下文

投影_image_9

基础配置包含基础信息和投影配置两部分。

投影_image_10

1）基础信息说明如下

投影类型
明细投影：用于加速明细查询（SELECT 明细字段）
聚合投影：用于加速统计分析（GROUP BY + 聚合函数，如 SUM/COUNT/MAX/MIN）
实时投影：用于加速对实时/高频更新数据的查询（数据到达后快速可查），适用于对时效性要求高的场景（如分钟级看板、实时监控、实时明细检索等）
投影名称
支持中英文数字下划线，长度为3~256个字符
建议命名规则：业务_表名_投影类型_用途（例如：sales_order_detail_detail_list / sales_order_agg_by_day_store）
创建后立即启用
勾选后，新建投影默认处于启用状态，可立即参与查询加速
未勾选则为未启用状态，需要后续手动启用后才生效
调度方式
自动更新：根据上游数据变化自动触发投影更新
手动更新：手动点击按钮触发投影更新（适用于低频更新或临时验证场景）
自定义：按照自定义的时间和数据变化触发更新（适用于需要特定刷新时间/频率的场景）
调度周期：与基础视图的调度周期相同
依赖强弱
强依赖：基于该投影和上游投影的数据周期判断是否进行更新。当上游所有任务都完成目标周期（或更细粒度）的数据更新后，该任务才会执行
弱依赖：不校验数据周期的一致性（只要触发条件满足即可执行）

2）“投影配置-明细投影”说明如下

投影_image_11

3）“投影配置-聚合投影”说明如下

投影_image_12

支持设置增量配置和下推写入配置

投影_image_13

1）增量配置说明如下：

示例-INSERT（增量数据追加写入）

投影_image_14

示例-MERGE（合并写入）

投影_image_15

配置项
增量类型：MERGE
增量字段：选择用于标识增量的字段（示例：C_CUSTKEY）
MERGE 条件：填写合并规则（WHEN MATCHED / WHEN NOT MATCHED 等）
错误数据处理：
- 继续插入：MERGE ON 条件匹配不上时将插入数据
- 忽略：MERGE ON 条件匹配不上时跳过此条数据
填写说明（可参考示例）
- ON 条件为主键/唯一键关联条件（示例：ON t.id = s.id）。
WHEN MATCHED 中的多个条件会按顺序匹配并执行
可按业务需要在 WHEN MATCHED 中编写 UPDATE / DELETE 行为，在 WHEN NOT MATCHED 中编写 INSERT 行为。