---
name: kd-ksql
description: >
  生成与审查金蝶 Cosmic 体系 KSQL/SQL 数据修复脚本。
  Use when: 数据修复、批量更新、回填、备份回滚、表字段映射确认、SQL lint。
  Do not use when: 写 Java 插件（ok-cosmic）；企业版未确认库表前硬套 Cosmic 规则；通用方言开发（sql/mysql 等）。
---

# 金蝶 KSQL 数据修复

产出数据库脚本，不生成 Java。细则：[references/ksql-datafix.md](references/ksql-datafix.md)、[references/details.md](references/details.md)

## When / Do not

**Use when**：Cosmic/星瀚/套件数据修复 SQL/KSQL。  
**Do not use when**：插件开发；表结构未验证；跨库策略未确认。

## Input / Output

| Input | Output |
|-------|--------|
| 产品线、目标单据/表/字段、操作类型、条件与新值 | 确认卡片 + 查询/备份/更新/回滚脚本 或 待确认清单 |

## Steps

```
- [ ] 1. 确认 Cosmic 体系与库类型（默认 PostgreSQL 语法除非另有证据）
- [ ] 2. 只读连库/元数据验证表名、字段 dbKey/dbName、枚举
- [ ] 3. 多表 dbName 一致性检查；跨库先确认策略
- [ ] 4. 先 SELECT 影响范围，再备份，再 UPDATE/DELETE
- [ ] 5. review（kd-ksql-rules）或人工高风险检查
- [ ] 6. 交付脚本 + 执行顺序 + 回滚
```

## 失败策略

| 失败 | 动作 |
|------|------|
| 字段/表未验证 | 只输出待确认项，不给最终 SQL |
| 跨库未策略 | 不生成普通跨库 UPDATE |
| lint ERROR | 修到通过再交付 |

## 验证

- 影响行数查询、备份表名、时间戳、WHERE 完整性、回滚可用性