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