'\" t
.\"     Title: reindexdb
.\"    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 "REINDEXDB" "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)"
reindexdb \- بازسازی نمایه‌های یک پایگاه‌داده PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBreindexdb\fR\ 'u
\fBreindexdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\ \fB\-S\fR\ |\ \fB\-\-schema\fR\ \fIschema\fR\ ]...  [\ \fB\-t\fR\ |\ \fB\-\-table\fR\ \fItable\fR\ ]...  [\ \fB\-i\fR\ |\ \fB\-\-index\fR\ \fIindex\fR\ ]...  [\ \fB\-s\fR\ |\ \fB\-\-system\fR\ ]  [\fIdbname\fR\ |\ \fB\-a\fR\ |\ \fB\-\-all\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBreindexdb\fR
ابزاری برای بازسازی نمایه‌ها (indexes) در یک پایگاه‌داده
PostgreSQL
است\&.
.PP
\fBreindexdb\fR
یک پوسته پیرامون دستور اس‌کیوال
\fBREINDEX\fR
است\&. هیچ تفاوت موثری میان بازسازی نمایه‌های پایگاه‌های داده از طریق این ابزار و روش‌های دیگر برای دسترسی به سرور وجود ندارد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fBreindexdb\fR
آرگومان‌های خط فرمان زیر را می‌پذیرد:
.PP
\fB\-a\fR
.br
\fB\-\-all\fR
.RS 4
بازسازی نمایه‌های تمامی پایگاه‌های داده\&.
.RE
.PP
\fB\-\-concurrently\fR
.RS 4
استفاده از گزینه
CONCURRENTLY\&.
راهنمای
\fBREINDEX\fR(7)
را ببینید، که در آن تمام هشدارهای مربوط به این گزینه با جزئیات شرح داده شده است\&.
.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
نمایش دستوراتی که
reindexdb
تولید کرده و به سرور ارسال می‌کند\&.
.RE
.PP
\fB\-i \fR\fB\fIindex\fR\fR
.br
\fB\-\-index=\fR\fB\fIindex\fR\fR
.RS 4
تنها بازسازی
\fIindex\fR\&.
با نوشتن چندین سوئیچ
\fB\-i\fR
می‌توان چندین نمایه را بازسازی کرد\&.
.RE
.PP
\fB\-j \fR\fB\fInjobs\fR\fR
.br
\fB\-\-jobs=\fR\fB\fInjobs\fR\fR
.RS 4
اجرای موازی دستورات بازسازی نمایه از طریق اجرای هم‌زمان
\fInjobs\fR
دستور\&. این گزینه ممکن است زمان پردازش را کاهش دهد، اما بار کاری روی سرور پایگاه‌داده را نیز افزایش می‌دهد\&.
.sp
\fBreindexdb\fR
تعداد
\fInjobs\fR
اتصال به پایگاه‌داده باز خواهد کرد، بنابراین مطمئن شوید تنظیمات
max_connections
شما به اندازه کافی بالا باشد تا همه اتصالات را بپذیرد\&.
.sp
توجه داشته باشید که این گزینه با گزینه
\fB\-\-system\fR
ناسازگار است\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
پیام‌های پیشرفت نمایش داده نشوند\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-system\fR
.RS 4
تنها بازسازی کاتالوگ‌های سیستمی پایگاه‌داده\&.
.RE
.PP
\fB\-S \fR\fB\fIschema\fR\fR
.br
\fB\-\-schema=\fR\fB\fIschema\fR\fR
.RS 4
تنها بازسازی
\fIschema\fR\&.
با نوشتن چندین سوئیچ
\fB\-S\fR
می‌توان چندین طرح‌واره را بازسازی کرد\&.
.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\-\-tablespace=\fR\fB\fItablespace\fR\fR
.RS 4
مشخص‌کننده tablespace که نمایه‌ها در آن بازسازی می‌شوند\&. (این نام به عنوان یک شناسه داخل گیومه دوگانه پردازش می‌شود\&.)
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
چاپ اطلاعات با جزئیات در طول پردازش\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
چاپ نسخه
reindexdb
و خروج\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
نمایش راهنما درباره آرگومان‌های خط فرمان
reindexdb
و خروج\&.
.RE
.PP
\fBreindexdb\fR
همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد:
.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
اجبار
reindexdb
به درخواست رمز عبور پیش از اتصال به یک پایگاه‌داده\&.
.sp
این گزینه هرگز ضروری نیست، زیرا
reindexdb
اگر سرور درخواست احراز هویت با رمز عبور کند به‌طور خودکار اعلان رمز عبور را نمایش می‌دهد\&. با این حال،
reindexdb
یک تلاش اتصال را هدر خواهد داد تا بفهمد سرور رمز عبور می‌خواهد\&. در برخی موارد وارد کردن
\fB\-W\fR
ارزش دارد تا از تلاش اضافه برای برقراری اتصال جلوگیری شود\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
هنگامی که گزینه
\fB\-a\fR/\fB\-\-all\fR
استفاده می‌شود، برای جمع‌آوری فهرست پایگاه‌های داده‌ای که باید بازسازی شوند، به این پایگاه‌داده متصل شود\&. در صورت عدم تعیین، از پایگاه‌داده
postgres
استفاده خواهد شد، یا اگر آن وجود نداشته باشد، از
template1
استفاده می‌شود\&. این مقدار می‌تواند یک رشته اتصال (connection string) باشد\&. در این حالت، پارامترهای رشته اتصال هر گزینه خط فرمان متضاد را لغو خواهند کرد\&. همچنین، پارامترهای رشته اتصال به غیر از خود نام پایگاه‌داده، هنگام اتصال به سایر پایگاه‌های داده دوباره استفاده خواهند شد\&.
.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
در صورت بروز مشکل، برای بررسی خطاهای احتمالی و پیام‌های خطا به
\fBREINDEX\fR(7)
و
\fBpsql\fR(1)
مراجعه کنید\&. سرور پایگاه‌داده باید بر روی میزبان هدف در حال اجرا باشد\&. همچنین، هرگونه تنظیمات اتصال پیش‌فرض و متغیرهای محیطی مورد استفاده توسط کتابخانه کلاینت
libpq
اعمال خواهند شد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
برای بازسازی نمایه‌های پایگاه‌داده
test:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBreindexdb test\fR
.fi
.if n \{\
.RE
.\}
.PP
برای بازسازی نمایه‌های جدول
foo
و نمایه
bar
در پایگاه‌داده‌ای به نام
abcd:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBreindexdb \-\-table=foo \-\-index=bar abcd\fR
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
\fBREINDEX\fR(7)