createCataRG()

语法

db.createCataRG( <host>, <service>, <dbpath>, [config] )

新建一个编目分区组，同时创建并启动一个编目节点。

参数描述

参数名参数类型描述是否必填
hoststring指定编目节点的主机名。是
serviceint/string指定编目节点的服务端口，请确保该端口号，以及往后延续的3个端口号未被占用；如设置为11800，请确保11800/11801/11802/11803端口都未被占用。是
dbpathstring数据文件路径，用于存放编目数据文件，需确保数据管理员（安装时创建，默认为 sdbadmin）用户有写权限。是
configjson参数为可选参数，用于配置更多细节参数，格式必须为 json 格式，参数参见数据库配置一节；如需要配置日志大小参数{ logfilesz: 64 }。否

Note:

  • 如果配置路径不以“/”开头，数据文件存放路径将是数据库管理员用户(默认为sdbadmin)的主目录(默认为/home/sequoiadb) + 配置的路径。
  • 请确保数据文件存放路径的权限，如果 SequoiaDB 采用的默认安装，那么给路径赋予 sdbadmin 权限。
  • service 目前建议直接采用port。

返回值

返回新建编目分区组的引用，出错抛异常，并输出错误信息，可以通过 getLastErrMsg() 获取错误信息 或 通过 getLastError() 获取错误码。关于错误处理可以参考常见错误处理指南 。

示例

  • 在名为：hostname1 的主机上创建一个编目节点组，服务端口为：11800，数据文件存放路径为：/opt/sequoiadb/database/cata/11800
  1. > db.createCataRG( "hostname1", 11800, "/opt/sequoiadb/database/cata/11800" )