REINDEXDB(1) PostgreSQL 18.6 Documentation REINDEXDB(1)

reindexdb - بازسازی نمایه‌های یک پایگاه‌داده PostgreSQL

reindexdb [connection-option...] [option...] [ -S | --schema schema ]... [ -t | --table table ]... [ -i | --index index ]... [ -s | --system ] [dbname | -a | --all]

reindexdb ابزاری برای بازسازی نمایه‌ها (indexes) در یک پایگاه‌داده PostgreSQL است.

reindexdb یک پوسته پیرامون دستور اس‌کیوال REINDEX است. هیچ تفاوت موثری میان بازسازی نمایه‌های پایگاه‌های داده از طریق این ابزار و روش‌های دیگر برای دسترسی به سرور وجود ندارد.

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

-a
--all

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

--concurrently

استفاده از گزینه CONCURRENTLY. راهنمای REINDEX(7) را ببینید، که در آن تمام هشدارهای مربوط به این گزینه با جزئیات شرح داده شده است.

[-d] dbname
[--dbname=]dbname

مشخص‌کننده نام پایگاه‌داده‌ای که باید بازسازی شود، هنگامی که از -a/--all استفاده نشده باشد. اگر این مورد مشخص نشود، نام پایگاه‌داده از متغیر محیطی PGDATABASE خوانده می‌شود. اگر آن هم تنظیم نشده باشد، نام کاربری مشخص‌شده برای اتصال استفاده خواهد شد. مقدار dbname می‌تواند یک رشته اتصال (connection string) باشد. در این صورت، پارامترهای رشته اتصال هرگونه گزینه ناسازگار خط فرمان را لغو خواهند کرد.

-e
--echo

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

-i index
--index=index

تنها بازسازی index. با نوشتن چندین سوئیچ -i می‌توان چندین نمایه را بازسازی کرد.

-j njobs
--jobs=njobs

اجرای موازی دستورات بازسازی نمایه از طریق اجرای هم‌زمان njobs دستور. این گزینه ممکن است زمان پردازش را کاهش دهد، اما بار کاری روی سرور پایگاه‌داده را نیز افزایش می‌دهد.

reindexdb تعداد njobs اتصال به پایگاه‌داده باز خواهد کرد، بنابراین مطمئن شوید تنظیمات max_connections شما به اندازه کافی بالا باشد تا همه اتصالات را بپذیرد.

توجه داشته باشید که این گزینه با گزینه --system ناسازگار است.

-q
--quiet

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

-s
--system

تنها بازسازی کاتالوگ‌های سیستمی پایگاه‌داده.

-S schema
--schema=schema

تنها بازسازی schema. با نوشتن چندین سوئیچ -S می‌توان چندین طرح‌واره را بازسازی کرد.

-t table
--table=table

تنها بازسازی table. با نوشتن چندین سوئیچ -t می‌توان چندین جدول را بازسازی کرد.

--tablespace=tablespace

مشخص‌کننده tablespace که نمایه‌ها در آن بازسازی می‌شوند. (این نام به عنوان یک شناسه داخل گیومه دوگانه پردازش می‌شود.)

-v
--verbose

چاپ اطلاعات با جزئیات در طول پردازش.

-V
--version

چاپ نسخه reindexdb و خروج.

-?
--help

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

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

-h host
--host=host

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

-p port
--port=port

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

-U username
--username=username

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

-w
--no-password

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

-W
--password

اجبار reindexdb به درخواست رمز عبور پیش از اتصال به یک پایگاه‌داده.

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

--maintenance-db=dbname

هنگامی که گزینه -a/--all استفاده می‌شود، برای جمع‌آوری فهرست پایگاه‌های داده‌ای که باید بازسازی شوند، به این پایگاه‌داده متصل شود. در صورت عدم تعیین، از پایگاه‌داده postgres استفاده خواهد شد، یا اگر آن وجود نداشته باشد، از template1 استفاده می‌شود. این مقدار می‌تواند یک رشته اتصال (connection string) باشد. در این حالت، پارامترهای رشته اتصال هر گزینه خط فرمان متضاد را لغو خواهند کرد. همچنین، پارامترهای رشته اتصال به غیر از خود نام پایگاه‌داده، هنگام اتصال به سایر پایگاه‌های داده دوباره استفاده خواهند شد.

PGDATABASE
PGHOST
PGPORT
PGUSER

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

PG_COLOR

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

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

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

برای بازسازی نمایه‌های پایگاه‌داده test:

$ reindexdb test

برای بازسازی نمایه‌های جدول foo و نمایه bar در پایگاه‌داده‌ای به نام abcd:

$ reindexdb --table=foo --index=bar abcd

REINDEX(7)

2026 PostgreSQL 18.6