# dropuser

dropuser — 移除 PostgreSQL 使用者帳戶

## 語法

`dropuser` \[*`connection-option`*...] \[*`option`*...] \[*`username`*]

## 說明

dropuser 移除現有的 PostgreSQL 使用者。只有具有 CREATEROLE 權限的超級使用者或一般使用者才能移除 PostgreSQL 使用者。（但要移除超級使用者，您還必須自己是超級使用者。）

dropuser 是 SQL 指令 [DROP ROLE](/12/reference/sql-commands/drop-role.md) 的一個封裝。透過此實用工具和透過存取伺服器的其他方法移除使用者，之間沒有區別。

## 參數

dropuser 接受以下的命令列參數：

*`username`*

指定要移除的 PostgreSQL 使用者的名稱。如果在命令列中沒有指定名稱，則會提示您輸入名稱，如同使用 -i / -interactive。

`-e`\
`--echo`

顯示 dropuser 發送到伺服器的指令。

`-i`\
`--interactive`

在實際移除使用者之前提示確認，如果沒有在命令列中指定使用者名稱，會提示輸入。

`-V`\
`--version`

輸出 dropuser 版本然後退出。

`--if-exists`

如果使用者不存在，請不要拋出錯誤。在這種情況下發布 NOTICE。

`-?`\
`--help`

顯示有關 dropuser 命令列參數的說明，然後退出。

dropuser 還接受連線有關的以下命令列參數：

`-h` *`host`*\
`--host=`*`host`*

指定運行伺服器的主機名。如果以斜線開頭，則將其視為 Unix domain socket 的目錄。

`-p` *`port`*\
`--port=`*`port`*

指定伺服器正在監聽連線的 TCP 連接埠或本地 Unix domain socket 檔案延伸名稱。

`-U` *`username`*\
`--username=`*`username`*

要連線的使用者名稱（不是要移除的使用者名稱）。

`-w`\
`--no-password`

避免發出密碼提示。如果伺服器需要密碼驗證，請透過其他方式（如 .pgpass 檔案），無法使用密碼的話，則連線嘗試將會失敗。此選項可用於沒有使用者輸入密碼的批次處理作業和腳本。

`-W`\
`--password`

強制 dropuser 在連線到資料庫之前提示輸入密碼。

此選項從來不是必須的，因為如果伺服器需要密碼認證，dropuser 將自動提示輸入密碼。然而，dropuser 會浪費連線嘗試發現伺服器想要密碼。在某些情況下，值得輸入 -W 以避免額外的連線嘗試。

## 環境變數

`PGHOST`\
`PGPORT`\
`PGUSER`

預設連線參數

與其他大多數 PostgreSQL 實用工具一樣，此工具也使用 libpq 支援的環境變數（請參閱[第 33.14 節](/12/client-interfaces/libpq-c-library/environment-variables.md)）。

## 診斷

如果遇到困難，請參閱 [DROP ROLE](/12/reference/sql-commands/drop-role.md) 和 [psql](/12/reference/client-applications/psql.md)，以便討論潛在問題和錯誤訊息。資料庫伺服器必須在目標主機上運行。此外，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;
```

## 參閱

[createuser](/12/reference/client-applications/createuser.md), [DROP ROLE](/12/reference/sql-commands/drop-role.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.postgresql.tw/12/reference/client-applications/dropuser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.