updateConf()

名称

updateConf - 更新指定的节点配置

语法

db.updateConf(<config>, [options])

类别

Sdb

描述

该函数用于更新指定的节点配置。生效类型为“在线生效”的配置，更新后立即生效；生效类型为“重启生效”的配置，需重启节点后生效。各配置的生效类型可参考参数说明。

参数

• config（ object，必填 ）

  节点配置参数

• options（ object，选填 ）

  命令位置参数

  如果不指定该参数，更新操作默认对所有节点生效。

返回值

函数执行成功时，无返回值。

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

错误

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

版本

v2.9 及以上版本

示例

• 更新“在线生效”类型的配置 diaglevel，并指定生效节点为 11820

  > db.updateConf({diaglevel: 3}, {ServiceName: "11820"})

• 更新“重启生效”类型的配置 numpreload，并指定生效节点为 11820

  > db.updateConf({numpreload: 10}, {ServiceName: "11820"})

  如果返回如下信息，需重启节点

  (shell):1 uncaught exception: -322
  Some configuration changes didn't take effect:
  Config 'numpreload' require(s) restart to take effect.