?
このドキュメントでは、 php中國(guó)語(yǔ)ネットマニュアル リリース
createdb [connection-option...] [option...] [dbname] [description]
createdb創(chuàng)建一個(gè)新PostgreSQL數(shù)據(jù)庫(kù)。
通常,執(zhí)行這個(gè)命令的數(shù)據(jù)庫(kù)用戶(hù)將成為新數(shù)據(jù)庫(kù)的所有者。不過(guò), 如果擁有合適的權(quán)限,那么也可以通過(guò)-O指定其它用戶(hù)。
createdb是一個(gè)SQL命令CREATE DATABASE的封裝。 因此,兩種方法創(chuàng)建的數(shù)據(jù)庫(kù)都一樣。
createdb接受下列命令行參數(shù):
要?jiǎng)?chuàng)建的數(shù)據(jù)庫(kù)名。該名稱(chēng)應(yīng)該在本節(jié)點(diǎn)的所有 PostgreSQL數(shù)據(jù)庫(kù)里面必須是唯一的。 缺省是與當(dāng)前系統(tǒng)用戶(hù)同名。
這個(gè)選項(xiàng)聲明一個(gè)與新創(chuàng)建的數(shù)據(jù)庫(kù)相關(guān)的注解。
指定數(shù)據(jù)庫(kù)的缺省表空間
回顯createdb生成并它發(fā)送到服務(wù)器的命令。
指定在此數(shù)據(jù)庫(kù)中要使用的環(huán)境。這相當(dāng)于指定--lc-collate和 --lc-ctype。
聲明要在數(shù)據(jù)庫(kù)中使用的LC_COLLATE設(shè)置。
聲明要再次數(shù)據(jù)庫(kù)中使用的LC_CTYPE設(shè)置。
聲明此數(shù)據(jù)庫(kù)的字符編碼。PostgreSQL 服務(wù)器支持的字符集在Section 22.2.1里列出。
指定將擁有新數(shù)據(jù)庫(kù)的用戶(hù)
聲明創(chuàng)建此數(shù)據(jù)庫(kù)的模板數(shù)據(jù)庫(kù)
輸出createdb版本并退出。
顯示關(guān)于createdb命令行的幫助并退出。
選項(xiàng)-D,-l,-E, -O和-T對(duì)應(yīng)底層SQL命令 CREATE DATABASE的選項(xiàng), 更多信息可以參考該命令的手冊(cè)頁(yè)。
createdb還接受下列命令行參數(shù)作為連接參數(shù):
指定運(yùn)行服務(wù)器的主機(jī)名。如果數(shù)值以斜杠開(kāi)頭則被用作到Unix域套接字的路徑。
服務(wù)器偵聽(tīng)的TCP端口或一個(gè)本地Unix域套接字文件的擴(kuò)展(描述符)
進(jìn)行連接的用戶(hù)名
從不發(fā)出密碼提示。若服務(wù)器請(qǐng)求密碼認(rèn)證并且一個(gè)密碼不能通過(guò)其他 像.pgpass文件的方式獲得,此連接嘗試將會(huì)失敗。 該選項(xiàng)在批量作業(yè)和腳本中是很有用的,在當(dāng)前沒(méi)有用戶(hù)可以輸入密碼時(shí)。
在連接到一個(gè)數(shù)據(jù)可之前,強(qiáng)制createdb 提示密碼。
連接數(shù)據(jù)庫(kù)之前強(qiáng)制createdb口令提示符。
該選項(xiàng)從不是最重要的,盡管若服務(wù)器請(qǐng)求密碼認(rèn)證 createdb會(huì)自動(dòng)提示密碼。然而, createdb將浪費(fèi)一個(gè)連接嘗試來(lái)發(fā)現(xiàn)服務(wù)器想 要一個(gè)密碼。在一些情況下,輸入-W來(lái)避免額外的連接嘗試是 值得的。
如果設(shè)置了,那么就是要?jiǎng)?chuàng)建的數(shù)據(jù)庫(kù)名字,除非在命令行上進(jìn)行了覆蓋。
缺省連接參數(shù)。如果沒(méi)有在命令行上聲明數(shù)據(jù)庫(kù)名字, 也沒(méi)有用PGDATABASE聲明的話(huà),PGUSER還決定了要?jiǎng)?chuàng)建的數(shù)據(jù)庫(kù)名字。
This utility, like most other PostgreSQL utilities, also uses the environment variables supported by libpq (see Section 31.13). 這個(gè)實(shí)用程序,跟大多數(shù)其他PostgreSQL實(shí)用程序一樣,也試用 libpq支持的環(huán)境變量。(參閱Section 31.13)。
如果出現(xiàn)錯(cuò)誤,將會(huì)顯示后端錯(cuò)誤信息。 參閱CREATE DATABASE 和psql獲取可能信息描述。數(shù)據(jù)庫(kù)服務(wù)器必須在目標(biāo)服務(wù)器上運(yùn)行。 同樣,前端庫(kù)libpq使用的缺省連接設(shè)置和環(huán)境變量都將適用。
用缺省數(shù)據(jù)庫(kù)服務(wù)器創(chuàng)建一個(gè)demo數(shù)據(jù)庫(kù):
$ createdb demo
在主機(jī)eden上創(chuàng)建demo數(shù)據(jù)庫(kù), 端口是5000,使用LATIN1編碼方式,并且顯示執(zhí)行的命令:
$ createdb -p 5000 -h eden -E LATIN1 -e demo CREATE DATABASE demo ENCODING 'LATIN1';