.TH "CREATEDB" "1" "2003-11-02" "Application" "PostgreSQL Client Applications"
.SH NAME
createdb \- 創建一個新的 PostgreSQL 數據庫

.SH SYNOPSIS
.sp
\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
.SH "DESCRIPTION  描述"
.PP
\fBcreatedb\fR 創建一個新的 PostgreSQL 數據庫。
.PP
 通常，執行這個命令的數據庫用戶成爲新數據庫的所有者。 不過，如果執行用戶擁有合適的權限，那麼他可以通過 \fB\-O\fP 指定合適的用戶。
.PP
\fBcreatedb\fR 是一個 SQL 命令 CREATE DATABASE [\fBcreate_database\fR(7)] 的封裝。 因此，用哪種方法創建數據庫都沒什麼特別的。
.SH "OPTIONS 選項"
.PP
\fBcreatedb\fR 接受下列命令行參數：
.TP
\fB\fIdbname\fB\fR
 聲明要創建的數據庫名。該名稱應該在本節點的 PostgreSQL 所有數據庫裏面是唯一的。 缺省是與當前系統用戶同名。
.TP
\fB\fIdescription\fB\fR
 這個選項聲明一個與新創建的數據庫相關的註解。
.TP
\fB-D \fIlocation\fB\fR
.TP
\fB--location \fIlocation\fB\fR
 聲明變更了的數據庫集羣（節點）的位置。 又見 \fBinitlocation\fR(1).
.TP
\fB-e\fR
.TP
\fB--echo\fR
 回顯 createdb 生成的命令並且把它發送到服務器。
.TP
\fB-E \fIencoding\fB\fR
.TP
\fB--encoding \fIencoding\fB\fR
 聲明用於此數據庫的字符編碼方式。
.TP
\fB-O \fIowner\fB\fR
.TP
\fB--owner \fIowner\fB\fR
 指定將擁有新數據庫的數據庫用戶。
.TP
\fB-q\fR
.TP
\fB--quiet\fR
 不顯示響應。
.TP
\fB-T \fItemplate\fB\fR
.TP
\fB--template \fItemplate\fB\fR
 聲明創建此數據庫的模板數據庫。
.PP
.PP
 選項 -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)]  的選項；參考該條目獲取更多相關信息。
.PP
\fBcreatedb\fR 還接受下列命令行參數作爲連接參數：
.TP
\fB-h \fIhost\fB\fR
.TP
\fB--host \fIhost\fB\fR
 聲明運行服務器的主機名。 如果數值以斜扛開頭，則它被用做到 Unix 域套接字的路徑。
.TP
\fB-p \fIport\fB\fR
.TP
\fB--port \fIport\fB\fR
 聲明服務器 偵聽的等待連接的互聯網 TCP 端口或一個本地 Unix 域套接字文件擴展（描述符）。
.TP
\fB-U \fIusername\fB\fR
.TP
\fB--username \fIusername\fB\fR
 進行聯接的用戶名。
.TP
\fB-W\fR
.TP
\fB--password\fR
 強制口令提示符。
.PP
.SH "ENVIRONMENT 環境"
.TP
\fBPGDATABASE\fR
 如果設置了，那麼就是要創建的數據庫名字，除非在命令行上覆蓋了。
.TP
\fBPGHOST\fR
.TP
\fBPGPORT\fR
.TP
\fBPGUSER\fR
 缺省連接參數。PGUSER 還決定了要創建的數據庫名字－－ 如果我們沒有在命令行上聲明數據庫名字，也沒有用 \fBPGDATABASE\fR  聲明的話。
.SH "DIAGNOSTICS 診斷"
.PP
 如果出現錯誤，將會顯示後端錯誤信息。參閱 CREATE DATABASE [\fBcreate_database\fR(7)]  和 \fBpsql\fR(1) 獲取可能信息描述。 數據庫服務器必須在目標服務器上運行。同樣，前端庫 libpq  使用的缺省連接設置和環境變量都將適用。
.SH "EXAMPLES 例子"
.PP
 用缺省數據庫服務器創建一個數據庫 demo：
.sp
.nf
$ \fBcreatedb demo\fR
CREATE DATABASE
.sp
.fi
 響應信息與運行 CREATE DATABASE SQL 命令時一樣。
.PP
 用在主機eden上的服務器創建數據庫 demo， 端口是 5000，使用 LATIN1 編碼方式，並且顯示執行的命令：
.sp
.nf
$ \fBcreatedb -p 5000 -h eden -E LATIN1 -e demo\fR
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
CREATE DATABASE
.sp
.fi
.SH "SEE ALSO 參見"
\fBdropdb\fR(1), CREATE DATABASE [\fBcreate_database\fR(7)]

.SH "譯者"
.B Postgresql 中文網站
.B 何偉平 <laser@pgsqldb.org>
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR