SequoiaDB巨杉数据库编目节点

概念

编目节点是一种逻辑节点，用于保存数据库的元数据信息，而不保存用户数据。

编目节点属于编目分区组（可参考 分区组）。

编目节点中包含以下集合空间：

• SYSCAT： 系统编目集合空间，包含以下系统集合：

  集合名	描述
  SYSCOLLECTIONS	保存了该集群中所有的用户集合信息
  SYSCOLLECTIONSPACES	保存了该集群中所有的用户集合空间信息
  SYSDOMAINS	保存了该集群中所有用户域的信息
  SYSNODES	保存了该集群中所有的逻辑节点与复制组信息
  SYSTASKS	保存了该集群中所有正在运行的后台任务信息

• SYSAUTH： 系统认证集合空间，包含一个用户集合，保存当前系统中所有的用户信息

  集合名	描述
  SYSUSRS	保存了该集群中所有的用户信息

• SYSPROCEDURES： 系统存储过程集合空间，包含一个集合，用于存储所有的存储过程函数信息

  集合名	描述
  STOREPROCEDURES	保存所有存储过程函数信息

• SYSGTS： 系统自增字段集合空间，包含一个集合，用于存储所有的自增字段信息

  集合名	描述
  SEQUENCES	保存所有自增字段信息

除编目节点外，集群中所有其他的节点不在磁盘中保存任何全局元数据信息。当需要访问其他节点上的数据时，除编目节点外的其他节点需要从本地缓存中寻找集合信息，如果不存在则需要从编目节点获取。

编目节点与其它节点之间主要使用编目服务端口（catalogname参数）进行通讯。

管理编目节点

在新建编目分区组和新增编目节点时，如果涉及到新增主机，则需要先按照集群中新增主机一节完成主机的主机名和参数配置。

新建编目分区组

一个数据库集群必须有且仅有一个编目分区组，所以新建分区组往往在安装时就已经完成，不需要在安装后执行新建分区组操作。实例见安装指南集群模式的配置与启动一节。

• 操作方法：

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

Sdb.createCataRG() 用于创建编目分区组，同时创建并启动一个编目节点，其中：

- **host** ：指定编目节点的主机名；

• service ：指定编目节点的服务端口，需要确保该端口号及往后延续的五个端口号未被占用；如端口号设置为11800，应确保11800/11801/11802/11803/11804/11805端口都未被占用；

• dbpath ：数据文件路径，用于存放编目数据文件，需要确保数据管理员（安装时创建，默认为sdbadmin）用户有写权限。如果配置路径不以“/”开头，则数据文件存放路径是数据库管理员用户(默认为sdbadmin)的主目录(默认为/home/sequoiadb) + 配置的路径；

• config ：该参数为可选参数，用于配置更多细节参数，格式必须为 json格式，细节参数可参考数据库配置一节；如需要配置日志大小参数｛logfilesz:64｝。

Note:

编目节点上的事务选项 transactionon 默认为开启（为了保证事务日志，需要对编目节点上的日志文件个数 logfilenum 进行设置，可参考数据库配置）。

编目分区组中新增节点

随着整个集群中的物理设备的扩展，可以通过增加编目节点来提高编目服务的可靠性。

• 操作方法：

1. 获取编目分区组：

   > var cataRG = db.getCatalogRG()
   

   Note:

   在 Sdb Shell 中用户可以使用 Sdb.getCataRG() 获取编目分区组。

2. 创建一个新的编目节点：

   > var node1 = cataRG.createNode( <host>, <service>, <dbpath>, [config] )
   

   Note:

   host, service, dbpath 及 config 的设置可参考 新建编目分区组

3. 启动新增的编目节点：

   > node1.start()
   

查看编目节点

在 Sdb Shell 中可以查看协调节点的列表：

> db.getCataRG().getDetail()

故障恢复

编目节点故障恢复策略与数据节点相同。

更多内容可点击巨杉数据库官网查看。