نام (NAME)

vacuumlo - حذف اشیاء بزرگ رهاشده از یک پایگاه‌داده PostgreSQL

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

vacuumlo [option...] dbname...

توضیحات (DESCRIPTION)

vacuumlo یک برنامه کاربردی ساده است که هرگونه شیء بزرگ “رهاشده” (orphaned) را از یک پایگاه‌داده PostgreSQL حذف می‌کند. یک شیء بزرگ رهاشده (LO) شیئی در نظر گرفته می‌شود که OID آن در هیچ ستون داده‌ای از نوع oid یا lo در پایگاه‌داده ظاهر نشده باشد.

اگر از این ابزار استفاده می‌کنید، ممکن است به تریگر lo_manage در ماژول lo نیز علاقه‌مند باشید. lo_manage برای جلوگیری از ایجاد LOهای رهاشده در وهله اول مفید است.

تمام پایگاه‌های داده‌ای که نام آن‌ها در خط فرمان مشخص شده باشد پردازش می‌شوند.

گزینه‌ها (OPTIONS)

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

-l limit
--limit=limit

حذف حداکثر limit شیء بزرگ در هر تراکنش (پیش‌فرض ۱۰۰۰). از آنجا که سرور به ازای هر LO حذف‌شده یک قفل اختصاص می‌دهد، حذف بیش از حد LOها در یک تراکنش خطر فراتر رفتن از max_locks_per_transaction را در پی دارد. اگر می‌خواهید تمام حذف‌ها در یک تراکنش واحد انجام شوند، این محدودیت را برابر صفر قرار دهید.

-n
--dry-run

چیزی را حذف نمی‌کند؛ فقط نشان می‌دهد چه کاری انجام خواهد شد.

-v
--verbose

پیام‌های پیشرفت فراوانی می‌نویسد.

-V
--version

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

-?
--help

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

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

-h host
--host=host

میزبان سرور پایگاه‌داده.

-p port
--port=port

درگاه (پورت) سرور پایگاه‌داده.

-U username
--username=username

نام کاربری برای اتصال.

-w
--no-password

هرگز اعلان درخواست رمز عبور نشان نمی‌دهد. اگر سرور نیازمند احراز هویت با رمز عبور باشد و رمز عبور از طریق روش‌های دیگر مانند فایل .pgpass در دسترس نباشد، تلاش برای برقراری اتصال با شکست مواجه می‌شود. این گزینه در کارهای دسته‌ای (batch jobs) و اسکریپت‌هایی که کاربری برای وارد کردن رمز عبور حضور ندارد مفید است.

-W
--password

برنامه vacuumlo را وادار می‌کند قبل از اتصال به یک پایگاه‌داده، درخواست رمز عبور کند.

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

محیط (ENVIRONMENT)

PGHOST
PGPORT
PGUSER

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

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

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

نکات (NOTES)

vacuumlo بر اساس روش زیر عمل می‌کند: ابتدا، vacuumlo یک جدول موقت ایجاد می‌کند که شامل تمام OIDهای اشیاء بزرگ در پایگاه‌داده انتخاب‌شده است. سپس تمام ستون‌های پایگاه‌داده را که از نوع oid یا lo هستند بررسی کرده و رکوردهای منطبق را از جدول موقت حذف می‌کند. (توجه: فقط نوع‌هایی با این نام‌ها در نظر گرفته می‌شوند؛ به‌ویژه دامنه‌ها (domains) بر روی آن‌ها لحاظ نمی‌شوند.) رکوردهای باقی‌مانده در جدول موقت، LOهای رهاشده را مشخص می‌کنند. این موارد حذف می‌شوند.

نویسندگان (AUTHORS)

Peter Mount <peter@retep.org.uk>