文档中心

关于 SequoiaDB

快速入门

安装

基本操作

数据模型

SQL引擎

S3引擎

系统架构

数据库管理

连接器

驱动

参考手册

故障排除

SAC 管控中心

Web服务

版本信息

traceStatus()

名称

traceStatus - 查看当前程序跟踪的状态

语法

db.traceStatus()

描述

开启数据库引擎跟踪功能后,用户可使用该函数查看当前程序跟踪的状态。

参数

返回值

函数执行成功时,将通过游标(cursor)方式返回当前程序跟踪状态,返回的字段信息如下:

参数名 参数类型 参数描述
TraceStarted Boolean 跟踪是否开始
"true":跟踪开始
"false":跟踪未开始
Wrapped Boolean 跟踪文件是否翻转
"true":已翻转
"false":未翻转
Size Int64 跟踪文件大小
FreeSize Int64 可用内存大小
Mask String 所跟踪的模块,模块说明可参考 SdbTraceOption 的 conponent 参数
BreakPoint String 所跟踪的函数断点
Threads Int32 线程号
ThreadTypes String 线程类型,类型说明可参考 SdbTraceOption 的 threadTypes 参数
FunctionNames String 所跟踪的函数名

函数执行失败时,将抛异常并输出错误信息。

错误

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

版本

v2.0 及以上版本

示例

  • 开启数据库引擎程序跟踪的功能

    > db.traceOn( 100, new SdbTraceOption().components( "dms" ).functionNames( "_dmsStorageUnit::insertRecord"    ).threadTypes( "RestListener" ) )
  • 查看当前程序跟踪的状态

    > db.traceStatus()
    {
     "TraceStarted": true,
     "Wrapped": false,
     "Size": 104857600,
     "FreeSize": 104857600,
     "PadSize": 0,
     "Mask": [
       "dms"
     ],
     "BreakPoint": [],
     "Threads": [],
     "ThreadTypes": [
       "RestListener"
     ],
     "FunctionNames": [
       "_dmsStorageUnit::insertRecord"
     ]
    }
回到顶部