'\" t
.\"     Title: pg_walsummary
.\"    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 "PG_WALSUMMARY" "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)"
pg_walsummary \- چاپ محتویات فایل‌های خلاصه WAL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpg_walsummary\fR\ 'u
\fBpg_walsummary\fR [\fIگزینه\fR...] [\fIفایل\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
pg_walsummary
برای چاپ محتویات فایل‌های خلاصه WAL استفاده می‌شود\&. این فایل‌های دودویی در زیردایرکتوری
pg_wal/summaries
از دایرکتوری داده‌ها قرار دارند و می‌توان با استفاده از این ابزار آن‌ها را به متن تبدیل کرد\&. این کار در حالت عادی ضروری نیست، زیرا فایل‌های خلاصه WAL در درجه اول برای پشتیبانی از پشتیبان‌گیری افزایشی (incremental backup) وجود دارند، اما ممکن است برای اهداف عیب‌یابی مفید باشند\&.
.PP
یک فایل خلاصه WAL بر اساس OID فضای جدول (tablespace)، OID رابطه (relation) و انشعاب رابطه (relation fork) نمایه‌سازی می‌شود\&. برای هر انشعاب رابطه، فهرستی از بلوک‌هایی را که توسط WAL در بازه خلاصه شده در فایل تغییر یافته‌اند ذخیره می‌کند\&. همچنین می‌تواند یک «بلوک محدودیت» (limit block) را ذخیره کند که اگر انشعاب رابطه در بازه WAL مربوطه ایجاد یا کوتاه‌سازی (truncate) شده باشد، مقدار آن 0 است و در غیر این صورت کوتاه‌ترین طولی است که انشعاب رابطه به آن بریده شده است\&. اگر انشعاب رابطه در بازه WAL مربوطه ایجاد، حذف یا کوتاه‌سازی نشده باشد، بلوک محدودیت تعریف‌نشده یا نامتناهی است و توسط این ابزار چاپ نخواهد شد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB\-i\fR
.br
\fB\-\-individual\fR
.RS 4
به‌طور پیش‌فرض،
pg_walsummary
برای هر بازه از یک یا چند بلوک تغییریافته متوالی، یک خط خروجی چاپ می‌کند\&. این کار می‌تواند خروجی را بسیار مختصرتر کند، زیرا رابطه‌ای که در آن تمام بلوک‌های 0 تا 999 تغییر یافته‌اند، به جای 1000 خط جداگانه، تنها یک خط خروجی تولید خواهد کرد\&. این گزینه درخواست می‌کند که برای هر بلوک تغییریافته یک خط خروجی جداگانه چاپ شود\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
هیچ خروجی، به جز خطاها را چاپ نکن\&. این گزینه زمانی می‌تواند مفید باشد که می‌خواهید بدانید آیا یک فایل خلاصه WAL با موفقیت تجزیه می‌شود یا خیر، اما محتویات آن اهمیتی ندارد\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
اطلاعات نسخه را نمایش داده و خارج شو\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنمایی درباره آرگومان‌های خط فرمان
pg_walsummary
را نمایش می‌دهد و خارج می‌شود\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
متغیر محیطی
\fBPG_COLOR\fR
مشخص می‌کند که آیا در پیام‌های عیب‌یابی از رنگ استفاده شود یا خیر\&. مقادیر ممکن عبارتند از
always،
auto
و
never\&.
.SH "همچنین ببینید (SEE ALSO)"
\fBpg_basebackup\fR(1), \fBpg_combinebackup\fR(1)