文档中心
v3.4

SequoiaDB 简介

安装部署

数据库实例

分布式引擎

SAC 管控中心

参考手册

常见问题及解答(FAQ)

版本信息

listLobs()

名称

listLobs - 列举集合中的大对象

语法

db.collectionspace.collection.listLobs([SdbQueryOption])

类别

SdbCollection

描述

该函数用于获取集合中的大对象列表。

参数

SdbQueryOption( Object选填 )

使用一个对象来指定记录查询参数,使用方法可参考 SdbQueryOption

Note:

当用户使用 SdbQueryOption 指定 hint 为{"ListPieces": 1}时,可以获取 Lob 详细的分片信息。

返回值

函数执行成功时,将返回一个 DBCursor 类型的对象。

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

错误

listLobs() 函数常见异常如下:

错误码 错误类型 描述 解决方法
-6 SDB_INVALIDARG 参数错误 查看参数是否填写正确
-34 SDB_DMS_CS_NOTEXIST 集合空间不存在 检查集合空间是否存在
-23 SDB_DMS_NOTEXIST 集合不存在 检查集合是否存在

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

版本

此函数适用于 v2.0 及以上版本,其中 v3.2 及以上版本支持通过输入参数获取指定的大对象。

示例

  • 列举 sample.employee 中所有的大对象

    > db.sample.employee.listLobs()
    {
       "Size": 2,
       "Oid": {
         "$oid": "00005d36c8a5350002de7edc"
       },
       "CreateTime": {
         "$timestamp": "2019-07-23-16.43.17.360000"
       },
       "ModificationTime": {
         "$timestamp": "2019-07-23-16.43.17.508000"
       },
       "Available": true,
       "HasPiecesInfo": false
     }
     {
       "Size": 51717368,
       "Oid": {
         "$oid": "00005d36cae8370002de7edd"
       },
       "CreateTime": {
         "$timestamp": "2019-07-23-16.52.56.278000"
       },
       "ModificationTime": {
         "$timestamp": "2019-07-23-16.52.56.977000"
       },
       "Available": true,
       "HasPiecesInfo": false
    }
    Return 2 row(s).
  • 列举 sample.employee 中 Size 大于 10 的大对象

    > db.sample.employee.listLobs( SdbQueryOption().cond( { "Size": { $gt: 10 } } ) )
    {
       "Size": 51717368,
       "Oid": {
         "$oid": "00005d36cae8370002de7edd"
       },
       "CreateTime": {
         "$timestamp": "2019-07-23-16.52.56.278000"
       },
       "ModificationTime": {
         "$timestamp": "2019-07-23-16.52.56.977000"
       },
       "Available": true,
       "HasPiecesInfo": false
    }
    Return 1 row(s).
回到顶部