resetSnapshot()

语法

db.resetSnapshot( [options] )

重置快照。主要针对一些统计信息，比如TotalDataRead、TotalDataWrite等。它的作用是清空之前的统计，重新开始统计。

参数描述

参数名参数类型描述是否必填
optionsJson 对象设定快照类型、会话号、命令位置参数否

  1. options 格式

    属性名描述默认值格式
    Type指定重置的快照类型。取值：
    “sessions”
    “sessions current”
    “database”
    “health”
    “collections”
    “all”    		“all”Type: “sessions”
    SessionID指定重置的会话ID。所有会话SessionID: 1
    CollectionSpace指定需要重置快照统计信息的集合空间名称，字符串类型。空CollectionSpace : “foo”
    Collection指定需要重置快照统计信息的集合名称，字符串类型。需要为集合全名。空Collection : “foo.bar”
    Location Elements命令位置参数所有节点GroupName:”db1”

    Note:

    • Type: “all” 表示重置所有快照。
    • SessionID 字段只在 Type: “sessions” 才生效。
    • CollectionSpace 字段和 Collection 字段只在 Type : “collections” 时生效；CollectionSpace 字段和 Collection 字段不能同时指定；Collection 字段和 CollectionSpace 字段不指定时为清空所有所有集合的快照统计信息。

  2. 重置项

    快照类型重置项
    sessions“TotalDataRead”，”TotalIndexRead”，”TotalDataWrite”，”TotalIndexWrite”
    “WriteTimeSpent”，”ResetTimestamp”，”LastOpType”，”LastOpBegin”
    “TotalRead”，”TotalReadTime”，”TotalWriteTime”，”ReadTimeSpent”
    “LastOpEnd”，”LastOpInfo”，”ReadTimeSpent”，”WriteTimeSpent”
    “TotalUpdate”，”TotalDelete”，”TotalInsert”，”TotalSelect”
    sessions current与”sessions”重置项相同
    database“totalDataRead”，”totalIndexRead”，”totalLobRead”，”TotalDataWrite”
    “svcNetOut”，”totalReadTime”，”totalWriteTime”，”resetTimestamp”
    “TotalIndexWrite”，”totalLobWrite”，”totalUpdate”，”totalDelete”
    “totalInsert”，”totalSelect”，”totalRead”，”receiveNum”
    “replUpdate”，”replInsert”，”replDelete”，”svcNetIn”
    health“ErrNum”:{“SDB_OOM”，”SDB_NOSPC”，”SDB_TOO_MANY_OPEN_FD”}
    collections“TotalDataRead”，”TotalIndexRead”，”TotalDataWrite”，”TotalIndexWrite”
    “TotalUpdate”，”TotalDelete”，”TotalInsert”，”TotalSelect”
    “TotalRead”，”TotalWrite”，”TotalTbScan”，”TotalIxScan”
    “ResetTimestamp”
    all除了重置上述所有的项，还包括：
    “totalTime”，”totalContexts”

返回值

无返回值，出错抛异常，并输出错误信息。可以通过 getLastErrObj() 或 getLastErrMsg() 获取错误信息 或 通过 getLastError() 获取错误码。

关于错误处理可以参考常见错误处理指南。

示例

  • 重置 SessionID 为22的快照。

    重置前：

    1. >db.snapshot(SDB_SNAP_CONTEXTS,{"SessionID":22})
    2. {
    3. "NodeName": "u1604-nzb:31820",
    4. "SessionID": 22,
    5. "TID": 11076,
    6. "Status": "Waiting",
    7. "Type": "ShardAgent",
    8. "Name": "Type:Shard,NetID:1,R-TID:12930,R-IP:192.168.20.53,R-Port:11810",
    9. "QueueSize": 0,
    10. "ProcessEventCount": 32,
    11. "RelatedID": "c0a814352e2200003282",
    12. "Contexts": [
    13.     200
    14. ],
    15. "TotalDataRead": 27577,
    16. "TotalIndexRead": 0,
    17. "TotalDataWrite": 0,
    18. "TotalIndexWrite": 0,
    19. "TotalUpdate": 0,
    20. "TotalDelete": 0,
    21. "TotalInsert": 0,
    22. "TotalSelect": 27577,
    23. "TotalRead": 27577,
    24. "TotalReadTime": 0,
    25. "TotalWriteTime": 0,
    26. "ReadTimeSpent": 0,
    27. "WriteTimeSpent": 0,
    28. "ConnectTimestamp": "2019-06-20-13.55.52.646730",
    29. "ResetTimestamp": "2019-06-20-13.55.52.646730",
    30. "LastOpType": "GETMORE",
    31. "LastOpBegin": "--",
    32. "LastOpEnd": "2019-06-20-14.20.22.223637",
    33. "LastOpInfo": "ContextID:200, NumToRead:-1",
    34. "UserCPU": 0.38,
    35. "SysCPU": 0.29
    36. }

    重置快照：

    1. > db.resetSnapshot({Type : "session", SessionID: 22})
    2. Takes 0.001436s.

    重置后：

    1. >db.snapshot(SDB_SNAP_CONTEXTS,{"SessionID":22})
    2. {
    3. "NodeName": "u1604-nzb:31820",
    4. "SessionID": 22,
    5. "TID": 11076,
    6. "Status": "Waiting",
    7. "Type": "ShardAgent",
    8. "Name": "Type:Shard,NetID:1,R-TID:12930,R-IP:192.168.20.53,R-Port:11810",
    9. "QueueSize": 0,
    10. "ProcessEventCount": 32,
    11. "RelatedID": "c0a814352e2200003282",
    12. "Contexts": [
    13.     200
    14. ],
    15. "TotalDataRead": 0,
    16. "TotalIndexRead": 0,
    17. "TotalDataWrite": 0,
    18. "TotalIndexWrite": 0,
    19. "TotalUpdate": 0,
    20. "TotalDelete": 0,
    21. "TotalInsert": 0,
    22. "TotalSelect": 0,
    23. "TotalRead": 0,
    24. "TotalReadTime": 0,
    25. "TotalWriteTime": 0,
    26. "ReadTimeSpent": 0,
    27. "WriteTimeSpent": 0,
    28. "ConnectTimestamp": "2019-06-20-13.55.52.646730",
    29. "ResetTimestamp": "2019-06-20-14.23.42.059988",
    30. "LastOpType": "UNKNOW",
    31. "LastOpBegin": "--",
    32. "LastOpEnd": "--",
    33. "LastOpInfo": "",
    34. "UserCPU": 0.38,
    35. "SysCPU": 0.3
    36. }