SequoiaDB 简介 
安装部署
数据库实例
分布式引擎
SAC 管控中心
参考手册
常见问题及解答（FAQ）
版本信息
getLobDetail - 获取大对象被读写访问的详细信息
db.collectionspace.collection.getLobDetail(<oid>)
SdbCollection
该函数用于获取集合中的大对象被读写访问的详细信息。
| 参数名 | 参数类型 | 描述 | 是否必填 |
|---|---|---|---|
| oid | string | 大对象的唯一描述符。 | 是 |
函数执行成功时，将返回一个 BSONObj 类型的对象。通过该对象获取大对象被读写访问的详细信息列表。
函数执行失败时，将抛异常并输出错误信息。
大对象被读写访问的详细信息格式为：
| 字段名 | 描述 |
|---|---|
| Oid | 大对象的唯一描述符。 |
| AccessInfo | 被读写访问的详细信息。 |
| ContextID | 本次操作的上下文标识。 |
其中 AccessInfo 的详细信息格式为：
| 字段名 | 描述 | 说明 |
|---|---|---|
| RefCount | 大对象当前被引用的总个数。 | RefCount 为 ReadCount, WriteCount, ShareReadCount 之和。 |
| ReadCount | 大对象当前被以只读模式打开的个数。 | |
| WriteCount | 大对象当前被以写模式打开的个数。 | 以读写模式打开的计数也计算在此项。 |
| ShareReadCount | 大对象当前被以共享读模式打开的个数。 | getLobRuntimeDetail 命令本身会增加一次 ShareReadCount |
| LockSections | 记录大对象中被加锁的区域，以及进行加锁操作的上下文标识。 | 可以通过该项查看大对象是被哪些上下文持有锁。S 为读锁；X 为写锁 |
当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。
列取 00005deb85c5350004743b09 的 lob 当前被访问的详细信息
> db.sample.employee.getLobDetail('00005deb85c5350004743b09')
{
"Oid": "00005deb85c5350004743b09",
"AccessInfo": {
"RefCount": 3,
"ReadCount": 0,
"WriteCount": 1,
"ShareReadCount": 2,
"LockSections": [
{
"Begin": 10,
"End": 30,
"LockType": "X",
"Contexts": [
11
]
},
{
"Begin": 30,
"End": 50,
"LockType": "S",
"Contexts": [
12
]
}
]
},
"ContextID": 14
}
展开
