选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

createuser

createuser — 定义一个新的PostgreSQL用户账户

Synopsis

createuser [connection-option...] [option...] [username]

描述

createuser创建一个新的PostgreSQL用户(更准确地说,是一个角色)。只有超级用户以及具有CREATEROLE权限的用户才能创建新用户,因此调用createuser的用户必须能够以超级用户或具有CREATEROLE权限的用户身份连接。

如果希望创建新的超级用户,必须以超级用户身份连接,而不能仅凭CREATEROLE权限。超级用户意味着能够绕过数据库内所有访问权限检查,因此不应轻易授予超级用户访问权限。

createuserSQL命令CREATE ROLE的包装器。通过此工具创建用户与通过其他访问服务器的方法创建用户,在效果上没有区别。

选项

createuser接受以下命令行参数:

username

指定要创建的PostgreSQL用户的名称。该名称必须不同于此PostgreSQL安装中所有现有角色的名称。

-c number
--connection-limit=number

为新用户设置最大连接数。默认不设限制。

-d
--createdb

允许新用户创建数据库。

-D
--no-createdb

不允许新用户创建数据库。这是默认设置。

-e
--echo

回显createuser生成并发送给服务器的命令。

-E
--encrypted

该选项已废弃,但为了向后兼容仍被接受。

-g role
--role=role(已废弃)

指定新角色应自动成为指定现有角色的成员。 可以通过写多个-g开关来指定多个现有角色。

-i
--inherit

新角色将自动继承其所属角色的权限。 这是默认设置。

-I
--no-inherit

新角色将不会自动继承其所属角色的权限。

--interactive

如果命令行中未指定用户名,则提示输入用户名;此外,还会提示输入命令行中未指定的 -d/-D-r/-R-s/-S选项。 (直到 PostgreSQL 9.1 为止,这都是默认行为。)

-l
--login

允许新用户登录(也就是说,该用户名可用作初始会话用户标识符)。 这是默认设置。

-L
--no-login

不允许新用户登录。 (不具有登录权限的角色仍可用于管理数据库权限。)

-P
--pwprompt

如果给出此选项,createuser会提示输入新用户的密码。 如果不打算使用密码认证,则不需要这样做。

-r
--createrole

允许新用户创建新角色(即该用户将具有CREATEROLE权限)。

-R
--no-createrole

不允许新用户创建新角色。这是默认设置。

-s
--superuser

新用户将成为超级用户。

-S
--no-superuser

新用户将不是超级用户。这是默认设置。

-V
--version

打印createuser版本并退出。

--replication

新用户将具有REPLICATION权限,关于该权限的更完整说明见CREATE ROLE

--no-replication

新用户将不具有REPLICATION权限,关于该权限的更完整说明见CREATE ROLE。这是默认设置。

-?
--help

显示有关createuser命令行参数的帮助并退出。

createuser还接受以下用于连接参数的命令行参数:

-h host
--host=host

指定服务器所在主机的主机名。如果该值以斜杠开头,则将其用作 Unix 域套接字所在目录。

-p port
--port=port

指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。

-U username
--username=username

指定连接时使用的用户名(不是要创建的用户名)。

-w
--no-password

绝不提示输入密码。如果服务器要求密码认证,而密码又无法通过诸如.pgpass文件等其他方式获得,则连接尝试将失败。该选项可用于没有用户在场输入密码的批处理作业和脚本。

-W
--password

强制createuser提示输入密码(用于连接到服务器,而不是新用户的密码)。

该选项绝非必需,因为如果服务器要求密码认证,createuser会自动提示输入密码。不过,createuser会浪费一次连接尝试来发现服务器需要密码。在某些情况下,输入-W可以避免这次额外的连接尝试。

环境

PGHOST
PGPORT
PGUSER

默认连接参数

与大多数其他PostgreSQL工具一样,此工具也使用 libpq支持的环境变量(见Section 33.14)。

诊断

若遇到困难,请参见CREATE ROLEpsql, 其中讨论了潜在问题和错误消息。数据库服务器必须在目标主机上运行。 此外,libpq前端库使用的任何默认连接设置和环境变量也都会生效。

示例

要在默认数据库服务器上创建用户joe

$ createuser joe

要在默认数据库服务器上创建用户joe,并提示输入一些额外属性:

$ createuser --interactive joe
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) n
Shall the new role be allowed to create more new roles? (y/n) n

要通过主机eden、端口 5000 上的服务器创建同一个用户joe, 并显式指定各项属性,同时查看底层命令:

$ createuser -h eden -p 5000 -S -D -R -e joe
CREATE ROLE joe NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;

创建用户joe作为超级用户,并立即分配密码:

$ createuser -P -s -e joe
Enter password for new role: xyzzy
Enter it again: xyzzy
CREATE ROLE joe PASSWORD 'md5b5f5ba1a423792b526f799ae4eb3d59e' SUPERUSER CREATEDB CREATEROLE INHERIT LOGIN;

上面的示例中,输入密码时实际上不会回显新密码,但为清晰起见,我们显示了所输入的内容。如你所见,密码在发送给客户端之前会被加密。