跳到主要内容

元事件删除工具

最近更新 2026/11/11

一、简介​

元事件删除工具 event_del_full 用于删除指定项目中一个或多个事件的 全部历史数据及事件定义 ,同时删除事件与属性的关联关系、关联超事件的定义及其属性关联关系。属性定义本身保留。

本工具适用于需要完整移除事件数据和事件定义的场景,不支持按时间范围或其他条件只删除部分数据。

注意

删除操作不可撤销,请提前确认删除范围,并按需备份数据。删除事件不会停止该事件的上报;如果后续仍有数据上报或补传,事件及其数据可能再次出现。

二、使用说明​

2.1 操作前准备​

本说明适用于已部署二次开发工具的私有化环境。操作前,请准备目标项目的 appid 和待删除的事件名,并确认以下事项:

  • 已停止目标事件的数据上报,并检查是否还有待处理或补传的数据。
  • 已确认删除对相关分析、报表及关联超事件的影响。
  • 如需停止 ETL(数据处理服务),已安排合适的操作时间。停止 ETL 可能影响其他项目的数据处理。

如果不确定当前环境是否支持该指令,或无法确认上述影响,请先联系管理员或技术支持。

2.2 启动工具​

登录已安装并配置好二次开发工具的服务器,使用具备运行权限的账号执行命令。使用 ta 账号的部署环境,可在 root 登录后先执行 su - ta,再启动工具:

ta-tool event_del_full

启动时无需附加参数,按提示输入即可。在等待输入的阶段,可输入 quit 退出工具;开始删除后的取消方式见“3.3 中途取消”。

2.3 填写 appid 并确认项目​

工具提示“请输入要操作的appId”,输入目标项目的 appid。校验通过后,工具显示项目名称,请仔细核对,并输入 y 继续;输入其他内容取消操作。

如果提示“不存在与您输入相对应的项目,请核对appid参数”,请核对 appid 后重新执行命令。

2.4 输入待删除的事件名​

工具提示“请输入要删除的事件名,多个事件使用逗号(,)分割”。此处填写上报使用的 事件名(key),不是显示名 。

多个事件可使用英文逗号 , 或中文逗号 , 分隔,例如:

draw_card, gold_get

重复输入的事件名会自动去重;未输入有效事件名时,工具会要求重新输入。

2.5 确认删除内容​

工具会展示项目名称、待删除的事件列表及删除范围,并要求 连续两次确认 。核对无误后,两次均输入 y 继续;任一次输入其他内容都会取消操作。

2.6 选择是否停止 ETL​

工具提示是否停止 ETL 后执行删除?<y/n> >:

  • 输入 y: 先停止 ETL,再执行删除,结束时自动尝试恢复 ETL。暂停期间,相关节点上的数据处理会受到影响,影响范围可能包含其他项目。
  • 输入 n: 不停止 ETL,继续进入风险确认。必须保证执行期间没有相关事件数据上报;确认满足条件后输入 y 继续,输入其他内容取消。
  • 输入其他内容: 取消操作。

K8s(容器化)环境必须选择停止 ETL。 如果选择不停止,工具会提示不支持并退出,需要重新执行命令。

停止 ETL 不等于停止客户端上报,也不会清除尚未处理的数据。因此,无论选择哪种方式,都应先完成上报和补传检查。

2.7 等待执行并查看结果​

确认完成后,工具会检查事件和环境状态,等待必要的后台同步任务结束,再逐个删除事件。任一待删除事件不存在时,本次任务会在开始删除前终止。

执行期间会显示各事件的删除进度,结束后输出成功和失败的事件数量及列表。请以这些列表核对删除结果;中途取消时,还需核对是否有尚未处理的事件。

工具会根据所选方式自动请求刷新缓存或尝试恢复 ETL,无需手动调用。请等待命令退出,并检查是否有后续错误提示。 事件显示删除成功,不代表数据处理服务已恢复成功。 如提示缓存刷新或 ETL 恢复失败,请保留终端输出并联系管理员或技术支持。

三、注意事项​

3.1 删除范围与关联影响​

内容处理方式
指定事件的全部历史数据,含更新事件数据删除,不区分时间范围
指定事件的定义及其与属性的关联关系删除
关联超事件的定义及其与属性的关联关系删除
属性定义保留
用户数据、项目信息及项目成员不删除
未指定事件的数据及事件定义不直接删除;共享超事件可能受到影响

如果多个事件关联同一个超事件,删除其中一个事件也可能删除共享的超事件定义和属性关联关系,影响其他事件的使用。存在此类关联时,请先联系管理员或技术支持确认影响。

工具不会自动调整引用被删事件的分析、报表等配置,请提前检查,并在删除后按需修改。

3.2 常见提示与处理方式​

提示或现象处理方式
需要后台数据同步任务结束后,执行删除工具会自动等待并重试。若长时间没有进展,请联系管理员或技术支持检查。
运维人员在执行运维操作,该期间禁止执行元数据修改相关操作待运维操作结束后再执行;如不确定当前状态,请联系管理员。
项目中不存在事件核对项目 appid 和事件名,确认填写的不是显示名,且该事件尚未被删除。
等待锁期间事件元数据已发生变化,本次删除已取消重新核对项目内的事件及关联关系,确认删除范围后再执行。
部分事件删除失败,请检查日志保留失败事件列表和错误信息,排查后按“3.4 删除失败后的处理”操作。

3.3 中途取消​

开始执行后,如需取消,可按一次 Ctrl+C 请求停止,并等待工具完成后续清理。 取消不会恢复已经删除的数据 ,正在处理的事件也可能已被部分删除。

请勿连续按 Ctrl+C 或强制结束进程,以免影响 ETL 的恢复。取消后若出现服务恢复失败等提示,请保留终端输出并联系管理员或技术支持。

3.4 删除失败后的处理​

单个事件删除失败后,工具通常会继续处理后续事件。失败事件可能已完成部分数据删除,已完成的删除不会自动恢复。

请先保留成功、失败事件列表及错误信息,联系管理员或技术支持排查。重试时,仅输入确认仍需删除且仍存在的事件;不要直接重复提交包含已成功删除事件的完整列表,否则可能因事件不存在而终止。

如果事件均已删除成功,仅缓存刷新或 ETL 恢复失败,应处理相应的服务问题,无需重复删除事件。

这篇文档对你有帮助吗?