PostgreSQL CREATE DATABASE

描述

CREATE DATABASE創(chuàng)建一個(gè)新的PostgreSQL數(shù)據(jù)庫(kù)。

要?jiǎng)?chuàng)建一個(gè)數(shù)據(jù)庫(kù)，你必須是一個(gè)超級(jí)用戶或者具有特殊的CREATEDB特權(quán)。見CREATE ROLE。

默認(rèn)情況下，新數(shù)據(jù)庫(kù)將通過(guò)克隆標(biāo)準(zhǔn)系統(tǒng)數(shù)據(jù)庫(kù)template1被創(chuàng)建?？梢酝ㄟ^(guò)寫TEMPLATE name 指定一個(gè)不同的模板。特別地，通過(guò)寫TEMPLATE template0你可以創(chuàng)建一個(gè)原始的數(shù)據(jù)庫(kù)（其中沒有用戶定義的對(duì)象存在并且系統(tǒng)對(duì)象沒有被更改），它將只包含你的PostgreSQL版本所預(yù)定義的標(biāo)準(zhǔn)對(duì)象。如果你希望避免拷貝任何可能被加入到template1中的本地安裝對(duì)象，這將有所幫助。

參數(shù)

可選的參數(shù)可以被寫成任何順序，不用按照上面說(shuō)明的順序。

注解

CREATE DATABASE不能在一個(gè)事務(wù)塊內(nèi)被執(zhí)行。

帶有一行“不能初始化數(shù)據(jù)庫(kù)目錄”的錯(cuò)誤大部分與在數(shù)據(jù)目錄上權(quán)限不足、磁盤滿或其他文件系統(tǒng)問(wèn)題有關(guān)。

使用DROP DATABASE移除一個(gè)數(shù)據(jù)庫(kù)。

程序createdb是這個(gè)命令的一個(gè)包裝器程序，為了使用方便而提供。

數(shù)據(jù)庫(kù)層面的配置參數(shù)(參見ALTER DATABASE)和 數(shù)據(jù)庫(kù)級(jí)權(quán)限(參見GRANT)不會(huì)從模板數(shù)據(jù)庫(kù)中復(fù)制。

盡管可以通過(guò)指定一個(gè)數(shù)據(jù)庫(kù)作為模板來(lái)從其中而不是template1復(fù)制，這（還）不是“COPY DATABASE”功能的一般目的。主要的限制是在模板數(shù)據(jù)庫(kù)被拷貝期間其他會(huì)話不能連接到它。如果CREATE DATABASE啟動(dòng)時(shí)還存在任何其他連接，它將失敗。否則，到模板數(shù)據(jù)庫(kù)的新連接將被擋在外面直到 CREATE DATABASE完成。詳見第 22.3 節(jié)。

為新數(shù)據(jù)庫(kù)指定的字符集編碼必須與選定的區(qū)域設(shè)置（LC_COLLATE和LC_CTYPE）相兼容。如果區(qū)域是C（或者等效的POSIX），那么所有編碼都被允許，但是對(duì)于其他區(qū)域設(shè)置只有一種編碼能正確工作（不過(guò)，在 Windows 上 UTF-8 編碼能夠與任何區(qū)域一起使用）。 CREATE DATABASE將允許超級(jí)用戶指定SQL_ASCII編碼而不管區(qū)域設(shè)置，但是這種選擇已被廢棄并且可能在數(shù)據(jù)與數(shù)據(jù)庫(kù)中存儲(chǔ)的區(qū)域不是編碼兼容時(shí)讓字符串函數(shù)行為失當(dāng)。

編碼和區(qū)域設(shè)置必須匹配模板數(shù)據(jù)的編碼和區(qū)域，除非template0被用作模板。這是因?yàn)槠渌麛?shù)據(jù)庫(kù)可能包含不匹配指定編碼的數(shù)據(jù)，或者可能包含排序順序受LC_COLLATE和LC_CTYPE影響的索引?？截愡@種數(shù)據(jù)將導(dǎo)致一個(gè)由于該新設(shè)置損壞的數(shù)據(jù)庫(kù)。不過(guò)，template0是不會(huì)含有任何可能被影響的數(shù)據(jù)或索引的。

CONNECTION LIMIT選項(xiàng)大概是唯一會(huì)被強(qiáng)制的，如果兩個(gè)新會(huì)話在大約同一時(shí)間開始并且那時(shí)該數(shù)據(jù)庫(kù)只剩有一個(gè)連接“槽”，可能兩者都會(huì)失敗。還有，該限制對(duì)超級(jí)用戶或后臺(tái)工作進(jìn)程無(wú)效。

例子

要?jiǎng)?chuàng)建一個(gè)新數(shù)據(jù)庫(kù)：

CREATE DATABASE lusiadas;

要在一個(gè)默認(rèn)表空間salesspace中創(chuàng)建一個(gè)被用戶salesapp擁有的新數(shù)據(jù)庫(kù)sales：

CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;

要用不同的語(yǔ)言環(huán)境創(chuàng)建數(shù)據(jù)庫(kù)music：

CREATE DATABASE music
    LOCALE 'sv_SE.utf8'
    TEMPLATE template0;

在這個(gè)例子中，如果指定的語(yǔ)言環(huán)境與template1中的語(yǔ)言環(huán)境不同， 則需要TEMPLATE template0子句。（如果不是，則明確指定區(qū)域設(shè)置是多余的。）

要用不同的語(yǔ)言環(huán)境和不同的字符集編碼創(chuàng)建數(shù)據(jù)庫(kù)music2：

CREATE DATABASE music2
    LOCALE 'sv_SE.iso885915'
    ENCODING LATIN9
    TEMPLATE template0;

指定的區(qū)域設(shè)置和編碼設(shè)置必須匹配，否則會(huì)報(bào)告錯(cuò)誤。

請(qǐng)注意，區(qū)域名稱是特定于操作系統(tǒng)的， 因此上述命令可能無(wú)法在任何地方以相同的方式工作。

兼容性

在 SQL 標(biāo)準(zhǔn)中沒有CREATE DATABASE語(yǔ)句。數(shù)據(jù)庫(kù)等效于目錄，而目錄的創(chuàng)建由實(shí)現(xiàn)定義。

參見