文档中心
v3.4

SequoiaDB 简介

安装部署

数据库实例

分布式引擎

SAC 管控中心

参考手册

常见问题及解答(FAQ)

版本信息

detachNode()

名称

detachNode - 分离当前复制组内的一个节点

语法

rg.detachNode( <host>, <service>, <options> )

类别

SdbReplicaGroup

描述

分离当前复制组内的一个节点,其配置信息不会被删除。搭配 rg.attachNode()使用。目前可以支持从数据组或者编目组中分离节点。

参数

参数名 参数类型 描述 是否必填
host string 节点的主机名或者主机 IP。
service string 节点服务名或者端口。
options Json 对象 详见如下options选项说明。

options 选项:

参数名 参数类型 描述 默认值
KeepData bool 是否保留目标节点原有的数据。 无默认值,需用户显式指定。
Enforced bool 是否强制分离节点 false

Note:

  1. 参数 options 中的 KeepData 字段为必填项,需用户显式指定。由于该选项会决定被detach的节点的数据是否继续被保留,用户应该谨慎考虑。
  2. 主节点或复制组内只有一个节点时,该节点将不能被 detach,如需强制删除请使用 Enforced 参数。
  3. 分离后的节点将不再受集群管理,请尽快加入到其他复制组中。

返回值

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

错误

错误信息记录在节点诊断日志(diaglog)中,可参考错误码

错误码 可能的原因 解决方法
-15 网络错误 1. 检查 sdbcm 状态是否正常;
2. 检查 host 是否正确,网络是否能正常通信。
-155 节点不属于当前复制组 检查节点是否属于当前复制组。
-204 尝试分离主节点,
或者组内最后一个节点
如果需要强制删除,可以加入 { Enforced: true } 选项。

版本

v2.0 及以上版本

示例

rg.attachNode() 中示例说明。

回到顶部