# CREATE GROUP
#### 功能描述
创建一个新用户组。
#### 注意事项
CREATE GROUP是CREATE ROLE的别名，非SQL标准语法，不推荐使用，建议用户直接使用CREATE ROLE替代。
#### 语法格式
```
CREATE GROUP group_name [ [ WITH ] option [ ... ] ] 
    [ ENCRYPTED | UNENCRYPTED ] { PASSWORD | IDENTIFIED BY } { 'password' [ EXPIRED ] | DISABLE };
```
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/figure/zh-cn_image_0000002558058985.png "点击放大")
其中可选项option子句语法为：
```
{SYSADMIN | NOSYSADMIN}
    | {MONADMIN | NOMONADMIN}
    | {OPRADMIN | NOOPRADMIN}
    | {POLADMIN | NOPOLADMIN}
    | {AUDITADMIN | NOAUDITADMIN}
    | {CREATEDB | NOCREATEDB}
    | {USEFT | NOUSEFT}
    | {CREATEROLE | NOCREATEROLE}
    | {INHERIT | NOINHERIT}
    | {LOGIN | NOLOGIN}
    | {REPLICATION | NOREPLICATION}
    | {PERSISTENCE | NOPERSISTENCE}
    | CONNECTION LIMIT connlimit
    | VALID BEGIN 'timestamp'
    | VALID UNTIL 'timestamp'
    | RESOURCE POOL 'respool'
    | USER GROUP 'groupuser'
    | PERM SPACE 'spacelimit'
    | TEMP SPACE 'tmpspacelimit'
    | SPILL SPACE 'spillspacelimit'
    | NODE GROUP logic_group_name
    | IN ROLE role_name [, ...]
    | IN GROUP role_name [, ...]
    | ROLE role_name [, ...]
    | ADMIN role_name [, ...]
    | USER role_name [, ...]
    | SYSID uid
    | DEFAULT TABLESPACE tablespace_name
    | PROFILE DEFAULT
    | PROFILE profile_name
    | PGUSER
```
![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/figure/zh-cn_image_0000002526899152.png "点击放大")
#### 参数说明
请参见[参数说明](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0560.html#ZH-CN_TOPIC_0000002527826210__zh-cn_topic_0000002527056272_zh-cn_topic_0059778189_s5a43ec5742a742089e2c302063de7fe4)。
#### 示例
```
--创建用户组，与CREATE ROLE效果一样。
gaussdb=# CREATE GROUP test_group WITH PASSWORD "********";
--使用CREATE ROLE创建角色，默认不能登录数据库。
--可使用ALTER ROLE role_name WITH LOGIN语句让用户可以登录数据库。
gaussdb=# CREATE ROLE test_role WITH PASSWORD "********";
--使用CREATE USER创建用户，自动创建同名模式，有登录的权限。
gaussdb=# CREATE USER test_user WITH PASSWORD "********";
--查看用户信息。
gaussdb=# \du test*
             List of roles
 Role name  |  Attributes  | Member of 
------------+--------------+-----------
 test_group | Cannot login | {}
 test_role  | Cannot login | {}
 test_user  |              | {}
--查询CREATE USER命令自动创建的模式。
gaussdb=# \dn test*
    List of schemas
   Name    |   Owner   
-----------+-----------
 test_user | test_user
(1 row)
--删除。
gaussdb=# DROP ROLE test_role;
gaussdb=# DROP GROUP test_group;
gaussdb=# DROP USER test_user;
```
#### 相关链接
[ALTER GROUP](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0490.html#ZH-CN_TOPIC_0000002558945983)，[DROP GROUP](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0597.html#ZH-CN_TOPIC_0000002527826228)，[CREATE ROLE](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0560.html#ZH-CN_TOPIC_0000002527826210)