文档

关于 SequoiaDB

快速入门

安装

基本操作

数据模型

SQL引擎

FileSystem引擎

S3引擎

系统架构

数据库管理

连接器

驱动

参考手册

SequoiaDB Shell方法

概述

Global

Sdb

SecureSdb

SdbCS

SdbCollection

SdbCursor

SdbQuery

SdbReplicaGroup

SdbNode

SdbDomain

Oma

File

FileContent

Cmd

Remote

Hash

IniFile

Sdbtool

Ssh

System

辅助类型对象

特殊类型对象

操作符

SQL语法

SQL to SequoiaDB 映射表

限制

错误码

故障排除

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()
回到顶部