架构与系统设计 / 系统课时
租户数据导出注销
租户数据导出注销
租户注销不是一条 DELETE 语句,而是一条可审计、可撤销到明确节点的数据处理链路。本课将设计数据导出、保留期、逻辑删除和物理清理流程,并给出可验证的最小 SQL 示例。
学习目标
- 规划租户注销前的数据导出范围与交付方式
- 设计保留期、逻辑删除和物理清理的状态流转
- 使用审计、校验和幂等机制保证注销过程可追踪
注销前先明确数据边界
导出范围应按业务域列出,而不是直接打包整库。常见内容包括租户资料、用户与角色、业务单据、账务记录、配置、操作日志和附件索引。平台级字典、共享模板、系统密钥和其他租户数据不得进入导出包。
| 数据类型 | 建议格式 | 关键要求 |
|---|---|---|
| 结构化业务数据 | CSV 或 JSON | 保留字段说明、时区和金额单位 |
| 账务与审计数据 | CSV | 只读导出,附生成时间和校验值 |
| 文件与图片 | 原文件加清单 | 清单记录文件名、大小和哈希 |
| 配置数据 | JSON | 排除密钥明文和平台级配置 |
导出包应加密存储,并设置短期下载凭证。系统还要记录导出申请人、审批人、生成时间、下载次数和文件校验值,防止“已生成但无法证明内容未被替换”。
设计可撤销的注销流程
注销流程至少包含申请、停止新增、生成导出包、进入保留期、物理清理和完成六个阶段。只有在保留期结束且没有法律、财务或争议保留要求时,才能执行物理删除。

推荐状态可以定义为 ACTIVE、EXPORTING、RETENTION、PURGING 和 PURGED。进入 RETENTION 后,租户在线业务应保持关闭,但管理员仍可查看导出进度或在规则允许时撤销注销。
用逻辑删除承接保留期
逻辑删除用于让在线查询立即看不到租户数据,同时保留恢复和审计能力。物理清理则应由后台任务分批执行,按子表到主表、附件到索引的顺序删除,避免外键冲突和长事务。
下面示例展示从正常状态进入保留期,再在保留期结束后物理清理的最小过程,可在 MySQL 8.0 中运行。
CREATE TABLE tenant_archive_demo (
tenant_id BIGINT PRIMARY KEY,
tenant_name VARCHAR(64) NOT NULL,
status VARCHAR(16) NOT NULL,
deleted_at DATETIME NULL,
purge_after DATETIME NULL
);
INSERT INTO tenant_archive_demo
(tenant_id, tenant_name, status, deleted_at, purge_after)
VALUES
(1001, 'Demo Tenant', 'ACTIVE', NULL, NULL);
UPDATE tenant_archive_demo
SET status = 'RETENTION',
deleted_at = '2026-08-01 00:00:00',
purge_after = '2026-08-31 00:00:00'
WHERE tenant_id = 1001
AND status = 'ACTIVE';
SELECT tenant_id, status, deleted_at, purge_after
FROM tenant_archive_demo
WHERE tenant_id = 1001;
DELETE FROM tenant_archive_demo
WHERE tenant_id = 1001
AND status = 'RETENTION'
AND purge_after <= '2026-09-01 00:00:00';
SELECT ROW_COUNT() AS affected_rows;预期结果:
tenant_id | status | deleted_at | purge_after
1001 | RETENTION | 2026-08-01 00:00:00 | 2026-08-31 00:00:00
affected_rows
1生产环境不能只删除租户主表。清理任务应先根据 tenant_id 统计各业务表待删数量,再分批删除明细、关联记录和主数据;每批提交后记录游标和影响行数,失败时从最近检查点继续。
处理保留期与例外数据
保留期应由合同、财务、合规和业务恢复需求共同确定,不能由开发人员随意写死。支付凭证、发票、审计日志或争议相关数据可能需要更长保留时间,这类数据应转入受限归档区,而不是继续暴露在在线业务库中。
注销申请撤销时,只允许从明确的可恢复阶段回退。已经开始物理清理后,系统应拒绝恢复请求,避免部分表已删除、部分表已恢复的破坏性状态。
验收注销结果
完成物理清理后,应同时验证在线接口、数据库、对象存储、搜索索引、缓存和消息系统。验收重点不是“主表查不到”,而是所有以租户标识分区的副本都已清理或进入合法归档。
最终审计记录至少保存注销申请编号、导出包校验值、保留期起止时间、各清理任务结果和批准人。审计记录本身应脱离租户业务数据保存,避免随租户数据一起被删除。
本课总结
- 注销流程应先导出、再进入保留期,最后执行可审计的分批物理清理
- 逻辑删除负责立即隔离在线访问,物理清理负责在保留条件满足后真正释放数据
- 清理验收必须覆盖数据库、文件、缓存、索引和消息副本,不能只检查租户主表
下一课预告
下一课将继续处理租户级配置的发布与变更控制,重点关注配置版本、灰度生效和回滚机制。