跳到主要内容
版本:3.x

任务错误码及解决方案

如果遇到任务异常,您可以通过任务的监控页面的底部查看相关日志信息,针对常见的问题,Tapdata Cloud 将其固化为特定的错误码方便您查找,同时提供了错误原因及其解决方案。

10001

错误码描述:客户端连接被服务端关闭,原因:

  • 服务端手动关闭了连接。
  • 服务端连接数过多,自动关闭或者拒绝了后续连接。

10002

错误码描述:用户名或者密码错误,原因:

  • 填写错误。
  • 密码中含有特殊字符。

解决方案

  • 尝试重新填写密码,并进行连接测试。
  • 尝试换一个没有特殊字符的密码,并反馈给技术支持解决。

10003

错误码描述:该错误发生在启动增量阶段,启动起始点在源库日志中已经不存在,大部分情况起始点为时间或者源库的日志 ID。对于大部分数据库,增量功能是基于数据库的日志文件实现的,引擎通过监听或者主动读取数据库日志文件,完成增量的读取阶段。

所以在读取前,引擎需要在日志中,依据起始点找到监听或者读取日志文件的具体位置,无法在日志文件中找到位置时,则会导致错误,原因:

  • 源库执行了日志文件的人工或定时清理。
  • 如果是增量任务,任务设置中\"增量采集开始时刻\",设置错误,或者时区与数据库时区不匹配导致的错误。
  • 增量速度过慢,导致延迟过大,此时源库的写入覆盖了最旧的日志,比如 MongoDB 的 Oplog,可以尝试调大日志空间,或者排查增量速度过慢的原因。

解决方案

  • 重置任务后再次启动,此时任务会重新初始化并顺利进入增量阶段
  • 重置任务后,将任务改为增量模式,设置增量起始时间后,再次启动任务。该方案需要人工的在源库中查询出最早的日志时间,确保设置的增量起始点包含在日志文件中,否则会丢失一部分增量数据。

10004

错误码描述:读取数据时,缺失了相应权限,原因:

  • 使用的数据连接中的用户,没有相应的读取权限。
  • 部分数据库,增量读取所需的权限较多,请查看创建数据源右侧的说明,确认权限是否设置正确。

10005

错误码描述:写入数据时,缺失了相应权限。

解决方案:检查目标节点所使用的数据连接中用户名是否缺失了写入权限。

10006

错误码描述:写入的数据类型与数据库实际的字段类型不一致,原因:

  • 运行任务前,目标表名在数据库中已存在,Tapdata 则不会自动创建该表,可能原有的表中字段存在与源表不一致的情况。
  • 源库是非结构化数据库,目标为结构化数据库,比如 MongoDB 同步到 Oracle,源端的某一个字段可能有多个类型,而目标结构化数据库一个字段不允许多个类型写入,会导致该错误。
  • 同步过程中,加入了计算节点,如js处理器,导致数据在处理节点类型变化,触发了该错误。

解决方案

  • 参考下方报错信息,比对出错的字段在源库和目标库的类型是否一致,如果不一致,使用数据库的DDL或类似命令进行修正后,再次运行任务。
  • 使用 JS 处理节点,将出错字段过滤,如出错字段为 field1,对应的 JS 为\"record.remove('field1')\"。
  • 如果用 JS 处理节点对数据类型进行了改动,则应在 JS 编辑框的下方,按照模型语法,将新的类型传递给 Tapdata,删除目标表后,再次运行任务。

10007

错误码描述:写入的数据长度与数据库实际的字段长度不一致,原因:

  • 运行任务前,目标表名在数据库中已存在,Tapdata 则不会自动创建该表,可能原有的表中字段存在与源表不一致的情况。
  • 源库是非结构化数据库,目标为结构化数据库,比如 MongoDB 同步到 Oracle,字符串类型在 MongoDB 中并没有固定长度限制,而 Oracle 在创建表的时候需要指定长度。此时可能导致超出长度的报错。
  • 同步过程中,加入了计算节点,如js处理器,导致数据在处理节点变化,触发了该错误。

解决方案

  • 参考下方报错信息,找到出错的字段,使用数据库的DDL或类似命令进行修正后,再次运行任务。
  • 使用 JS 处理节点,将出错字段过滤,如出错字段为 field1,对应的 JS 为\"record.remove('field1')\"。
  • 如果用 JS 处理节点对数据类型进行了改动,则应在 JS 编辑框的下方,按照模型语法,将新的类型传递给 Tapdata,删除目标表后,再次运行任务。

10008

错误码描述:写入数据时,违反了唯一约束,原因:目标表的唯一索引或主键与源表不一致。

解决方案

  • 使用数据库的 DDL 或类似命令,修改目标表的主键或唯一索引后,再次尝试启动任务。
  • 删除目标表,让 Tapdata 的自动建表功能重新创建表,再次尝试启动任务。
  • 在 Tapdata 的任务编辑界面,将目标表的并发写入关闭,再次尝试启动任务。

10009

错误码描述:写入数据时,违反了非空约束,原因:

  • 目标表的字段非空约束与源表不一致。
  • 使用了 JS 处理节点,在同步过程中将某些字段值设置为空,同时目标表中,该字段又是非空约束。

解决方案

  • 使用数据库的DLL或类似命令,去除目标表的非空约束后,再次尝试启动任务。
  • 检查 JS 逻辑,是否错误的将数据值改为了空或删除了报错字段。

11001

错误码描述:未知错误。

解决方案:联系技术支持解决。

11002

错误码描述:日志挖掘任务,将单条日志数据写入外部持久缓存失败,原因:外部缓存配置的数据库无法提供正常的服务。

解决方案:在挖掘任务监控界面,找到外部缓存的配置。检查该配置的数据库是否正常。

13001

错误码描述:未知错误。

解决方案:联系技术支持解决。

13002

错误码描述:无法从日志数据获取正确的操作类型。

解决方案:查看详细的报错信息,其中op字段为空值或不存在,则代表数据可能已经被破坏,需要检查对应的日志挖掘任务是否出现错误。

13003

错误码描述:更新数据日志事件,更新后数据是空值或不存在。

13004

错误码描述:日志事件中,源表名为空或不存在

13005

错误码描述:元数据操作日志事件,操作的具体内容为空或不存在。

13006

错误码描述:日志事件为空。

13007

错误码描述:日志事件中,缺失操作类型属性。

13008

错误码描述:日志事件中,缺失断点信息。

13009

错误码描述:删除数据日志事件,删除数据是空值或不存在。

13010

错误码描述:写入数据日志事件,写入数据是空值或不存在。