نام (NAME)

dropdb - حذف یک پایگاه‌داده PostgreSQL

خلاصه دستور (SYNOPSIS)

dropdb [connection-option...] [option...] dbname

توضیحات (DESCRIPTION)

دستور dropdb یک پایگاه‌داده موجود PostgreSQL را حذف می‌کند. کاربری که این دستور را اجرا می‌کند باید مدیر ارشد پایگاه‌داده (superuser) یا مالک آن پایگاه‌داده باشد.

دستور dropdb یک پوشش (wrapper) پیرامون دستور SQL به نام DROP DATABASE است. هیچ تفاوت مؤثری بین حذف پایگاه‌های داده از طریق این ابزار و سایر روش‌های دسترسی به سرور وجود ندارد.

گزینه‌ها (OPTIONS)

دستور dropdb آرگومان‌های خط فرمان زیر را می‌پذیرد:

dbname

-e
--echo

-f
--force

-i
--interactive

-V
--version

--if-exists

-?
--help

دستور dropdb همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد:

-h host
--host=host

-p port
--port=port

-U username
--username=username

-w
--no-password

-W
--password

--maintenance-db=dbname

محیط (ENVIRONMENT)

PGHOST
PGPORT
PGUSER

PG_COLOR

این ابزار، مانند بیشتر ابزارهای دیگر PostgreSQL، از متغیرهای محیطی پشتیبانی‌شده توسط libpq نیز استفاده می‌کند (بخش 32.15 را ببینید).

خطاها (DIAGNOSTICS)

در صورت بروز مشکل، برای بررسی مسائل احتمالی و پیام‌های خطا به DROP DATABASE (DROP_DATABASE(7)) و psql(1) مراجعه کنید. سرور پایگاه‌داده باید روی میزبان مورد نظر در حال اجرا باشد. همچنین، هرگونه تنظیمات پیش‌فرض اتصال و متغیرهای محیطی مورد استفاده توسط کتابخانه رابط کاربری libpq اعمال خواهند شد.

مثال‌ها (EXAMPLES)

برای حذف پایگاه‌داده demo روی سرور پایگاه‌داده پیش‌فرض:

$ dropdb demo

برای حذف پایگاه‌داده demo با استفاده از سرور روی میزبان eden، پورت 5000، همراه با تأیید و مشاهده دستور زیرین:

$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE demo;

همچنین ببینید (SEE ALSO)

createdb(1), DROP DATABASE (DROP_DATABASE(7))