refactor CHPA hierarchy SQL

2026-08-20 18:22:16 +08:00
commit 3f3dc443da
5 changed files with 592 additions and 0 deletions
@@ -0,0 +1,54 @@
+# REFACTOR-MA
+
+Databricks 数仓 SQL 重构仓库。
+
+## 首批 review 范围
+
+本批次只重构原 `CHPA/01` 中两个层级维表脚本：
+
+- `sql/chpa/01_dwd/01_dwd_ims_atc_hierarchy.sql`
+- `sql/chpa/01_dwd/02_dwd_ims_nfc_hierarchy.sql`
+
+工作区 `CHPA/` 下的原脚本保持不变，便于逐项对照。
+
+## 兼容性决策
+
+首批代码继续写入现有物理表：
+
+- `dwd.dwd_ims_atc_hierarchy`
+- `dwd.dwd_ims_nfc_hierarchy`
+
+这样不会立即影响 pack property 和 DWS 等现有下游任务。推荐的新表名及迁移规则记录在 `docs/sql_refactoring_standard.md`；是否执行物理改名，待本批 review 后决定。
+
+## 目录结构
+
+```text
+RE/
+|-- README.md
+|-- docs/
+|   `-- sql_refactoring_standard.md
+|-- sql/
+|   `-- chpa/
+|       `-- 01_dwd/
+|           |-- 01_dwd_ims_atc_hierarchy.sql
+|           `-- 02_dwd_ims_nfc_hierarchy.sql
+`-- validation/
+    `-- chpa/
+        `-- 01_dwd/
+            `-- validate_hierarchy_refactor.sql
+```
+
+## 执行顺序
+
+1. 在覆盖目标表前运行 `validation/chpa/01_dwd/validate_hierarchy_refactor.sql`。
+2. 核对两个 `DESCRIBE TABLE` 结果；兼容性检查必须全部返回 `passed = true`。
+3. review 重复路径和未匹配层级指标，确认它们符合现有业务口径。
+4. 通过后，按文件名前缀顺序执行 `sql/chpa/01_dwd/` 中的重构脚本。
+
+两个重构脚本都要求现有 DWD 源表、目标表已经创建。
+
+## 本次 review 重点
+
+1. 表命名模型是否适用于整个数仓。
+2. 物理表改名采用兼容视图还是一次性联动下游。
+3. 替换调度任务前，在 Databricks 中对比新旧结果的行数、业务键重复数和空键数。