'\" t
.\"
.TH "\fBMARIADB-DUMP\fR" "1" "5 March 2025" "MariaDB 11.8" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mariadb-dump
.\" dumping: databases and tables
.\" backups: databases and tables
.\" databases: dumping
.\" tables: dumping
.SH "نام (NAME)"
mariadb-dump \- برنامه‌ای برای پشتیبان‌گیری از پایگاه داده (mariadb-dump اکنون یک پیوند نمادین به mariadb-dump است)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmariadb-dump\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB\ [\fR\fB\fItbl_name\fR\fR\fB\ \&.\&.\&.]]\fR\ 'u
\fBmariadb-dump [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB \&.\&.\&.]]\fR
.SH "توضیحات (DESCRIPTION)"
.PP
کلاینت
\fBmariadb-dump\fR
یک برنامهٔ پشتیبان‌گیری است که در ابتدا توسط Igor Romanenko نوشته شده است\&. این برنامه می‌تواند برای استخراج (dump) یک پایگاه داده یا مجموعه‌ای از پایگاه‌های داده جهت پشتیبان‌گیری یا انتقال به یک سرور SQL دیگر (که لزوماً یک سرور MariaDB نیست) مورد استفاده قرار گیرد\&. خروجی دامپ معمولاً شامل دستورهای SQL برای ایجاد جدول، مقداردهی داده‌ها، یا هر دو است\&. با این حال،
\fBmariadb-dump\fR
می‌تواند برای تولید فایل‌هایی با قالب CSV، متون با نویسهٔ جداکننده، یا قالب XML نیز به کار رود\&.
.PP
اگر پشتیبان‌گیری را روی سرور انجام می‌دهید و تمام جدول‌های شما از نوع
MyISAM
هستند، استفاده از
\fBmariadb-hotcopy\fR
را در نظر بگیرید، زیرا می‌تواند پشتیبان‌گیری و بازیابی بسیار سریع‌تری انجام دهد\&. به
\fBmariadb-hotcopy\fR(1)
مراجعه کنید\&.
.PP
چهار روش کلی برای فراخوانی
\fBmariadb-dump\fR
وجود دارد:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB \&.\&.\&.]\fR
shell> \fBmariadb-dump [\fR\fB\fIoptions\fR\fR\fB] \-\-databases \fR\fB\fIdb_name\fR\fR\fB \&.\&.\&.\fR
shell> \fBmariadb-dump [\fR\fB\fIoptions\fR\fR\fB] \-\-all\-databases\fR
shell> \fBmariadb-dump [\fR\fB\fIoptions\fR\fR\fB] \-\-system={options}\fR
.fi
.if n \{\
.RE
.\}
.PP
اگر بعد از
\fIdb_name\fR
نام هیچ جدولی را ذکر نکنید یا اگر از گزینهٔ
\fB\-\-databases\fR
یا
\fB\-\-all\-databases\fR
استفاده کنید، تمام پایگاه‌های داده استخراج خواهند شد\&.
.PP
\fBmariadb-dump\fR
به‌طور پیش‌فرض از پایگاه‌های دادهٔ
INFORMATION_SCHEMA یا performance_schema
پشتیبان نمی‌گیرد\&. برای استخراج این پایگاه‌های داده،
نام آن‌ها را به‌صراحت در خط فرمان مشخص کنید، اگرچه باید از گزینهٔ
\fB\-\-skip\-lock\-tables\fR
نیز استفاده کنید\&.
.PP
برای مشاهدهٔ فهرستی از گزینه‌هایی که نسخهٔ شما از
\fBmariadb-dump\fR
پشتیبانی می‌کند، دستور
\fBmariadb-dump \-\-help\fR
را اجرا کنید\&.
.PP
برخی از گزینه‌های
\fBmariadb-dump\fR
شکل کوتاه‌شده‌ای برای گروهی از گزینه‌های دیگر هستند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
استفاده از
\fB\-\-opt\fR
معادل مشخص کردن گزینه‌های
\fB\-\-add\-drop\-table\fR،
\fB\-\-add\-locks\fR،
\fB\-\-create\-options\fR،
\fB\-\-disable\-keys\fR،
\fB\-\-extended\-insert\fR،
\fB\-\-lock\-tables\fR،
\fB\-\-quick\fR
و
\fB\-\-set\-charset\fR
است\&. تمام گزینه‌هایی که
\fB\-\-opt\fR
نمایندهٔ آن‌هاست نیز به‌طور پیش‌فرض فعال هستند زیرا گزینهٔ
\fB\-\-opt\fR
به‌طور پیش‌فرض فعال است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
استفاده از
\fB\-\-compact\fR
معادل مشخص کردن گزینه‌های
\fB\-\-skip\-add\-drop\-table\fR،
\fB\-\-skip\-add\-locks\fR،
\fB\-\-skip\-comments\fR،
\fB\-\-skip\-disable\-keys\fR
و
\fB\-\-skip\-set\-charset\fR
است\&.
.RE
.PP
برای معکوس کردن اثر یک گزینهٔ گروهی، از شکل
\fB\-\-skip\-\fR\fB\fIxxx\fR\fR
آن (\fB\-\-skip\-opt\fR
یا
\fB\-\-skip\-compact\fR)
استفاده کنید\&. همچنین این امکان وجود دارد که با درج گزینه‌هایی پس از آن که ویژگی‌های خاصی را فعال یا غیرفعال می‌کنند، تنها بخشی از اثر یک گزینهٔ گروهی را انتخاب کنید\&. چند مثال در زیر آورده شده است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
برای اعمال اثر
\fB\-\-opt\fR
به‌جز برخی ویژگی‌ها، از گزینهٔ
\fB\-\-skip\fR
مربوط به هر ویژگی استفاده کنید\&. برای غیرفعال کردن درج‌های گسترده (extended inserts) و بافرینگ حافظه، از گزینه‌های
\fB\-\-opt\fR
\fB\-\-skip\-extended\-insert\fR
\fB\-\-skip\-quick\fR
استفاده کنید\&. (در واقع، استفاده از
\fB\-\-skip\-extended\-insert\fR
\fB\-\-skip\-quick\fR
کفایت می‌کند زیرا گزینهٔ
\fB\-\-opt\fR
به‌طور پیش‌فرض فعال است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
برای معکوس کردن
\fB\-\-opt\fR
برای تمامی ویژگی‌ها به‌جز غیرفعال‌سازی کلیدها و قفل کردن جدول‌ها، از
\fB\-\-skip\-opt\fR
\fB\-\-disable\-keys\fR
\fB\-\-lock\-tables\fR
استفاده کنید\&.
.RE
.PP
هنگامی که اثر یک گزینهٔ گروهی را به‌صورت انتخابی فعال یا غیرفعال می‌کنید، ترتیب گزینه‌ها حائز اهمیت است زیرا گزینه‌ها از چپ به راست پردازش می‌شوند\&. به عنوان مثال،
\fB\-\-disable\-keys\fR
\fB\-\-lock\-tables\fR
\fB\-\-skip\-opt\fR
اثر مورد نظر را نخواهد داشت؛ این کار معادل استفاده از گزینهٔ
\fB\-\-skip\-opt\fR
به‌تنهایی است\&.
.PP
\fBmariadb-dump\fR
می‌تواند محتویات جدول را سطر به سطر واکشی و استخراج کند، یا می‌تواند کل محتوای یک جدول را پیش از استخراج واکشی کرده و در حافظه بافر کند\&. بافر کردن در حافظه هنگام استخراج جدول‌های حجیم می‌تواند مشکل‌ساز باشد\&. برای استخراج سطر به سطر جدول‌ها، از گزینهٔ
\fB\-\-quick\fR
(یا
\fB\-\-opt\fR
که گزینهٔ
\fB\-\-quick\fR
را فعال می‌کند) استفاده کنید\&. گزینهٔ
\fB\-\-opt\fR
(و در نتیجه
\fB\-\-quick\fR)
به‌طور پیش‌فرض فعال است، بنابراین برای فعال کردن بافرینگ حافظه، از گزینهٔ
\fB\-\-skip\-quick\fR
استفاده نمایید\&..PP
اگر از نسخه جدیدی از
\fBmariadb-dump\fR
برای تولید یک نسخه پشتیبان (dump) جهت بارگذاری مجدد در یک سرور بسیار قدیمی MySQL استفاده می‌کنید، نباید از گزینه
\fB\-\-opt\fR
یا
\fB\-\-extended\-insert\fR
استفاده کنید\&. به‌جای آن از
\fB\-\-skip\-opt\fR
استفاده کنید\&.
.RE
.PP
\fBmariadb-dump\fR
از گزینه‌های زیر پشتیبانی می‌کند که می‌توان آن‌ها را در خط فرمان یا در گروه‌های
[mariadb-dump]
و
[client]
فایل تنظیمات مشخص کرد\&.
\fBmariadb-dump\fR
همچنین از گزینه‌های پردازش فایل‌های تنظیمات پشتیبانی می‌کند\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: help option
.\" help option: mariadb-dump
\fB\-\-help\fR,
\fB\-?\fR
.sp
نمایش پیام راهنما و خروج\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: add-drop-database option
.\" add-drop-database option: mariadb-dump
\fB\-\-add\-drop\-database\fR
.sp
افزودن یک دستور
DROP DATABASE
پیش از هر دستور
CREATE DATABASE\&.
این گزینه معمولاً همراه با گزینه
\fB\-\-all\-databases\fR
یا
\fB\-\-databases\fR
استفاده می‌شود، چرا که هیچ دستور
CREATE DATABASE
نوشته نمی‌شود مگر اینکه یکی از این گزینه‌ها مشخص شده باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: add-drop-table option
.\" add-drop-table option: mariadb-dump
\fB\-\-add\-drop\-table\fR
.sp
افزودن یک دستور
DROP TABLE
پیش از هر دستور
CREATE TABLE\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: add-drop-trigger option
.\" add-drop-trigger option: mariadb-dump
\fB\-\-add\-drop\-trigger\fR
.sp
افزودن یک دستور
DROP TRIGGER
پیش از هر دستور
CREATE TRIGGER\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: add-locks option
.\" add-locks option: mariadb-dump
\fB\-\-add\-locks\fR
.sp
احاطه کردن نسخه پشتیبان (dump) هر جدول با دستورهای
LOCK TABLES
و
UNLOCK TABLES\&.
این کار هنگام بارگذاری مجدد فایل dump، منجر به درج سریع‌تر اطلاعات می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: all-databases option
.\" all-databases option: mariadb-dump
\fB\-\-all\-databases\fR,
\fB\-A\fR
.sp
پشتیبان‌گیری از تمام جدول‌ها در تمامی پایگاه‌های داده\&. این کار معادل استفاده از گزینه
\fB\-\-databases\fR
و ذکر نام تمام پایگاه‌های داده در خط فرمان است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: all-tablespaces option
.\" all-tablespaces option: mariadb-dump
\fB\-\-all\-tablespaces\fR,
\fB\-Y\fR
.sp
افزودن تمامی دستورهای SQL مورد نیاز برای ایجاد هرگونه فضای جدولی (tablespace) استفاده‌شده توسط یک جدول
NDBCLUSTER
به پشتیبان جدول\&. این اطلاعات در حالت عادی در خروجی
\fBmariadb-dump\fR
قرار نمی‌گیرد\&. این گزینه در حال حاضر تنها برای جدول‌های MySQL Cluster کاربرد دارد\&.
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: allow-keywords option
.\" allow-keywords option: mariadb-dump
\fB\-\-allow\-keywords\fR
.sp
اجازه به ایجاد نام ستون‌هایی که جزو کلمات کلیدی هستند\&. این کار با قرار دادن نام جدول به عنوان پیشوند نام هر ستون انجام می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: apply-slave-statements option
.\" apply-slave-statements option: mariadb-dump
\fB\-\-apply\-slave\-statements\fR.sp
دستور \'STOP SLAVE\' را پیش از \'CHANGE MASTER\' و \'START SLAVE\' را به انتهای dump می‌افزاید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: as-of option
.\" as-of option: mariadb-dump
\fB\-\-as\-of=\fR\fB\fIname\fR\fR
.sp
گرفتن dump از جدول دارای نسخه‌بندی سیستمی (system-versioned) در برچسب زمانی (timestamp) مشخص‌شده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: character-sets-dir option
.\" character-sets-dir option: mariadb-dump
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp
دایرکتوری محل نصب مجموعه‌نویسه‌ها (character sets)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: comments option
.\" comments option: mariadb-dump
\fB\-\-comments\fR,
\fB\-i\fR
.sp
نوشتن اطلاعات تکمیلی در فایل dump مانند نسخه برنامه، نسخه کارگزار و میزبان\&. این گزینه به‌طور پیش‌فرض فعال است\&. برای جلوگیری از درج این اطلاعات اضافی، از
\fB\-\-skip\-comments\fR
استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: compact option
.\" compact option: mariadb-dump
\fB\-\-compact\fR
.sp
تولید خروجی فشرده‌تر\&. این گزینه گزینه‌های
\fB\-\-skip\-add\-drop\-table\fR،
\fB\-\-skip\-add\-locks\fR،
\fB\-\-skip\-comments\fR،
\fB\-\-skip\-disable\-keys\fR
و
\fB\-\-skip\-set\-charset\fR
را فعال می‌کند\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: compatible option
.\" compatible option: mariadb-dump
\fB\-\-compatible=\fR\fB\fIname\fR\fR
.sp
تولید خروجی با سازگاری بیشتر با دیگر سامانه‌های پایگاه‌داده یا با کارگزارهای قدیمی‌تر MySQL\&. مقدار
\fIname\fR
می‌تواند
ansi،
mysql323،
mysql40،
postgresql،
oracle،
mssql،
db2،
maxdb،
no_key_options،
no_table_options
یا
no_field_options
باشد\&. برای استفاده از چند مقدار، آن‌ها را با ویرگول از هم جدا کنید\&. این مقادیر معنایی مشابه با گزینه‌های متناظر برای تنظیم حالت SQL (SQL mode) کارگزار دارند\&.
.sp
این گزینه سازگاری با سایر کارگزارها را تضمین نمی‌کند\&. این گزینه فقط آن دسته از مقادیر حالت SQL را فعال می‌کند که در حال حاضر برای سازگارتر کردن خروجی dump در دسترس هستند\&. برای مثال،
\fB\-\-compatible=oracle\fR
انواع داده را به انواع داده Oracle نگاشت نمی‌کند یا از قواعد نگارشی توضیحات (comments) در Oracle استفاده نمی‌کند\&.
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: complete-insert option
.\" complete-insert option: mariadb-dump
\fB\-\-complete\-insert\fR,
\fB\-c\fR
.sp
استفاده از دستورهای کامل
INSERT
که شامل نام ستون‌ها هستند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: compress option
.\" compress option: mariadb-dump
\fB\-\-compress\fR,
\fB\-C\fR
.sp
فشرده‌سازی تمام اطلاعات ارسالی بین کلاینت و کارگزار در صورتی که هر دو از فشرده‌سازی پشتیبانی کنند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: copy-s3-tables option
.\" copy-s3-tables option: mariadb-dump
\fB\-\-copy\-s3\-tables\fR
.sp
به‌طور پیش‌فرض جدول‌های S3 نادیده گرفته می‌شوند\&. با تنظیم این گزینه، فایل حاصل شامل یک دستور CREATE
برای یک جدول مشابه Aria خواهد بود که پس از آن داده‌های جدول آمده و با دستور ALTER TABLE xxx ENGINE=S3 پایان می‌یابد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: create-options option
.\" create-options option: mariadb-dump
\fB\-\-create\-options\fR,
\fB\-a\fR
.sp
گنجاندن تمام گزینه‌های مختص MariaDB برای جدول در دستورهای
CREATE TABLE\&.
برای غیرفعال کردن از \fB\-\-skip\-create\-options\fR استفاده کنید.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1.IP \(bu 2.3
.\}
.\" mariadb-dump: databases option
.\" databases option: mariadb-dump
\fB\-\-databases\fR,
\fB\-B\fR
.sp
پشتیبان‌گیری از چند پایگاه‌داده\&. در حالت عادی،
\fBmariadb-dump\fR
نخستین آرگومان نام در خط فرمان را به عنوان نام پایگاه‌داده و نام‌های پس از آن را به عنوان نام‌های جدول در نظر می‌گیرد\&. با این گزینه، تمامی آرگومان‌های نام به عنوان نام‌های پایگاه‌داده در نظر گرفته می‌شوند\&.
دستورهای
CREATE DATABASE
و
USE
پیش از هر پایگاه‌داده جدید در خروجی گنجانده می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: debug option
.\" debug option: mariadb-dump
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
نوشتن لاگ اشکال‌زدایی\&. یک رشته معمول برای
\fIdebug_options\fR
عبارت است از 'd:t:o,\fIfile_name\fR'\&. مقدار پیش‌فرض 'd:t:o,/tmp/mariadb-dump.trace' است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: debug-check option
.\" debug-check option: mariadb-dump
\fB\-\-debug\-check\fR
.sp
چاپ برخی اطلاعات اشکال‌زدایی هنگام خروج برنامه\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: debug-info option
.\" debug-info option: mariadb-dump
\fB\-\-debug\-info\fR
.sp
چاپ اطلاعات اشکال‌زدایی و آمار مصرف حافظه و CPU هنگام خروج برنامه\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: default-auth option
.\" default-auth option: mariadb-dump
\fB\-\-default\-auth\fR
.sp
پلاگین پیش‌فرض احراز هویت سمت کلاینت برای استفاده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: default-character-set option
.\" default-character-set option: mariadb-dump
\fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR
.sp
استفاده از
\fIcharset_name\fR
به عنوان مجموعه نویسه پیش‌فرض\&. اگر هیچ مجموعه نویسه‌ای مشخص نشده باشد،
\fBmariadb-dump\fR
از
utf8
استفاده می‌کند\&.
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: defaults-extra-file option
.\" defaults-extra-file option: mariadb-dump
\fB\-\-defaults\-extra\-file=\fR\fB\fIfilename\fR\fR
.sp
تعیین \fB\fIfilename\fR\fR به عنوان فایلی برای خواندن گزینه‌های پیش‌فرض، پس از خوانده شدن فایل‌های پیش‌فرض سراسری\&.
باید به عنوان نخستین گزینه داده شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: defaults-file option
.\" defaults-file option: mariadb-dump
\fB\-\-defaults\-file=\fR\fB\fIfilename\fR\fR
.sp
تعیین \fB\fIfilename\fR\fR به عنوان فایلی برای خواندن گزینه‌های پیش‌فرض و نادیده‌گرفتن فایل‌های پیش‌فرض سراسری\&.
باید به عنوان نخستین گزینه داده شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" my_print_defaults: defaults-group-suffix option
.\" defaults-group-suffix option: my_print_defaults
\fB\-\-defaults\-group\-suffix=\fR\fB\fIstr\fR\fR,
.sp
همچنین خواندن گروه‌هایی با پسوند \fIstr\fR\&. برای نمونه، از آنجا که mariadb-dump به طور معمول گروه‌های [client] و [mariadb-dump] را می‌خواند، \-\-defaults\-group\-suffix=x سبب می‌شود که گروه‌های [mariadb-dump_x] و [client_x] نیز خوانده شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: delayed-insert option
.\" delayed-insert option: mariadb-dump
\fB\-\-delayed\-insert\fR
.sp
نوشتن دستورهای
INSERT DELAYED
به جای دستورهای
INSERT\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: delete-master-logs option
.\" delete-master-logs option: mariadb-dump
\fB\-\-delete\-master\-logs\fR
.sp
در یک سرور تکثیر اصلی (master replication server)، حذف لاگ‌های باینری با ارسال دستور
PURGE BINARY LOGS
به سرور پس از انجام عملیات پشتیبان‌گیری\&. این گزینه به طور خودکار
\fB\-\-master\-data\fR
را فعال می‌کند\&.
.RE.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: dir option
.\" dirs option: mariadb-dump
\fB\-\-dir\fR
.sp
پشتیبان‌گیری موازی از چندین پایگاه‌داده. از نظر خروجی دقیقاً مانند \fB\-\-tab\fR عمل می‌کند 
(فایل sql برای تعاریف جداول و فایل‌های جداشده با تب برای داده‌ها، با همان گزینه‌ها، مانند \fB\-\-parallel\fR)\&.
همچنین امکان استفاده از گزینه‌های \fB\-\-databases\fR و \fB\-\-all-databases\fR را فراهم می‌آورد\&. هنگامی که \fB\-\-dir\fR به کار می‌رود، 
ساختار پوشه‌ها را در دایرکتوری خروجی مشخص‌شده با \fB\-\-dir\fR ایجاد می‌کند\&. به ازای 
هر پایگاه‌داده‌ای که باید پشتیبان‌گیری شود، دایرکتوری‌ای با نام همان پایگاه‌داده وجود خواهد داشت\&. تمام 
گزینه‌هایی که \fB\-\-tab\fR پشتیبانی می‌کند، توسط \fB\-\-dir\fR نیز پشتیبانی می‌شوند، به‌ویژه \fB\-\-parallel\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: disable-keys option
.\" disable-keys option: mariadb-dump
\fB\-\-disable\-keys\fR,
\fB\-K\fR
.sp
برای هر جدول، عبارت‌های
INSERT
را در میان عبارت‌های
/*!40000 ALTER TABLE \fItbl_name\fR DISABLE KEYS */;
و
/*!40000 ALTER TABLE \fItbl_name\fR ENABLE KEYS */;
قرار می‌دهد\&. این کار بارگذاری فایل پشتیبان را سریع‌تر می‌کند زیرا نمایه‌ها پس از درج تمام ردیف‌ها ایجاد می‌شوند\&. این گزینه فقط برای نمایه‌های غیریکتای جداول
MyISAM
مؤثر است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: dump-date option
.\" dump-date option: mariadb-dump
\fB\-\-dump\-date\fR
.sp
اگر گزینهٔ
\fB\-\-comments\fR
داده شده باشد،
\fBmariadb-dump\fR
در انتهای خروجی پشتیبان، توضیحی به شکل زیر تولید می‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\- Dump completed on \fIDATE\fR
.fi
.if n \{\
.RE
.\}
.sp
با این حال، درج تاریخ باعث می‌شود فایل‌های پشتیبان تهیه‌شده در زمان‌های گوناگون متفاوت به نظر برسند، حتی اگر داده‌های آن‌ها کاملاً یکسان باشد\&.
\fB\-\-dump\-date\fR
و
\fB\-\-skip\-dump\-date\fR
اضافه شدن تاریخ به این توضیح را کنترل می‌کنند\&. مقدار پیش‌فرض
\fB\-\-dump\-date\fR
است (گنجاندن تاریخ در بخش توضیحات)\&.
\fB\-\-skip\-dump\-date\fR
از چاپ تاریخ جلوگیری می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: dump-history option
.\" dump-history option: mariadb-dump
\fB\-\-dump\-history\fR
.sp
پشتیبان‌گیری از جداول به همراه تاریخچه. تا پیش از این گزینه، mariadb-dump قادر به خواندن ردیف‌های تاریخی از جداول نسخه‌بندی‌شده نبود، 
و در نتیجه از داده‌های تاریخی پشتیبان‌گیری نمی‌شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: dump-slave option
.\" dump-slave option: mariadb-dump
\fB\-\-dump\-slave[=\fR\fB\fIvalue\fR\fR\fB]\fR
.sp
برای تولید یک فایل پشتیبان از سرور اسلیو (slave) رونویسی استفاده می‌شود که می‌توان با آن سرور اسلیو دیگری
با همان مَستر (master) راه‌اندازی کرد\&. باعث می‌شود موقعیت binary log و نام فایل سرور مستر به خروجی داده‌های
پشتیبان‌گیری افزوده شود\&. مقداردهی آن به 1 (پیش‌فرض) آن را به صورت یک دستور CHANGE MASTER در خروجی داده‌های
پشتیبان چاپ می‌کند؛ در صورت تنظیم روی 2، یک نماد توضیح (کامنت) در ابتدای آن دستور قرار می‌گیرد\&. این گزینه
\-\-lock\-all\-tables
را فعال می‌کند، مگر اینکه \-\-single-transaction نیز مشخص شده باشد (که در این حالت قفل خواندن سراسری تنها برای مدتی کوتاه
در ابتدای پشتیبان‌گیری گرفته می‌شود \- مطالعه دربارهٔ \-\-single-transaction در ادامه را فراموش نکنید)\&. در تمام
حالات، هرگونه اقدام بر روی لاگ‌ها دقیقاً در همان لحظهٔ پشتیبان‌گیری رخ خواهد داد\&. این گزینه به‌طور خودکار
\-\-lock\-tables
را غیرفعال می‌کند\&. استفاده از این گزینه باعث می‌شود mariadb-dump پیش از آغاز پشتیبان‌گیری، تردِ SQL اسلیو را متوقف کرده
و پس از اتمام، دوباره آن را راه‌اندازی کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: events option
.\" events option: mariadb-dump
\fB\-\-events\fR,
\fB\-E\fR
.sp
رویدادهای Event Scheduler را برای پایگاه‌های دادهٔ پشتیبان‌گیری‌شده در خروجی قرار می‌دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: extended-insert option
.\" extended-insert option: mariadb-dump
\fB\-\-extended\-insert\fR,
\fB\-e\fR
.sp
استفاده از نحو
INSERT
چندردیفی که شامل چندین فهرست از
VALUES
است\&. این امر منجر به ایجاد فایل پشتیبان کوچک‌تر شده و سرعت درج ردیف‌ها را هنگام بارگذاری مجدد فایل افزایش می‌دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: fields-terminated-by option
.\" fields-terminated-by option: mariadb-dump
\fB\-\-fields\-terminated\-by=\&.\&.\&.\fR,
.\" mariadb-dump: fields-enclosed-by option
.\" fields-enclosed-by option: mariadb-dump
\fB\-\-fields\-enclosed\-by=\&.\&.\&.\fR,
.\" mariadb-dump: fields-optionally-enclosed-by option
.\" fields-optionally-enclosed-by option: mariadb-dump
\fB\-\-fields\-optionally\-enclosed\-by=\&.\&.\&.\fR,
.\" mariadb-dump: fields-escaped-by option
.\" fields-escaped-by option: mariadb-dump
\fB\-\-fields\-escaped\-by=\&.\&.\&.\fR
.sp
این گزینه‌ها همراه با گزینهٔ
\fB\-\-tab\fR
به کار می‌روند و معنایی مشابه با عبارت‌های متناظر
FIELDS
برای
LOAD DATA INFILE
دارند\&.
.RE.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: first-slave option
.\" first-slave option: mariadb-dump
\fB\-\-first\-slave\fR
.sp
در MariaDB 5.5 حذف شده است\&. در عوض از
\fB\-\-lock\-all\-tables\fR
استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: flush-logs option
.\" flush-logs option: mariadb-dump
\fB\-\-flush\-logs\fR,
\fB\-F\fR
.sp
فایل‌های گزارش (log) کارساز MariaDB را پیش از شروع پشتیبان‌گیری بازنشانی (flush) می‌کند\&. این گزینه نیازمند مجوز
RELOAD
است\&. اگر از این گزینه در ترکیب با گزینهٔ
\fB\-\-all\-databases\fR
استفاده کنید، گزارش‌ها
\fIبه‌ازای هر پایگاه دادهٔ پشتیبان‌گیری‌شده\fR
بازنشانی می‌شوند\&. استثنا در زمان استفاده از
\fB\-\-lock\-all\-tables\fR
یا
\fB\-\-master\-data\fR
است: در این حالت، گزارش‌ها تنها یک بار بازنشانی می‌شوند، که منطبق با لحظهٔ قفل شدن تمامی جدول‌ها است\&. اگر می‌خواهید پشتیبان‌گیری و بازنشانی گزارش دقیقاً در یک لحظه رخ دهند، باید از
\fB\-\-flush\-logs\fR
همراه با
\fB\-\-lock\-all\-tables\fR
یا
\fB\-\-master\-data\fR
استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: flush-privileges option
.\" flush-privileges option: mariadb-dump
\fB\-\-flush\-privileges\fR
.sp
یک دستور
FLUSH PRIVILEGES
را پس از پشتیبان‌گیری از پایگاه دادهٔ
mysql
به کارساز ارسال می‌کند\&. این گزینه باید هر زمان که خروجی پشتیبان شامل پایگاه دادهٔ
mysql
و هر پایگاه دادهٔ دیگری باشد که برای بازیابی مناسب به داده‌های پایگاه دادهٔ
mysql
وابسته است، استفاده شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: force option
.\" force option: mariadb-dump
\fB\-\-force\fR,
\fB\-f\fR
.sp
حتی در صورت وقوع یک خطای SQL حین پشتیبان‌گیری از یک جدول، به کار ادامه می‌دهد\&.
.sp
یکی از کاربردهای این گزینه این است که باعث می‌شود
\fBmariadb-dump\fR
حتی هنگام مواجهه با نمایی (view) که به‌دلیل ارجاع تعریف آن به جدولی که حذف (drop) شده نامعتبر گردیده است، به اجرا ادامه دهد\&. بدون
\fB\-\-force\fR،
دستور
\fBmariadb-dump\fR
با یک پیام خطا خارج می‌شود\&. با
\fB\-\-force\fR،
دستور
\fBmariadb-dump\fR
پیام خطا را چاپ می‌کند، اما همچنین یک کامنت SQL حاوی تعریف نما را در خروجی پشتیبان می‌نویسد و به اجرا ادامه می‌دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: gtid option
.\" gtid option: mariadb-dump
\fB\-\-gtid\fR
.sp
از MariaDB 10.0.13 در دسترس است و همراه با \fB\-\-master\-data\fR و \fB\-\-dump\-slave\fR برای راه‌اندازی راحت‌تر یک slave جدید GTID به کار می‌رود\&. این گزینه باعث می‌شود که آن گزینه‌ها عبارت‌های SQLای تولید کنند که slave را برای استفاده از شناسهٔ سراسری تراکنش (GTID) جهت اتصال به master به‌جای موقعیت‌های قدیمی نام‌فایل/آفست پیکربندی کند\&. موقعیت‌های سبک قدیمی در صورت استفاده از \fB\-\-gtid\fR همچنان در کامنت‌ها گنجانده می‌شوند؛ به‌همین ترتیب حتی اگر از \fB\-\-gtid\fR استفاده نشود، موقعیت GTID در کامنت‌ها قرار می‌گیرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: header option
.\" header option: mariadb-dump
\fB\-\-header\fR
.sp
همراه با \-\-tab استفاده می‌شود\&. در صورت فعال بودن، سرآیندی شامل نام ستون‌ها به ابتدای فایل‌های txt خروجی اضافه می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: hex-blob option
.\" hex-blob option: mariadb-dump
\fB\-\-hex\-blob\fR
.sp
پشتیبان‌گیری از ستون‌های دودویی با استفاده از نمادگذاری شانزده‌شانزدهی (برای مثال، \(aqabc\(aq تبدیل به
0x616263
می‌شود)\&. نوع‌های دادهٔ متأثر عبارت‌اند از
BINARY،
VARBINARY، نوع‌های
BLOB، و
BIT\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: host option
.\" host option: mariadb-dump
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
پشتیبان‌گیری از داده‌ها از کارساز MariaDB روی میزبان مشخص‌شده\&. میزبان پیش‌فرض
localhost
است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: ignore-table option
.\" ignore-table option: mariadb-dump
\fB\-\-ignore\-table=\fR\fB\fIdb_name\&.tbl_name\fR\fR
.sp
از جدول داده‌شده پشتیبان‌گیری نمی‌کند؛ این جدول باید با هر دو نام پایگاه داده و جدول مشخص شود\&. برای نادیده گرفتن چندین جدول، از این گزینه چندین بار استفاده کنید\&. از این گزینه می‌توان برای نادیده گرفتن نماها نیز استفاده کرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: include-master-host-port option
.\" include-master-host-port option: mariadb-dump
\fB\-\-include\-master\-host\-port\fR
.sp
افزودن گزینه‌های MASTER_HOST و MASTER_PORT به عبارت CHANGE MASTER TO هنگام استفاده از گزینهٔ \fB\-\-dump\-slave\fR برای پشتیبان‌گیری از یک slave\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: insert-ignore option
.\" insert-ignore option: mariadb-dump
\fB\-\-insert\-ignore\fR
.sp
نوشتن عبارت‌های
INSERT IGNORE
به جای عبارت‌های
INSERT\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: lines-terminated-by option
.\" lines-terminated-by option: mariadb-dump
\fB\-\-lines\-terminated\-by=\&.\&.\&.\fR
.sp
این گزینه همراه با گزینهٔ
\fB\-\-tab\fR
استفاده می‌شود و معنایی یکسان با بندِ متناظر
LINES
برای
LOAD DATA INFILE
دارد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: lock-all-tables option
.\" lock-all-tables option: mariadb-dump
\fB\-\-lock\-all\-tables\fR,
\fB\-x\fR
.sp
قفل کردن تمام جدول‌ها در همهٔ پایگاه‌های داده\&. این عمل با دریافت یک قفل خواندن سراسری (global read lock) برای کل مدت‌زمان پشتیبان‌گیری انجام می‌شود\&. این گزینه به طور خودکار گزینه‌های
\fB\-\-single\-transaction\fR
و
\fB\-\-lock\-tables\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: lock-tables option
.\" lock-tables option: mariadb-dump
\fB\-\-lock\-tables\fR,
\fB\-l\fR
.sp
برای هر پایگاه داده‌ای که پشتیبان‌گیری می‌شود، قفل کردن تمام جدول‌های مربوطه پیش از استخراج آن‌ها\&. جدول‌ها با
READ LOCAL
قفل می‌شوند تا امکان درج هم‌زمان در جدول‌های
MyISAM
وجود داشته باشد\&. برای جدول‌های تراکنشی مانند
InnoDB،
گزینهٔ
\fB\-\-single\-transaction\fR
بسیار بهتر از
\fB\-\-lock\-tables\fR
است، زیرا اصلاً نیازی به قفل کردن جدول‌ها ندارد\&.
.sp
از آنجا که
\fB\-\-lock\-tables\fR
جدول‌ها را برای هر پایگاه داده به صورت جداگانه قفل می‌کند، این گزینه تضمین نمی‌کند که جدول‌های موجود در فایل پشتیبان بین پایگاه‌های دادهٔ مختلف از نظر منطقی سازگار باشند\&. جدول‌ها در پایگاه‌های دادهٔ گوناگون ممکن است در وضعیت‌های کاملاً متفاوتی استخراج شوند\&.
.sp
برای غیرفعال کردن از \fB\-\-skip\-lock\-tables\fR استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: log-error option
.\" log-error option: mariadb-dump
\fB\-\-log\-error=\fR\fB\fIfile_name\fR\fR
.sp
ثبت هشدارها و خطاها با افزودن آن‌ها به فایل مشخص‌شده\&. حالت پیش‌فرض بر روی عدم ثبت هرگونه گزارش قرار دارد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: log-queries option
.\" log-queries option: mariadb-dump
\fB\-\-log\-queries\fR\fR
.sp
هنگام بازیابی پشتیبان، در صورتی که ثبت گزارش فعال باشد، سرور پرس‌وجوها را در لاگ‌های عمومی (general log) و پرس‌وجوهای کُند (slow query log) ثبت خواهد کرد\&.
به طور پیش‌فرض فعال است؛ برای غیرفعال کردن از \fB\-\-skip\-log\-queries\fR استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: master-data option
.\" master-data option: mariadb-dump
\fB\-\-master\-data[=\fR\fB\fIvalue\fR\fR\fB]\fR
.sp
استفاده از این گزینه برای پشتیبان‌گیری از یک سرور اصلی همانندسازی (master replication server) جهت تولید فایل پشتیبانی که بتوان از آن برای راه‌اندازی سروری دیگر به عنوان slave آن master استفاده کرد\&. این گزینه سبب می‌شود که خروجی پشتیبان شامل دستور
CHANGE MASTER TO
باشد که مختصات لاگ دودویی (نام فایل و موقعیت) سرورِ پشتیبان‌گیری‌شده را مشخص می‌کند\&. این‌ها مختصات سرور اصلی هستند که slave پس از بارگذاری فایل پشتیبان، باید همانندسازی را از آن نقطه آغاز کند\&.
.sp
اگر مقدار گزینه برابر با 2 باشد، دستور
CHANGE MASTER TO
به عنوان یک کامنت SQL نوشته می‌شود و بنابراین صرفاً جنبهٔ اطلاع‌رسانی دارد؛ هنگام بارگذاری مجدد فایل پشتیبان هیچ اثری نخواهد داشت\&. اگر مقدار این گزینه 1 باشد، عبارت مذکور به صورت کامنت نوشته نمی‌شود و هنگام بارگذاری مجدد فایل پشتیبان اعمال خواهد شد\&. اگر مقداری مشخص نشود، مقدار پیش‌فرض 1 خواهد بود\&.
.sp
این گزینه نیازمند امتیاز
RELOAD
بوده و لاگ دودویی (binary log) نیز باید فعال باشد\&.
.sp
گزینهٔ
\fB\-\-master\-data\fR
به طور خودکار
\fB\-\-lock\-tables\fR
را غیرفعال می‌کند\&. همچنین
\fB\-\-lock\-all\-tables\fR
را فعال می‌سازد، مگر اینکه
\fB\-\-single\-transaction\fR
نیز تعیین شده باشد\&. در تمام حالات، هرگونه اقدام بر روی لاگ‌ها دقیقاً در لحظهٔ پشتیبان‌گیری روی می‌دهد\&.
.sp
همچنین امکان راه‌اندازی یک slave با پشتیبان‌گیری از یک slave موجود از سرور master وجود دارد\&. بدین منظور، مراحل زیر را روی slave موجود انجام دهید:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
نخِ SQL مربوط به slave را متوقف کرده و وضعیت فعلی آن را بررسی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBSTOP SLAVE SQL_THREAD;\fR
mariadb> \fBSHOW SLAVE STATUS;\fR
.fi
.if n \{\
.RE
.\}
.RE.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
از خروجی عبارت
SHOW SLAVE STATUS
مختصات لاگ باینری سرور master که slave جدید باید همانندسازی را از آن آغاز کند، مقادیر فیلدهای
Relay_Master_Log_File
و
Exec_Master_Log_Pos
است\&. این مقادیر را به عنوان
\fIfile_name\fR
و
\fIfile_pos\fR\&
در نظر بگیرید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
از سرور slave نسخه‌ی پشتیبان (dump) بگیرید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-master\-data=2 \-\-all\-databases > dumpfile\fR
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
سرور slave را مجدداً راه‌اندازی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBSTART SLAVE;\fR
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
روی slave جدید، فایل dump را بارگذاری کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb < dumpfile\fR
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
روی slave جدید، مختصات همانندسازی را به مقادیر به دست آمده از سرور master تنظیم کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBCHANGE MASTER TO\fR
    \-> \fBMASTER_LOG_FILE = '\fR\fB\fIfile_name\fR\fR\fB', MASTER_LOG_POS = \fR\fB\fIfile_pos\fR\fR\fB;\fR
.fi
.if n \{\
.RE
.\}
.sp
عبارت
CHANGE MASTER TO
ممکن است به پارامترهای دیگری مانند
MASTER_HOST
برای هدایت slave به میزبان صحیح سرور master نیز نیاز داشته باشد\&. در صورت نیاز این پارامترها را اضافه کنید\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: max-allowed-packet option
.\" max-allowed-packet option: mariadb-dump
\fB\-\-max\-allowed\-packet=\fR\fB\fIlength\fR\fR
.sp
حداکثر طول بسته برای ارسال به سرور یا دریافت از آن را تعیین می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: max-statement-time option
.\" max-statement-time option: mariadb-dump
\fB\-\-max\-statement\-time=\fR\fB\fIseconds\fR\fR
.sp
حداکثر زمانی که یک عبارت می‌تواند پیش از اتمام مهلت زمانی (timeout) توسط سرور اجرا شود را تنظیم می‌کند. (مقدار پیش‌فرض 0 (نامحدود) است)\&
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: net-buffer-length option
.\" net-buffer-length option: mariadb-dump
\fB\-\-net\-buffer\-length=\fR\fB\fIlength\fR\fR
.sp
اندازه بافر را برای ارتباطات TCP/IP و سوکت تعیین می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: no-autocommit option
.\" no-autocommit option: mariadb-dump
\fB\-\-no\-autocommit\fR
.sp
عبارت‌های
INSERT
را برای هر جدول نسخه‌برداری‌شده، درون عبارت‌های
SET autocommit = 0
و
COMMIT
قرار می‌دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: no-create-db option
.\" no-create-db option: mariadb-dump
\fB\-\-no\-create\-db\fR,
\fB\-n\fR
.sp
این گزینه از نوشتن دستورات
CREATE DATABASE
که در صورت مشخص شدن گزینهٔ
\fB\-\-databases\fR
یا
\fB\-\-all\-databases\fR
در خروجی گنجانده می‌شوند، جلوگیری می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: no-create-info option
.\" no-create-info option: mariadb-dump
\fB\-\-no\-create\-info\fR,
\fB\-t\fR
.sp
دستورات
CREATE TABLE
را که هر جدول استخراج‌شده را مجدداً ایجاد می‌کنند، در خروجی نمی‌نویسد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: no-data option
.\" no-data option: mariadb-dump
\fB\-\-no\-data\fR,
\fB\-d\fR
.sp
هیچ‌یک از اطلاعات سطرهای جدول را نمی‌نویسد (یعنی محتویات جدول را استخراج نمی‌کند)\&. این گزینه زمانی کاربرد دارد که تنها بخواهید دستور
CREATE TABLE
را برای جدول استخراج کنید (برای نمونه، جهت ایجاد یک رونوشت خالی از جدول با بارگذاری فایل پشتیبان)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: no-defaults option
.\" no-defaults option: mariadb-dump
\fB\-\-no\-defaults\fR
.sp
گزینه‌های پیش‌فرض را از هیچ فایل تنظیمی نمی‌خواند\&. این گزینه باید به عنوان نخستین آرگومان مشخص شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: no-set-names option
.\" no-set-names option: mariadb-dump
\fB\-\-no\-set\-names\fR,
\fB\-N\fR
.sp
این گزینه اثری مشابه با
\fB\-\-skip\-set\-charset\fR
دارد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: opt option
.\" opt option: mariadb-dump
\fB\-\-opt\fR
.sp
این گزینه یک میان‌بر است\&. مشخص کردن آن معادل تعیین هم‌زمانِ
\fB\-\-add\-drop\-table\fR
\fB\-\-add\-locks\fR
\fB\-\-create\-options\fR
\fB\-\-disable\-keys\fR
\fB\-\-extended\-insert\fR
\fB\-\-lock\-tables\fR
\fB\-\-quick\fR
\fB\-\-set\-charset\fR\&
می‌باشد\&. این گزینه عملیات استخراج را سریع کرده و فایلی تولید می‌کند که می‌توان آن را به‌سرعت در یک سرور MariaDB بارگذاری مجدد کرد\&.
.sp
گزینهٔ \fB\-\-opt\fR به‌طور پیش‌فرض فعال است\&. برای غیرفعال کردن آن از \fB\-\-skip\-opt\fR استفاده کنید\&.
جهت کسب اطلاعات دربارهٔ فعال یا غیرفعال‌سازی گزینشی زیرمجموعه‌ای از گزینه‌های متأثر از
\fB\-\-opt\fR\&،
توضیحات ابتدای این بخش را ببینید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: order-by-primary option
.\" order-by-primary option: mariadb-dump
\fB\-\-order\-by\-primary\fR
.sp
سطرهای هر جدول را مرتب‌شده بر اساس کلید اصلی آن یا در صورت وجود، نخستین نمایهٔ یکتا (unique index) استخراج می‌کند\&. این گزینه هنگام استخراج یک جدول
MyISAM
برای بارگذاری در یک جدول
InnoDB
مفید است، اما زمان عملیات استخراج را به‌طور چشمگیری افزایش می‌دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: order-by-size option
.\" order-by-size option: mariadb-dump
\fB\-\-order\-by\-size\fR
.sp
هر جدول را بر اساس اندازه‌اش استخراج می‌کند، ابتدا کوچک‌ترین‌ها. هنگام استفاده از \-\-single\-transaction روی جدول‌هایی که مکرراً خالی (truncate) یا دستخوش تغییر ساختار (alter) می‌شوند بسیار کاربردی است\&. فرض بر این است که جدول‌های کوچک‌تر بیشتر خالی می‌شوند و با استخراج ابتدایی آن‌ها، احتمال اینکه عملیات استخراج با \-\-single\-transaction با خطای
\(aqTable definition has changed, please retry transaction\(aq
شکست بخورد، کاهش می‌یابد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: parallel option
.\" parallel option: mariadb-dump
\fB\-\-parallel=#\fR,
\fB\-j\fR
.sp
تعداد کارهای استخراج جدول که به‌طور هم‌روند و موازی اجرا می‌شوند (تنها برای استفاده همراه با گزینهٔ \-\-tab). آزمایش‌های اولیه نشان می‌دهد که در استخراج‌های کوچک‌تر، هنگامی که پایگاه داده در حافظه جا می‌گیرد، کارایی می‌تواند تا ۴ برابر افزایش (کاهش زمان استخراج) یابد. با این حال نقطه‌ای وجود دارد که در آن دیسک به گلوگاه تبدیل می‌شود، که پس از آن افزودن کارهای موازی بیشتر بهبودی در کارایی ایجاد نخواهد کرد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}

.\" mariadb-dump: password option
.\" password option: mariadb-dump
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR.sp
گذرواژه برای استفاده هنگام اتصال به سرور\&. اگر از شکل کوتاه گزینه (\fB\-p\fR) استفاده کنید،
\fIنمی‌توانید\fR
بین گزینه و گذرواژه فاصله بگذارید\&. اگر مقدار
\fIpassword\fR
به‌دنبال گزینهٔ
\fB\-\-password\fR
یا
\fB\-p\fR
در خط فرمان قید نشود،
\fBmariadb-dump\fR
آن را از شما درخواست می‌کند\&.
.sp
مشخص کردن گذرواژه در خط فرمان باید ناامن تلقی شود\&. می‌توانید از یک فایل گزینه‌ها (option file) استفاده کنید تا از ارائه گذرواژه در خط فرمان پرهیز شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: pipe option
.\" pipe option: mariadb-dump
\fB\-\-pipe\fR,
\fB\-W\fR
.sp
در Windows، اتصال به سرور از طریق یک لولهٔ نام‌گذاری‌شده (named pipe)\&. این گزینه تنها در صورتی اعمال می‌شود که سرور از اتصالات named\-pipe پشتیبانی کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: plugin-dir option
.\" plugin-dir option: mariadb-dump
\fB\-\-plugin\-dir\fR
.sp
دایرکتوری افزونه‌های سمت کلاینت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: port option
.\" port option: mariadb-dump
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
شماره درگاه TCP/IP برای استفاده در اتصال\&.
هنگامی که بدون سایر ویژگی‌های اتصال در خط فرمان مشخص شود، استفاده از --protocol=tcp را اجباری می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: protocol option
.\" protocol option: mariadb-dump
\fB\-\-protocol={TCP|SOCKET|PIPE|MEMORY}\fR
.sp
پروتکل اتصال برای اتصال به سرور\&. زمانی مفید است که سایر پارامترهای اتصال به‌طور معمول باعث استفاده از پروتکلی غیر از پروتکل دلخواه شما شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: quick option
.\" quick option: mariadb-dump
\fB\-\-quick\fR,
\fB\-q\fR
.sp
این گزینه برای استخراج جدول‌های بزرگ مفید است\&. این گزینه
\fBmariadb-dump\fR
را ملزم می‌کند تا ردیف‌های یک جدول را به جای دریافت کل مجموعه ردیف‌ها و بافر کردن آن‌ها در حافظه پیش از نوشتن، سطر به سطر از سرور دریافت کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: print-defaults option
.\" print-defaults option: mariadb-dump
\fB\-\-print\-defaults\fR
.sp
چاپ فهرست آرگومان‌های برنامه و خروج\&. این گزینه باید به عنوان نخستین آرگومان مشخص شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: quote-names option
.\" quote-names option: mariadb-dump
\fB\-\-quote\-names\fR,
\fB\-Q\fR
.sp
شناسه‌ها (مانند نام پایگاه داده، جدول و ستون) را درون نویسه‌های
\(lq`\(rq
قرار می‌دهد\&. اگر حالت SQL مربوط به
ANSI_QUOTES
فعال باشد، شناسه‌ها درون نویسه‌های
\(lq"\(rq
محصور می‌شوند\&. این گزینه به‌طور پیش‌فرض فعال است\&. می‌توان آن را با
\fB\-\-skip\-quote\-names\fR
غیرفعال کرد، اما این گزینه باید پس از هر گزینه‌ای مانند
\fB\-\-compatible\fR
که ممکن است
\fB\-\-quote\-names\fR
را فعال کند، مشخص شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: replace option
.\" replace option: mariadb-dump
\fB\-\-replace\fR
.sp
نوشتن دستورهای
REPLACE
به جای دستورهای
INSERT\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: result-file option
.\" result-file option: mariadb-dump
\fB\-\-result\-file=\fR\fB\fIfile_name\fR\fR,
\fB\-r \fR\fB\fIfile_name\fR\fR
.sp
هدایت مستقیم خروجی به یک فایل مشخص\&. این گزینه باید در Windows استفاده شود تا از تبدیل نویسه‌های خط جدید
\(lq\en\(rq
به توالی‌های بازگشت به ابتدای سطر/خط جدید
\(lq\er\en\(rq
جلوگیری شود\&. فایل نتیجه ایجاد شده و محتویات قبلی آن بازنویسی می‌شود، حتی اگر در حین تولید dump خطایی رخ دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: routines option
.\" routines option: mariadb-dump
\fB\-\-routines\fR,
\fB\-R\fR
.sp
روال‌های ذخیره‌شده (رویه‌ها و توابع) پایگاه‌های دادهٔ پشتیبان‌گیری‌شده را در خروجی می‌گنجاند\&. استفاده از این گزینه نیازمند امتیاز
SELECT
برای جدول
mysql\&.proc
است\&. خروجی تولیدشده با استفاده از
\fB\-\-routines\fR
شامل دستورهای
CREATE PROCEDURE
و
CREATE FUNCTION
جهت ایجاد مجدد روال‌ها است\&. با این حال، این دستورها ویژگی‌هایی مانند برچسب‌های زمانی ایجاد و تغییر روال را در بر نمی‌گیرند\&. این بدان معناست که هنگام بارگذاری مجدد روال‌ها، آن‌ها با برچسب‌های زمانی برابر با زمان بارگذاری ایجاد خواهند شد\&.
.sp
اگر نیاز دارید روال‌ها با ویژگی‌های برچسب زمانی اولیه‌شان ایجاد شوند، از
\fB\-\-routines\fR
استفاده نکنید\&. در عوض، محتویات جدول
mysql\&.proc
را مستقیماً با استفاده از یک حساب کاربری MariaDB که امتیازات لازم برای پایگاه دادهٔ
mysql
را دارد، پشتیبان‌گیری و دوباره بارگذاری نمایید\&.
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: set-charset option
.\" set-charset option: mariadb-dump
\fB\-\-set\-charset\fR
.sp
دستور
SET NAMES \fIdefault_character_set\fR
را به خروجی اضافه می‌کند\&. این گزینه به‌طور پیش‌فرض فعال است\&. برای جلوگیری از درج دستور
SET NAMES،
از گزینهٔ
\fB\-\-skip\-set\-charset\fR
استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: single-transaction option
.\" single-transaction option: mariadb-dump
\fB\-\-single\-transaction\fR
.sp
این گزینه پیش از آغاز پشتیبان‌گیری از داده‌ها، یک دستور
START TRANSACTION
را به کارساز ارسال می‌کند\&. این ویژگی تنها برای جدول‌های تراکنشی مانند
InnoDB
مفید است، زیرا وضعیت سازگار پایگاه داده را در لحظهٔ صدور
BEGIN
بدون مسدود کردن هیچ برنامه‌ای پشتیبان‌گیری می‌کند\&.
.sp
هنگام استفاده از این گزینه، باید در نظر داشته باشید که تنها جدول‌های
InnoDB
در وضعیتی سازگار پشتیبان‌گیری می‌شوند\&. برای مثال، هرگونه جدول
MyISAM
یا
MEMORY
که هم‌زمان با این گزینه پشتیبان‌گیری شود، ممکن است وضعیتشان تغییر کند\&.
.sp
در حین انجام پشتیبان‌گیری با
\fB\-\-single\-transaction\fR،
برای اطمینان از صحت فایل پشتیبان (محتوای درست جدول‌ها و مختصات لاگ باینری)، هیچ اتصال دیگری نباید از دستورهای زیر استفاده کند:
ALTER TABLE،
CREATE TABLE،
DROP TABLE،
RENAME TABLE،
TRUNCATE TABLE\&.
خواندن سازگار (consistent read) در برابر این دستورها ایزوله نیست، بنابراین استفاده از آن‌ها بر روی جدولی که در حال پشتیبان‌گیری است می‌تواند باعث شود دستور
SELECT
که توسط
\fBmariadb-dump\fR
برای بازیابی محتویات جدول اجرا می‌شود، محتوای نادرستی دریافت کند یا با خطا مواجه شود\&.
.sp
گزینهٔ
\fB\-\-single\-transaction\fR
و گزینهٔ
\fB\-\-lock\-tables\fR
مانعة‌الجمع هستند (نمی‌توانند هم‌زمان استفاده شوند)، زیرا
LOCK TABLES
باعث می‌شود هرگونه تراکنش معلق به‌صورت ضمنی اعمال (commit) شود\&.
.sp
برای پشتیبان‌گیری از جدول‌های بزرگ، باید گزینهٔ
\fB\-\-single\-transaction\fR
را با
\fB\-\-quick\fR
ترکیب کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-add-drop-table option
.\" skip-add-drop-table option: mariadb-dump
\fB\-\-skip\-add\-drop\-table\fR
.sp
غیرفعال کردن گزینهٔ
\fB\-\-add\-drop\-table\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-add-locks option
.\" skip-add-locks option: mariadb-dump
\fB\-\-skip\-add\-locks\fR
.sp
غیرفعال کردن گزینهٔ
\fB\-\-add\-locks\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-comments option
.\" skip-comments option: mariadb-dump
\fB\-\-skip\-comments\fR
.sp
غیرفعال کردن گزینهٔ
\fB\-\-comments\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-compact option
.\" skip-compact option: mariadb-dump
\fB\-\-skip\-compact\fR
.sp
غیرفعال کردن گزینهٔ
\fB\-\-compact\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-disable-keys option
.\" skip-disable-keys option: mariadb-dump
\fB\-\-skip\-disable\-keys\fR.sp
گزینهٔ
\fB\-\-disable\-keys\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-extended-insert option
.\" skip-extended-insert option: mariadb-dump
\fB\-\-skip\-extended\-insert\fR
.sp
گزینهٔ
\fB\-\-extended\-insert\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-opt option
.\" skip-opt option: mariadb-dump
\fB\-\-skip\-opt\fR
.sp
گزینهٔ
\fB\-\-opt\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-quick option
.\" skip-quick option: mariadb-dump
\fB\-\-skip\-quick\fR
.sp
گزینهٔ
\fB\-\-quick\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-quote-names option
.\" skip-quote-names option: mariadb-dump
\fB\-\-skip\-quote\-names\fR
.sp
گزینهٔ
\fB\-\-quote\-names\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-set-charset option
.\" skip-set-charset option: mariadb-dump
\fB\-\-skip\-set\-charset\fR
.sp
گزینهٔ
\fB\-\-set\-charset\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-triggers option
.\" skip-triggers option: mariadb-dump
\fB\-\-skip\-triggers\fR
.sp
گزینهٔ
\fB\-\-triggers\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: skip-tz-utc option
.\" skip-tz-utc option: mariadb-dump
\fB\-\-skip\-tz\-utc\fR
.sp
گزینهٔ
\fB\-\-tz\-utc\fR
را غیرفعال می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: socket option
.\" socket option: mariadb-dump
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
برای اتصال به
localhost، فایل سوکت یونیکس برای استفاده، یا در Windows، نام لولهٔ نام‌گذاری‌شده (named pipe) مورد استفاده\&.
اگر در خط فرمان بدون سایر مشخصه‌های اتصال تعیین شود، \-\-protocol=socket را تحمیل می‌کند؛ در Windows، مقدار \-\-protocol=pipe را تحمیل می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL options
.\" SSL options: mariadb-admin
\fB\-\-ssl\fR
.sp
فعال‌سازی SSL برای اتصال (به‌طور خودکار با پرچم‌های دیگر فعال می‌شود). غیرفعال‌سازی با
\fB\-\-skip-ssl\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL CA option
.\" SSL CA option: mariadb-admin
\fB\-\-ssl\-ca=\fIname\fR
.sp
فایل CA در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم
\fB\-\-ssl\fR
است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL CA Path option
.\" SSL CA Path option: mariadb-admin
\fB\-\-ssl\-capath=\fIname\fR
.sp
دایرکتوری CA (مستندات OpenSSL بررسی شود، مستلزم
\fB\-\-ssl\fR است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL Cert option
.\" SSL Cert option: mariadb-admin
\fB\-\-ssl\-cert=\fIname\fR
.sp
گواهی X509 در قالب PEM (مستندات OpenSSL بررسی شود، مستلزم
\fB\-\-ssl\fR است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL Cipher option
.\" SSL Cipher option: mariadb-admin
\fB\-\-ssl\-cipher=\fIname\fR
.sp
رمزنگاری SSL مورد استفاده (مستندات OpenSSL بررسی شود، مستلزم
\fB\-\-ssl\fR است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL Key option
.\" SSL Key option: mariadb-admin
\fB\-\-ssl\-key=\fIname\fR
.sp
کلید X509 در قالب PEM (مستندات OpenSSL بررسی شود، مستلزم
\fB\-\-ssl\fR است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL Crl option
.\" SSL CRL option: mariadb-admin
\fB\-\-ssl\-crl=\fIname\fR
.sp
فهرست ابطال گواهی (مستندات OpenSSL بررسی شود، مستلزم
\fB\-\-ssl\fR است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL Crlpath option
.\" SSL Crlpath option: mariadb-admin
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
مسیر فهرست ابطال گواهی (مستندات OpenSSL بررسی شود، مستلزم
\fB\-\-ssl\fR است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-admin
\fB\-\-ssl\-verify\-server\-cert\fR
.sp
بررسی «Common Name» سرور در گواهی آن در برابر نام میزبان مورد استفاده هنگام اتصال. این گزینه به‌طور پیش‌فرض غیرفعال است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-admin: Dump system tables option
.\" Dump system tables option: mariadb-admin
\fB\-\-system=\fR\fB\fI{all, users, plugins, udfs, servers, stats, timezones}\fR\fR
.sp
استخراج جدول‌های سیستمی پایگاه داده mysql در یک قالب منطقی\&. این گزینه به‌طور پیش‌فرض یک مجموعهٔ خالی است\&.
.sp
یک یا چند گزینه را می‌توان در یک فهرست جداشده با کاما مشخص کرد\&.
.sp
گزینه‌ها در اینجا عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
all \- یک نام مستعار برای فعال‌سازی تمامی گزینه‌های زیر\&.
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
users \- کاربران، نقش‌ها و مجوزهای آن‌ها که در قالب \fBCREATE USER\fB، \fBCREATE ROLE\fR، \fBGRANT\fR و \fBSET DEFAULT ROLE\fR خروجی داده می‌شوند (\fBALTER USER\fR برای +MySQL-8.0)\&.
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
plugins \- افزونه‌های فعال سرور که در قالب \fBINSTALL PLUGIN\fR خروجی داده می‌شوند\&.
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
udfs \- توابع تعریف‌شده توسط کاربر که در قالب \fBCREATE FUNCTION\fR خروجی داده می‌شوند\&.
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
servers \- سرورهای راه دور (اتحادی یا federated) در قالب \fBCREATE SERVER\fR\&.
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1.IP \(bu 2.3
.\}
stats \- جدول‌های آمار، InnoDB و آمار جدول مستقل از موتور (EITS)، به صورت دستورهای \fBREPLACE INTO\fR (یا در صورت مشخص شدن \fB\-\-insert\-ignore\fR، \fBINSERT IGNORE\fR) بدون ایجاد (مجدد) جدول‌ها پشتیبان‌گیری می‌شوند\&.
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
timezones \- جدول‌های سیستمی مربوط به منطقه زمانی به صورت دستورهای \fBREPLACE INTO\fR (یا در صورت مشخص شدن \fB\-\-insert\-ignore\fR، \fBINSERT IGNORE\fR) بدون ایجاد (مجدد) جدول‌ها پشتیبان‌گیری می‌شوند\&.
.RE
.sp
قالب خروجی تحت تأثیر \fB\-\-replace\fR و \fB\-\-insert\-ignore\fR قرار می‌گیرد\&. گزینهٔ \fB\-\-replace\fR شکل‌های \fBCREATE OR REPLACE\fR از SQL و همچنین در صورت در دسترس نبودن گزینهٔ \fBCREATE OR REPLACE\fR، عبارت \fBDROP IF EXISTS\fR را پیش از \fBCREATE\fR در خروجی قرار می‌دهد.
.sp
با \fB\-\-system=user\fR (یا \fBall\fR) و \fB\-\-replace\fR، دستورات SQL به گونه‌ای تولید می‌شوند که در صورت تلاش برای وارد کردن خروجی پشتیبان با کاربری که اتصال برقرار کرده و در حین بارگذاری جایگزین می‌شود، یک خطا ایجاد شود\&.
.sp
گزینهٔ \fB\-\-insert\-ignore\fR باعث می‌شود در صورت امکان، دستورهای SQL به شکل \fBCREATE IF NOT EXIST\fR تولید شوند.
.sp
برای stats و timezones، گزینه‌های \fB\-\-replace\fR و \fB\-\-insert\-ignore\fR اثرات معمول خود را دارند.
.sp
فعال کردن گزینه‌های مشخص در اینجا باعث می‌شود هنگام پشتیبان‌گیری از پایگاه‌دادهٔ mysql یا \fB\-\-all\-databases\fR، جدول‌های مربوطه در پایگاه‌دادهٔ mysql نادیده گرفته شوند\&.
.sp
برای کمک به مهاجرت از MySQL به MariaDB، این گزینه به گونه‌ای طراحی شده است که بتواند اطلاعات سیستم را از کارگزارهای MySQL-5\&.7 و 8\&.0 استخراج کند\&. دستورهای SQL تولیدشده نیز به صورت آزمایشی با MySQL-5\&.7/8\&.0 سازگار هستند. با این حال، نگاشت دسترسی‌ها/افزونه‌های خاص هر پیاده‌سازی همواره میان MariaDB و MySQL یک‌به‌یک نبوده و به اعمال تغییرات دستی نیاز خواهد داشت\&.
.sp
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: tab option
.\" tab option: mariadb-dump
\fB\-\-tab=\fR\fB\fIpath\fR\fR,
\fB\-T \fR\fB\fIpath\fR\fR
.sp
تولید فایل‌های داده با قالب متنی جداشده با تب (tab\-separated)\&. برای هر جدول پشتیبان‌گیری‌شده،
\fBmariadb-dump\fR
یک فایل
\fItbl_name\fR\&.sql
حاوی دستور
CREATE TABLE
که جدول را می‌سازد ایجاد می‌کند و کارگزار یک فایل
\fItbl_name\fR\&.txt
که حاوی داده‌های آن است می‌نویسد\&. مقدار این گزینه، پوشه‌ای است که فایل‌ها در آن نوشته می‌شوند\&.
.if n \{\
.sp
.\}
.RS 4
.it 1
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
این گزینه تنها زمانی باید استفاده شود که
\fBmariadb-dump\fR
روی همان ماشینی اجرا می‌شود که کارگزار
\fBmariadbd\fR
در حال اجرا است\&. شما باید دارای دسترسی
FILE
باشید و کارگزار نیز باید مجوز نوشتن فایل در پوشهٔ مشخص‌شده را داشته باشد\&.
.sp .5v
.RE
به طور پیش‌فرض، فایل‌های دادهٔ
\&.txt
با استفاده از نویسه‌های تب بین مقادیر ستون‌ها و یک خط جدید در انتهای هر سطر قالب‌بندی می‌شوند\&. این قالب را می‌توان به طور صریح با استفاده از گزینه‌های
\fB\-\-fields\-\fR\fB\fIxxx\fR\fR
و
\fB\-\-lines\-terminated\-by\fR
مشخص کرد\&.
.sp
مقادیر ستون‌ها به مجموعه نویسهٔ (character set) مشخص‌شده توسط گزینهٔ
\fB\-\-default\-character\-set\fR
تبدیل می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: tables option
.\" tables option: mariadb-dump
\fB\-\-tables\fR
.sp
نادیده گرفتن و اولویت یافتن بر گزینهٔ
\fB\-\-databases\fR
یا
\fB\-B\fR\&.
ابزار
\fBmariadb-dump\fR
تمام آرگومان‌های نام پس از این گزینه را به عنوان نام‌های جدول در نظر می‌گیرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: triggers option
.\" triggers option: mariadb-dump
\fB\-\-triggers\fR
.sp
گنجاندن تریگرها (محرک‌ها) برای هر جدول پشتیبان‌گیری‌شده در خروجی\&. این گزینه به طور پیش‌فرض فعال است؛ برای غیرفعال کردن آن از
\fB\-\-skip\-triggers\fR
استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: tz-utc option
.\" tz-utc option: mariadb-dump
\fB\-\-tz\-utc\fR
.sp
این گزینه امکان پشتیبان‌گیری و بازگردانی ستون‌های
TIMESTAMP
را بین کارگزارهایی در مناطق زمانی مختلف فراهم می‌کند\&.
\fBmariadb-dump\fR
منطقهٔ زمانی اتصال خود را روی UTC تنظیم کرده و عبارت
SET TIME_ZONE='+00:00'
را به فایل پشتیبان اضافه می‌کند\&. بدون این گزینه، ستون‌های
TIMESTAMP
در مناطق زمانی محلیِ کارگزارهای مبدأ و مقصد پشتیبان‌گیری و بازگردانی می‌شوند، که در صورت متفاوت بودن مناطق زمانی کارگزارها می‌تواند موجب تغییر مقادیر شود\&.
گزینهٔ
\fB\-\-tz\-utc\fR
همچنین در برابر تغییرات ناشی از ساعت تابستانی محافظت می‌کند\&.
گزینهٔ
\fB\-\-tz\-utc\fR
به طور پیش‌فرض فعال است\&. برای غیرفعال کردن آن، از
\fB\-\-skip\-tz\-utc\fR
استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: user option
.\" user option: mariadb-dump
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
نام کاربری MariaDB جهت استفاده هنگام اتصال به کارگزار\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: verbose option
.\" verbose option: mariadb-dump
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
حالت پرگو (پرتفصیل)\&. چاپ اطلاعات بیشتر دربارهٔ آنچه برنامه انجام می‌دهد\&.
.RE.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: version option
.\" version option: mariadb-dump
\fB\-\-version\fR,
\fB\-V\fR
.sp
نمایش اطلاعات نسخه و خروج\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: where option
.\" where option: mariadb-dump
\fB\-\-where='\fR\fB\fIwhere_condition\fR\fR\fB'\fR,
\fB\-w '\fR\fB\fIwhere_condition\fR\fR\fB'\fR
.sp
فقط ردیف‌هایی را که توسط شرط
WHERE
داده‌شده انتخاب شده‌اند پشتیبان‌گیری می‌کند\&. اگر شرط حاوی فاصله‌ها یا نویسه‌های ویژهٔ مفسر خط فرمان شما باشد، قرار دادن آن درون نقل‌قول الزامی است\&.
.sp
مثال‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-where="user='jimf'"
\-w"userid>1"
\-w"userid<1"
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-dump: xml option
.\" xml option: mariadb-dump
\fB\-\-xml\fR,
\fB\-X\fR
.sp
نوشتن خروجی پشتیبان به صورت XML خوش‌ساخت (well\-formed)\&.
.sp
\fBNULL\fR\fB، \fR\fB\(aqNULL\(aq\fR\fB و مقادیر خالی\fR: برای ستونی با نام
\fIcolumn_name\fR، مقدار NULL، یک رشتهٔ خالی و مقدار رشته‌ای \(aqNULL\(aq
در خروجی تولیدشده توسط این گزینه به صورت زیر از یکدیگر متمایز می‌شوند\&.
.TS
allbox tab(:);
l lx.
T{
\fBمقدار\fR:
T}:T{
\fBنمایش XML\fR:
T}
T{
NULL (\fIمقدار نامشخص\fR)
T}:T{
<field name="\fIcolumn_name\fR" xsi:nil="true" />
T}
T{
\(aq\(aq (\fIرشتهٔ خالی\fR)
T}:T{
<field name="\fIcolumn_name\fR"></field>
T}
T{
\(aqNULL\(aq (\fIمقدار رشته‌ای\fR)
T}:T{
<field name="\fIcolumn_name\fR">NULL</field>
T}
.TE
.sp 1
خروجی کلاینت
\fBmariadb\fR
هنگامی که با گزینهٔ
\fB\-\-xml\fR
اجرا شود نیز از قواعد پیشین پیروی می‌کند\&. (بخش
\(lqMARIADB OPTIONS\(rq
را ببینید\&.)
.sp
خروجی XML از
\fBmariadb-dump\fR
شامل فضای نام (namespace) XML است، همان‌طور که در اینجا نشان داده شده است:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-xml \-u root world City\fR
<?xml version="1\&.0"?>
<mariadb-dump xmlns:xsi="http://www\&.w3\&.org/2001/XMLSchema\-instance">
<database name="world">
<table_structure name="City">
<field Field="ID" Type="int(11)" Null="NO" Key="PRI" Extra="auto_increment" />
<field Field="Name" Type="char(35)" Null="NO" Key="" Default="" Extra="" />
<field Field="CountryCode" Type="char(3)" Null="NO" Key="" Default="" Extra="" />
<field Field="District" Type="char(20)" Null="NO" Key="" Default="" Extra="" />
<field Field="Population" Type="int(11)" Null="NO" Key="" Default="0" Extra="" />
<key Table="City" Non_unique="0" Key_name="PRIMARY" Seq_in_index="1" Column_name="ID"
Collation="A" Cardinality="4079" Null="" Index_type="BTREE" Comment="" />
<options Name="City" Engine="MyISAM" Version="10" Row_format="Fixed" Rows="4079"
Avg_row_length="67" Data_length="273293" Max_data_length="18858823439613951"
Index_length="43008" Data_free="0" Auto_increment="4080"
Create_time="2007\-03\-31 01:47:01" Update_time="2007\-03\-31 01:47:02"
Collation="latin1_swedish_ci" Create_options="" Comment="" />
</table_structure>
<table_data name="City">
<row>
<field name="ID">1</field>
<field name="Name">Kabul</field>
<field name="CountryCode">AFG</field>
<field name="District">Kabol</field>
<field name="Population">1780000</field>
</row>
\fI\&.\&.\&.\fR
<row>
<field name="ID">4079</field>
<field name="Name">Rafah</field>
<field name="CountryCode">PSE</field>
<field name="District">Rafah</field>
<field name="Population">92020</field>
</row>
</table_data>
</database>
</mariadb-dump>
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
همچنین می‌توانید متغیرهای زیر را با استفاده از ساختار
\fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR
تنظیم کنید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
max_allowed_packet
.sp
حداکثر اندازهٔ بافر برای ارتباط کلاینت/سرور\&. مقدار بیشینه 1GB است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
max_statement_time
.sp
پرس‌وجویی که اجرای آن بیش از max_statement_time ثانیه طول بکشد، لغو خواهد شد و فرایند پشتیبان‌گیری
شکست می‌خورد\&. این آرگومان به عنوان یک مقدار ده‌دهی با دقت میکروثانیه در نظر گرفته می‌شود\&. مقدار
0 (پیش‌فرض) به معنای نبود مهلت زمانی است\&. حداکثر مهلت زمانی 31536000 ثانیه است\&.
.RE.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
net_buffer_length
.sp
اندازه اولیه بافر برای ارتباط میان کارخواه و کارگزار\&. هنگام ایجاد دستورهای چندسطری
INSERT
(مانند حالت استفاده از گزینه
\fB\-\-extended\-insert\fR
یا
\fB\-\-opt\fR)،
ابزار
\fBmariadb-dump\fR
سطرهایی تا طول
net_buffer_length
می‌سازد\&. اگر این متغیر را افزایش دهید، باید اطمینان حاصل کنید که متغیر
net_buffer_length
در کارگزار MariaDB نیز دست‌کم به همین اندازه بزرگ باشد\&.
.RE
.PP
یک کاربرد رایج
\fBmariadb-dump\fR
تهیه نسخه پشتیبان از کل یک پایگاه‌داده است:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \fR\fB\fIdb_name\fR\fR\fB > \fR\fB\fIbackup\-file\&.sql\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
می‌توانید فایل پشتیبان را مانند زیر مجدداً در کارگزار بارگذاری کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \fR\fB\fIdb_name\fR\fR\fB < \fR\fB\fIbackup\-file\&.sql\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
یا به این صورت:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \-e "source \fR\fB\fI/path\-to\-backup/backup\-file\&.sql\fR\fR\fB" \fR\fB\fIdb_name\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
ابزار
\fBmariadb-dump\fR
همچنین برای پر کردن پایگاه‌های داده با کپی داده‌ها از یک کارگزار MariaDB به دیگری بسیار کاربردی است:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-opt \fR\fB\fIdb_name\fR\fR\fB | mariadb \-\-host=\fR\fB\fIremote_host\fR\fR\fB \-C \fR\fB\fIdb_name\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
تهیه نسخه پشتیبان از چندین پایگاه‌داده با یک دستور نیز امکان‌پذیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-databases \fR\fB\fIdb_name1\fR\fR\fB [\fR\fB\fIdb_name2\fR\fR\fB \&.\&.\&.] > my_databases\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
برای پشتیبان‌گیری از تمامی پایگاه‌های داده، از گزینه
\fB\-\-all\-databases\fR
استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-all\-databases > all_databases\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
برای جدول‌های
InnoDB،
ابزار
\fBmariadb-dump\fR
روشی برای تهیه نسخه پشتیبان برخط (online) فراهم می‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-all\-databases \-\-single\-transaction > all_databases\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
این نوع پشتیبان‌گیری در ابتدای فرایند، یک قفل سراسری خواندن روی تمامی جدول‌ها (با استفاده از
FLUSH TABLES WITH READ LOCK)
ایجاد می‌کند\&. به محض دریافت این قفل، مختصات لاگ دودویی (binary log) خوانده شده و قفل آزاد می‌گردد\&. اگر هنگام صدور دستور
FLUSH
دستورهای به‌روزرسانی طولانی در حال اجرا باشند، ممکن است کارگزار MariaDB تا پایان اجرای آن دستورها متوقف شود\&. پس از آن، فرایند پشتیبان‌گیری بدون قفل ادامه می‌یابد و مزاحمتی برای خواندن و نوشتن روی جدول‌ها ایجاد نمی‌کند\&. اگر دستورهای به‌روزرسانی دریافتی توسط کارگزار MariaDB کوتاه باشند (از لحاظ زمان اجرا)، بازه قفل اولیه حتی با وجود به‌روزرسانی‌های فراوان، محسوس نخواهد بود\&.
.PP
برای بازیابی در نقطه زمانی مشخص (که با عنوان
\(lqroll\-forward\(rq
نیز شناخته می‌شود، هنگامی که نیاز دارید پشتیبان قدیمی را بازگردانی کرده و تغییرات رخ‌داده از زمان آن پشتیبان را مجدداً اعمال کنید)، چرخاندن لاگ دودویی یا دست‌کم دانستن مختصات لاگ دودویی مربوط به این پشتیبان، غالباً مفید است:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-all\-databases \-\-master\-data=2 > all_databases\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
یا:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-dump \-\-all\-databases \-\-flush\-logs \-\-master\-data=2\fR
              \fB> all_databases\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
گزینه‌های
\fB\-\-master\-data\fR
و
\fB\-\-single\-transaction\fR
می‌توانند به‌طور هم‌زمان استفاده شوند، که در صورت ذخیره‌سازی جدول‌ها با موتور ذخیره‌سازی
InnoDB،
روشی مناسب برای ایجاد یک پشتیبان برخط مناسبِ استفاده پیش از بازیابی به نقطه زمانی مشخص فراهم می‌سازد\&.
.PP
.\" mariadb-dump: views
.\" mariadb-dump: problems
.\" mariadb-dump: workarounds
.PP
اگر در پشتیبان‌گیری از نماها (views) با مشکل مواجه شدید، لطفاً بخشی را که به محدودیت‌های نماها می‌پردازد بخوانید؛ در آن بخش راهکاری برای پشتیبان‌گیری از نماها در زمان شکست ناشی از مجوزهای ناکافی شرح داده شده است\&..SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.br
.PP
کپی‌رایت 2007-2008 MySQL AB، 2008-2010 Sun Microsystems, Inc.، 2010-2025 MariaDB Foundation
.PP
این مستندات یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تنها تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) منتشر شده است؛ نسخهٔ ۲ این مجوز، بازتوزیع کرده و/یا تغییر دهید.
.PP
این مستندات با این امید که مفید باشد توزیع شده است، اما «بدون هرگونه ضمانت»؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «تناسب برای یک هدف خاص». برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
شما باید نسخه‌ای از مجوز عمومی همگانی گنو را همراه با برنامه دریافت کرده باشید؛ در غیر این صورت، به آدرس Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA مکاتبه نموده یا به http://www.gnu.org/licenses مراجعه فرمایید.
.sp
.SH "همچنین ببینید (SEE ALSO)"
برای کسب اطلاعات بیشتر، لطفاً به مستندات MariaDB که به‌صورت برخط در https://mariadb.com/docs در دسترس است مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
MariaDB Foundation (http://www.mariadb.org).