GaussDB-CREATE NODE GROUP

GaussDB-CREATE NODE GROUP

功能描述

创建一个新的集群节点组。

注意事项

• CREATE NODE GROUP是集群管理工具封装的接口，用来实现集群管理。
• 该接口仅对管理员用户开放使用。

语法格式

| ``` CREATE NODE GROUP groupname WITH ( nodename [, ... ] ) [ BUCKETS [ ( bucketnumber [, ... ] ) ] ];

| ------------------------------------------------------------------------------------------------------------------- |

#### 参数说明

-   **groupname**

    节点组名称。

    取值范围：字符串，要符合[标识符命名规范](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0321.html#ZH-CN_TOPIC_0000001865746364__zh-cn_topic_0000001704458709_section14873217506)。且最大长度不超过63个字符。

    ![](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/8456850563c842ebba877d5003f1f1f1~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgamVycnl3YW5nMTk4Mw==:q75.awebp?rk3s=f64ab15b&x-expires=1771380452&x-signature=crFIGOvb2KHIbIbgLt3KGqEbKHY%3D)

    节点组命名支持ASCII字符集上所有字符，但是建议用户按照标识符命名规范命名。

-   **nodename**

    节点名称。

    取值范围：字符串，要符合[标识符命名规范](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0321.html#ZH-CN_TOPIC_0000001865746364__zh-cn_topic_0000001704458709_section14873217506)。且最大长度不超过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;

--删除node group。 gaussdb=# DROP NODE GROUP test_group;

#### 相关链接

[ALTER NODE GROUP](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0497.html#ZH-CN_TOPIC_0000001865746196)，[DROP NODE GROUP](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0606.html#ZH-CN_TOPIC_0000001911666885)

更多详情请参考GaussDB 文档中心：<https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html>