功能描述

创建角色。

角色是拥有数据库对象和权限的实体。在不同的环境中角色可以认为是一个用户，一个组或者兼顾两者。

注意事项

在数据库中添加一个新角色，角色无登录权限。
创建角色的用户必须具备CREATE ROLE的权限或者是系统管理员。

语法格式

CREATE ROLE role_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { PASSWORD | IDENTIFIED BY } { 'password' | DISABLE };

其中角色信息设置子句option语法为：

{SYSADMIN | NOSYSADMIN}
    | {AUDITADMIN | NOAUDITADMIN}
    | {CREATEDB | NOCREATEDB}
    | {USEFT | NOUSEFT}
    | {CREATEROLE | NOCREATEROLE}
    | {INHERIT | NOINHERIT}
    | {LOGIN | NOLOGIN}
    | {REPLICATION | NOREPLICATION}
    | {INDEPENDENT | NOINDEPENDENT}
    | {VCADMIN | NOVCADMIN}
    | CONNECTION LIMIT connlimit
    | VALID BEGIN 'timestamp'
    | VALID UNTIL 'timestamp'
    | RESOURCE POOL 'respool'
    | USER GROUP 'groupuser'
    | PERM SPACE 'spacelimit'
    | NODE GROUP logic_cluster_name
    | IN ROLE role_name [, ...]
    | IN GROUP role_name [, ...]
    | ROLE role_name [, ...]
    | ADMIN rol e_name [, ...]
    | USER role_name [, ...]
    | SYSID uid
    | DEFAULT TABLESPACE tablespace_name
    | PROFILE DEFAULT
    | PROFILE profile_name
    | PGUSER

参数说明

role_name
角色名称。
取值范围：字符串，要符合标识符的命名规范。且最多为63个字符。
password
登录密码。
密码规则如下：
- 密码默认不少于8个字符。
- 不能与用户名及用户名倒序相同。
- 至少包含大写字母（A-Z），小写字母（a-z），数字（0-9），非字母数字字符（限定为~!@#$%^&*()-_=+\|[{}];:,<.>/?）四类字符中的三类字符。
取值范围：字符串。
DISABLE
默认情况下，用户可以更改自己的密码，除非密码被禁用。要禁用用户的密码，请指定DISABLE。禁用某个用户的密码后，将从系统中删除该密码，此类用户只能通过外部认证来连接数据库，例如：IAM认证或kerberos认证。只有管理员才能启用或禁用密码。普通用户不能禁用初始用户的密码。要启用密码，请运行ALTER USER并指定密码。
ENCRYPTED | UNENCRYPTED
控制密码存储在系统表里的口令是否加密。（如果没有指定，那么缺省的行为由配置参数password_encryption控制。）按照产品安全要求，密码必须加密存储，所以，UNENCRYPTED在GaussDB 200中禁止使用。因为系统无法对指定的加密口令字符串进行解密，所以如果目前的口令字符串已经是用SHA256加密的格式，则会继续照此存放，而不管是否声明了ENCRYPTED或UNENCRYPTED。这样就允许在dump/restore的时候重新加载加密的口令。
SYSADMIN | NOSYSADMIN
决定一个新角色是否为“系统管理员”，具有SYSADMIN属性的角色拥有系统最高权限。
缺省为NOSYSADMIN。
AUDITADMIN | NOAUDITADMIN
定义角色是否有审计管理属性。
缺省为NOAUDITADMIN。
CREATEDB | NOCREATEDB
决定一个新角色是否能创建数据库。
新角色没有创建数据库的权限。
缺省为NOCREATEDB。
USEFT | NOUSEFT
该参数为保留参数，暂未启用。
CREATEROLE | NOCREATEROLE
决定一个角色是否可以创建新角色（也就是执行CREATE ROLE和CREATE USER）。一个拥有CREATEROLE权限的角色也可以修改和删除其他角色。
缺省为NOCREATEROLE。
INHERIT | NOINHERIT
这些子句决定一个角色是否“继承”它所在组的角色的权限。不推荐使用。
LOGIN | NOLOGIN
具有LOGIN属性的角色才可以登录数据库。一个拥有LOGIN属性的角色可以认为是一个用户。
缺省为NOLOGIN。
REPLICATION | NOREPLICATION
定义角色是否允许流复制或设置系统为备份模式。REPLICATION属性是特定的角色，仅用于复制。
缺省为NOREPLICATION。
INDEPENDENT | NOINDEPENDENT
定义私有、独立的角色。具有INDEPENDENT属性的角色，管理员对其进行的控制、访问的权限被分离，具体规则如下：
- 未经INDEPENDENT角色授权，管理员无权对其表对象进行增、删、查、改、拷贝、授权操作。
- 未经INDEPENDENT角色授权，管理员无权修改INDEPENDENT角色的继承关系。
- 管理员无权修改INDEPENDENT角色的表对象的属主。
- 管理员无权去除INDEPENDENT角色的INDEPENDENT属性。
- 管理员无权修改INDEPENDENT角色的数据库口令，INDEPENDENT角色需管理好自身口令，口令丢失无法重置。
- 管理员属性用户不允许定义修改为INDEPENDENT属性。
VCADMIN | NOVCADMIN
定义逻辑集群管理员角色。具有逻辑集群管理员属性的角色，和普通用户相比，有如下额外权限：
- 在所关联逻辑集群中创建、修改和删除资源池的权限。
- 将所关联的逻辑集群的访问权限授予其他用户或角色，或回收其他用户或角色对关联逻辑集群的访问权限。
CONNECTION LIMIT
声明该角色可以使用的并发连接数量。
取值范围：整数，>=-1，缺省值为-1，表示没有限制。
VALID BEGIN
设置角色生效的时间戳。如果省略了该子句，角色无有效开始时间限制。
VALID UNTIL
设置角色失效的时间戳。如果省略了该子句，角色无有效结束时间限制。
RESOURCE POOL
设置角色使用的resource pool名字，该名字属于系统表：pg_resource_pool
USER GROUP 'groupuser'
创建一个user的子用户。使用规则可以参考用户层级管理。
PERM SPACE
设置用户使用空间的大小。
NODE GROUP
设置用户关联的逻辑集群名称。如果需要关联的逻辑集群名称包含大写字符或特殊字符，指定逻辑集群名称时需要加双引号。
IN ROLE
新角色立即拥有IN ROLE子句中列出的一个或多个现有角色拥有的权限。不推荐使用。
IN GROUP
IN GROUP是IN ROLE过时的拼法。不推荐使用。
ROLE
ROLE子句列出一个或多个现有的角色，它们将自动添加为这个新角色的成员，拥有新角色所有的权限。
ADMIN
ADMIN子句类似ROLE子句，不同的是ADMIN后的角色可以把新角色的权限赋给其他角色。
USER
USER子句是ROLE子句过时的拼法。
SYSID
SYSID子句将被忽略，无实际意义。
DEFAULT TABLESPACE
DEFAULT TABLESPACE子句将被忽略，无实际意义。
PROFILE
PROFILE子句将被忽略，无实际意义。

