CREATE DATABASE · PostgreSQL 中文文檔 9.3

# CREATE DATABASE ## Name CREATE DATABASE?--?創建一個新數據庫 ## Synopsis ``` CREATE DATABASE _name_ [ [ WITH ] [ OWNER [=] _user_name_ ] [ TEMPLATE [=] _template_ ] [ ENCODING [=] _encoding_ ] [ LC_COLLATE [=] _lc_collate_ ] [ LC_CTYPE [=] _lc_ctype_ ] [ TABLESPACE [=] _tablespace_name_ ] [ CONNECTION LIMIT [=] _connlimit_ ] ] ``` ## 描述 `CREATE DATABASE`創建一個新PostgreSQL數據庫。要創建一個數據庫，你必須是一個超級用戶或者有特殊的`CREATEDB`權限。參閱[CREATE USER](#calibre_link-15)。缺省情況下新數據庫將通過復制標準系統數據庫`template1`來創建。可以通過`TEMPLATE` `_name_`指定不同的模板。尤其是，用`TEMPLATE template0`創建一個很純凈的、只包括PostgreSQL預定義的標準對象的數據庫。這個方法對于避免把任何已經加入到`template1`里的本地安裝對象拷貝到新數據庫是非常有用的。 ## 參數 `_name_` 要創建的數據庫名字。 `_user_name_` 數據庫用戶的名字，他將是新數據庫的所有者，或者是使用`DEFAULT`選項來指定當前缺省用戶(也就是執行命令的用戶)。要創建一個其他角色所有的數據庫，你必須是那個角色的直接或間接的成員，或者是超級用戶。 `_template_` 模板名，即從哪個模板創建新數據庫，或者使用`DEFAULT`選項來指定缺省模板(`template1`)。 `_encoding_` 創建新數據庫使用的字符編碼。可以使用文本名字(例如`'SQL_ASCII'`)、整數編號或是`DEFAULT`選項來指定(模版數據庫的編碼)。 PostgreSQL服務器支持的字符集在[Section 22.3.1](#calibre_link-1463)里有描述。額外的限制參見下文。 `_lc_collate_` 用于新數據庫的排序規則(LC_COLLATE)。這影響到應用對字符串的排序順序，例如：在有ORDER BY的查詢中，以及用于文本列的索引的順序。在默認情況下，使用模板數據庫的排序規則。請看以下附加的限制。 `_lc_ctype_` 用于新數據庫的字符分類(`LC_CTYPE`)。這影響字符的分類，例如：小寫、大寫和數字。默認情況下使用模板數據庫的字符分類。請看以下附加的限制。 `_tablespace_name_` 和新數據庫關聯的表空間名字，或者使用`DEFAULT`選項表示使用模版數據庫的表空間。這個表空間將成為在這個數據庫里創建的對象的缺省表空間。參閱[CREATE TABLESPACE](#calibre_link-99)獲取更多信息。 `_connlimit_` 數據庫可以接受多少并發的連接。-1(缺省)意味著沒有限制。可選參數可以按任意順序書寫，而不僅僅是上面顯示的順序。 ## 注意 `CREATE DATABASE`不能在事務塊里面執行。類似"could not initialize database directory"這樣的錯誤，最有可能是因為數據目錄的權限不夠或者磁盤滿之類的文件系統問題。使用[DROP DATABASE](#calibre_link-38)刪除一個數據庫。程序[createdb](#calibre_link-40)是這個命令的封裝，使用更加方便。盡管可以通過把某數據庫名聲明為模板而不是用`template1`，但是這(還)不是一個通用的"`COPY DATABASE`"功能。主要的限制是在從模版復制的時候不允許有其它會話鏈接到模版數據庫上。如果在開始執行`CREATE DATABASE`的時候有其它會話正連接在模版數據庫上，那么操作將會失敗；否則直到`CREATE DATABASE`完成之后，才允許對模板數據庫建立新的會話連接。參見[Section 21.3](#calibre_link-1266)獲取更多信息。為一個新數據庫指定的字符集編碼必須兼容所選擇的區域環境設置 (`LC_COLLATE`和`LC_CTYPE`)。若區域設置為 `C`(或相當于`POSIX`)，那么所有的編碼都允許，但是對于其他的區域設置，只有一個編碼能正常工作。（然而，在Windows系統中， UTF-8編碼可用于任何區域設置。） `CREATE DATABASE`將會允許超級用戶來指定`SQL_ASCII`編碼而不考慮區域設置情況，這種做法已過時了，是不宜采用的，它會導致編碼與不兼容區域設置的數據被存儲在數據庫中時字符串函數功能會不正常。除了`template0`用作模板的時候，其他數據庫的編碼和區域設置必須匹配模板數據庫。這是因為其他數據庫可能會包含不匹配指定編碼的數據，或者可能包含排序順序受`LC_COLLATE`和`LC_CTYPE`影響的索引。復制這些數據會導致數據庫被新設置破壞。然而，`template0`公認是不包含任何會受到影響的數據或者索引的。 `CONNECTION LIMIT`選項只是近似地強制；如果兩個新的連接幾乎同時發起，而只剩下一個連接"slot"了，那么很可能兩個連接都失效。另外，超級用戶連接時不受這個限制。 ## 例子創建一個新數據庫: ``` CREATE DATABASE lusiadas; ``` 創建一個由用戶`salesapp`擁有的數據庫`sales`，缺省表空間是`salesspace`： ``` CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace; ``` 創建一個數據庫`music`，支持ISO-8859-1字符集： ``` CREATE DATABASE music ENCODING 'LATIN1' TEMPLATE template0; ``` 在這個例子中，`TEMPLATE template0`選項只在`template1`的編碼不是ISO-8859-1時被請求。請注意：更改編碼可能也會需要選擇新的`LC_COLLATE`和`LC_CTYPE`設置。 ## 兼容性在sql標準里頭沒有 CREATE DATABASE 語句。數據庫等同于目錄，其創建是交給具體的數據庫實現去定義的。 ## 參見 [ALTER DATABASE](#calibre_link-1431), [DROP DATABASE](#calibre_link-38)