支援的版本:目前 (17) / 16 / 15 / 14 / 13
開發版本:devel
不支援的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

dropuser

dropuser — 移除 PostgreSQL 使用者帳戶

概要

dropuser [connection-option...] [option...] [username]

描述

dropuser 移除現有的 PostgreSQL 使用者。超級使用者可以使用此命令移除任何角色;否則,只有非超級使用者角色可以被移除,並且只能由擁有 CREATEROLE 權限並且已被授予目標角色 ADMIN OPTION 的使用者移除。

dropuserSQL命令 DROP ROLE 的包裝函式。透過此工具移除使用者與透過其他方式存取伺服器之間沒有實際差異。

選項

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

預設連線參數

PG_COLOR

指定是否在診斷訊息中使用顏色。 可能的值為 alwaysautonever

與大多數其他 PostgreSQL 公用程式一樣,此公用程式也使用 libpq 支援的環境變數(請參閱 第 32.15 節)。

診斷

如果遇到困難,請參閱 DROP ROLEpsql,以了解潛在問題和錯誤訊息的討論。 資料庫伺服器必須在目標主機上執行。 此外,libpq 前端函式庫使用的任何預設連線設定和環境變數都將適用。

範例

從預設資料庫伺服器移除使用者 joe

$ dropuser joe

使用主機 eden 上埠 5000 上的伺服器移除使用者 joe,並進行驗證和查看底層命令

$ dropuser -p 5000 -h eden -i -e joe
Role "joe" will be permanently removed.
Are you sure? (y/n) y
DROP ROLE joe;

另請參閱

createuserDROP ROLE

提交更正

如果您在文件中發現任何不正確、與您使用特定功能的經驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。