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()