pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
createuser — 定义一个新的 PostgreSQL 用户账户
createuser [options...] [username]
createuser创建一个新的 PostgreSQL用户。只有超级用户（在 pg_shadow表中usesuper被设置的用户）才能创建新的 PostgreSQL用户，因此 createuser必须由能以 PostgreSQL超级用户身份连接的人来调用。
成为超级用户还意味着能够绕过数据库内的访问权限检查，所以不应轻易授予超级用户身份。
createuser是一个 shell 脚本，它通过 PostgreSQL交互式终端 psql包装了 SQL命令 CREATE USER。因此，通过这个或其他方法创建用户没有什么特别之处。这意味着脚本必须能找到 psql，并且目标主机上必须有一个数据库服务器在运行。此外， psql和 libpq前端库使用的任何默认设置和环境变量都将适用。
createuser接受下列命令行参数：
username指定要创建的 PostgreSQL 用户的名称。这个名称必须在所有 PostgreSQL用户之间唯一。
-a--adduser允许新用户创建其他用户。（注意：实际上，这会使新用户成为超级用户。这个选项的命名并不恰当。）
-A--no-adduser不允许新用户创建其他用户（即新用户是普通用户，不是超级用户）。
-d--createdb允许新用户创建数据库。
-D--no-createdb不允许新用户创建数据库。
-e--echo显示 createuser 生成并发送给服务器的查询。
-E--encrypted加密存储在数据库中的用户口令。如果未指定，则使用默认值。
-i uid--sysid uid允许你为新用户选择一个非默认的用户 ID。这并非必需，但有些人喜欢这样。
-N--unencrypted不加密存储在数据库中的用户口令。如果未指定，则使用默认值。
-P--pwprompt如果给出这个选项，createuser将提示输入新用户的口令。如果你不打算使用口令认证，则不需要它。
-q--quiet不显示响应。
如果命令行上没有指定名称和其他缺少的信息，系统会提示你输入。
createuser还接受下列用于连接参数的命令行参数：
-h host--host host指定服务器正在运行的主机名。如果 host 以斜杠开头，它将被用作 Unix 域套接字的目录。
-p port--port port指定服务器正在监听连接的 Internet TCP/IP 端口或本地 Unix 域套接字文件扩展名。
-U username--username username要连接的用户名（不是要创建的用户名）
-W--password强制口令提示（用于连接服务器，而不是新用户的口令）。
PGHOSTPGPORTPGUSER默认连接参数
CREATE USER一切正常。
createuser: creation of user "username" failed出了些问题。用户没有被创建。
如果出现错误情况，将显示后端错误消息。参见 CREATE USER 和psql了解各种可能。
在默认数据库服务器上创建用户 joe：
$createuser joeIs the new user allowed to create databases? (y/n)nShall the new user be allowed to create more new users? (y/n)nCREATE USER
使用主机 eden上端口 5000 的服务器创建同一个用户 joe，避开提示并查看底层查询：
$createuser -p 5000 -h eden -D -A -e joeCREATE USER "joe" NOCREATEDB NOCREATEUSERCREATE USER
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。