# CREATE NODE GROUP
#### 功能描述
创建一个新的集群节点组。
#### 注意事项
- CREATE NODE GROUP是集群管理工具封装的接口，用来实现集群管理。
- 该接口仅对管理员用户开放使用。
 
#### 语法格式
```
CREATE NODE GROUP groupname
    WITH ( nodename [, ... ] ) 
    [ BUCKETS [ ( bucketnumber [, ... ] ) ] ];
```
#### 参数说明
- **groupname**
  节点组名称。
  取值范围：字符串，要符合[标识符说明](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0040.html#ZH-CN_TOPIC_0000002558805265)。且最大长度不超过63个字符。
  ![](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  节点组命名支持ASCII字符集上所有字符，但是建议用户按照标识符命名规范命名。
  
- **nodename**
  节点名称。
  取值范围：字符串，要符合[标识符说明](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0040.html#ZH-CN_TOPIC_0000002558805265)。且最大长度不超过63个字符。
  
- **BUCKETS \[ ( bucketnumber \[, ... \] ) \]**
  BUCKETS选项功能当前版本不支持。
  
 
#### 示例
```
--查询集群DN初始状态。
gaussdb=# SELECT node_name, nodeis_preferred FROM pgxc_node WHERE node_type = 'D' ORDER BY 1;
 node_name | nodeis_preferred
-----------+------------------
 dn_6001_6002_6003 | f
 dn_6004_6005_6006 | f
 dn_6007_6008_6009 | f
(3 rows)
--创建NODE GROUP，用上一步中查询到的真实节点名称替换dn_6001_6002_6003。
gaussdb=# CREATE NODE GROUP test_group WITH ( dn_6001_6002_6003 );
--查询NODE GROUP。
gaussdb=# SELECT group_name, group_members FROM pgxc_group;
   group_name   |   group_members   
----------------+-------------------
 group_version1 | 16384 16388 16394
 test_group     | 16384
(2 rows)
--删除node group。
gaussdb=# DROP NODE GROUP test_group;
```
#### 相关链接
[ALTER NODE GROUP](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-12-0497.html#ZH-CN_TOPIC_0000002527965404)，[DROP NODE GROUP](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-12-0604.html#ZH-CN_TOPIC_0000002558805297)