'\" t .\" Title: vacuumlo .\" Author: The PostgreSQL Global Development Group .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2026 .\" Manual: PostgreSQL 18.6 Documentation .\" Source: PostgreSQL 18.6 .\" Language: English .\" .TH "VACUUMLO" "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)" vacuumlo \- حذف اشیاء بزرگ رهاشده از یک پایگاه‌داده PostgreSQL .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBvacuumlo\fR\ 'u \fBvacuumlo\fR [\fIoption\fR...] \fIdbname\fR... .SH "توضیحات (DESCRIPTION)" .PP \fBvacuumlo\fR یک برنامه کاربردی ساده است که هرگونه شیء بزرگ \(lqرهاشده\(rq (orphaned) را از یک پایگاه‌داده PostgreSQL حذف می‌کند\&. یک شیء بزرگ رهاشده (LO) شیئی در نظر گرفته می‌شود که OID آن در هیچ ستون داده‌ای از نوع oid یا lo در پایگاه‌داده ظاهر نشده باشد\&. .PP اگر از این ابزار استفاده می‌کنید، ممکن است به تریگر \fBlo_manage\fR در ماژول lo نیز علاقه‌مند باشید\&. \fBlo_manage\fR برای جلوگیری از ایجاد LOهای رهاشده در وهله اول مفید است\&. .PP تمام پایگاه‌های داده‌ای که نام آن‌ها در خط فرمان مشخص شده باشد پردازش می‌شوند\&. .SH "گزینه‌ها (OPTIONS)" .PP \fBvacuumlo\fR آرگومان‌های خط فرمان زیر را می‌پذیرد: .PP \fB\-l \fR\fB\fIlimit\fR\fR .br \fB\-\-limit=\fR\fB\fIlimit\fR\fR .RS 4 حذف حداکثر \fIlimit\fR شیء بزرگ در هر تراکنش (پیش‌فرض ۱۰۰۰)\&. از آنجا که سرور به ازای هر LO حذف‌شده یک قفل اختصاص می‌دهد، حذف بیش از حد LOها در یک تراکنش خطر فراتر رفتن از max_locks_per_transaction را در پی دارد\&. اگر می‌خواهید تمام حذف‌ها در یک تراکنش واحد انجام شوند، این محدودیت را برابر صفر قرار دهید\&. .RE .PP \fB\-n\fR .br \fB\-\-dry\-run\fR .RS 4 چیزی را حذف نمی‌کند؛ فقط نشان می‌دهد چه کاری انجام خواهد شد\&. .RE .PP \fB\-v\fR .br \fB\-\-verbose\fR .RS 4 پیام‌های پیشرفت فراوانی می‌نویسد\&. .RE .PP \fB\-V\fR .br \fB\-\-version\fR .RS 4 نسخه vacuumlo را چاپ کرده و خارج می‌شود\&. .RE .PP \fB\-?\fR .br \fB\-\-help\fR .RS 4 راهنمایی درباره آرگومان‌های خط فرمان vacuumlo را نمایش داده و خارج می‌شود\&. .RE .PP \fBvacuumlo\fR همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد: .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 درگاه (پورت) سرور پایگاه‌داده\&. .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 برنامه vacuumlo را وادار می‌کند قبل از اتصال به یک پایگاه‌داده، درخواست رمز عبور کند\&. .sp این گزینه هرگز ضروری نیست، چرا که اگر سرور نیازمند احراز هویت با رمز عبور باشد، vacuumlo به‌طور خودکار درخواست رمز عبور خواهد کرد\&. با این حال، vacuumlo یک تلاش برای اتصال را هدر می‌دهد تا متوجه شود سرور نیازمند رمز عبور است\&. در برخی موارد برای جلوگیری از این تلاش اتصال اضافی، وارد کردن \fB\-W\fR ارزشش را دارد\&. .RE .SH "محیط (ENVIRONMENT)" .PP \fBPGHOST\fR .br \fBPGPORT\fR .br \fBPGUSER\fR .RS 4 پارامترهای اتصال پیش‌فرض\&. .RE .PP این ابزار نیز مانند بیشتر ابزارهای دیگر PostgreSQL، از متغیرهای محیطی پشتیبانی‌شده توسط libpq استفاده می‌کند (بخش\ \&32.15 را ببینید)\&. .PP متغیر محیطی \fBPG_COLOR\fR مشخص می‌کند که آیا در پیام‌های عیب‌یابی از رنگ استفاده شود یا خیر\&. مقادیر ممکن عبارتند از always، auto و never\&. .SH "نکات (NOTES)" .PP \fBvacuumlo\fR بر اساس روش زیر عمل می‌کند: ابتدا، vacuumlo یک جدول موقت ایجاد می‌کند که شامل تمام OIDهای اشیاء بزرگ در پایگاه‌داده انتخاب‌شده است\&. سپس تمام ستون‌های پایگاه‌داده را که از نوع oid یا lo هستند بررسی کرده و رکوردهای منطبق را از جدول موقت حذف می‌کند\&. (توجه: فقط نوع‌هایی با این نام‌ها در نظر گرفته می‌شوند؛ به‌ویژه دامنه‌ها (domains) بر روی آن‌ها لحاظ نمی‌شوند\&.) رکوردهای باقی‌مانده در جدول موقت، LOهای رهاشده را مشخص می‌کنند\&. این موارد حذف می‌شوند\&. .SH "نویسندگان (AUTHORS)" .PP Peter Mount