src/man1/createdb.1

   1 .\\" auto-generated by docbook2man-spec $Revision: 1.1 $
   2 .TH "CREATEDB" "1" "2003-11-02" "Application" "PostgreSQL Client Applications"
   3 .SH NAME
   4 createdb \- 创建一个新的 PostgreSQL 数据库
   5
   6 .SH SYNOPSIS
   7 .sp
   8 \fBcreatedb\fR\fR [ \fR\fB\fIoption\fB\fR...\fB \fR\fR]\fR\fR [ \fR\fB\fIdbname\fB \fR\fR]\fR\fR [ \fR\fB\fIdescription\fB \fR\fR]\fR
   9 .SH "DESCRIPTION  描述"
  10 .PP
  11 \fBcreatedb\fR 创建一个新的 PostgreSQL 数据库。
  12 .PP
  13  通常，执行这个命令的数据库用户成为新数据库的所有者。 不过，如果执行用户拥有合适的权限，那么他可以通过 \fB\-O\fP 指定合适的用户。
  14 .PP
  15 \fBcreatedb\fR 是一个 SQL 命令 CREATE DATABASE [\fBcreate_database\fR(7)] 的封装。 因此，用哪种方法创建数据库都没什么特别的。
  16 .SH "OPTIONS 选项"
  17 .PP
  18 \fBcreatedb\fR 接受下列命令行参数：
  19 .TP
  20 \fB\fIdbname\fB\fR
  21  声明要创建的数据库名。该名称应该在本节点的 PostgreSQL 所有数据库里面是唯一的。 缺省是与当前系统用户同名。
  22 .TP
  23 \fB\fIdescription\fB\fR
  24  这个选项声明一个与新创建的数据库相关的注解。
  25 .TP
  26 \fB-D \fIlocation\fB\fR
  27 .TP
  28 \fB--location \fIlocation\fB\fR
  29  声明变更了的数据库集群（节点）的位置。 又见 \fBinitlocation\fR(1).
  30 .TP
  31 \fB-e\fR
  32 .TP
  33 \fB--echo\fR
  34  回显 createdb 生成的命令并且把它发送到服务器。
  35 .TP
  36 \fB-E \fIencoding\fB\fR
  37 .TP
  38 \fB--encoding \fIencoding\fB\fR
  39  声明用于此数据库的字符编码方式。
  40 .TP
  41 \fB-O \fIowner\fB\fR
  42 .TP
  43 \fB--owner \fIowner\fB\fR
  44  指定将拥有新数据库的数据库用户。
  45 .TP
  46 \fB-q\fR
  47 .TP
  48 \fB--quiet\fR
  49  不显示响应。
  50 .TP
  51 \fB-T \fItemplate\fB\fR
  52 .TP
  53 \fB--template \fItemplate\fB\fR
  54  声明创建此数据库的模板数据库。
  55 .PP
  56 .PP
  57  选项 -h，-p，-U， -W，-e 是以文本形式传递给 psql。 选项\fB-O\fR，\fB-D\fR，\fB-T\fR 和 \fB-E\fR 转换为下层的 SQL 命令 CREATE DATABASE [\fBcreate_database\fR(7)]  的选项；参考该条目获取更多相关信息。
  58 .PP
  59 \fBcreatedb\fR 还接受下列命令行参数作为连接参数：
  60 .TP
  61 \fB-h \fIhost\fB\fR
  62 .TP
  63 \fB--host \fIhost\fB\fR
  64  声明运行服务器的主机名。 如果数值以斜扛开头，则它被用做到 Unix 域套接字的路径。
  65 .TP
  66 \fB-p \fIport\fB\fR
  67 .TP
  68 \fB--port \fIport\fB\fR
  69  声明服务器 侦听的等待连接的互联网 TCP 端口或一个本地 Unix 域套接字文件扩展（描述符）。
  70 .TP
  71 \fB-U \fIusername\fB\fR
  72 .TP
  73 \fB--username \fIusername\fB\fR
  74  进行联接的用户名。
  75 .TP
  76 \fB-W\fR
  77 .TP
  78 \fB--password\fR
  79  强制口令提示符。
  80 .PP
  81 .SH "ENVIRONMENT 环境"
  82 .TP
  83 \fBPGDATABASE\fR
  84  如果设置了，那么就是要创建的数据库名字，除非在命令行上覆盖了。
  85 .TP
  86 \fBPGHOST\fR
  87 .TP
  88 \fBPGPORT\fR
  89 .TP
  90 \fBPGUSER\fR
  91  缺省连接参数。PGUSER 还决定了要创建的数据库名字－－ 如果我们没有在命令行上声明数据库名字，也没有用 \fBPGDATABASE\fR  声明的话。
  92 .SH "DIAGNOSTICS 诊断"
  93 .PP
  94  如果出现错误，将会显示后端错误信息。参阅 CREATE DATABASE [\fBcreate_database\fR(7)]  和 \fBpsql\fR(1) 获取可能信息描述。 数据库服务器必须在目标服务器上运行。同样，前端库 libpq  使用的缺省连接设置和环境变量都将适用。
  95 .SH "EXAMPLES 例子"
  96 .PP
  97  用缺省数据库服务器创建一个数据库 demo：
  98 .sp
  99 .nf
 100 $ \fBcreatedb demo\fR
 101 CREATE DATABASE
 102 .sp
 103 .fi
 104  响应信息与运行 CREATE DATABASE SQL 命令时一样。
 105 .PP
 106  用在主机eden上的服务器创建数据库 demo， 端口是 5000，使用 LATIN1 编码方式，并且显示执行的命令：
 107 .sp
 108 .nf
 109 $ \fBcreatedb -p 5000 -h eden -E LATIN1 -e demo\fR
 110 CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
 111 CREATE DATABASE
 112 .sp
 113 .fi
 114 .SH "SEE ALSO 参见"
 115 \fBdropdb\fR(1), CREATE DATABASE [\fBcreate_database\fR(7)]
 116
 117 .SH "译者"
 118 .B Postgresql 中文网站
 119 .B 何伟平 <laser@pgsqldb.org>