نام (NAME)

pg_walsummary - چاپ محتویات فایل‌های خلاصه WAL

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

pg_walsummary [گزینه...] [فایل...]

توضیحات (DESCRIPTION)

ابزار pg_walsummary برای چاپ محتویات فایل‌های خلاصه WAL استفاده می‌شود. این فایل‌های دودویی در زیردایرکتوری pg_wal/summaries از دایرکتوری داده‌ها قرار دارند و می‌توان با استفاده از این ابزار آن‌ها را به متن تبدیل کرد. این کار در حالت عادی ضروری نیست، زیرا فایل‌های خلاصه WAL در درجه اول برای پشتیبانی از پشتیبان‌گیری افزایشی (incremental backup) وجود دارند، اما ممکن است برای اهداف عیب‌یابی مفید باشند.

یک فایل خلاصه WAL بر اساس OID فضای جدول (tablespace)، OID رابطه (relation) و انشعاب رابطه (relation fork) نمایه‌سازی می‌شود. برای هر انشعاب رابطه، فهرستی از بلوک‌هایی را که توسط WAL در بازه خلاصه شده در فایل تغییر یافته‌اند ذخیره می‌کند. همچنین می‌تواند یک «بلوک محدودیت» (limit block) را ذخیره کند که اگر انشعاب رابطه در بازه WAL مربوطه ایجاد یا کوتاه‌سازی (truncate) شده باشد، مقدار آن 0 است و در غیر این صورت کوتاه‌ترین طولی است که انشعاب رابطه به آن بریده شده است. اگر انشعاب رابطه در بازه WAL مربوطه ایجاد، حذف یا کوتاه‌سازی نشده باشد، بلوک محدودیت تعریف‌نشده یا نامتناهی است و توسط این ابزار چاپ نخواهد شد.

گزینه‌ها (OPTIONS)

-i
--individual

به‌طور پیش‌فرض، pg_walsummary برای هر بازه از یک یا چند بلوک تغییریافته متوالی، یک خط خروجی چاپ می‌کند. این کار می‌تواند خروجی را بسیار مختصرتر کند، زیرا رابطه‌ای که در آن تمام بلوک‌های 0 تا 999 تغییر یافته‌اند، به جای 1000 خط جداگانه، تنها یک خط خروجی تولید خواهد کرد. این گزینه درخواست می‌کند که برای هر بلوک تغییریافته یک خط خروجی جداگانه چاپ شود.

-q
--quiet

هیچ خروجی، به جز خطاها را چاپ نکن. این گزینه زمانی می‌تواند مفید باشد که می‌خواهید بدانید آیا یک فایل خلاصه WAL با موفقیت تجزیه می‌شود یا خیر، اما محتویات آن اهمیتی ندارد.

-V
--version

اطلاعات نسخه را نمایش داده و خارج شو.

-?
--help

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

محیط (ENVIRONMENT)

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

همچنین ببینید (SEE ALSO)

pg_basebackup(1), pg_combinebackup(1)