'\" t
.\"     Title: clusterdb
.\"    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: Persian
.\"
.TH "CLUSTERDB" "1" "2026" "PostgreSQL 18.6" "مستندات PostgreSQL 18.6"
.\" -----------------------------------------------------------------
.\" * 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)"
clusterdb \- خوشه‌بندی جداول پایگاه داده PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBclusterdb\fR\ 'u
\fBclusterdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\ \fB\-\-table\fR\ |\ \fB\-t\fR\ \fItable\fR\ ]...  [\fIdbname\fR\ |\ \fB\-a\fR\ |\ \fB\-\-all\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
.B clusterdb
ابزاری برای خوشه‌بندی مجدد جداول در یک پایگاه داده
.B PostgreSQL
است\&. این ابزار جداولی را که پیش‌تر خوشه‌بندی شده‌اند پیدا کرده و آن‌ها را بر اساس همان نمایه‌ای (index) که آخرین بار استفاده شده بود، دوباره خوشه‌بندی می‌کند\&. جداولی که هرگز خوشه‌بندی نشده‌اند تحت تاثیر قرار نمی‌گیرند\&.
.PP
.B clusterdb
یک پوشش (wrapper) بر روی دستور اس‌کیوال
\fBCLUSTER\fR(7)
است\&. تفاوت موثری میان خوشه‌بندی پایگاه‌های داده از طریق این ابزار و سایر روش‌های دسترسی به سرور وجود ندارد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.B clusterdb
آرگومان‌های خط فرمان زیر را می‌پذیرد:
.PP
\fB\-a\fR
.br
\fB\-\-all\fR
.RS 4
خوشه‌بندی تمام پایگاه‌های داده\&.
.RE
.PP
\fB[\-d]\fR\fB \fR\fB\fIdbname\fR\fR
.br
\fB[\-\-dbname=]\fR\fB\fIdbname\fR\fR
.RS 4
نام پایگاه داده‌ای را که باید خوشه‌بندی شود مشخص می‌کند، زمانی که از
\fB\-a\fR/\fB\-\-all\fR
استفاده نشده باشد\&. اگر مشخص نشود، نام پایگاه داده از متغیر محیطی
\fBPGDATABASE\fR
خوانده می‌شود\&. اگر آن هم تنظیم نشده باشد، از نام کاربری مشخص‌شده برای اتصال استفاده می‌شود\&. مقدار
\fIdbname\fR
می‌تواند یک رشته اتصال (connection string) باشد\&. در این حالت، پارامترهای رشته اتصال بر هر گزینه متناقض خط فرمان اولویت خواهند داشت\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
چاپ دستوراتی که
.B clusterdb
تولید کرده و به سرور می‌فرستد\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
عدم نمایش پیام‌های پیشرفت کار\&.
.RE
.PP
\fB\-t \fR\fB\fItable\fR\fR
.br
\fB\-\-table=\fR\fB\fItable\fR\fR
.RS 4
خوشه‌بندی فقط
\fItable\fR\&.
چندین جدول را می‌توان با مشخص کردن چندین سوئیچ
\fB\-t\fR
خوشه‌بندی کرد\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
چاپ اطلاعات با جزئیات کامل در حین پردازش\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
چاپ نسخه
.B clusterdb
و خروج\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
نمایش راهنمای آرگومان‌های خط فرمان
.B clusterdb
و خروج\&.
.RE
.PP
.B clusterdb
همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد:
.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
اجبار
.B clusterdb
به درخواست رمز عبور پیش از اتصال به پایگاه داده\&.
.sp
این گزینه هرگز ضروری نیست، زیرا
.B clusterdb
اگر سرور احراز هویت با رمز عبور را بخواهد، به صورت خودکار درخواست رمز عبور خواهد کرد\&. با این حال،
.B clusterdb
یک تلاش برای برقراری اتصال را صرف پی بردن به نیاز سرور به رمز عبور می‌کند\&. در برخی موارد وارد کردن
\fB\-W\fR
برای جلوگیری از این تلاش اضافی اتصال ارزشمند است\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
هنگامی که از
\fB\-a\fR/\fB\-\-all\fR
استفاده می‌شود، برای دریافت فهرست پایگاه‌های داده جهت خوشه‌بندی، به این پایگاه داده متصل می‌شود\&. اگر مشخص نشود، از پایگاه داده
postgres
استفاده خواهد شد، یا اگر آن وجود نداشته باشد، از
template1
استفاده می‌شود\&. این مقدار می‌تواند یک رشته اتصال باشد\&. در این صورت، پارامترهای رشته اتصال بر هر گزینه متناقض خط فرمان اولویت دارند\&. همچنین، پارامترهای رشته اتصال به جز نام خود پایگاه داده هنگام اتصال به سایر پایگاه‌های داده دوباره استفاده خواهند شد\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBPGDATABASE\fR
.br
\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
در صورت بروز مشکل، به
\fBCLUSTER\fR(7)
و
\fBpsql\fR(1)
برای توضیحات پیرامون مشکلات احتمالی و پیام‌های خطا مراجعه کنید\&. سرور پایگاه داده باید روی میزبان هدف در حال اجرا باشد\&. همچنین، هرگونه تنظیمات پیش‌فرض اتصال و متغیرهای محیطی مورد استفاده توسط کتابخانه کلاینت
libpq
اعمال خواهد شد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
برای خوشه‌بندی پایگاه داده
test:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBclusterdb test\fR
.fi
.if n \{\
.RE
.\}
.PP
برای خوشه‌بندی یک جدول منفرد
foo
در پایگاه داده‌ای به نام
xyzzy:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBclusterdb \-\-table=foo xyzzy\fR
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
\fBCLUSTER\fR(7)