• list()
    • 语法
    • 参数描述
    • 返回值
    • 错误
    • 示例

    list()

    语法

    db.list( <listType>, [cond], [sel], [sort] )

    枚举列表,列表是一种轻量级得到当前系统状态的命令。查看更多有关列表信息。

    参数描述

    参数名参数类型描述是否必填
    listType枚举列表类型。
    condJson 对象设置匹配条件以及命令位置参数。
    selJson 对象选择返回的字段名。为 null 时,返回所有的字段名。
    sortJson 对象对返回的记录按选定的字段排序。1为升序;-1为降序。

    Note:

    • listType 字段的值请参考列表类型。
    • sel 参数是一个json结构,如:{字段名:字段值},字段值一般指定为空串。sel中指定的字段名在记录中存在,设置字段值不生效;不存在则返回sel中指定的字段名和字段值。
    • 记录中字段值类型为数组,我们可以在sel中指定该字段名,用"."操作符加上双引号("")来引用数组元素。

    返回值

    返回游标对象,出错抛异常,并输出错误信息,可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。关于错误处理可以参考常见错误处理指南。

    错误

    常见错误可参考错误码。

    示例

    • 指定 listType 的值为 SDB_LIST_CONTEXTS:
    1. > db.list( SDB_LIST_CONTEXTS )
    2. {
    3. "NodeName": "ubuntu-200-043:11850",
    4. "SessionID": 29,
    5. "TotalCount": 1,
    6. "Contexts": [
    7. 254
    8. ]
    9. }
    • 指定 listType 的值为 SDB_LIST_STORAGEUNITS:
    1. > db.list( SDB_LIST_STORAGEUNITS )
    2. {
    3. "NodeName": "ubuntu-200-043:11830",
    4. "Name": "foo",
    5. "UniqueID": 61,
    6. "ID": 4094,
    7. "LogicalID": 186,
    8. "PageSize": 65536,
    9. "LobPageSize": 262144,
    10. "Sequence": 1,
    11. "NumCollections": 1,
    12. "CollectionHWM": 1,
    13. "Size": 306315264
    14. }
    • 返回符合条件 LogicalID 大于1的记录,并且每条记录只返回 Name 和 ID 这两个字段,记录按 Name 字段的值升序排序
    1. > db.list( SDB_LIST_STORAGEUNITS, { "LogicalID": { $gt: 1 } }, { Name: "", ID: "" }, { Name: 1 } )
    2. {
    3. "Name": "foo",
    4. "ID": 4094
    5. }
    • 指定命令位置参数,只返回数据组 db1 的 context:
    1. > db.list( SDB_LIST_CONTEXTS, { GroupName: "db1" } )
    2. {
    3. "NodeName": "ubuntu-200-043:20000",
    4. "SessionID": 29,
    5. "TotalCount": 1,
    6. "Contexts": [
    7. 254
    8. ]
    9. }