'\" t
.\"     Title: dropdb
.\"    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 "DROPDB" "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)"
dropdb \- حذف یک پایگاه‌داده PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBdropdb\fR\ 'u
\fBdropdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] \fIdbname\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
dropdb
یک پایگاه‌داده موجود
PostgreSQL
را حذف می‌کند\&. کاربری که این دستور را اجرا می‌کند باید مدیر ارشد پایگاه‌داده (superuser) یا مالک آن پایگاه‌داده باشد\&.
.PP
دستور
dropdb
یک پوشش (wrapper) پیرامون دستور
SQL
به نام
\fBDROP DATABASE\fR
است\&. هیچ تفاوت مؤثری بین حذف پایگاه‌های داده از طریق این ابزار و سایر روش‌های دسترسی به سرور وجود ندارد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور
dropdb
آرگومان‌های خط فرمان زیر را می‌پذیرد:
.PP
\fIdbname\fR
.RS 4
نام پایگاه‌داده‌ای که باید حذف شود را مشخص می‌کند\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
دستوراتی را که
dropdb
تولید کرده و به سرور ارسال می‌کند، در خروجی نمایش می‌دهد\&.
.RE
.PP
\fB\-f\fR
.br
\fB\-\-force\fR
.RS 4
تلاش برای قطع تمام اتصالات موجود به پایگاه‌داده هدف پیش از حذف آن\&. برای اطلاعات بیشتر در مورد این گزینه، به
DROP DATABASE (\fBDROP_DATABASE\fR(7))
مراجعه کنید\&.
.RE
.PP
\fB\-i\fR
.br
\fB\-\-interactive\fR
.RS 4
پیش از انجام هرگونه عملیات مخرب، یک اعلان تأیید نمایش می‌دهد\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
نسخه
dropdb
را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-if\-exists\fR
.RS 4
در صورتی که پایگاه‌داده وجود نداشته باشد، خطایی صادر نمی‌کند\&. در این حالت یک اعلان (notice) صادر می‌شود\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنمای مربوط به آرگومان‌های خط فرمان
dropdb
را نمایش داده و خارج می‌شود\&.
.RE
.PP
دستور
dropdb
همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
نام میزبان ماشینی را مشخص می‌کند که سرور روی آن در حال اجرا است\&. اگر مقدار با یک اسلش آغاز شود، به عنوان دایرکتوری سوکت دامنه یونیکس (Unix domain socket) استفاده می‌شود\&.
.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
در دسترس نباشد، تلاش برای برقراری اتصال با شکست مواجه می‌شود\&. این گزینه می‌تواند در کارهای دسته‌ای (batch jobs) و اسکریپت‌هایی که هیچ کاربری برای وارد کردن رمز عبور حضور ندارد مفید باشد\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
اجبار
dropdb
به درخواست رمز عبور پیش از اتصال به یک پایگاه‌داده\&.
.sp
این گزینه هرگز ضروری نیست، چرا که اگر سرور احراز هویت با رمز عبور را الزامی بداند،
dropdb
به طور خودکار درخواست رمز عبور خواهد کرد\&. با این حال،
dropdb
یک تلاش برای برقراری اتصال را صرف پی بردن به این موضوع می‌کند که سرور رمز عبور می‌خواهد\&. در برخی موارد برای جلوگیری از این تلاش اضافی اتصال، وارد کردن
\fB\-W\fR
ارزشمند است\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
نام پایگاه‌داده‌ای را برای اتصال مشخص می‌کند تا پایگاه‌داده هدف حذف شود\&. اگر مشخص نشود، از پایگاه‌داده
postgres
استفاده خواهد شد؛ اگر آن وجود نداشته باشد (یا همان پایگاه‌داده‌ای باشد که در حال حذف است)، از
template1
استفاده خواهد شد\&. این مقدار می‌تواند یک رشته اتصال (connection string) باشد\&. در این صورت، پارامترهای رشته اتصال هرگونه گزینه متناقض خط فرمان را لغو خواهند کرد\&.
.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 DATABASE (\fBDROP_DATABASE\fR(7))
و
\fBpsql\fR(1)
مراجعه کنید\&. سرور پایگاه‌داده باید روی میزبان مورد نظر در حال اجرا باشد\&. همچنین، هرگونه تنظیمات پیش‌فرض اتصال و متغیرهای محیطی مورد استفاده توسط کتابخانه رابط کاربری
libpq
اعمال خواهند شد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
برای حذف پایگاه‌داده
demo
روی سرور پایگاه‌داده پیش‌فرض:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropdb demo\fR
.fi
.if n \{\
.RE
.\}
.PP
برای حذف پایگاه‌داده
demo
با استفاده از سرور روی میزبان
eden،
پورت 5000، همراه با تأیید و مشاهده دستور زیرین:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropdb \-p 5000 \-h eden \-i \-e demo\fR
Database "demo" will be permanently deleted\&.
Are you sure? (y/n) \fBy\fR
DROP DATABASE demo;
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
\fBcreatedb\fR(1), DROP DATABASE (\fBDROP_DATABASE\fR(7))