
# ALTER NODE
#### 功能描述
修改一个现有节点的定义。
#### 注意事项
ALTER NODE是集群管理工具封装的接口，用来实现集群管理，管理员用户才有权限使用该接口。该接口不建议用户直接使用，以免对集群状态造成影响。
#### 语法格式
```
ALTER 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 ]]
  );
```
![](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
PORT选项指定的端口号为节点间内部通信绑定的端口号，不同于外部客户端连接节点的端口号，可通过pgxc_node表查询。
#### 参数说明
请参见CREATE NODE的[参数说明](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0368.html#ZH-CN_TOPIC_0000002222774429__zh-cn_topic_0000002220897769_zh-cn_topic_0059777554_s68bbe2607b464e78b392c344c0e2fbdd)。
#### 相关链接
[CREATE NODE](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0368.html#ZH-CN_TOPIC_0000002222774429)，[DROP NODE](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0402.html#ZH-CN_TOPIC_0000002187368776)
