pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
createuser — 定义一个新的 PostgreSQL 用户账号
createuser [options...] [username]
host指定服务器正在运行的主机名。如果 host 以斜杠开头，它将被用作 Unix 域套接字的目录。
port指定服务器正在监听连接的 Internet TCP/IP 端口或本地 Unix 域套接字文件扩展名。
显示 createuser 生成并发送给服务器的查询。
不显示响应。
允许新用户创建数据库。
不允许新用户创建数据库。
允许新用户创建其他用户。（注意：实际上，这会使新用户成为超级用户。这个选项的命名并不恰当。）
不允许新用户创建其他用户（即新用户是普通用户不是超级用户）。
如果给出这个选项，createuser将提示输入新用户的口令。如果你不打算使用口令认证，则不需要它。
uid允许你为新用户选择一个非默认的用户 id。这并非必需，但有些人喜欢这样。
加密存储在数据库中的用户口令。如果未指定，则使用默认值。
不加密存储在数据库中的用户口令。如果未指定，则使用默认值。
username指定要创建的 PostgreSQL 用户的名称。这个名称必须在所有 PostgreSQL用户之间唯一。
如果命令行上没有指定名称和其他缺少的信息，系统会提示你输入。
选项 -h、-p和 -e会按原样传递给psql。 psql的选项 -U和 -W也可用，但在这种场合使用它们可能造成困惑。
CREATE USER一切正常。
createuser: creation of user "username" failed出了些问题。用户没有被创建。
如果出现错误情况，将显示后端错误消息。参见 CREATE USER 和psql了解各种可能。
createuser创建一个新的 PostgreSQL用户。只有超级用户（在 pg_shadow表中usesuper被设置的用户）才能创建新的 PostgreSQL用户，因此 createuser必须由 PostgreSQL超级用户来调用。
成为超级用户还意味着能够绕过数据库内的访问权限检查，所以不应轻易授予超级用户身份。
createuser是一个 shell 脚本，它通过 PostgreSQL交互式终端 psql包装了 SQL命令 CREATE USER 。因此，通过这个或其他方法创建用户没有什么特别之处。这意味着脚本必须能找到 psql，并且目标主机上必须有一个数据库服务器在运行。此外， psql和 libpq前端库使用的任何默认设置和环境变量都将适用。
在默认数据库服务器上创建用户 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 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。