• traceFmt()
    • 语法
    • 类别
    • 描述
    • 参数
    • 返回值
    • 错误
    • 版本
    • 示例

    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文件不合法确认输入的文件是否合法

    当异常抛出时，可以通过getLastError()获取错误码，或通过getLastErrMsg()获取错误信息。可以参考常见错误处理指南了解更多内容。

    版本

    v1.0及以上版本。

    示例

    • 解析二进制文件
    1. > traceFmt( 0, "/opt/sequoiadb/trace.dump", "/opt/sequoiadb/trace_output" )
    • 查看当前程序跟踪的状态可参考traceStatus()
    1. > db.traceStatus()