大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:ADMIN SKIP COMMITTED TRANSACTION

· 52CE 我爱测

强制 abort 一个在存算分离(lake)表上卡在 状态的事务:通过一次"no-op publish" 推进分区的可见版本——丢弃该事务的数据贡献,但仍写出一份不含该事务任何数据变更的新 tablet 元数据文件,让分区版本号正常前进。

ADMIN SKIP COMMITTED TRANSACTION

强制 abort 一个在存算分离(lake)表上卡在 COMMITTED 状态的事务:通过一次"no-op publish" 推进分区的可见版本——丢弃该事务的数据贡献,但仍写出一份不含该事务任何数据变更的新 tablet 元数据文件,让分区版本号正常前进。

这是面向运维的 应急通道,用于解除 publish 队列因 txnlog 丢失、segment / SST 数据文件丢失或对象存储故障而永久卡死的情况。它会丢弃事务的数据,仅在正常重试无法恢复时使用,并优先于更具破坏性的恢复路径(如 drop partition)。

Abort 一个已经 COMMITTED 的事务是不可逆的,会导致该事务的数据丢失。事务记录仍会被标记为 VISIBLE(以保持分区版本序列完整),但其内部携带一个 no-op publish 的标记用于审计。

执行此操作需要 SYSTEM 级别的 OPERATE 权限。可参考 GRANT 授权。

语法

ADMIN SKIP COMMITTED TRANSACTION <txn_id> [REASON '<text>']

参数

参数 是否必填 说明
txn_id 是 事务的数字 ID。可通过 SHOW TRANSACTION 或 FE 日志获取。
REASON '<text>' 否 abort 的原因,自由文本,写入 FE 审计日志。强烈建议填写,便于事后复盘。

限制(第一期)

  1. 该功能需要 FE 配置打开。FE config enable_admin_skip_committed_txn 为 false 时该语句会被拒绝并报错(默认 false,避免误操作)。打开方式:

    ADMIN SET FRONTEND CONFIG ("enable_admin_skip_committed_txn" = "true");
    

    恢复操作完成后请立即关闭。

  2. 事务必须处于 COMMITTED 状态。处于 PREPARED 的事务会自动按 timeout 超时,或者通过各导入类型自带的取消方式中止 —— 例如 broker / spark / routine load 用 CANCEL LOAD,stream load 用 POST /api/transaction/rollback。已经 VISIBLE 的事务无法撤销。

  3. 仅支持开启了 file_bundling=true 的存算分离(cloud-native)表。file_bundling 模式下分区元数据由 aggregator 一次原子写出,no-op publish 要么对整个分区生效要么完全不生效。未开启 file_bundling 的表存在 partial-publish 中间状态风险,会在入口处被拒绝。

  4. 当前版本仅支持导入和 lake-compaction 类型的事务。Alter / schema-change 类型的事务暂不支持,会报错。

行为

  1. FE 校验事务状态、来源类型和涉及的表是否符合限制。
  2. FE 将 no-op publish 标记写入事务并落盘到 edit log。
  3. 下一轮 publish daemon tick 时,FE 把该标记通过 publish RPC 传给 BE。
  4. BE 在事务目标版本写出一份 tablet 元数据文件,内容等于 base 版本(不含该事务的数据变更)。file_bundling 下由 aggregator 保证分区原子。
  5. 分区可见版本推进到事务的目标版本,后续事务可以正常 publish。
  6. 该事务最终状态记为 VISIBLE,但携带 no-op publish 标记便于审计。

竞态处理:如果原 publish RPC 恰好先成功,事务会按正常流程标 VISIBLE,标记变成 no-op(数据反而保住了)。FE 日志会记录这一结果。

审计

SHOW PROC '/transactions/<db_name>/finished' 在末尾追加了两列:

  • NoOpPublish:true/false,标识该事务最终落盘时是否走了 no-op publish 路径
  • NoOpPublishReason:ADMIN SKIP COMMITTED TRANSACTION 语句里 REASON 的内容

事后复盘时通过这两列就能确认 abort 是否真的生效,以及当时填写的原因。

示例

  1. 找到卡死的事务:

    SHOW PROC '/transactions/<db_name>/running';
    
  2. 打开开关:

    ADMIN SET FRONTEND CONFIG ("enable_admin_skip_committed_txn" = "true");
    
  3. Abort 卡死的事务:

    ADMIN SKIP COMMITTED TRANSACTION 12345 REASON 'OSS 上 txnlog 文件丢失,手动恢复';
    
  4. 再次关闭开关:

    ADMIN SET FRONTEND CONFIG ("enable_admin_skip_committed_txn" = "false");
    

相关命令

  • SHOW TRANSACTION —— 查询事务状态。
  • ADMIN REPAIR —— 当元数据无法恢复时把 lake 分区回滚到一个历史可用版本;本命令不适用时的更激进备选。

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。