NAME¶

createdb - 創建一個新的 PostgreSQL 數據庫

SYNOPSIS¶

createdb [ option... ] [ dbname ] [ description ]

DESCRIPTION 描述¶

createdb 創建一個新的 PostgreSQL 數據庫。

通常，執行這個命令的數據庫用戶成爲新數據庫的所有者。 不過，如果執行用戶擁有合適的權限，那麼他可以通過 -O 指定合適的用戶。

createdb 是一個 SQL 命令 CREATE DATABASE [create_database(7)] 的封裝。 因此，用哪種方法創建數據庫都沒什麼特別的。

OPTIONS 選項¶

createdb 接受下列命令行參數：

dbname

聲明要創建的數據庫名。該名稱應該在本節點的 PostgreSQL 所有數據庫裏面是唯一的。 缺省是與當前系統用戶同名。

description

這個選項聲明一個與新創建的數據庫相關的註解。

-D location

--location location

聲明變更了的數據庫集羣（節點）的位置。 又見 initlocation(1).

-e

--echo

回顯 createdb 生成的命令並且把它發送到服務器。

-E encoding

--encoding encoding

聲明用於此數據庫的字符編碼方式。

-O owner

--owner owner

指定將擁有新數據庫的數據庫用戶。

-q

--quiet

不顯示響應。

-T template

--template template

聲明創建此數據庫的模板數據庫。

選項 -h，-p，-U， -W，-e 是以文本形式傳遞給 psql。 選項-O，-D，-T 和 -E 轉換爲下層的 SQL 命令 CREATE DATABASE [create_database(7)] 的選項；參考該條目獲取更多相關信息。

createdb 還接受下列命令行參數作爲連接參數：

-h host

--host host

聲明運行服務器的主機名。 如果數值以斜扛開頭，則它被用做到 Unix 域套接字的路徑。

-p port

--port port

聲明服務器 偵聽的等待連接的互聯網 TCP 端口或一個本地 Unix 域套接字文件擴展（描述符）。

-U username

--username username

進行聯接的用戶名。

-W

--password

強制口令提示符。

ENVIRONMENT 環境¶

PGDATABASE

如果設置了，那麼就是要創建的數據庫名字，除非在命令行上覆蓋了。

PGHOST

PGPORT

PGUSER

缺省連接參數。PGUSER 還決定了要創建的數據庫名字－－ 如果我們沒有在命令行上聲明數據庫名字，也沒有用 PGDATABASE 聲明的話。

DIAGNOSTICS 診斷¶

如果出現錯誤，將會顯示後端錯誤信息。參閱 CREATE DATABASE [create_database(7)] 和 psql(1) 獲取可能信息描述。 數據庫服務器必須在目標服務器上運行。同樣，前端庫 libpq 使用的缺省連接設置和環境變量都將適用。

EXAMPLES 例子¶

用缺省數據庫服務器創建一個數據庫 demo：

$ createdb demo
CREATE DATABASE

用在主機eden上的服務器創建數據庫 demo， 端口是 5000，使用 LATIN1 編碼方式，並且顯示執行的命令：

$ createdb -p 5000 -h eden -E LATIN1 -e demo
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
CREATE DATABASE

SEE ALSO 參見¶

dropdb(1), CREATE DATABASE [create_database(7)]

譯者¶

Postgresql 中文網站 何偉平 <laser@pgsqldb.org>

跋¶

本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh