createuser

说明

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

如果要创建一个具有SUPERUSER、REPLICATION或BYPASSRLS权限的角色，则必须以超级用户身份连接，而不能仅具有CREATEROLE权限。超级用户意味着能够绕过数据库中的所有访问权限检查，因此不应轻易授予超级用户权限。CREATEROLE也赋予非常广泛的权限。

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

选项

createuser接受下列命令行参数：

createuser也接受下列用于连接参数的命令行参数：

环境

与大多数其他 PostgreSQL 工具一样，此工具也使用 libpq 支持的环境变量（见第 32.15 节）。

诊断

如果遇到问题，请参见CREATE ROLE和psql中关于潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外，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 'SCRAM-SHA-256$4096:44560wPMLfjqiAzyPDZ/eQ==$4CA054rZlSFEq8Z3FEhToBTa2X6KnWFxFkPwIbKoDe0=:L/nbSZRCjp6RhOhKK56GoR1zibCCSePKshCJ9lnl3yw=' SUPERUSER CREATEDB CREATEROLE INHERIT LOGIN NOREPLICATION NOBYPASSRLS;

在上面的示例中，输入新密码时实际上不会回显它，但为清楚起见，这里展示了输入的内容。可以看到，该密码在发送给服务器之前就已经被加密了。

另见

dropuser, CREATE ROLE, createrole_self_grant