createuser — 定义一个新的PostgreSQL用户账户
createuser [connection-option...] [option...] [username]
createuser创建一个新的PostgreSQL用户（更准确地说，是一个角色）。只有超级用户以及具有CREATEROLE权限的用户才能创建新用户，因此调用createuser的用户必须能够以超级用户或具有CREATEROLE权限的用户身份连接。
如果要创建一个具有SUPERUSER、REPLICATION或BYPASSRLS权限的角色， 则必须以超级用户身份连接，而不能仅具有CREATEROLE权限。 超级用户意味着能够绕过数据库中的所有访问权限检查，因此不应轻易授予超级用户权限。 CREATEROLE也赋予非常广泛的权限。
createuser是SQL命令CREATE ROLE的一个包装器。 通过此工具创建用户与通过其他访问服务器的方法创建用户，在效果上没有区别。
createuser接受下列命令行参数：
username #指定要创建的PostgreSQL用户名。 该名称必须不同于此PostgreSQL安装中的所有现有角色名称。
-a role--with-admin=role #指定一个现有角色，使其自动作为带有 ADMIN OPTION 的成员加入新角色，从而有权将新角色的成员资格授予其他角色。 可以通过写多个-a开关来指定多个现有角色。
-c number--connection-limit=number #为新用户设置最大连接数。默认不设限制。
-d--createdb #允许新用户创建数据库。
-D--no-createdb #不允许新用户创建数据库。这是默认设置。
-e--echo #回显createuser生成并发送给服务器的命令。
-E--encrypted #该选项已废弃，但为了向后兼容仍被接受。
-g role--member-of=role--role=role（已废弃） #指定新角色应自动成为指定现有角色的成员。 可以通过写多个-g开关来指定多个现有角色。
-i--inherit #新角色将自动继承其所属角色的权限。 这是默认设置。
-I--no-inherit #新角色将不会自动继承其所属角色的权限。
--interactive #如果命令行中未指定用户名，则提示输入用户名；此外，还会提示输入命令行中未指定的 -d/-D、 -r/-R、 -s/-S选项。 （直到 PostgreSQL 9.1 为止，这都是默认行为。）
-l--login #允许新用户登录（也就是说，该用户名可用作初始会话用户标识符）。 这是默认设置。
-L--no-login #不允许新用户登录。 （不具有登录权限的角色仍可用于管理数据库权限。）
-m role--with-member=role #指定一个现有角色，使其自动作为成员加入新角色。 可以通过写多个-m开关来指定多个现有角色。
-P--pwprompt #如果给出此选项，createuser会提示输入新用户的密码。 如果不打算使用密码认证，则不需要这样做。
-r--createrole #允许新用户创建、更改、删除其他角色，对其添加注释，以及更改其安全标签；也就是说， 该用户将具有CREATEROLE权限。 关于该权限赋予哪些能力的更多细节，见创建角色。
-R--no-createrole #不允许新用户创建新角色。这是默认设置。
-s--superuser #新用户将成为超级用户。
-S--no-superuser #新用户将不是超级用户。这是默认设置。
-v timestamp--valid-until=timestamp #设置一个日期和时间，在此之后该角色的密码将不再有效。 默认不设置密码过期日期。
-V--version #打印createuser版本并退出。
--bypassrls #新用户将绕过每一条行级安全（RLS）策略。
--no-bypassrls #新用户将不会绕过行级安全（RLS）策略。这是默认设置。
--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可以避免这次额外的连接尝试。
与大多数其他PostgreSQL工具一样，此工具也使用 libpq支持的环境变量（见Section 32.15）。
若遇到困难，请参见CREATE ROLE和psql， 其中讨论了潜在问题和错误消息。数据库服务器必须在目标主机上运行。 此外，libpq前端库使用的任何默认连接设置和环境变量也都会生效。
要在默认数据库服务器上创建用户joe：
$createuser joe
要在默认数据库服务器上创建用户joe，并提示输入一些额外属性：
$createuser --interactive joeShall the new role be a superuser? (y/n)nShall the new role be allowed to create databases? (y/n)nShall 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 joeCREATE ROLE joe NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;
要把用户joe创建为超级用户，并立即为其设置密码：
$createuser -P -s -e joeEnter password for new role:xyzzyEnter it again:xyzzyCREATE ROLE joe PASSWORD 'SCRAM-SHA-256$4096:44560wPMLfjqiAzyPDZ/eQ==$4CA054rZlSFEq8Z3FEhToBTa2X6KnWFxFkPwIbKoDe0=:L/nbSZRCjp6RhOhKK56GoR1zibCCSePKshCJ9lnl3yw=' SUPERUSER CREATEDB CREATEROLE INHERIT LOGIN NOREPLICATION NOBYPASSRLS;
在上面的示例中，输入新密码时实际上不会回显它，但为清楚起见，这里展示了输入的内容。 可以看到，该密码在发送给客户端之前就已经被加密了。
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明，请使用此表单来报告文档问题。