文档中心

关于 SequoiaDB

快速入门

安装

基本操作

数据模型

SQL引擎

S3引擎

系统架构

数据库管理

连接器

驱动

参考手册

故障排除

SAC 管控中心

Web服务

版本信息

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()函数常见异常如下:

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

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

版本

v1.0及以上版本。

示例

  • 解析二进制文件

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

    > db.traceStatus()
回到顶部