• getSlave()
    • 名称
    • 语法
    • 类别
    • 描述
    • 参数
    • 返回值
    • 错误
    • 版本
    • 示例

    getSlave()

    名称

    getSlave - 获取当前分区组的备节点。

    语法

    rg.getSlave([positions])

    类别

    Replica Group

    描述

    获取当前分区组的备节点。

    参数

    • positions ( Int32选填 )

    节点位置。目前,节点位置定义为该节点在 catalog 元数据的 "Group" 数组中的位置。其起始值为1,范围为[1,7]。最多只能输入7个不重复的、有效节点位置。若指定的节点位置大于分区组的节点数,这些节点位置将按照公式 (position - 1) % nodeCount + 1 进行转换。

    返回值

    成功:返回 SdbNode 对象。

    失败:抛出异常。

    Note:

    • 当分区组只有一个节点,不管是否指定节点位置,直接返回唯一的节点对象,即使该节点为主节点。
    • 当分区组有多个节点,在不指定节点位置的情况下,返回的节点必为备节点。
    • 当分区组有多个节点,在指定节点位置的情况下,若节点位置包含备节点,则随机返回包含的备节点;若节点位置只包含主节点,则返回主节点。

    错误

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

    错误码错误类型描述解决方法
    -6SDB_INVALIDARG参数错误。输入的节点位置参数有误。
    -10SDB_SYS系统错误。一般由 catalog 元素数据变更后,驱动无法解析元数据导致。
    -154SDB_CLS_GRP_NOT_EXIST分区组不存在。检查分区组是否存在。
    -158SDB_CLS_EMPTY_GROUP分区组为空。检查分区组是否包含任何节点。

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

    版本

    • v2.10加入节点位置参数,用于获取指定位置的备节点。
    • v1.0 添加此接口。

    示例

    • 获取 group1 分区组的备节点。
    1. > var rg = db.getRG("group1")
    2. > rg.getSlave()
    3. hostname1:42000
    • group1 分区组信息如下:
    1. > db.list(SDB_LIST_GROUPS, {"GroupName":"group1"})
    2. {
    3. "Group": [
    4. {
    5. "HostName": "hostname1",
    6. "Status": 1,
    7. "dbpath": "/sequoiadb/database/40000/",
    8. "Service": [
    9. {
    10. "Type": 0,
    11. "Name": "40000"
    12. },
    13. {
    14. "Type": 1,
    15. "Name": "40001"
    16. },
    17. {
    18. "Type": 2,
    19. "Name": "40002"
    20. }
    21. ],
    22. "NodeID": 1001
    23. },
    24. {
    25. "HostName": "hostname1",
    26. "Status": 1,
    27. "dbpath": "/sequoiadb/database/41000/",
    28. "Service": [
    29. {
    30. "Type": 0,
    31. "Name": "41000"
    32. },
    33. {
    34. "Type": 1,
    35. "Name": "41001"
    36. },
    37. {
    38. "Type": 2,
    39. "Name": "41002"
    40. }
    41. ],
    42. "NodeID": 1002
    43. },
    44. {
    45. "HostName": "hostname1",
    46. "Status": 1,
    47. "dbpath": "/sequoiadb/database/42000/",
    48. "Service": [
    49. {
    50. "Type": 0,
    51. "Name": "42000"
    52. },
    53. {
    54. "Type": 1,
    55. "Name": "42001"
    56. },
    57. {
    58. "Type": 2,
    59. "Name": "42002"
    60. }
    61. ],
    62. "NodeID": 1003
    63. }
    64. ],
    65. "GroupID": 1001,
    66. "GroupName": "group1",
    67. "PrimaryNode": 1002,
    68. "Role": 0,
    69. "SecretID": 1425460557,
    70. "Status": 1,
    71. "Version": 7,
    72. "_id": {
    73. "$oid": "5a045460c517f3cf06a32976"
    74. }
    75. }

    其中,节点为:hostname1:40000(备节点,节点位置为1);hostname1:41000(主节点,节点位置为2);hostname1:42000(备节点,节点位置为3);从 group1 分区组中,随机获取位置1和位置2节点中的备节点:

    1. > var rg = db.getRG("group1")
    2. > rg.getSlave(1,2)
    3. hostname1:40000