编辑表

“编辑表”用于维护基础视图（PDS）的表级配置，包括分区字段、下推、并行拉取，以及当前视图和下游视图的投影默认更新配置。

操作入口

操作前需具备目标表的编辑权限。下文以数据库表的通用编辑窗口为例；部分配置项会根据数据源类型及表的能力显示或禁用。API、文件和飞书等类型可能进入专用编辑表单，参见本文末尾的相关操作。

配置项	说明
表名称	展示当前表名，只读，不能在此重命名
分区字段	为基础视图指定用于分区识别和更新的字段。已从源端采集到的系统分区字段不可在此修改；允许维护的自定义分区字段可以选择或清空。此处配置不会在源数据库创建或修改物理分区
下推	设置当前表是否允许将可下推的查询计算交给源端执行。选择“与数据源配置相同”继承数据源设置；“支持”或“不支持”指定表级设置。实际能否下推还取决于数据源及查询算子的能力

“下推”控制查询计算的执行位置。投影构建中的“下推写入”还需要在源端写入临时结果表，须另行满足写账号等条件，见数据源的下推与写账号配置和投影下推写入。

编辑表的基础信息与手动并行拉取配置

并行拉取用于提高从源表读取数据的效率。在支持该配置的读取路径中，例如 Spark 通过 JDBC 读取数据库表，AIR 根据分批字段划分读取范围，再由多个读取任务并行获取数据，供查询或投影构建使用。

例如，以数值字段 p_promo_sk 作为分批字段、分批数量设置为 4，引擎可根据字段取值范围组织多批读取。分批数量表示读取任务的划分数量，不是每批读取的行数，也不会把源表拆成多张表。实际同时执行的任务数还受引擎资源、源端连接限制和数据分布影响。

拉取方式	配置与用途
自动推荐	使用系统根据源表元数据得到的分批字段和数量。存在推荐结果时，页面会展示结果；没有推荐结果时，不应据此认为已经启用有效的并行读取
手动配置	自行指定“分批字段”和“分批数量”，适合已了解字段分布并需要控制读取批次的表
无	清除本表的分批字段和数量，不通过本项配置指定并行拉取；不代表整个查询或构建任务都只有一个执行线程

从“手动配置”切换到“自动推荐”或“无”会清除原先手动填写的分批参数。自动推荐结果与元数据采集有关；保存后可重新打开窗口核对当前配置和推荐结果。

优先选择取值分布较均匀、便于按范围读取的字段。字段值集中在少数范围时，各批读取量可能相差很大；字段的最大值与最小值相同时，无法通过范围划分获得有效并行度。增加分批数量会增加源端并发读取压力，应结合源端可用连接和负载逐步调整。

这些配置用途不同，不要求使用同一个字段。PDS 的并行拉取读取源表；下推写入中的分批读取针对源端临时结果表，需要在投影配置中设置。仅配置 PDS 并行拉取不需要为源端新增写账号。

本区域的配置作为当前基础视图和下游视图的投影默认配置。设置后还需检查具体投影采用的调度方式和更新配置，不能仅凭此处设置判断投影已经创建或完成更新。

编辑表中的增量更新、周期调度、数据周期和过期时间

全量更新：按全量方式更新投影数据。
增量更新：按更新字段识别需要处理的数据范围。选择后，需在下方选择更新字段；支持数值及日期／时间等可用类型，具体以列表为准。对于已有分区字段的表，更新字段可能由分区字段确定并锁定。该选项是否可用取决于表的能力。

对于按水位识别变化的增量更新，新增或变更的数据应产生更大的更新字段值。首次构建、增量范围、更新写入模式及多表场景见投影增量构建；业务示例见投影增量构建最佳实践。

选择“是”后，设置按小时、日、周或月执行的周期及对应时间；选择“否”则不在此配置周期调度。是否由手动操作、依赖变化或其他方式触发，需结合具体投影的调度配置判断，见投影。

支持此项的表可选择“无”“日”或“月”，表示数据所对应的时间粒度。“数据周期”用于下游投影的周期继承及强依赖更新判断，与多久执行一次的“周期调度”不同。

下游投影自动继承上游最细的数据周期，例如上游分别为“日”和“月”时，下游使用“日”。采用强依赖时，还会检查上游是否存在满足目标周期的成功更新记录。依赖配置见投影的调度与依赖说明。

过期设置影响投影数据的可用性，不会删除源表数据，也不能替代周期调度。应结合数据时效要求和更新频率设置，避免投影长期未更新或反复过期。

保存后重新打开“编辑表”，确认分区字段、下推、拉取方式及投影更新配置符合预期。涉及增量更新或读取并发时，再检查相关投影的更新记录和数据结果；具体入口见投影。

现象	检查方向
无法编辑或部分选项不可选	当前账号的编辑权限、数据源类型、表的能力，以及字段是否由源端分区定义
手动分批找不到目标字段	字段类型是否符合要求，元数据是否已更新；Oracle 仅提供数值分批字段
自动推荐没有展示字段或数量	是否已有元数据推荐结果；需要明确控制批次时可在确认字段适用后使用手动配置
配置后读取没有明显加速	执行引擎与读取路径、字段分布、数据量、源端负载及可用连接数
增量更新遗漏变化	更新字段是否能识别本次变化，视图和投影是否保留了所需增量字段