Эх сурвалжийг харах

docs(kb/30): §4.2 加 jobs backfill SQL 命名规范(链 ADR-11)

jobs/{层}/{域}/{表}_backfill.sql 可复用补数任务流, 与日调度同目录
后缀区分; 仅业务时间分区 dwd 事件表需要。§4.6 速查表同步。
kb/92 changelog 补 5-28 行并修正其错位顺序。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
tianyu.chu 2 долоо хоног өмнө
parent
commit
de9d2726c4

+ 2 - 1
kb/30-开发规范.md

@@ -358,6 +358,7 @@ manual/ddl/
 
 - **简单表** — `jobs/{layer}/{domain}/{表名}.sql` 一个文件顶到底(单次 `INSERT OVERWRITE`,可带 `WITH` CTE)
 - **多步表** — `jobs/{layer}/{domain}/{表名}/{表名}-{NN}-{描述}.sql`,序号三位,`99` 固定留给最终 `INSERT OVERWRITE` 目标表那一步。DS 工作流对应 N 个 task 节点按序号链式依赖
+- **补数 SQL** — `jobs/{layer}/{domain}/{表名}_backfill.sql`,与日调度同目录、`_backfill` 后缀区分;仅业务时间分区的 dwd 事件表需要(raw_ods / dim 走 DS COMPLEMENT_DATA)。设计见 `93-架构决策.md` ADR-11
 
 所有 `.sql` 只写 `INSERT OVERWRITE` / `INSERT INTO`,**不写 CREATE TABLE**(表由 `manual/ddl/` 保证已存在)。
 
@@ -465,7 +466,7 @@ jobs/ads/trd/
 | `manual/ddl/{layer}/{domain}/` | `.sql` | `{表名}_create.sql`(首次) 或 `{yyyymmdd}_{表名}_{change}.sql`(ALTER) | DDL 唯一来源;首次建表用 `CREATE TABLE IF NOT EXISTS`,后续 ALTER 带日期前缀 |
 | `manual/ddl/tmp/{目标表名}/` | `.sql` | `tmp_{目标表名}_{NN}_create.sql` | 多步表的单目标加速中间表 DDL |
 | `jobs/raw/{domain}/` | `.ini`(DataX)或 `.sql`(CSV 导入) | `{目标表名}.ini` 或 `{目标表名}.sql` | DataX 采集或 CSV 导入任务定义 |
-| `jobs/{ods\|dwd\|dws\|tdm}/{domain}/` | `.sql` | **简单表**:`{目标表名}.sql`;**多步表**:子目录 `{目标表名}/{目标表名}-{NN}-{描述}.sql`(`99` 为最终 insert) | 每日 `INSERT OVERWRITE` 计算,详见 §4.2 |
+| `jobs/{ods\|dwd\|dws\|tdm}/{domain}/` | `.sql` | **简单表**:`{目标表名}.sql`;**多步表**:子目录 `{目标表名}/{目标表名}-{NN}-{描述}.sql`(`99` 为最终 insert);**补数**:`{目标表名}_backfill.sql`(仅业务时间分区 dwd 事件表)| 每日 `INSERT OVERWRITE` 计算,详见 §4.2 |
 | `jobs/ads/{domain}/` | `.sql` + `.ini` | **简单表**:`{ads 表名}.sql` + `{ads 表名}__{db_type}_{instance}.ini`;**多步**:`{ads 表名}/{ads 表名}-{NN}-{描述}.sql` + 同级目录放 ini | 产出 + 导出;同一张 ads 表扇出多下游时各一份 ini |
 | `manual/backfill/` | `.sql` | `{yyyymmdd}_{表名}_history.sql` | 一次性历史回刷脚本 |
 | `manual/imports/{yyyymmdd}/` | `.ini` / `.sql` | `{任务描述}.ini` 或 `.sql` | 一次性入仓任务(离线硬盘、历史 dump、外部 CSV 等),按执行日期归档 |

Файлын зөрүү хэтэрхий том тул дарагдсан байна
+ 0 - 0
kb/92-重构进度.md


Энэ ялгаанд хэт олон файл өөрчлөгдсөн тул зарим файлыг харуулаагүй болно