# MySQL复制延迟只读证据卡 V1.0

卡片：`SQL-MY-08`

## 用途

在MySQL复制延迟、接收线程或应用线程异常时，先形成一行不含主机、端口、账号、通道、GTID、binlog位点、错误文本、SQL或业务对象的实例级聚合证据。

## 已验证范围

- MySQL 8.0.46、8.4.10；
- 双节点异步复制隔离环境；
- 正常复制、停止接收、停止应用、配置延迟、合成冲突、恢复；
- 普通账号权限不足明确失败；
- 连续执行列合同稳定；
- 单行12列输出。

## 未验证范围

- MySQL 5.7；
- 组复制或多源复制；
- 云厂商托管限制；
- 生产环境或客户环境；
- 具体复制根因；
- 自动切换、跳日志、重建或修复。

## 使用步骤

1. 由负责人确认MySQL版本、拓扑、只读窗口和Performance Schema可见性；
2. 使用仅对三个复制状态表具有`SELECT`权限的账号；
3. 设置客户端超时，建议5秒；
4. 保存CSV、执行时间、版本和相邻时间窗；
5. 结合业务新鲜度、变更记录和受控错误详情决定下一步。

## 输出解释

| 字段组 | 可以说明什么 | 不能说明什么 |
|---|---|---|
| receiver状态 | 复制接收线程当前是否运行 | 网络、权限、源端或人为停止中的具体根因 |
| applier状态 | 复制应用当前是否运行 | 具体事务、对象或业务影响 |
| worker错误单位 | 是否存在应用worker异常计数 | 错误原文和修复方式 |
| configured delay | 是否存在配置或剩余延迟 | 业务数据一定过期 |
| ready | 聚合线程状态未发现本卡定义的异常 | 业务新鲜度、读取路径或下游报表一定正确 |

## 禁止事项

- 不扩大业务库、复制控制或管理权限；
- 不公开端点、账号、通道、GTID、binlog位点、错误原文、SQL或业务对象；
- 不因本卡结果自动停止/启动复制、跳日志、重建副本、切换主从或修改参数；
- 本卡是分流证据，不是根因证明或生产变更授权。

## 文件

- `mysql-replication-delay-readonly-v1.0.sql`
- `mysql-replication-delay-sample-v1.0.csv`
- `mysql-replication-delay-evidence-flow-v1.0.svg`
- `mysql-replication-delay-assets-v1.0.json`