SQL COMMAND · 角色与权限

CREATE USER

定义一个新的数据库角色

define a new database role

CREATE角色与权限引入 6.4（基线）现存至 20 devel12 次语法变更

动词: CREATE
对象: USER
分组: 角色与权限
引入版本: 6.4（基线）
状态: 现存
语法变更次数: 12
手册小节数: 3

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

option

语法概要

CREATE USER name [ [ WITH ] option [ ... ] ]

其中 option 可以是：

SUPERUSER | NOSUPERUSER
| CREATEDB | NOCREATEDB
| CREATEROLE | NOCREATEROLE
| INHERIT | NOINHERIT
| LOGIN | NOLOGIN
| REPLICATION | NOREPLICATION
| BYPASSRLS | NOBYPASSRLS
| CONNECTION LIMIT connlimit
| [ ENCRYPTED ] PASSWORD 'password' | PASSWORD NULL
| VALID UNTIL 'timestamp'
| IN ROLE role_name [, ...]
| IN GROUP role_name [, ...]
| ROLE role_name [, ...]
| ADMIN role_name [, ...]
| USER role_name [, ...]
| SYSID uid

PostgreSQL 18 手册 · 查看完整参考页

描述

CREATE USER 现为 CREATE ROLE 的别名。唯一的区别在于：当命令写为 CREATE USER 时，默认假定为 LOGIN；而当命令写为 CREATE ROLE 时，默认假定为 NOLOGIN。

兼容性

CREATE USER 语句是 PostgreSQL 的一种扩展。SQL 标准将用户的定义留给具体实现决定。

另见

CREATE ROLE

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

PostgreSQL 19← 18语法变化

− | IN GROUP role_name [, ...]− | ROLE role_name [, ...]− | USER role_name [, ...]− | SYSID uid
PostgreSQL 11← 10语法变化

+ | [ ENCRYPTED ] PASSWORD 'password' | PASSWORD NULL
PostgreSQL 10← 9.6语法变化

− | [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'
PostgreSQL 9.6← 9.5语法变化

− | CREATEUSER | NOCREATEUSER
PostgreSQL 9.5← 9.4语法变化

+ | BYPASSRLS | NOBYPASSRLS
PostgreSQL 9.1← 9.0语法变化

+ | REPLICATION | NOREPLICATION
PostgreSQL 9.0← 8.4语法变化

+ | IN ROLE role_name [, ...]+ | IN GROUP role_name [, ...]+ | ROLE role_name [, ...]+ | ADMIN role_name [, ...]+ | USER role_name [, ...]− where option can be:− | IN ROLE rolename [, ...]− | IN GROUP rolename [, ...]− | ROLE rolename [, ...]− | ADMIN rolename [, ...]− | USER rolename [, ...]
PostgreSQL 8.2← 8.1正文更新

正文更新
PostgreSQL 8.1← 8.0语法变化

+ SUPERUSER | NOSUPERUSER+ | CREATEROLE | NOCREATEROLE+ | CREATEUSER | NOCREATEUSER+ | INHERIT | NOINHERIT+ | LOGIN | NOLOGIN+ | CONNECTION LIMIT connlimit+ | VALID UNTIL 'timestamp'+ | IN ROLE rolename [, ...]+ | IN GROUP rolename [, ...]+ | ROLE rolename [, ...]+ | ADMIN rolename [, ...]+ | USER rolename [, ...]+ | SYSID uid− SYSID uid− | IN GROUP groupname [, ...]− | VALID UNTIL 'abstime'正文更新
PostgreSQL 8.0← 7.4语法变化

+ | [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'+ | VALID UNTIL 'abstime'− | [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'− | CREATEDB | NOCREATEDB正文更新
PostgreSQL 7.4← 7.3语法变化

+ CREATE USER name [ [ WITH ] option [ ... ] ]− CREATE USER username [ [ WITH ] option [ ... ] ]正文更新
PostgreSQL 7.3← 7.2正文更新

正文更新
PostgreSQL 7.2← 7.1语法变化

+ CREATE USER username [ [ WITH ] option [ ... ] ]+ where option can be:+ | [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'+ | CREATEDB | NOCREATEDB+ | CREATEUSER | NOCREATEUSER+ | IN GROUP groupname [, ...]+ | VALID UNTIL 'abstime'− [ PASSWORD 'password' ] ]− [ CREATEDB | NOCREATEDB ] [ CREATEUSER | NOCREATEUSER ]− [ IN GROUP groupname [, ...] ]− [ VALID UNTIL 'abstime' ]正文更新
PostgreSQL 7.1← 7.0文件改名

sql-createuser.htm → sql-createuser.html

正文更新
PostgreSQL 7.0← 6.5语法变化

+ [ SYSID uid ]+ [ PASSWORD 'password' ] ]− [ WITH PASSWORD password ]正文更新
PostgreSQL 6.5← 6.4正文更新

正文更新

同组命令

命令	动词	对象	最近变更
ROLES & PRIVILEGES角色与权限20 条↑
`GRANT`	GRANT	—	1717 次
定义访问权限			现存
`REVOKE`	REVOKE	—	1719 次
撤销访问权限			现存
`ALTER DEFAULT PRIVILEGES`	ALTER	DEFAULT PRIVILEGES	186 次
定义默认访问权限			现存
`CREATE GROUP`	CREATE	GROUP	198 次
定义一个新的数据库角色			现存
`ALTER GROUP`	ALTER	GROUP	144 次
更改角色名称或成员资格			现存
`DROP GROUP`	DROP	GROUP	8.22 次
移除一个数据库角色			现存
`SECURITY LABEL`	SECURITY	LABEL	126 次
定义或更改应用于对象的安全标签			现存
`DROP OWNED`	DROP	OWNED	142 次
移除一个数据库角色所拥有的数据库对象			现存
`REASSIGN OWNED`	REASSIGN	OWNED	142 次
更改一个数据库角色所拥有的数据库对象的所有权			现存
`CREATE POLICY`	CREATE	POLICY	142 次
为一个表定义一条新的行级安全策略			现存
`ALTER POLICY`	ALTER	POLICY	141 次
更改一条行级安全策略的定义			现存
`DROP POLICY`	DROP	POLICY	9.61 次
从一个表中移除一条行级安全策略			现存
`CREATE ROLE`	CREATE	ROLE	177 次
定义一个新的数据库角色			现存
`ALTER ROLE`	ALTER	ROLE	1410 次
更改数据库角色			现存
`DROP ROLE`	DROP	ROLE	8.21 次
移除一个数据库角色			现存
`SET ROLE`	SET	ROLE	9.01 次
设置当前会话的当前用户标识符			现存
`SET SESSION AUTHORIZATION`	SET	SESSION AUTHORIZATION	9.02 次
设置当前会话的会话用户标识符和当前用户标识符			现存
`CREATE USER`	CREATE	USER	1912 次
定义一个新的数据库角色			现存
`ALTER USER`	ALTER	USER	1417 次
更改数据库角色			现存
`DROP USER`	DROP	USER	8.23 次
移除一个数据库角色			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

兼容性

另见

语法演化

相关命令

同组命令