dropdb · PostgreSQL 中文文檔 9.3

# dropdb ## Name dropdb?--?刪除一個 PostgreSQL 數據庫 ## Synopsis `dropdb` [`_connection-option_`...] [`_option_`...] `_dbname_` ## 描述 dropdb 刪除一個現有 PostgreSQL 數據庫。執行此命令的用戶必須是數據庫超級用戶或者是數據庫的所有者。 dropdb是對 SQL命令[DROP DATABASE](#calibre_link-38)的封裝。因此，用哪種方法刪除數據庫都一樣。 ## 選項 dropdb 接受下列命令行參數： `_dbname_` 指定要刪除的數據庫名稱 `-e``--echo` 回顯dropdb生成并發送到服務端的命令。 `-i` `--interactive` 在做任何破壞性動作前發出確認提示。 `-V` `--version` 輸出dropdb命令的版本信息，然后退出。 `--if-exists` 不要拋出如果數據庫不存在時發出的錯誤。 `-?` `--help` 顯示dropdb命令的幫助信息，然后退出。 dropdb 還接受以下命令行選項用于連接參數： `-h` `_host_` `--host=``_host_` 指定運行服務器的主機名。如果數值以斜杠開頭則被用作到Unix域套接字的路徑。 `-p` `_port_` `--port=``_port_` 指定服務器偵聽的TCP端口或一個本地Unix域套接字文件的擴展(描述符)。 `-U` `_username_` `--username=``_username_` 進行聯接的用戶名。 `-w` `--no-password` 永遠不提示輸入密碼。如果服務器要求密碼驗證和密碼通過其他方式如`.pgpass`文件（驗證）不可用，則聯接嘗試將失敗。此選項在不需要用戶輸入密碼的批處理作業和腳本中非常有用。 `-W` `--password` 強制 dropdb 聯接到數據庫之前提示輸入密碼。這個選項不是必須的，如果服務器要求認證密碼 dropdb 會自動提示需輸入密碼。然而 dropdb 會浪費一個聯接嘗試判斷出該服務器需要密碼。在某些情況下，這是值得鍵入 `-W` 以避免多余的聯接嘗試。 `--maintenance-db=``_dbname_` 指定要刪除數據庫時聯接的數據庫名稱。如果沒有指定，將使用`postgres`數據庫；如果不存在（或是正在被刪除的數據庫），將使用`template1`數據庫。 ## 環境變量 `PGHOST` `PGPORT` `PGUSER` 缺省的聯接參數此實用工具，像大多其他的PostgreSQL 實用工具，還使用libpq支持的環境變量 (見 [Section 31.14](#calibre_link-39))。 ## 診斷如果有問題，參閱 [DROP DATABASE](#calibre_link-38) 和[psql](#calibre_link-23) 獲取可能的問題和錯誤消息的描述。數據庫服務器必須在目標機器上運行。此外，前端庫 libpq中的所有缺省連接設置和環境變量都將適用。 ## 示例刪除缺省數據庫服務器上的`demo`數據庫： ``` <samp class="literal">$</samp> <kbd class="literal">dropdb demo</kbd> ``` 在主機`eden`上刪除`demo`數據庫，端口是5000，執行命令前提示并且回顯執行的命令： ``` <samp class="literal">$</samp> <kbd class="literal">dropdb -p 5000 -h eden -i -e demo</kbd> <samp class="literal">Database "demo" will be permanently deleted. Are you sure? (y/n)</samp> <kbd class="literal">y</kbd> <samp class="literal">DROP DATABASE demo;</samp> ``` ## 另請參閱 [createdb](#calibre_link-40), [DROP DATABASE](#calibre_link-38)