# DROP NODE
#### 功能描述
删除集群节点。
#### 注意事项
DROP NODE是集群管理工具封装的接口，用来实现集群管理。该接口不建议用户直接使用，以免对集群状态造成影响。管理员用户才有权限使用该接口。
#### 语法格式
```
DROP NODE [ IF EXISTS ] nodename [WITH ( cnnodename [, ... ] )];
```
#### 参数说明
- **IF EXISTS**
  如果指定的节点不存在，则发出一个notice而不是抛出一个错误。
  

- **nodename**
  要删除的节点名。
  取值范围：已存在的节点nodename。
  

- **cnnodename**
  CN名称。如果定义了该参数，则删除当前连接CN下的集群节点以及所定义CN下的集群节点。
  取值范围：已存在的CN的nodename。
  
![](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
多CN环境下，创建集群节点时只会在当前连接的CN下创建，不会同步至其他CN，需要在所有CN上执行创建操作，如果删除集群节点只需要连接一个CN即可。如果只在其中一个CN执行创建了集群节点，要删除需要定义当前cnnodename，并在此CN下执行删除操作。
#### 示例
```
--创建集群节点，在所有CN上执行。
gaussdb=# CREATE NODE datanode1 WITH(
   TYPE = datanode,
   PREFERRED = false
);
--删除集群节点，连接一个CN即可。
gaussdb=# DROP NODE datanode1;
```
#### 相关链接
[CREATE NODE](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-12-0554.html#ZH-CN_TOPIC_0000002527965418)，[ALTER NODE](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-12-0496.html#ZH-CN_TOPIC_0000002558925187)。