traceFmt()

语法

traceFmt(<formatType>,<input>,<output>)

类别

Global

描述

将 db.traceOff() 导出来的 trace 文件格式化为用户可读的内容,并输出到指定文件。

参数

  • formatType ( Int32必填 )

    traceFmt输出两种信息:

    0:输出分析文件,包含线程的执行序列( flw 文件)、函数的执行时间分析( CSV 文件)、执行时间峰值( except 文件)、 trace 记录错误信息( error 文件);

    1:输出 dump 记录信息( fmt 文件);

    Note:

    CSV 文件可以使用 Excel 软件查看

  • input ( String必填 )

    db.traceOff() 导出来的二进制文件。

  • output ( String必填 )

    输出的目标文件。

返回值

成功:无返回值。

失败:抛出异常。

错误

traceFmt()函数常见异常如下:

错误码错误类型可能的原因解决方法
-3SDB_PERM权限错误检查输入、输出文件路径是否存在权限问题
-4SDB_FNE文件不存在检查输入文件是否存在
-6SDB_INVALIDARG参数错误检查输入的类型是否正确
-189SDB_PD_TRACE_FILE_INVALID输入的trace文件不合法确认输入的文件是否合法

如果出错则抛异常,并输出错误信息,可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。 关于错误处理可以参考常见错误处理指南

版本

v1.0及以上版本。

示例

  • 解析二进制文件

    1. > traceFmt( 0, "/opt/sequoiadb/trace.dump", "/opt/sequoiadb/trace_output" )
  • 查看当前程序跟踪的状态可参考traceStatus()

    1. > db.traceStatus()