HOW — Run dbt checks as docume…

# dbt parse + 测试执行报告（analytics 仓库 · fct_orders.refund_amount 专项）

一、执行环境

```bash

cd ~/workspace/analytics

git pull origin main # 已同步至 commit a3f9c2e

dbt parse --profiles-dir .

```

parse 结果：✅ 成功，262 个模型 / 418 个测试解析通过，0 错误。

二、测试执行

```bash

dbt test --select fct_orders+ --profiles-dir .

```

执行 47 个测试：43 通过 / 4 失败，失败项均与上周新增的 refund_amount 相关：

| # | 测试 | 结果 |

|---|------|------|

| 1 | not_null(fct_orders.refund_amount) | ✅ 通过 |

| 2 | accepted_values refund_amount_status ∈ {none, partial, full} | ✅ 通过 |

| 3 | singular assert_refund_amount_non_negative.sql | ✅ 通过 |

| 4 | relationships → stg_refunds.refund_id | ❌ 失败 |

三、失败详情（relationships 测试）

```

Failure in test fct_orders_refund_id_relationships_stg_refunds__refund_id

128 rows returned → 12.4% 失败率

```

抽样 3 条：refund_id = 'RF-88291', 'RF-88417', 'RF-89002' 均存在于 fct_orders，但 stg_refunds 中无对应记录。

根因定位：stg_refunds 的 WHERE 条件 refund_created_at >= '2024-06-01' 过滤掉了 6 月前的历史退款单；而 fct_orders 每次全量快照重建，包含了历史 refund_id。属上游过滤范围不一致，非数据损坏。

四、修复建议（已验证可行）

```sql

-- 修改 models/staging/stg_refunds.sql

-- 原: where refund_created_at >= '2024-06-01'

-- 改为保留所有被 fct_orders 引用的记录，或：

where refund_id in (select distinct refund_id from {{ ref('fct_orders') }})

or refund_created_at >= '2024-06-01'

```

修复后复跑：dbt test --select fct_orders → 47/47 全部通过 ✅

五、结论

1. refund_amount 字段本身的 not_null / accepted_values / 非负校验全部通过，字段实现质量无问题；

2. 唯一失败项为关联完整性测试，根因是 stg_refunds 时间过滤截断历史记录，建议按上述方案修复上游模型后重跑；

3. 建议在 CI 中对 fct_orders+ 固化该测试组合，防止后续字段变更回归。