Skip to main content

节点管理

组成 TDengine 集群的物理实体是 dnode (data node 的缩写),它是一个运行在操作系统之上的进程。在 dnode 中可以建立负责时序数据存储的 vnode (virtual node),在多节点集群环境下当某个数据库的 replica 为 3 时,该数据库中的每个 vgroup 由 3 个 vnode 组成;当数据库的 replica 为 1 时,该数据库中的每个 vgroup 由 1 个 vnode 组成。如果要想配置某个数据库为多副本,则集群中的 dnode 数量至少为 3。在 dnode 还可以创建 mnode (management node),单个集群中最多可以创建三个 mnode。在 TDengine 3.0.0.0 中为了支持存算分离,引入了一种新的逻辑节点 qnode (query node),qnode 和 vnode 既可以共存在一个 dnode 中,也可以完全分离在不同的 dnode 上。

创建数据节点

CREATE DNODE {dnode_endpoint | dnode_host_name PORT port_val}

其中 dnode_endpoint 是形成 hostname:port的格式。也可以分开指定 hostname 和 port。

实际操作中推荐先创建 dnode,再启动相应的 dnode 进程,这样该 dnode 就可以立即根据其配置文件中的 firstEP 加入集群。每个 dnode 在加入成功后都会被分配一个 ID。

查看数据节点

SHOW DNODES;

可以列出集群中所有的数据节点,所列出的字段有 dnode 的 ID, endpoint, status。

删除数据节点

DROP DNODE dnode_id

注意删除 dnode 不等于停止相应的进程。实际中推荐先将一个 dnode 删除之后再停止其所对应的进程。

修改数据节点配置

ALTER DNODE dnode_id dnode_option

ALTER ALL DNODES dnode_option

dnode_option: {
'resetLog'
| 'balance' 'value'
| 'monitor' 'value'
| 'debugFlag' 'value'
| 'monDebugFlag' 'value'
| 'vDebugFlag' 'value'
| 'mDebugFlag' 'value'
| 'cDebugFlag' 'value'
| 'httpDebugFlag' 'value'
| 'qDebugflag' 'value'
| 'sdbDebugFlag' 'value'
| 'uDebugFlag' 'value'
| 'tsdbDebugFlag' 'value'
| 'sDebugflag' 'value'
| 'rpcDebugFlag' 'value'
| 'dDebugFlag' 'value'
| 'mqttDebugFlag' 'value'
| 'wDebugFlag' 'value'
| 'tmrDebugFlag' 'value'
| 'cqDebugFlag' 'value'
}

上面语法中的这些可修改配置项其配置方式与 dnode 配置文件中的配置方式相同,区别是修改是动态的立即生效,且不需要重启 dnode。

value 是参数的值,需要是字符格式。如修改 dnode 1 的日志输出级别为 debug:

ALTER DNODE 1 'debugFlag' '143';

添加管理节点

CREATE MNODE ON DNODE dnode_id

系统启动默认在 firstEP 节点上创建一个 MNODE,用户可以使用此语句创建更多的 MNODE 来提高系统可用性。一个集群最多存在三个 MNODE,一个 DNODE 上只能创建一个 MNODE。

查看管理节点

SHOW MNODES;

列出集群中所有的管理节点,包括其 ID,所在 DNODE 以及状态。

删除管理节点

DROP MNODE ON DNODE dnode_id;

删除 dnode_id 所指定的 DNODE 上的 MNODE。

创建查询节点

CREATE QNODE ON DNODE dnode_id;

系统启动默认没有 QNODE,用户可以创建 QNODE 来实现计算和存储的分离。一个 DNODE 上只能创建一个 QNODE。一个 DNODE 的 supportVnodes 参数如果不为 0,同时又在其上创建上 QNODE,则在该 dnode 中既有负责存储管理的 vnode 又有负责查询计算的 qnode,如果还在该 dnode 上创建了 mnode,则一个 dnode 上最多三种逻辑节点都可以存在。但通过配置也可以使其彻底分离。将一个 dnode 的supportVnodes配置为 0,可以选择在其上创建 mnode 或者 qnode 中的一种,这样可以实现三种逻辑节点在物理上的彻底分离。

查看查询节点

SHOW QNODES;

列出集群中所有查询节点,包括 ID,及所在 DNODE。

删除查询节点

DROP QNODE ON DNODE dnode_id;

删除 ID 为 dnode_id 的 DNODE 上的 QNODE,但并不会影响该 dnode 的状态。

查询集群状态

SHOW CLUSTER ALIVE;

查询当前集群的状态是否可用,返回值: 0:不可用 1:完全可用 2:部分可用(集群中部分节点下线,但其它节点仍可以正常使用)

修改客户端配置

如果将客户端也看作广义的集群的一部分,可以通过如下命令动态修改客户端配置参数。

ALTER LOCAL local_option

local_option: {
'resetLog'
| 'rpcDebugFlag' 'value'
| 'tmrDebugFlag' 'value'
| 'cDebugFlag' 'value'
| 'uDebugFlag' 'value'
| 'debugFlag' 'value'
}

上面语法中的参数与在配置文件中配置客户端的用法相同,但不需要重启客户端,修改后立即生效。

查看客户端配置

SHOW LOCAL VARIABLES;