.\" Man page generated from reStructuredText.
.
.TH "XBSTREAM" "1" "Jun 15, 2026" "8.0" "Percona XtraBackup"
.SH "نام (NAME)"
xbstream \- مستندات xbstream برای Percona
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.sp
برای پشتیبانی هم‌زمان از فشرده‌سازی و ارسال جریانی (streaming)، علاوه بر قالب TAR، قالب جریانی سفارشی جدیدی با نام xbstream به \fIPercona XtraBackup\fP افزوده شد. این کار برای غلبه بر برخی محدودیت‌های قالب‌های سنتی بایگانی مانند tar، cpio و موارد دیگر لازم بود، چرا که آن‌ها اجازه ارسال جریانی فایل‌های تولیدشده به‌صورت پویا (مانند فایل‌هایی که به‌صورت پویا فشرده می‌شوند) را نمی‌دادند. از دیگر مزایای xbstream نسبت به قالب‌های سنتی جریان/بایگانی می‌توان به توانایی ارسال جریانی هم‌زمان چندین فایل (که استفاده از ارسال جریانی در قالب xbstream را همراه با گزینه \-\-parallel امکان‌پذیر می‌کند) و ذخیره‌سازی فشرده‌تر داده‌ها اشاره کرد.
.sp
این ابزار رابطی مشابه با tar دارد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
با گزینه \fB\-x\fP، فایل‌ها را از جریانی که از ورودی استاندارد خوانده می‌شود به دایرکتوری جاری استخراج می‌کند، مگر اینکه با گزینه \fB\-c\fP به شکل دیگری مشخص شده باشد. پشتیبانی از استخراج موازی با گزینه \fB\-\-parallel\fP در \fIPercona XtraBackup\fP 2.4.7 پیاده‌سازی شده است.
.IP \(bu 2
با گزینه \fB\-c\fP، فایل‌های مشخص‌شده در خط فرمان را به خروجی استاندارد خود به‌صورت جریانی ارسال می‌کند.
.IP \(bu 2
با مشخص شدن گزینه \fB\-\-decrypt=ALGO\fP، ابزار xbstream هنگام استخراج جریان ورودی، فایل‌های رمزگذاری‌شده را به‌طور خودکار رمزگشایی خواهد کرد. مقادیر پشتیبانی‌شده برای این گزینه عبارتند از: \fBAES128\fP، \fBAES192\fP و \fBAES256\fP\&. برای ارائه کلید رمزگذاری باید یکی از گزینه‌های \fB\-\-encrypt\-key\fP یا \fB\-\-encrypt\-key\-file\fP مشخص شود، اما نه هر دو. این گزینه در \fIPercona XtraBackup\fP 2.4.7 پیاده‌سازی شده است.
.IP \(bu 2
با گزینه \fB\-\-encrypt\-threads\fP می‌توانید تعداد نخ‌ها (threads) را برای رمزگذاری موازی داده‌ها مشخص کنید. مقدار پیش‌فرض \fB1\fP است\&. این گزینه در \fIPercona XtraBackup\fP 2.4.7 پیاده‌سازی شده است.
.IP \(bu 2
گزینه \fB\-\-encrypt\-key\fP برای تعیین کلید رمزگذاری مورد استفاده به کار می‌رود. این گزینه نمی‌تواند همراه با گزینه \fB\-\-encrypt\-key\-file\fP استفاده شود زیرا مانعة‌الجمع هستند. این گزینه در \fIPercona XtraBackup\fP 2.4.7 پیاده‌سازی شده است.
.IP \(bu 2
گزینه \fB\-\-encrypt\-key\-file\fP برای تعیین فایلی که حاوی کلید رمزگذاری است به کار می‌رود. این گزینه نمی‌تواند همراه با گزینه \fB\-\-encrypt\-key\fP استفاده شود زیرا مانعة‌الجمع هستند. این گزینه در \fIPercona XtraBackup\fP 2.4.7 پیاده‌سازی شده است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
این ابزار همچنین تلاش می‌کند تا با استفاده از فراخوانی‌های مناسب \fBposix_fadvise()\fP در صورت وجود، تأثیر خود را بر حافظه پنهان صفحات سیستم‌عامل (OS page cache) به حداقل برساند.
.sp
هنگامی که فشرده‌سازی با \fIxtrabackup\fP فعال باشد، تمام داده‌ها از جمله فایل گزارش تراکنش‌ها و فایل‌های فراداده (metadata)، با استفاده از الگوریتم فشرده‌سازی مشخص‌شده فشرده می‌شوند. تنها الگوریتمی که در حال حاضر پشتیبانی می‌شود \fBquicklz\fP است\&.
.sp
فایل‌های حاصل دارای قالب بایگانی qpress هستند؛ به این معنی که هر فایل \fB*.qp\fP تولیدشده توسط \fIxtrabackup\fP اساساً یک بایگانی تک‌فایلی qpress است و می‌تواند توسط \fI\%qpress file archiver\fP استخراج شده و از فشرده‌سازی خارج شود. این بدان معناست که بر خلاف \fBtar.gz\fP، نیازی به باز کردن کل فایل پشتیبان برای بازیابی یک جدول منفرد وجود ندارد\&.
.sp
برای خارج کردن تک‌تک فایل‌ها از حالت فشرده، \fIxbstream\fP را با گزینه \fB\-\-decompress\fP اجرا کنید. می‌توانید با مشخص کردن گزینه \fB\-\-decompress\-threads\fP، تعداد نخ‌های مورد استفاده برای خارج کردن از فشرده‌سازی را کنترل کنید.
.sp
همچنین، فایل‌ها را می‌توان با استفاده از ابزار \fBqpress\fP که از \fI\%اینجا\fP قابل بارگیری است از حالت فشرده خارج کرد. ابزار Qpress از فشرده‌گشایی چندنخی پشتیبانی می‌کند.
.SH "نویسندگان (AUTHORS)"
Percona LLC و/یا شرکت‌های وابسته به آن
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2009-2022, Percona LLC و/یا شرکت‌های وابسته به آن
.\" Generated by docutils manpage writer.
.