更新时间:2024-11-12 GMT+08:00
分享

CREATE NODE

功能描述

创建一个新的集群节点。

注意事项

CREATE NODE是集群管理工具封装的接口,用来实现集群管理。该接口不建议用户直接使用,以免对集群状态造成影响。管理员用户才有权限使用该接口。

语法格式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
CREATE NODE nodename WITH
  (
    [ TYPE = nodetype,]
    [ HOST = hostname,]
    [ PORT = portnum,]
    [ HOST1 = 'hostname',]
    [ PORT1 = portnum,]
    [ HOSTPRIMARY [ = boolean ],]
    [ PRIMARY [ = boolean ],]
    [ PREFERRED [ = boolean ],]
    [ SCTP_PORT = portnum,]
    [ CONTROL_PORT = portnum,]
    [ SCTP_PORT1 = portnum,]
    [ CONTROL_PORT1 = portnum, ]
    [ NODEIS_CENTRAL [= boolean], ]
    [ NODEIS_ACTIVE [= boolean] ]
  );

PORT选项指定的端口号为节点间内部通信绑定的端口号,不同于外部客户端连接节点的端口号,可通过pgxc_node表查询。

参数说明

  • nodename

    节点名称。

    取值范围:字符串,要符合标识符命名规范

  • TYPE = nodetype

    指定节点的类型。

    取值范围:

    • 'coordinator'
    • 'datanode'
  • HOST = hostname

    指定节点对应的主机名称或者IP地址。

  • PORT = portnum

    指定节点绑定的主机端口号。

  • HOST1 = hostname

    指定节点对应的备机名称或者IP地址。

  • PORT1 = portnum

    指定节点绑定的备机端口号。

  • HOSTPRIMARY

    声明主机名称或者IP地址是否为主。

    取值范围:

    • true
    • false(默认值)
  • PRIMARY = boolean

    声明该节点是否为主节点。主节点允许做读写操作,否则只允许读操作。

    取值范围:

    • true
    • false(默认值)
  • PREFERRED = boolean

    声明该节点是否为读操作的首选节点。

    取值范围:

    • true
    • false(默认值)
  • SCTP_PORT = portnum

    主机TCP代理通信库使用的数据传输通道侦听端口,使用TCP协议侦听连接。

  • CONTROL_PORT = portnum

    主机TCP代理通信库使用的控制传输通道侦听端口,使用TCP协议侦听连接。

  • SCTP_PORT1 = portnum

    备机TCP代理通信库使用的数据传输通道侦听端口,使用TCP协议侦听连接。

  • CONTROL_PORT 1= portnum

    备机TCP代理通信库使用的控制传输通道侦听端口,使用TCP协议侦听连接。

  • NODEIS_CENTRAL

    表明当前节点是否为中心控制节点,只用于CN,对DN无效。

    • true
    • false(默认值)
  • NODEIS_ACTIVE

    表明当前节点是否是正常状态,用于标记CN是否被剔除,对DN无效。

    • true
    • false(默认值)

多CN环境下,创建集群节点时只会在当前连接的CN下创建,不会同步至其他CN,需要在所有CN上执行,如果删除集群节点只需要链接一个CN即可。如果只在其中一个CN执行创建了集群节点,要删除需要定义当前cnnodename,并在当前CN下执行删除操作。请参见DROP NODE

示例

--创建集群节点,在所有CN上执行。
gaussdb=# CREATE NODE datanode1 WITH(
   TYPE = datanode,
   PREFERRED = false
);
gaussdb=# CREATE NODE datanode2 WITH(
   TYPE = datanode,
   PREFERRED = false
);

--查询集群DN初始状态。
gaussdb=# SELECT node_name, nodeis_preferred FROM pgxc_node WHERE node_type = 'D' ORDER BY 1;
 node_name | nodeis_preferred
-----------+------------------
 datanode1 | f
 datanode2 | f
(2 rows)

--将datanode1设为preferred DN。
gaussdb=# ALTER NODE datanode1 WITH(preferred = true);
--查询集群DN变更后状态。
gaussdb=# SELECT node_name, nodeis_preferred FROM pgxc_node WHERE node_type = 'D' ORDER BY 1;
 node_name | nodeis_preferred
-----------+------------------
 datanode1 | t
 datanode2 | f
(2 rows)

--删除集群节点,连接一个CN即可。
gaussdb=# DROP NODE datanode1;
gaussdb=# DROP NODE datanode2;

相关链接

ALTER NODEDROP NODE

相关文档