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
 
響應資訊與執行 CREATE DATABASE SQL 命令時一樣。

用在主機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 中文網站 何偉平 <[email protected]>

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

Recommended readings

Pages related to createdb you should read also: