# CREATE NODE
#### 功能描述
创建一个新的集群节点。
#### 注意事项
CREATE NODE是集群管理工具封装的接口，用来实现集群管理。该接口不建议用户直接使用，以免对集群状态造成影响。管理员用户才有权限使用该接口。
#### 语法格式
```
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 ]
  );
```
#### 参数说明
- **nodename**
  节点名称。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0319.html#ZH-CN_TOPIC_0000002235270221__zh-cn_topic_0000002235098221_section14873217506)。
  
- **TYPE = nodetype**
  指定节点的类型。
  取值范围：
  - 'coordinator'
  
  - 'datanode'
   
- **HOST = hostname**
  指定节点对应的主机名称或者IP地址。
  
- **PORT = portnum**
  指定节点绑定的主机端口号。
  
- **HOST1 = hostname**
  指定节点对应的备机名称或者IP地址。
  
- **PORT1 = portnum**
  指定节点绑定的备机端口号。
  
- **HOSTPRIMARY**
- **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协议侦听连接。
  
#### 相关链接
[ALTER NODE](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0474.html#ZH-CN_TOPIC_0000002200190234)，[DROP NODE](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0574.html#ZH-CN_TOPIC_0000002200190342)。