src/man1/createuser.1

   1 .TH "CREATEUSER" "1" "2003-11-02" "Application" "PostgreSQL Client Applications"
   2 .SH NAME
   3 createuser \- 定义一个新的 PostgreSQL 用户帐户
   4
   5 .SH SYNOPSIS
   6 .sp
   7 \fBcreateuser\fR\fR [ \fR\fB\fIoption\fB\fR...\fB \fR\fR]\fR\fR [ \fR\fB\fIusername\fB \fR\fR]\fR
   8 .SH "DESCRIPTION 描述"
   9 .PP
  10 \fBcreateuser\fR 创建一个新的 PostgreSQL 用户。只有超级用户（在
  11 pg_shadow 表中设置了 usesuper 的用户）可以创建新的 PostgreSQL 用户。 因此，
  12 createuser 必须由某位可以以 PostgreSQL 超级用户连接的用户执行。
  13 .PP
  14  作为超级用户同时也意味着绕开数据库内访问检查的能力， 因此我们应该少赋予超级用户权限。
  15 .PP
  16 \fBcreateuser\fR 是 SQL 命令 CREATE USER [\fBcreate_user\fR(7)] 的封装。
  17 因此，用那种方法创建新用户都没什么特别的。
  18 .SH "OPTIONS 选项"
  19 .PP
  20 \fBcreateuser\fR 接受下列命令行参数：
  21 .TP
  22 \fB\fIusername\fB\fR
  23 声明要创建的 PostgreSQL 用户名称。 该名称必须在所有 PostgreSQL 用户中唯一。
  24 .TP
  25 \fB-a\fR
  26 .TP
  27 \fB--adduser\fR
  28 允许该新建用户创建其他用户。(注意: 实际上这样做相当于把这个新用户变成了
  29 superuser，只不过这个选项命名得比较烂。)
  30 .TP
  31 \fB-A\fR
  32 .TP
  33 \fB--no-adduser\fR
  34  不允许该新建用户创建其他用户。 （也就是说，该用户是一个普通用户，不是超级用户）。
  35 .TP
  36 \fB-d\fR
  37 .TP
  38 \fB--createdb\fR
  39  允许该新建用户创建数据库。
  40 .TP
  41 \fB-D\fR
  42 .TP
  43 \fB--no-createdb\fR
  44  禁止该新建用户创建数据库。
  45 .TP
  46 \fB-e\fR
  47 .TP
  48 \fB--echo\fR
  49  回显 createuser 生成的命令并发送给服务器。
  50 .TP
  51 \fB-E\fR
  52 .TP
  53 \fB--encrypted\fR
  54  对保存在数据库里的用户口令加密。如果没有声明， 则使用缺省值。
  55 .TP
  56 \fB-i \fInumber\fB\fR
  57 .TP
  58 \fB--sysid \fInumber\fB\fR
  59  允许你给新用户使用非缺省用户标识。这个也不是必须的，但是有些人喜欢这样。
  60 .TP
  61 \fB-N\fR
  62 .TP
  63 \fB--unencrypted\fR
  64  不对保存在数据库里的用户口令加密。如果没有声明， 则使用缺省值，
  65 .TP
  66 \fB-P\fR
  67 .TP
  68 \fB--pwprompt\fR
  69  如果给出，createuser 将发出一个提示符要求输入新用户的口令。 如果你不打算用口令认证，那么这是不必要的。
  70 .TP
  71 \fB-q\fR
  72 .TP
  73 \fB--quiet\fR
  74  不显示响应。
  75 .PP
  76 .PP
  77  如果没有在命令行上声明名称和其他的一些缺少的信息，脚本会提示你输入。
  78 .PP
  79 \fBcreateuser\fR 还接受下列命令行参数用作连接参数：
  80 .TP
  81 \fB-h \fIhost\fB\fR
  82 .TP
  83 \fB--host \fIhost\fB\fR
  84  声明运行服务器的机器的主机名。 如果数值以斜扛开头，则它被用做到 Unix 域套接字的路径。
  85 .TP
  86 \fB-p \fIport\fB\fR
  87 .TP
  88 \fB--port \fIport\fB\fR
  89  声明服务器 正在侦听的互联网 TCP 端口号或本地Unix域套接字的文件扩展（描述符）。
  90 .TP
  91 \fB-U \fIusername\fB\fR
  92 .TP
  93 \fB--username \fIusername\fB\fR
  94  连接的用户名（不是要创建的用户名）。
  95 .TP
  96 \fB-W\fR
  97 .TP
  98 \fB--password\fR
  99  强制口令提示（与服务器连接的口令，不是新用户的口令。）
 100 .PP
 101 .SH "ENVIRONMENT 环境"
 102 .TP
 103 \fBPGHOST\fR
 104 .TP
 105 \fBPGPORT\fR
 106 .TP
 107 \fBPGUSER\fR
 108  缺省连接参数。
 109 .SH "DIAGNOSTICS 诊断"
 110 .PP
 111  如果出现错误，将会显示后端错误信息。参阅 CREATE USER [\fBcreate_user\fR(7)] 和 \fBpsql\fR(1)  获取可能信息描述。数据库服务器必须在目标主机上运行。 同样，任何 libpq 前端库使用的缺省连接设置和环境变量都将适用。
 112 .SH "EXAMPLES 例子"
 113 .PP
 114  在缺省数据库服务器上创建一个用户 joe：
 115 .sp
 116 .nf
 117 $ \fBcreateuser joe\fR
 118 Is the new user allowed to create databases? (y/n) \fBn\fR
 119 Shall the new user be allowed to create more new users? (y/n) \fBn\fR
 120 CREATE USER
 121 .sp
 122 .fi
 123 .PP
 124  用在主机eden上的服务器创建用户 joe，端口是 5000，避免提示并且显示执行的命令：
 125 .sp
 126 .nf
 127 $ \fBcreateuser -p 5000 -h eden -D -A -e joe\fR
 128 CREATE USER "joe" NOCREATEDB NOCREATEUSER
 129 CREATE USER
 130 .sp
 131 .fi
 132 .SH "SEE ALSO 参见"
 133 \fBdropuser\fR(1), CREATE USER [\fBcreate_user\fR(7)]
 134
 135 .SH "译者"
 136 .B Postgresql 中文网站
 137 .B 何伟平 <laser@pgsqldb.org>