概述

概念

编目节点为一种逻辑节点，其中保存了数据库的元数据信息，而不保存其他用户数据。

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

编目节点中包含4个集合空间：

• SYSCAT： 系统编目集合空间，包含4个系统集合：

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

• SYSTEMP： 系统临时集合空间，可以创建最多4096个临时集合

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

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

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

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

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

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

管理编目节点

新建编目分区组

Note:如果新增节点涉及到新增主机，则请首先按照在集群中新增主机一节完成主机的主机名和参数配置。

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

• 操作方法：

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

该命令用于创建编目分区组，同时创建并启动一个编目节点，其中：

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

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

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

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

Note:

编目节点上的事务选项 transactionon 自动开启（为了保证事务日志，编目节点上的日志文件个数 logfilenum 需要设置为大于 5）

更详细的创建编目节点组，请参考 Sdb.createCataRG()

编目分区组中新增节点

Note:如果新增节点涉及到新增主机，则请首先按照在集群中新增主机一节完成主机的主机名和参数配置。

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

• 操作方法：
• 获取编目分区组：

> var cataRG = db.getCatalogRG()

Note:

在 Sdb Shell 中也可以使用 (Sdb.getRG())[reference/Sequoiadb_command/Sdb/getRG.md] 以 "SYSCatalogGroup" 为分区组组名获取编目节点组。

• 创建一个新的编目节点：

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

Note:

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

• 启动新增的编目节点：

> node1.start()

Note:

如何创建编目节点组和部署编目节点可以详细请参考 集群模式

查看编目节点

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

> db.getCatalogRG().getDetail()

故障恢复

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