审批、执行、gh-ost 调优与 result_unknown 核验
本手册面向审批人(Team Lead / DBA)与执行人,详细说明工单审批、水印查看 SQL、手动/预约执行、MySQL 进程内 gh-ost 18 项参数调优以及断网异常的人工核验流程。

1. 审批人日常操作(/approvals/changes)
- 在左侧点击 工单审批(
/approvals/changes),页面通过 SSE 实时刷新待你处理的工单,并提供 我已审批(是/否) 过滤列。 - 点击工单行进入
/approvals/orders/:id(审批上下文视图,避免一人同时是提交人和审批人时误点撤回)。 - 查看 SQL 明文(带水印 Reveal):
- 默认页面只展示元数据与冻结的 AI 预审发现(
has_sql: true)。 - 点击 查看 SQL 原文 后触发带审计记录的 Reveal,SQL 展示区会自动叠加
你的用户名 + 时间戳 + Trace ID水印。
- 默认页面只展示元数据与冻结的 AI 预审发现(
- 核对 AI 预审建议与冻结阶段信息后,提交三种决策之一:
- 通过(
approve):当前级按any_one(任一通过)或all_must_approve(全员通过)流转到下一级;全部通过后工单进入approved(待执行)。 - 退回修改(
request_changes):写明修改意见,研发可在原工单直接改 SQL 重跑预审后再提交。 - 拒绝(
reject):终态驳回,整单关闭。
- 通过(
为什么管理员也改不了已提交工单的审批人?
Yearning v4 实行提交即冻结:审批链、数据源身份、执行人与预审快照在提交瞬间全部锁定。任何角色(含内置 admin)都无法转交、加签、跳级或代执行。如原审批人离职或休假,请提交人撤回原单,待管理员更新流程模板后重新提交。
2. 执行人操作:立即执行 vs. 预约执行
审批全部通过后,系统绝不会自动落库。仅当前阶段的冻结执行人打开工单详情页可操作:
- 立即执行:点击 执行,系统立刻获取目标数据源的单库排他执行租约(同一时刻同数据源仅允许 1 笔工单运行,避免并发锁冲突返回
3001)并开始执行。 - 预约执行:选择未来的执行时间(需落在
/admin/settings/execution配置的每周允许执行时段内)。到点后调度器在 15 分钟宽限窗口 内自动复核前置条件并执行一次;错过窗口(3009)或数据源不可用时不补跑,须执行人重新确认。
3. MySQL 大表在线改表:进程内 gh-ost 18 项参数调优
当系统设置 execution.osc.tool = gh-ost 且目标库为原生 MySQL 5.7 / 8.0、工单为 ALTER TABLE 时,点击 执行 弹窗会出现 ddl_execution_mode 选择框:
online_ddl:直接走 MySQL 原生ALTER TABLE(适合小表或瞬间完成的ALGORITHM=INSTANT加列)。gh_ost:调用 Go 进程内嵌的gh-ost无锁改表引擎(无需安装外部二进制,pt-osc已彻底退役),页面实时显示拷贝百分比与 ETA。
生产大表推荐调优参数(支持在 /admin/settings/execution 配默认值,执行时按单覆写)
4. 遇网络闪断出现 result_unknown 怎么处理?(DBA 标准 SOP)
如果在数据库 COMMIT 瞬间发生网络断开、数据库切换或 Pod 重启,Yearning v4 严禁自动重试(防止重复更新/插入数据),而是将工单置为 result_unknown(3005 EXECUTION_RESULT_UNKNOWN)。
冻结执行人必须按以下 3 步人工核验:
- 只读核查目标库真实状态:通过只读查询或 DBA 终端核对表结构(
SHOW CREATE TABLE/\d)或受影响数据行,确认上次提交究竟是已落盘还是已回滚。 - 在工单详情页点击「核验执行结果」:
- 填写必填的 核验证据说明(例如
已核查 prod-mysql 表 core.orders,字段 risk_score 已存在且与目标定义一致;留空会报3012)。 - 选择 确认成功(
confirm_succeeded) 或 确认失败(confirm_failed)。
- 填写必填的 核验证据说明(例如
- 收敛后续动作:
- 选「确认成功」:状态变为
succeeded(永久保留「人工核验」审计标识),多阶段工单自动激活下一阶段。 - 选「确认失败」:状态变为
failed,点击 复制为新草稿 重新走预审与审批后执行。
- 选「确认成功」:状态变为