نام (NAME)

dropuser - حذف یک حساب کاربری PostgreSQL

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

dropuser [connection-option...] [option...] [username]

توضیحات (DESCRIPTION)

دستور dropuser یک کاربر موجود در PostgreSQL را حذف می‌کند. کاربران ارشد (Superusers) می‌توانند از این دستور برای حذف هر نقشی استفاده کنند؛ در غیر این صورت، تنها نقش‌های غیر کاربر ارشد قابل حذف هستند و آن هم فقط توسط کاربری که امتیاز CREATEROLE را داشته و ADMIN OPTION روی نقش هدف به او اعطا شده باشد.

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

گزینه‌ها (OPTIONS)

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

username

نام کاربر PostgreSQL که باید حذف شود را مشخص می‌کند. اگر نامی در خط فرمان مشخص نشده باشد و از گزینه -i/--interactive استفاده شود، برای وارد کردن نام از شما سؤال خواهد شد.

-e
--echo

دستوراتی را که dropuser تولید کرده و به سرور ارسال می‌کند، نمایش می‌دهد.

-i
--interactive

پیش از حذف واقعی کاربر، تأییدیه می‌خواهد؛ و در صورتی که نام کاربری در خط فرمان مشخص نشده باشد، نام کاربر را درخواست می‌کند.

-V
--version

نسخه dropuser را چاپ کرده و خارج می‌شود.

--if-exists

در صورتی که کاربر وجود نداشته باشد، خطایی صادر نمی‌کند. در این حالت یک اعلان صادر می‌شود.

-?
--help

راهنما درباره آرگومان‌های خط فرمان dropuser را نمایش داده و خارج می‌شود.

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

-h host
--host=host

نام میزبان دستگاهی که سرور روی آن در حال اجرا است را مشخص می‌کند. اگر مقدار با یک ممیز (اسلش) آغاز شود، به عنوان مسیر دایرکتوری سوکت دامنه یونیکس استفاده می‌شود.

-p port
--port=port

پورت TCP یا پسوند فایل سوکت محلی دامنه یونیکس را که سرور روی آن منتظر اتصالات است مشخص می‌کند.

-U username
--username=username

نام کاربری برای اتصال (نه نام کاربری که قرار است حذف شود).

-w
--no-password

هرگز برای گذرواژه درخواستی نمایش نمی‌دهد. اگر سرور نیاز به احراز هویت با گذرواژه داشته باشد و گذرواژه از روش‌های دیگر مانند فایل .pgpass در دسترس نباشد، تلاش برای اتصال با شکست مواجه می‌شود. این گزینه می‌تواند در کارهای دسته‌ای و اسکریپت‌هایی که کاربری برای وارد کردن گذرواژه حضور ندارد مفید باشد.

-W
--password

دستور dropuser را وادار می‌کند تا پیش از اتصال به یک پایگاه داده، گذرواژه را درخواست کند.

این گزینه هرگز ضروری نیست، چرا که اگر سرور احراز هویت با گذرواژه را درخواست کند، dropuser به طور خودکار گذرواژه را خواهد خواست. با این حال، dropuser یک تلاش اتصال را برای اینکه بفهمد سرور گذرواژه می‌خواهد هدر خواهد داد. در برخی موارد ارزش دارد که -W را تایپ کنید تا از تلاش اضافی برای اتصال جلوگیری شود.

محیط (ENVIRONMENT)

PGHOST
PGPORT
PGUSER

پارامترهای اتصال پیش‌فرض

PG_COLOR

مشخص می‌کند که آیا در پیام‌های خطا و عیب‌یابی از رنگ استفاده شود یا خیر. مقادیر ممکن عبارتند از always، auto و never.

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

خطاها (DIAGNOSTICS)

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

مثال‌ها (EXAMPLES)

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

$ dropuser joe

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

$ dropuser -p 5000 -h eden -i -e joe
Role "joe" will be permanently removed.
Are you sure? (y/n) y
DROP ROLE joe;

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

createuser(1), DROP ROLE (DROP_ROLE(7))