'\" t
.\"     Title: dropuser
.\"    Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026
.\"    Manual: PostgreSQL 18.6 Documentation
.\"    Source: PostgreSQL 18.6
.\"  Language: English
.\"
.TH "DROPUSER" "1" "2026" "PostgreSQL 18.6" "PostgreSQL 18.6 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
dropuser \- حذف یک حساب کاربری PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBdropuser\fR\ 'u
\fBdropuser\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\fIusername\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
dropuser
یک کاربر موجود در
PostgreSQL
را حذف می‌کند\&. کاربران ارشد (Superusers) می‌توانند از این دستور برای حذف هر نقشی استفاده کنند؛ در غیر این صورت، تنها نقش‌های غیر کاربر ارشد قابل حذف هستند و آن هم فقط توسط کاربری که امتیاز
CREATEROLE
را داشته و
ADMIN OPTION
روی نقش هدف به او اعطا شده باشد\&.
.PP
دستور
dropuser
یک پوشش پیرامون دستور
SQL
به نام
\fBDROP ROLE\fR
است\&. هیچ تفاوت مؤثری بین حذف کاربران از طریق این ابزار و روش‌های دیگر دسترسی به سرور وجود ندارد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور
dropuser
آرگومان‌های خط فرمان زیر را می‌پذیرد:
.PP
\fIusername\fR
.RS 4
نام کاربر
PostgreSQL
که باید حذف شود را مشخص می‌کند\&. اگر نامی در خط فرمان مشخص نشده باشد و از گزینه
\fB\-i\fR/\fB\-\-interactive\fR
استفاده شود، برای وارد کردن نام از شما سؤال خواهد شد\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
دستوراتی را که
dropuser
تولید کرده و به سرور ارسال می‌کند، نمایش می‌دهد\&.
.RE
.PP
\fB\-i\fR
.br
\fB\-\-interactive\fR
.RS 4
پیش از حذف واقعی کاربر، تأییدیه می‌خواهد؛ و در صورتی که نام کاربری در خط فرمان مشخص نشده باشد، نام کاربر را درخواست می‌کند\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
نسخه
dropuser
را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-if\-exists\fR
.RS 4
در صورتی که کاربر وجود نداشته باشد، خطایی صادر نمی‌کند\&. در این حالت یک اعلان صادر می‌شود\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنما درباره آرگومان‌های خط فرمان
dropuser
را نمایش داده و خارج می‌شود\&.
.RE
.PP
دستور
dropuser
همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
نام میزبان دستگاهی که سرور روی آن در حال اجرا است را مشخص می‌کند\&. اگر مقدار با یک ممیز (اسلش) آغاز شود، به عنوان مسیر دایرکتوری سوکت دامنه یونیکس استفاده می‌شود\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
پورت TCP یا پسوند فایل سوکت محلی دامنه یونیکس را که سرور روی آن منتظر اتصالات است مشخص می‌کند\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
نام کاربری برای اتصال (نه نام کاربری که قرار است حذف شود)\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
هرگز برای گذرواژه درخواستی نمایش نمی‌دهد\&. اگر سرور نیاز به احراز هویت با گذرواژه داشته باشد و گذرواژه از روش‌های دیگر مانند فایل
\&.pgpass
در دسترس نباشد، تلاش برای اتصال با شکست مواجه می‌شود\&. این گزینه می‌تواند در کارهای دسته‌ای و اسکریپت‌هایی که کاربری برای وارد کردن گذرواژه حضور ندارد مفید باشد\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
دستور
dropuser
را وادار می‌کند تا پیش از اتصال به یک پایگاه داده، گذرواژه را درخواست کند\&.
.sp
این گزینه هرگز ضروری نیست، چرا که اگر سرور احراز هویت با گذرواژه را درخواست کند،
dropuser
به طور خودکار گذرواژه را خواهد خواست\&. با این حال،
dropuser
یک تلاش اتصال را برای اینکه بفهمد سرور گذرواژه می‌خواهد هدر خواهد داد\&. در برخی موارد ارزش دارد که
\fB\-W\fR
را تایپ کنید تا از تلاش اضافی برای اتصال جلوگیری شود\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
پارامترهای اتصال پیش‌فرض
.RE
.PP
\fBPG_COLOR\fR
.RS 4
مشخص می‌کند که آیا در پیام‌های خطا و عیب‌یابی از رنگ استفاده شود یا خیر\&. مقادیر ممکن عبارتند از
always،
auto
و
never\&.
.RE
.PP
این ابزار نیز مانند بیشتر ابزارهای دیگر
PostgreSQL،
از متغیرهای محیطی پشتیبانی‌شده توسط
libpq
استفاده می‌کند (به بخش\ \&32.15 مراجعه کنید)\&.
.SH "خطاها (DIAGNOSTICS)"
.PP
در صورت بروز مشکل، برای بررسی مشکلات احتمالی و پیام‌های خطا به
DROP ROLE (\fBDROP_ROLE\fR(7))
و
\fBpsql\fR(1)
مراجعه کنید\&. سرور پایگاه داده باید روی میزبان مشخص‌شده در حال اجرا باشد\&. همچنین، هرگونه تنظیمات اتصال پیش‌فرض و متغیرهای محیطی که توسط کتابخانه فرانت‌اند
libpq
استفاده می‌شوند اعمال خواهند شد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
برای حذف کاربر
joe
از سرور پایگاه داده پیش‌فرض:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropuser joe\fR
.fi
.if n \{\
.RE
.\}
.PP
برای حذف کاربر
joe
با استفاده از سرور روی میزبان
eden، پورت 5000، همراه با تأییدیه و مشاهده دستور زیربنایی:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropuser \-p 5000 \-h eden \-i \-e joe\fR
Role "joe" will be permanently removed\&.
Are you sure? (y/n) \fBy\fR
DROP ROLE joe;
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
\fBcreateuser\fR(1), DROP ROLE (\fBDROP_ROLE\fR(7))