dropuser — 移除 PostgreSQL 使用者帳戶
dropuser
[connection-option
...] [option
...] [username
]
dropuser 移除現有的 PostgreSQL 使用者。超級使用者可以使用此命令移除任何角色;否則,只有非超級使用者角色可以被移除,並且只能由擁有 CREATEROLE
權限並且已被授予目標角色 ADMIN OPTION
的使用者移除。
dropuser 是SQL命令 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
指定是否在診斷訊息中使用顏色。 可能的值為 always
、auto
和 never
。
與大多數其他 PostgreSQL 公用程式一樣,此公用程式也使用 libpq 支援的環境變數(請參閱 第 32.15 節)。
如果遇到困難,請參閱 DROP ROLE 和 psql,以了解潛在問題和錯誤訊息的討論。 資料庫伺服器必須在目標主機上執行。 此外,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;
如果您在文件中發現任何不正確、與您使用特定功能的經驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。