
# CREATE USER
#### 功能描述
创建一个用户。
#### 注意事项
- 通过CREATE USER创建的用户，默认具有LOGIN权限。
- 通过CREATE USER创建用户的同时，系统会在执行该命令的数据库中，为该用户创建一个同名的SCHEMA。
- 系统管理员在普通用户同名schema下创建的对象，所有者为schema的同名用户（非系统管理员）。
 
#### 语法格式
```
CREATE USER user_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { PASSWORD | IDENTIFIED BY } { 'password' [EXPIRED] | DISABLE };
```
其中option子句用于设置权限及属性等信息。
```
{SYSADMIN | NOSYSADMIN}
    | {MONADMIN | NOMONADMIN}
    | {OPRADMIN | NOOPRADMIN}
    | {POLADMIN | NOPOLADMIN}
    | {AUDITADMIN | NOAUDITADMIN}
    | {CREATEDB | NOCREATEDB}
    | {USEFT | NOUSEFT}
    | {CREATEROLE | NOCREATEROLE}
    | {INHERIT | NOINHERIT}
    | {LOGIN | NOLOGIN}
    | {REPLICATION | NOREPLICATION}
    | {VCADMIN | NOVCADMIN}
    | {PERSISTENCE | NOPERSISTENCE}
    | CONNECTION LIMIT connlimit
    | VALID BEGIN 'timestamp'
    | VALID UNTIL 'timestamp'
    | USER GROUP 'groupuser'
    | PERM SPACE 'spacelimit'
    | TEMP SPACE 'tmpspacelimit'
    | SPILL SPACE 'spillspacelimit'
    | NODE GROUP logic_cluster_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
```
#### 参数说明
- **user_name**
  用户名称。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0227.html#ZH-CN_TOPIC_0000002187528220__zh-cn_topic_0000002185458746_section14873217506)。且最大长度不超过63个字符。当用户名中包含大写字母时数据库将自动转换为小写字母，如果需要创建包含大写字母的用户名则需要使用双引号括起来。
  
- **password**
  登录密码。
  密码规则如下：
  - 密码默认不少于8个字符。
  
  - 不能与用户名及用户名倒序相同。
  
  - 至少包含大写字母（A-Z），小写字母（a-z），数字（0-9），非字母数字字符（限定为\~!@#$%\^\&\*()-_=+\\\|\[{}\];:,\<.\>/?）四类字符中的三类字符。当密码中包含的字符不属于上述四种字符范围内时语句执行会报错。
  
  - 密码也可以是符合格式要求的密文字符串，这种情况主要用于用户数据导入场景，不推荐用户直接使用。如果直接使用密文密码，用户需要知道密文密码对应的明文，并且保证明文密码复杂度，数据库不会校验密文密码复杂度，直接使用密文密码的安全性由用户保证。
  
  - 创建用户时，应当使用单引号将用户密码括起来。
  
  
  取值范围：字符串。
  
CREATE USER的其他参数值请参考[CREATE ROLE参数说明](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0372.html#ZH-CN_TOPIC_0000002222774433__zh-cn_topic_0000002185618310_zh-cn_topic_0059778189_s5a43ec5742a742089e2c302063de7fe4)。
#### 示例
```
--创建用户jim，登录密码为********。
openGauss=# CREATE USER jim PASSWORD '********';
--下面语句与上面的等价。
openGauss=# CREATE USER kim IDENTIFIED BY '********';
--如果创建有“创建数据库”权限的用户，则需要加CREATEDB关键字。
openGauss=# CREATE USER dim CREATEDB PASSWORD '********';
--将用户jim的登录密码由********修改为**********。
openGauss=# ALTER USER jim IDENTIFIED BY '**********' REPLACE '********';
--为用户jim追加CREATEROLE权限。
openGauss=# ALTER USER jim CREATEROLE;
--锁定jim账户。
openGauss=# ALTER USER jim ACCOUNT LOCK;
--删除用户。
openGauss=# DROP USER kim CASCADE;
openGauss=# DROP USER jim CASCADE;
openGauss=# DROP USER dim CASCADE;
```
#### 相关链接
[ALTER USER](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0343.html#ZH-CN_TOPIC_0000002187528376)，[CREATE ROLE](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0372.html#ZH-CN_TOPIC_0000002222774433)，[DROP USER](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/gaussdb-12-0417.html#ZH-CN_TOPIC_0000002222888901)