PGUSER

该属性用于兼容开源Postgres的连接通讯，开源的Postgres客户端接口（推荐使用Postgres 9.2.19版本的相关客户端接口）可以使用具有该属性的数据库用户连接数据库。

该属性只用于兼容连接过程，而由于本产品与Postgres的内核差异导致的不兼容，不在此属性控制范围内。

由于具有PGUSER属性的用户的认证方式与其他用户不同，开源客户端的报错信息可能导致数据库用户PGUSER属性被枚举，建议使用本产品自有的客户端。例如：

#normaluser是不具有PGUSER属性的用户，psql是Postgres的客户端工具
pg@MPPDB04:~> psql -d postgres -p 25308 -h 10.11.12.13 -U normaluser
psql: authentication method 10 not supported
#pguser用户是具有PGUSER属性的用户
pg@MPPDB04:~> psql -d postgres -p 25308 -h 10.11.12.13 -U pguser
Password for user pguser:

示例

--创建一个角色，名为manager，密码为Bigdata123@。
CREATE ROLE manager IDENTIFIED BY 'Bigdata123@';
--创建一个角色，从2015年1月1日开始生效，到2026年1月1日失效。
CREATE ROLE miriam WITH LOGIN PASSWORD 'Bigdata123@' VALID BEGIN '2015-01-01' VALID UNTIL '2026-01-01';
--修改角色manager的密码为abcd@123。
ALTER ROLE manager IDENTIFIED BY 'abcd@123' REPLACE 'Bigdata123@';
--修改角色manager为系统管理员。
ALTER ROLE manager SYSADMIN;
--删除角色manager。
DROP ROLE manager;
--删除角色miriam。
DROP ROLE miriam;

ITPub博客

SQL语法-CREATE ROLE

功能描述

注意事项

语法格式

参数说明

示例

相关链接

最新文章