createdb · PostgreSQL 中文文檔 9.3

# createdb ## Name createdb?--?創建一個新 PostgreSQL 數據庫 ## Synopsis `createdb` [`_connection-option_`...] [`_option_`...] [`_dbname_` [`_description_`]] ## 描述 createdb 創建一個新 PostgreSQL 數據庫。通常，執行這個命令的數據庫用戶將成為新數據庫的所有者。不過，如果擁有合適的權限，那么也可以通過 `-O` 指定其他用戶。 createdb 是一個 SQL 命令 [CREATE DATABASE](#calibre_link-111)的封裝。因此，用哪種方法創建的數據庫都一樣。 ## 選項 createdb 接受下列命令行參數： `_dbname_` 要創建的數據庫名。該名稱應該在本節點的所有PostgreSQL 數據庫中是唯一的。缺省創建的數據庫名稱是與當前系統用戶同名。 `_description_` 指定與新創建的數據庫相關的注釋。 `-D` `_tablespace_``--tablespace=``_tablespace_` 指定數據庫默認表空間。（這個名稱被當作一個用雙引號括起來的標識符處理。） `-e` `--echo` 回顯 createdb 生成并發送到服務端的命令。 `-E` `_encoding_` `--encoding=``_encoding_` 指定在此數據庫中使用的字符編碼方案。 PostgreSQL 服務器支持的字符集在 [Section 22.3.1](#calibre_link-1463) 里列出。 `-l` `_locale_` `--locale=``_locale_` 指定在此數據庫中使用的語言環境。這相當于同時指定 `--lc-collate` 和 `--lc-ctype`選項。 `--lc-collate=``_locale_` 指定數據庫的LC_COLLATE設置。 `--lc-ctype=``_locale_` 指定數據庫的LC_CTYPE設置。 `-O` `_owner_` `--owner=``_owner_` 指定將擁有新數據庫的用戶。（這個名稱被當作一個用雙引號括起來的標識符處理。） `-T` `_template_` `--template=``_template_` 指定創建此數據庫的模板數據庫。（這個名稱被當作一個用雙引號括起來的標識符處理。） `-V` `--version` 輸出createdb命令的版本信息，然后退出。 `-?` `--help` 顯示createdb命令的幫助信息，然后退出。選項 `-D`, `-l`, `-E`, `-O`, 和 `-T` 對應底層的SQL命令 [CREATE DATABASE](#calibre_link-111)的選項；更多信息可以參考該命令的手冊頁。 createdb還接受以下命令行選項用于連接參數： `-h` `_host_` `--host=``_host_` 指定運行服務器的主機名。如果數值以斜杠開頭則被用作到Unix域套接字的路徑。 `-p` `_port_` `--port=``_port_` 指定服務器偵聽的TCP端口或一個本地Unix域套接字文件的擴展(描述符)。 `-U` `_username_` `--username=``_username_` 進行聯接的用戶名。 `-w` `--no-password` 永遠不提示輸入密碼。如果服務器要求密碼驗證和密碼通過其他方式如`.pgpass`文件（驗證）不可用，則聯接嘗試將失敗。此選項在不需要用戶輸入密碼的批處理作業和腳本中非常有用。 `-W` `--password` 強制createdb聯接到數據庫之前提示輸入密碼。這個選項不是必須的，如果服務器要求認證密碼 createdb會自動提示需輸入密碼。然而，createdb會浪費一個聯接嘗試判斷出該服務器需要密碼。在某些情況下，這是值得鍵入`-W`以避免多余的聯接嘗試。 `--maintenance-db=``_dbname_` 指定要創建新數據庫時聯接的數據庫名稱。如果沒有指定，將使用`postgres`數據庫；如果不存在（或是正在創建的新數據庫的名稱），將使用`template1`數據庫。 ## 環境變量 `PGDATABASE` 如果設置了，那么就是要創建的新數據庫的名稱，除非在命令行上進行覆蓋。 `PGHOST` `PGPORT` `PGUSER` 缺省的聯接參數。如果沒有在命令行上和`PGDATABASE` 中聲明數據庫名稱的話，`PGUSER` 還決定了要創建的數據庫名稱。 . 此實用工具，像大多其他的PostgreSQL實用工具，還使用 libpq支持的環境變量（見 [Section 31.14](#calibre_link-39)）。 ## 診斷如果有問題,將會顯示后端錯誤信息。參閱[CREATE DATABASE](#calibre_link-111) 和[psql](#calibre_link-23)獲取可能的問題和錯誤消息的描述。數據庫服務端必須運行在目標主機。此外，前端庫libpq中的所有缺省連接設置和環境變量都將適用。 ## 示例用缺省數據庫服務器創建一個`demo`數據庫： ``` <samp class="literal">$</samp> <kbd class="literal">createdb demo</kbd> ``` 在主機`eden`上創建`demo`數據庫，端口是5000，使用`LATIN1`編碼方案，并且回顯執行的命令： ``` <samp class="literal">$</samp> <kbd class="literal">createdb -p 5000 -h eden -E LATIN1 -e demo</kbd> <samp class="literal">CREATE DATABASE demo ENCODING 'LATIN1';</samp> ``` ## 另請參閱 [dropdb](#calibre_link-35), [CREATE DATABASE](#calibre_link-111)