'\" t
.\"
.TH "\fBMARIADB\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
.\" command-line tool
.\" tools: command-line
.\" scripts: SQL
.\" SQL scripts
.\" batch SQL files
.SH "نام (NAME)"
mariadb \- ابزار خط فرمان MariaDB (دستور mysql اکنون یک پیوند نمادین به mariadb است)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmariadb\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIdb_name\fR\fR\ 'u
\fBmariadb [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBmariadb\fR
یک پوسته ساده SQL (با قابلیتهای GNU readline) است\&. این ابزار از استفاده تعاملی و غیرتعاملی پشتیبانی میکند\&. هنگامی که به صورت تعاملی استفاده شود، نتایج پرسمان در قالب یک جدول ASCII نمایش داده میشوند\&. هنگامی که به صورت غیرتعاملی (برای مثال، به عنوان یک فیلتر) استفاده شود، نتایج در قالب مقادیر جداشده با تب (tab-separated) ارائه میشوند\&. قالب خروجی را میتوان با استفاده از گزینههای دستور تغییر داد\&.
.PP
اگر به دلیل حافظه ناکافی برای مجموعهنتایج بزرگ با مشکل مواجه شدید، از گزینه
\fB\-\-quick\fR
استفاده کنید\&. این گزینه
\fBmariadb\fR
را وادار میکند تا نتایج را به جای دریافت کل مجموعه نتیجه و بافر کردن آن در حافظه پیش از نمایش، سطر به سطر از سرور دریافت کند\&. این کار با بازگرداندن مجموعه نتایج با استفاده از تابع C API به نام
mariadb_use_result()
در کتابخانه کلاینت/سرور، به جای
mysql_store_result()
انجام میشود\&.
.PP
استفاده از
\fBmariadb\fR
بسیار آسان است\&. آن را از اعلان مفسر دستورات خود به شکل زیر فراخوانی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \fR\fB\fIdb_name\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
یا:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \-\-user=\fR\fB\fIuser_name\fR\fR\fB \-\-password=\fR\fB\fIyour_password\fR\fR\fB \fR\fB\fIdb_name\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
سپس یک عبارت SQL را تایپ کرده، آن را با
\(lq;\(rq،
\eg، یا
\eG
به پایان برسانید و Enter را فشار دهید\&.
.PP
فشردن Control\-C باعث میشود
\fBmariadb\fR
تلاش کند دستور جاری را متوقف کند\&. اگر این کار انجامشدنی نباشد، یا اگر پیش از متوقف شدن دستور مجدداً Control\-C فشرده شود،
\fBmariadb\fR
خارج میشود\&.
.PP
میتوانید دستورات SQL را درون یک فایل اسکریپت (batch file) مانند زیر اجرا کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \fR\fB\fIdb_name\fR\fR\fB < \fR\fB\fIscript\&.sql\fR\fR\fB > \fR\fB\fIoutput\&.tab\fR\fR
.fi
.if n \{\
.RE
.\}.SH "گزینههای MARIADB (MARIADB OPTIONS)"
.\" mariadb command options
.\" command options: mariadb
.\" options: command-line: mariadb
.\" startup parameters: mariadb
.PP
\fBmariadb\fR
از گزینههای زیر پشتیبانی میکند، که میتوان آنها را در خط فرمان یا در گروههای فایل تنظیمات
[mariadb]، [client]، [client-server] یا [client-mariadb]
مشخص کرد\&.
\fBmariadb\fR
همچنین از گزینهها برای پردازش فایلهای تنظیمات پشتیبانی میکند\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: help option
.\" help option: mariadb
\fB\-\-help\fR,
\fB\-?\fR,
\fB\-I\fR
.sp
نمایش پیام راهنما و خروج\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: abort-source-on-error option
.\" abort-source-on-error: mariadb
\fB\-\-abort\-source\-on\-error\fR
.sp
متوقف کردن عملیاتهای \(aqsource filename\(aq در صورت بروز خطا\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: auto-rehash option
.\" auto-rehash option: mariadb
\fB\-\-auto\-rehash\fR
.sp
فعالسازی درهمسازی مجدد خودکار (rehashing)\&. این گزینه بهطور پیشفرض فعال است و تکمیل نام پایگاهداده، جدول و ستون را ممکن میسازد\&. برای غیرفعال کردن rehashing از
\fB\-\-disable\-auto\-rehash\fR، \fB\-\-no\-auto\-rehash\fR یا \fB\-\-skip\-auto\-rehash\fR
استفاده کنید\&. این کار باعث میشود
\fBmariadb\fR
سریعتر شروع به کار کند، اما در صورت تمایل به استفاده از تکمیل نام، باید دستور
rehash
را اجرا کنید\&.
.sp
برای تکمیل یک نام، بخش اول آن را وارد کرده و کلید Tab را فشار دهید\&. اگر نام یکتا و بدون ابهام باشد،
\fBmariadb\fR
آن را تکمیل میکند\&. در غیر این صورت، میتوانید دوباره Tab را فشار دهید تا نامهای ممکنی را که با آنچه تا کنون تایپ کردهاید آغاز میشوند مشاهده کنید\&. در صورتی که هیچ پایگاهدادهٔ پیشفرضی وجود نداشته باشد، تکمیل نام انجام نمیشود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: auto-vertical-output option
.\" auto-vertical-output option: mariadb
\fB\-\-auto\-vertical\-output\fR
.sp
تغییر خودکار به حالت خروجی عمودی در صورتی که عرض نتیجه بیشتر از عرض ترمینال باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: batch option
.\" batch option: mariadb
\fB\-\-batch\fR,
\fB\-B\fR
.sp
چاپ نتایج با استفاده از tab به عنوان جداکننده ستونها، به طوری که هر سطر در یک خط جدید قرار گیرد\&. با این گزینه،
\fBmariadb\fR
از فایل تاریخچه استفاده نمیکند\&.
.sp
حالت دستهای (Batch mode) منجر به قالب خروجی غیرجدولی و گریزدهی (escaping) نویسههای خاص میشود\&. گریزدهی را میتوان با استفاده از حالت خام (raw) غیرفعال کرد؛ توضیحات مربوط به گزینهٔ
\fB\-\-raw\fR
را ببینید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: binary-mode option
.\" binary-mode option: mariadb
\fB\-\-binary\-mode\fR
.sp
حالت دودویی اجازه میدهد دنبالههای نویسهای مشخصی به عنوان داده پردازش شوند که در غیر این صورت توسط تجزیهکننده با معنای خاصی پردازش میشدند\&.
به طور مشخص، این سوییچ تجزیه تمام دستورات کلاینت را به جز \eC
و DELIMITER در حالت غیرتعاملی (یعنی زمانی که حالت دودویی با ۱) ورودی لولهکشیشده (piped)، ۲) گزینهٔ --batch در mariadb یا ۳) دستور \(aqsource\(aq ترکیب شود) غیرفعال میکند\&. همچنین، در حالت دودویی، رخدادهای \(aq\er\en\(aq و ASCII \(aq\e0\(aq در
رشتهها حفظ میشوند، در حالی که به طور پیشفرض، \(aq\er\en\(aq به \(aq\en\(aq تبدیل شده
و وجود \(aq\e0\(aq در ورودی کاربر مجاز نیست\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: character-sets-dir option
.\" character-sets-dir option: mariadb
\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: column-names option
.\" column-names option: mariadb
\fB\-\-column\-names\fR
.sp
نوشتن نام ستونها در نتایج\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: column-type-info option
.\" column-type-info option: mariadb
\fB\-\-column\-type\-info\fR,
\fB\-m\fR
.sp
نمایش متادادههای مجموعه نتایج\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: comments option
.\" comments option: mariadb
\fB\-\-comments\fR,
\fB\-c\fR
.sp
آیا کامنتها در دستورهای ارسالی به سرور حفظ شوند یا خیر\&. مقدار پیشفرض \-\-skip\-comments (حذف کامنتها) است، با \-\-comments (حفظ کامنتها) فعال میشود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: compress option
.\" compress option: mariadb
\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: connect-timeout option
.\" connect-timeout option: mariadb
\fB\-\-connect\-timeout=\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: database option
.\" database option: mariadb
\fB\-\-database=\fR\fB\fIdb_name\fR\fR,
\fB\-D \fR\fB\fIdb_name\fR\fR
.sp
پایگاه داده برای استفاده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: debug option
.\" debug option: mariadb
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
نوشتن یک لاگ اشکالزدایی (debug)\&. یک رشتهٔ معمول برای
\fIdebug_options\fR
مقدار 'd:t:o,\fIfile_name\fR' است\&. مقدار پیشفرض 'd:t:o,/tmp/mysql.trace' است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: debug-check option
.\" debug-check option: mariadb
\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: debug-info option
.\" debug-info option: mariadb
\fB\-\-debug\-info\fR,
\fB\-T\fR
.sp
چاپ اطلاعات اشکالزدایی و آمار مصرف حافظه و CPU هنگام خروج برنامه\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: default-auth option
.\" default-auth option: mariadb
\fB\-\-default\-auth=\fR\fB\fIname\fR
.sp
پلاگین احراز هویت پیشفرض سمت کلاینت برای استفاده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: default-character-set option
.\" default-character-set option: mariadb
\fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR
.sp
استفاده از
\fIcharset_name\fR
به عنوان مجموعه نویسه پیشفرض برای کلاینت و اتصال\&.
.sp
یک مشکل رایج که هنگام استفاده سیستمعامل از
utf8
یا مجموعه نویسههای چندبایتی دیگر ممکن است رخ دهد این است که خروجی کلاینت
\fBmariadb\fR
بهدلیل استفاده کلاینت MariaDB از مجموعه نویسه
latin1
بهطور پیشفرض، نادرست قالببندی میشود\&. معمولاً میتوانید این مشکلات را با استفاده از این گزینه برطرف کنید تا کلاینت وادار شود بهجای آن از مجموعه نویسه سیستم استفاده کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: defaults-extra-file option
.\" defaults-extra-file option: mariadb
\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: defaults-file option
.\" defaults-file option: mariadb
\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
.\}
.\" mariadb: defaults-group-suffix option
.\" defaults-group-suffix option: mariadb
\fB\-\-defaults\-group\-suffix=\fR\fB\fIsuffix\fR\fR
.sp
افزون بر گروههای نامبردهشده در خط فرمان، گروههایی را که پسوند مشخصشده را دارند نیز میخواند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: delimiter option
.\" delimiter option: mariadb
\fB\-\-delimiter=\fR\fB\fIstr\fR\fR
.sp
جداکنندهٔ دستورها را تنظیم میکند\&. مقدار پیشفرض نویسهٔ نقطهویرگول (\(lq;\(rq) است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: disable named commands
.\" disable named command: mariadb
\fB\-\-disable\-named\-commands\fR
.sp
دستورهای نامدار را غیرفعال میکند\&. تنها از قالب
\e*
استفاده کنید، یا از دستورهای نامدار تنها در ابتدای خطی که به یک نقطهویرگول (\(lq;\(rq) ختم میشود استفاده نمایید\&.
\fBmariadb\fR
بهطور پیشفرض با این گزینه بهصورت
\fIفعال\fR
شروع به کار میکند\&. با این وجود، حتی با این گزینه، دستورهای با قالب بلند همچنان از خط اول کار میکنند\&. بخش
\(lqMARIADB COMMANDS\(rq
را ببینید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: enable cleartext plugin option
.\" enable cleartext plugin option: mariadb
\fB\-\-enable\-cleartext\-plugin\fR
.sp
گزینهٔ منسوخشده\&. تنها برای سازگاری با MySQL وجود دارد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: execute option
.\" execute option: mariadb
\fB\-\-execute=\fR\fB\fIstatement\fR\fR،
\fB\-e \fR\fB\fIstatement\fR\fR
.sp
دستور را اجرا کرده و خارج میشود\&. گزینهٔ \fB\-\-force\fR و فایل تاریخچه را غیرفعال میکند\&. قالب خروجی پیشفرض مشابه خروجی حاصل از
\fB\-\-batch\fR
است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: force option
.\" force option: mariadb
\fB\-\-force\fR،
\fB\-f\fR
.sp
حتی در صورت بروز خطای SQL به کار ادامه میدهد\&. گزینهٔ \fB\-\-abort\-source\-on-error\fR را برابر 0 تنظیم میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: host option
.\" host option: mariadb
\fB\-\-host=\fR\fB\fIhost_name\fR\fR،
\fB\-h \fR\fB\fIhost_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: html option
.\" html option: mariadb
\fB\-\-html\fR،
\fB\-H\fR
.sp
خروجی را در قالب HTML تولید میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: ignore-spaces option
.\" ignore-spaces option: mariadb
\fB\-\-ignore\-spaces\fR،
\fB\-i\fR
.sp
فاصلههای پس از نام توابع را نادیده میگیرد\&. اجازه میدهد بین نام تابع و '('\& فاصله (شامل نویسههای تب و نویسههای خط جدید) قرار گیرد\&. عیب این گزینه این است که باعث میشود توابع توکار به کلمات رزروشده تبدیل شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: init-command option
.\" init-command option: mariadb
\fB\-\-init\-command=\fR\fB\fIstr\fR\fR\fR
.sp
دستور SQL برای اجرا هنگام اتصال به سرور MariaDB\&. در صورت اتصال مجدد، بهطور خودکار دوباره اجرا خواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: line-numbers option
.\" line-numbers option: mariadb
\fB\-\-line\-numbers\fR
.sp
شمارهٔ خطوط را برای خطاها مینویسد\&. این ویژگی را با
\fB\-\-skip\-line\-numbers\fR
غیرفعال کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1.IP \(bu 2.3
.\}
.\" mariadb: local-infile option
.\" local-infile option: mariadb
\fB\-\-local\-infile[={0|1}]\fR
.sp
فعال یا غیرفعال کردن قابلیت
LOCAL
برای
LOAD DATA INFILE\&. در صورت تعیین نشدن مقدار، این گزینه
LOCAL
را فعال میکند\&. این گزینه میتواند بهصورت
\fB\-\-local\-infile=0\fR
یا
\fB\-\-local\-infile=1\fR
برای غیرفعال یا فعالسازی صریح
LOCAL
مشخص شود\&. فعالسازی
LOCAL
در صورتی که سرور نیز از آن پشتیبانی نکند، هیچ اثری ندارد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: max-allowed-packet option
.\" max-allowed-packet option: mariadb
\fB\-\-max\-allowed\-packet=\fR\fB\fInum\fR\fR
.sp
تنظیم حداکثر طول بسته برای ارسال به سرور یا دریافت از آن\&. (مقدار پیشفرض 16MB و بیشترین مقدار 1GB است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: max-join-size option
.\" max-join-size option: mariadb
\fB\-\-max\-join\-size=\fR\fB\fInum\fR\fR
.sp
تنظیم حد خودکار برای ردیفها در یک join هنگام استفاده از
\fB\-\-safe\-updates\fR\&. (مقدار پیشفرض 1,000,000 است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: named-commands option
.\" named-commands option: mariadb
\fB\-\-named\-commands\fR,
\fB\-G\fR
.sp
فعالسازی دستورهای نامدار
\fBmariadb\fR\&.
دستورهای با قالب طولانی مجاز هستند، نه فقط دستورهای با قالب کوتاه\&. برای مثال، هر دوی
quit
و
\eq
شناخته میشوند\&. از
\fB\-\-skip\-named\-commands\fR
برای غیرفعال کردن دستورهای نامدار استفاده کنید\&. بخش با عنوان
\(lqMARIADB COMMANDS\(rq
را ببینید\&. بهطور پیشفرض غیرفعال است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\h'-04'\(bu\h'+03'\c
.\}
.\" mariadb: net-buffer-length option
.\" net-buffer-length option: mariadb
\fB\-\-net\-buffer\-length=\fR\fB\fIsize\fR\fR
.sp
تنظیم اندازه بافر برای ارتباطات TCP/IP و سوکت\&. (مقدار پیشفرض 16KB است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: no-auto-rehash option
.\" no-auto-rehash option: mariadb
\fB\-\-no\-auto\-rehash\fR,
\fB\-A\fR
.sp
این گزینه اثری یکسان با
\fB\-\-skip\-auto\-rehash\fR
دارد\&. توضیحات مربوط به
\fB\-\-auto\-rehash\fR
را ببینید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: no-beep option
.\" no-beep option: mariadb
\fB\-\-no\-beep\fR,
\fB\-b\fR
.sp
هنگام بروز خطا بوق صوتی پخش نشود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: no-defaults option
.\" no-defaults option: mariadb
\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: one-database option
.\" one-database option: mariadb
\fB\-\-one\-database\fR,
\fB\-o\fR
.sp
صرفنظر کردن از عبارتها، مگر مواردی که در زمان انتخاب پایگاه دادهٔ پیشفرضِ مشخصشده در خط فرمان اجرا میشوند\&. این پالایش محدود بوده و تنها مبتنی بر عبارتهای USE است\&. این گزینه برای نادیده گرفتن بهروزرسانیهای پایگاههای داده دیگر در binary log کاربرد دارد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: pager option
.\" pager option: mariadb
\fB\-\-pager[=\fR\fB\fIcommand\fR\fR\fB]\fR
.sp
استفاده از دستور دادهشده برای صفحهبندی خروجی پرسوجو\&. اگر دستور مشخص نشود، صفحهبند پیشفرض مقدار متغیر محیطی
PAGER
شما خواهد بود\&. صفحهبندهای معتبر عبارتند از
\fBless\fR،
\fBmore\fR،
\fBcat [> filename]\fR
و غیره\&. این گزینه تنها در Unix و فقط در حالت تعاملی عمل میکند\&. برای غیرفعالسازی صفحهبندی، از
\fB\-\-skip\-pager\fR
استفاده کنید\&.
بخش با عنوان \(lqMARIADB COMMANDS\(rq صفحهبندی خروجی را بیشتر توضیح میدهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: password option
.\" password option: mariadb
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
گذرواژهای که هنگام اتصال به سرور استفاده میشود\&. اگر از فرم کوتاه گزینه (\fB\-p\fR) استفاده میکنید،
\fIنباید\fR
بین گزینه و گذرواژه فاصله (space) وجود داشته باشد\&. اگر مقدار
\fIpassword\fR
را پس از گزینهٔ
\fB\-\-password\fR
یا
\fB\-p\fR
در خط فرمان وارد نکنید،
\fBmariadb\fR
آن را از شما درخواست میکند\&.
.sp
مشخص کردن گذرواژه در خط فرمان ناامن تلقی میشود\&. میتوانید برای جلوگیری از ارائهٔ گذرواژه در خط فرمان، از یک فایل تنظیمات (option file) استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: pipe option
.\" pipe option: mariadb
\fB\-\-pipe\fR,
\fB\-W\fR
.sp
در ویندوز، اتصال به سرور از طریق named pipe انجام میشود\&. این گزینه تنها در صورتی اعمال میشود که سرور از اتصالات named\-pipe پشتیبانی کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: plugin-dir option
.\" plugin-dir option: mariadb
\fB\-\-plugin\-dir=\fIdir_name\fR
.sp
دایرکتوری افزونههای (plugins) سمت کلاینت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: port option
.\" port option: mariadb
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
شماره درگاه TCP/IP برای استفاده در اتصال، یا مقدار 0 برای مقدار پیشفرض که به ترتیب اولویت از my.cnf، سپس $MYSQL_TCP_PORT، سپس /etc/services و در نهایت پیشفرض داخلی (3306) انتخاب میشود\&.
هنگامی که این گزینه در خط فرمان بدون سایر مشخصههای اتصال تعیین شود، مقدار --protocol=tcp را تحمیل میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: print-defaults option
.\" print-defaults option: mariadb
\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: progress-reports option
.\" progress-reports option: mariadb
\fB\-\-progress\-reports\fR
.sp
گزارشهای پیشرفت را برای دستورهای طولانیمدت (مانند ALTER TABLE) دریافت میکند\&. (پیشفرض فعال است؛ برای غیرفعالسازی از \fB\-\-skip\-progress\-reports\fR استفاده کنید\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: prompt option
.\" prompt option: mariadb
\fB\-\-prompt=\fR\fB\fIformat_str\fR\fR
.sp
اعلان (prompt) را به قالب مشخصشده تنظیم میکند\&. توالیهای ویژهای که اعلان میتواند شامل آنها باشد، در
بخش \(lqMARIADB COMMANDS\(rq شرح داده شدهاند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: protocol option
.\" protocol option: mariadb
\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: quick option
.\" quick option: mariadb
\fB\-\-quick\fR,
\fB\-q\fR
.sp
نتیجهٔ هر پرسوجو را ذخیرهسازی موقت (cache) نمیکند و هر سطر را به محض دریافت به خروجی میفرستد\&. اگر خروجی متوقف یا معلق شود، این امر ممکن است باعث کُند شدن سرور گردد\&. با استفاده از این گزینه،
\fBmariadb\fR
از فایل تاریخچه استفاده نخواهد کرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: raw option
.\" raw option: mariadb
\fB\-\-raw\fR,
\fB\-r\fR
.sp
برای خروجی جدولی،
\(lqکادربندی\(rq
دور ستونها امکان تفکیک مقادیر ستونها از یکدیگر را فراهم میکند\&. برای خروجی غیرجدولی (مانند خروجی حالت batch یا هنگامی که گزینهٔ
\fB\-\-batch\fR
یا
\fB\-\-silent\fR
داده شده باشد)، نویسههای ویژه در خروجی گریز داده میشوند (escaped) تا بهسادگی قابل تشخیص باشند\&. خط جدید، تب،
NUL و بکاسلش بهصورت
\en،
\et،
\e0 و
\e\e نوشته میشوند\&. گزینهٔ
\fB\-\-raw\fR
این گریز نویسهها را غیرفعال میکند\&.
.sp
مثال زیر تفاوت خروجی جدولی در مقابل غیرجدولی و استفاده از حالت raw را برای غیرفعال کردن گریز نویسهها نشان میدهد:
.sp
.if n \{\
.RS 4
.\}.nf
% \fBmariadb\fR
mariadb> SELECT CHAR(92);
+\-\-\-\-\-\-\-\-\-\-+
| CHAR(92) |
+\-\-\-\-\-\-\-\-\-\-+
| \e |
+\-\-\-\-\-\-\-\-\-\-+
% \fBmariadb \-s\fR
mariadb> SELECT CHAR(92);
CHAR(92)
\e\e
% \fBmariadb \-s \-r\fR
mariadb> SELECT CHAR(92);
CHAR(92)
\e
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: reconnect option
.\" reconnect option: mariadb
\fB\-\-reconnect\fR
.sp
در صورت قطع ارتباط با سرور، بهطور خودکار برای اتصال مجدد تلاش میکند\&. با هر بار قطع ارتباط، یک بار تلاش برای اتصال مجدد صورت میگیرد\&. این گزینه بهطور پیشفرض فعال است؛ برای غیرفعال کردن از
\fB\-\-skip\-reconnect\fR یا \fB\-\-disable\-reconnect\fR استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: safe-updates option
.\" safe-updates option: mariadb
.\" mariadb: i-am-a-dummy option
.\" i-am-a-dummy option: mariadb
\fB\-\-safe\-updates\fR,
\fB\-\-i\-am\-a\-dummy\fR,
\fB\-U\fR
.sp
تنها به آن دسته از دستورهای
UPDATE
و
DELETE
اجازه میدهد که سطرهای مورد نظر برای تغییر را با استفاده از مقادیر کلید مشخص کرده باشند\&. اگر این گزینه را در یک فایل گزینهها تنظیم کردهاید، میتوانید با استفاده از
\fB\-\-safe\-updates\fR
در خط فرمان آن را بازنویسی کنید\&. برای اطلاعات بیشتر دربارهٔ این گزینه، به بخش
\(lqMARIADB TIPS\(rq
مراجعه کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: secure-auth option
.\" secure-auth option: mariadb
\fB\-\-secure\-auth\fR
.sp
گذرواژهها را با قالب قدیمی (پیش از 4\&.1\&.1) به سرور ارسال نمیکند\&. این کار از اتصال به سرورها جلوگیری میکند، مگر برای سرورهایی که از قالب جدیدتر گذرواژه استفاده میکنند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: select-limit option
.\" select-limit option: mariadb
\fB\-\-select\-limit=\fR\fB\fIlimit\fR\fR
.sp
تعیین محدودیت خودکار برای SELECT هنگام استفاده از \fB\-\-safe\-updates\fR\&. (مقدار پیشفرض 1,000 است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: server-arg option
.\" server-arg option: mariadb
\fB\-\-server\-arg=\fR\fB\fIname\fR\fR
.sp
ارسال \fB\fIname\fR\fR بهعنوان یک پارامتر به سرور توکار (embedded server)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: show-warnings option
.\" show-warnings option: mariadb
\fB\-\-show\-warnings\fR
.sp
باعث میشود هشدارها در صورت وجود، پس از هر دستور نمایش داده شوند\&. این گزینه در هر دو حالت تعاملی و دستهای اعمال میشود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: sigint-ignore option
.\" sigint-ignore option: mariadb
\fB\-\-sigint\-ignore\fR
.sp
سیگنالهای
SIGINT
(معمولاً حاصل فشردن Control\-C) را نادیده میگیرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: silent option
.\" silent option: mariadb
\fB\-\-silent\fR,
\fB\-s\fR
.sp
حالت بیصدا\&. تولید خروجی کمتر\&. این گزینه را میتوان چندین بار مشخص کرد تا خروجی کمتر و کمتری تولید گردد\&.
.sp
این گزینه منجر به خروجی با قالب غیرجدولی و گریز دادن نویسههای ویژه میشود\&. گریزدهی را میتوان با استفاده از حالت خام (raw) غیرفعال کرد؛ توضیحات مربوط به گزینهٔ
\fB\-\-raw\fR
را ببینید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: skip-auto-rehash option
.\" skip-auto-rehash option: mariadb
\fB\-\-skip\-auto\-rehash\fR
.sp
غیرفعالسازی هشبندی مجدد خودکار\&. هممعنی با \fB\-\-disable\-auto\-rehash\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: skip-column-names option
.\" skip-column-names option: mariadb
\fB\-\-skip\-column\-names\fR,
\fB\-N\fR
.sp
نام ستونها را در نتایج نمینویسد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: skip-line-numbers option
.\" skip-line-numbers option: mariadb
\fB\-\-skip\-line\-numbers\fR,
\fB\-L\fR
.sp
شماره خطوط را برای خطاها درج نمیکند\&. هنگامی که میخواهید فایلهای نتیجه شامل پیامهای خطا را مقایسه کنید مفید است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: socket option
.\" socket option: mariadb
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
برای اتصال به localhost، فایل سوکت یونیکس (Unix socket) برای استفاده، یا در 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: SSL options
.\" SSL options: mariadb
\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: SSL CA option
.\" SSL CA option: mariadb
\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: SSL CA Path option
.\" SSL CA Path option: mariadb
\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: SSL Cert option
.\" SSL Cert option: mariadb
\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: SSL Cipher option
.\" SSL Cipher option: mariadb
\fB\-\-ssl\-cipher=\fIname\fR
.sp
الگوریتم رمزنگاری (cipher) 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: SSL Key option
.\" SSL Key option: mariadb
\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: SSL Crl option
.\" SSL CRL option: mariadb
\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: SSL Crlpath option
.\" SSL Crlpath option: mariadb
\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: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb
\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: table option
.\" table option: mariadb
\fB\-\-table\fR,
\fB\-t\fR
.sp
نمایش خروجی در قالب جدول\&. این حالت برای استفاده تعاملی پیشفرض است، اما میتواند برای تولید خروجی جدولی در حالت دستهای (batch) نیز استفاده شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: tee option
.\" tee option: mariadb
\fB\-\-tee=\fR\fB\fIfile_name\fR\fR
.sp
الحاق یک رونوشت از خروجی به فایل دادهشده\&. این گزینه تنها در حالت تعاملی کار میکند\&.
بخش موسوم به \(lqMARIADB COMMANDS\(rq، درباره فایلهای tee توضیحات بیشتری ارائه میدهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: unbuffered option
.\" unbuffered option: mariadb
\fB\-\-unbuffered\fR,
\fB\-n\fR
.sp
تخلیه بافر پس از هر پرسوجو\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: user option
.\" user option: mariadb
\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: verbose option
.\" verbose option: mariadb
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
حالت پرگو (verbose)\&. تولید خروجی بیشتر درباره کارهایی که برنامه انجام میدهد\&. این گزینه میتواند چندین بار مشخص شود تا خروجی باز هم بیشتری تولید کند\&. (برای نمونه،
\fB\-v \-v \-v\fR
حتی در حالت دستهای نیز خروجی را در قالب جدول تولید میکند\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: version option
.\" version option: mariadb
\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: vertical option
.\" vertical option: mariadb
\fB\-\-vertical\fR,
\fB\-E\fR
.sp
چاپ سطرهای خروجی پرسوجو بهصورت عمودی (یک سطر برای هر مقدار ستون)\&. بدون این گزینه، میتوانید خروجی عمودی را برای عبارات تکی با خاتمه دادن آنها با
\eG\&
مشخص کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: wait option
.\" wait option: mariadb
\fB\-\-wait\fR,
\fB\-w\fR
.sp
اگر اتصال برقرار نشود، به جای لغو عملیات، منتظر بماند و دوباره تلاش کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: xml option
.\" xml option: mariadb
\fB\-\-xml\fR,
\fB\-X\fR
.sp
تولید خروجی XML\&.
خروجی حاصل در حالتی که
\fB\-\-xml\fR
همراه با
\fBmariadb\fR
استفاده شود با خروجی
\fBmariadb-dump \fR\fB\fB\-\-xml\fR\fR
یکسان است\&. برای جزئیات به
\fBmariadb-dump\fR(1)
مراجعه کنید\&.
.sp
خروجی XML همچنین از یک فضای نام XML استفاده میکند، همانطور که در اینجا نشان داده شده است:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \-\-xml \-uroot \-e "SHOW VARIABLES LIKE 'version%'"\fR
version
5\&.0\&.40\-debug
version_comment
Source distribution
version_compile_machine
i686
version_compile_os
suse\-linux\-gnu
.fi
.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
.\}
.\" timeout: connect_timeout variable
.\" connect_timeout variable
connect_timeout
.sp
تعداد ثانیهها پیش از اتمام مهلت اتصال\&. (مقدار پیشفرض
0
است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" max_allowed_packet variable
max_allowed_packet
.sp
حداکثر طول بسته برای ارسال به سرور یا دریافت از آن\&. (مقدار پیشفرض 16MB است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" max_join_size variable
max_join_size
.sp
محدودیت خودکار برای سطرهای یک پیوند (join) هنگام استفاده از
\fB\-\-safe\-updates\fR\&. (مقدار پیشفرض 1,000,000 است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" net_buffer_length variable
net_buffer_length
.sp
اندازه بافر برای ارتباطات TCP/IP و سوکت\&. (مقدار پیشفرض 16KB است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" select_limit variable
select_limit
.sp
محدودیت خودکار برای دستورهای
SELECT
هنگام استفاده از
\fB\-\-safe\-updates\fR\&. (مقدار پیشفرض 1,000 است\&.)
.RE
.\" MARIADB_HISTFILE environment variable
.\" environment variable: MARIADB_HISTFILE
.\" HOME environment variable
.\" environment variable: HOME
.\" mariadb history file
.\" command-line history: mariadb
.\" .mariadb_history file
.PP
در یونیکس، کلاینت
\fBmariadb\fR
پیشینهای از دستورهای اجراشده را در یک فایل تاریخچه مینویسد\&. بهطور پیشفرض، نام این فایل
\&.mariadb_history
است و در دایرکتوری خانگی شما ایجاد میشود\&. برای سازگاری با نسخههای پیشین، در صورت وجود \&.mariadb_history و نبود \&.mariadb_history از آن استفاده خواهد شد\&. برای مشخص کردن فایلی متفاوت، مقدار متغیر محیطی
MARIADB_HISTFILE
را تنظیم کنید\&. در صورتی که MARIADB_HISTFILE موجود نباشد، متغیر محیطی MYSQL_HISTFILE استفاده خواهد شد\&.
.PP
فایل
\&.mariadb_history
باید با حالت دسترسی محدودکننده محافظت شود، زیرا ممکن است اطلاعات حساسی مانند متن دستورهای SQL حاوی گذرواژه در آن نوشته شود\&.
.PP
اگر مایل به نگهداری فایل تاریخچه نیستید، در صورت وجود ابتدا
\&.mariadb_history
را حذف کرده و سپس از یکی از روشهای زیر استفاده کنید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
متغیر
MARIADB_HISTFILE
را روی
/dev/null
تنظیم کنید\&. برای اینکه این تنظیم در هر بار ورود به سیستم اعمال شود، آن را در یکی از فایلهای راهاندازی شل خود قرار دهید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ایجاد
\&.mariadb_history
بهعنوان یک پیوند نمادین (symbolic link) به
/dev/null:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBln \-s /dev/null $HOME/\&.mariadb_history\fR
.fi
.if n \{\
.RE
.\}
.sp
کافی است این کار را تنها یک بار انجام دهید\&.
.RE.SH "دستورهای MARIADB (MARIADB COMMANDS)"
.PP
\fBmariadb\fR
هر عبارت SQL را که صادر میکنید، برای اجرا به سرور ارسال میکند\&. همچنین مجموعهای از دستورها وجود دارد که خود
\fBmariadb\fR
آنها را تفسیر میکند\&. برای مشاهده فهرستی از این دستورها، عبارت
help
یا
\eh
را در اعلان
mariadb>
وارد کنید:
.\" mariadb commands: list of
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBhelp\fR
List of all MariaDB commands:
Note that all text commands must be first on line and end with ';'
? (\e?) Synonym for 'help'\&.
clear (\ec) Clear command\&.
connect (\er) Reconnect to the server\&. Optional arguments are db and host\&.
delimiter (\ed) Set statement delimiter\&.
edit (\ee) Edit command with $EDITOR\&.
ego (\eG) Send command to mariadb server, display result vertically\&.
exit (\eq) Exit mariadb\&. Same as quit\&.
go (\eg) Send command to mariadb server\&.
help (\eh) Display this help\&.
nopager (\en) Disable pager, print to stdout\&.
notee (\et) Don't write into outfile\&.
pager (\eP) Set PAGER [to_pager]\&. Print the query results via PAGER\&.
print (\ep) Print current command\&.
prompt (\eR) Change your mariadb prompt\&.
quit (\eq) Quit mariadb\&.
rehash (\e#) Rebuild completion hash\&.
source (\e\&.) Execute an SQL script file\&. Takes a file name as an argument\&.
status (\es) Get status information from the server\&.
system (\e!) Execute a system shell command\&.
tee (\eT) Set outfile [to_outfile]\&. Append everything into given
outfile\&.
use (\eu) Use another database\&. Takes database name as argument\&.
charset (\eC) Switch to another charset\&. Might be needed for processing
binlog with multi\-byte charsets\&.
warnings (\eW) Show warnings after every statement\&.
nowarning (\ew) Don't show warnings after every statement\&.
For server side help, type 'help contents'
.fi
.if n \{\
.RE
.\}
.PP
هر دستور هم یک شکل بلند و هم یک شکل کوتاه دارد\&. شکل بلند به بزرگی و کوچکی حروف حساس نیست؛ اما شکل کوتاه حساس است\&. در انتهای شکل بلند میتوان بهصورت اختیاری یک نقطهویرگول پایانی قرار داد، اما برای شکل کوتاه نباید نقطهویرگول گذاشته شود\&.
.PP
استفاده از شکل کوتاه دستورها درون یادداشتهای چندخطی
/* \&.\&.\&. */
پشتیبانی نمیشود\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: help command
.\" help command: mariadb
\fBhelp [\fR\fB\fIarg\fR\fR\fB]\fR,
\fB\eh [\fR\fB\fIarg\fR\fR\fB]\fR,
\fB\e? [\fR\fB\fIarg\fR\fR\fB]\fR,
\fB? [\fR\fB\fIarg\fR\fR\fB]\fR
.sp
پیام راهنمایی شامل فهرست دستورهای دردسترس
\fBmariadb\fR
را نمایش میدهد\&.
.sp
اگر آرگومانی به دستور
help
بدهید،
\fBmariadb\fR
از آن بهعنوان یک رشته جستجو برای دسترسی به راهنمای سمت سرور استفاده میکند\&. برای اطلاعات بیشتر، بخش
\(lqراهنمای سمت سرور MARIADB (MARIADB SERVER-SIDE HELP)\(rq
را ببینید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: charset command
.\" charset command: mariadb
\fBcharset \fR\fB\fIcharset_name\fR\fR,
\fB\eC \fR\fB\fIcharset_name\fR\fR
.sp
مجموعه نویسه (character set) پیشفرض را تغییر داده و عبارت
SET NAMES
را صادر میکند\&. این امر امکان میدهد در صورتی که
\fBmariadb\fR
با قابلیت اتصال مجدد خودکار (auto-reconnect) فعال اجرا شده باشد (که توصیه نمیشود)، مجموعه نویسه بین کلاینت و سرور همگام باقی بماند، زیرا مجموعه نویسه مشخصشده برای اتصالات مجدد استفاده میشود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: clear command
.\" clear command: mariadb
\fBclear\fR,
\fB\ec\fR
.sp
ورودی فعلی را پاک میکند\&. اگر از اجرای عبارتی که در حال وارد کردن آن هستید منصرف شدید، از این دستور استفاده کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: connect command
.\" connect command: mariadb
\fBconnect [\fR\fB\fIdb_name\fR\fR\fB \fR\fB\fIhost_name\fR\fR\fB]]\fR,
\fB\er [\fR\fB\fIdb_name\fR\fR\fB \fR\fB\fIhost_name\fR\fR\fB]]\fR
.sp
اتصال مجدد به سرور\&. آرگومانهای اختیاری نام پایگاه داده و نام میزبان را میتوان برای مشخص کردن پایگاه داده پیشفرض یا میزبانی که سرور روی آن اجرا میشود ارائه کرد\&. در صورت عدم ذکر، از مقادیر فعلی استفاده خواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: delimiter command
.\" delimiter command: mariadb
\fBdelimiter \fR\fB\fIstr\fR\fR,
\fB\ed \fR\fB\fIstr\fR\fR
.sp
رشتهای را که
\fBmariadb\fR
بهعنوان جداکننده بین عبارات SQL تفسیر میکند تغییر میدهد\&. مقدار پیشفرض، نویسه نقطهویرگول (\(lq;\(rq) است\&.
.sp
جداکننده میتواند بهعنوان یک آرگومان نقلقولشده یا بدون نقلقول مشخص شود\&. نقلقول میتواند با استفاده از نویسههای نقلقول تکی (\(aq) یا جفتی (") انجام گیرد\&. برای گنجاندن نقلقول در یک رشته نقلقولشده، یا عبارت را با نوع دیگر نقلقول احاطه کنید یا آن را با یک نویسه اسلش وارو (\(lq\e\(rq) اسکیپ نمایید\&. باید از اسلش وارو در خارج از رشتههای نقلقولشده اجتناب شود زیرا این نویسه، نویسه گریز برای MariaDB است\&. برای آرگومان بدون نقلقول، جداکننده تا اولین فاصله یا انتهای خط خوانده میشود\&. برای آرگومان نقلقولشده، جداکننده تا نقلقول متناظر روی خط خوانده میشود\&.
.sp
هنگامی که جداکننده شناساییشده توسط
\fBmariadb\fR
روی مقداری غیر از پیشفرض
\(lq;\(rq
تنظیم شود، مواردی از آن نویسه بدون تفسیر به سرور ارسال میشوند\&. با این حال، خود سرور همچنان
\(lq;\(rq
را بهعنوان جداکننده عبارات تفسیر کرده و عبارات را مطابق با آن پردازش میکند\&. این رفتار در سمت سرور برای اجرای چندین عبارت (multiple-statement)، و برای تجزیه بدنه روالها و توابع ذخیرهشده (stored procedures and functions)، تریگرها (triggers) و رویدادها (events) به کار میآید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: edit command
.\" edit command: mariadb
\fBedit\fR,
\fB\ee\fR
.sp
ویرایش عبارت ورودی فعلی\&.
\fBmariadb\fR
مقادیر متغیرهای محیطی
EDITOR
و
VISUAL
را برای تعیین ویرایشگر مورد استفاده بررسی میکند\&. در صورتی که هیچکدام از متغیرها تنظیم نشده باشند، ویرایشگر پیشفرض
\fBvi\fR
خواهد بود\&..sp
دستور
\fBedit\fR
تنها در Unix کار میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: ego command
.\" ego command: mariadb
\fBego\fR,
\fB\eG\fR
.sp
عبارت جاری را برای اجرا به سرور ارسال کرده و نتیجه را با قالببندی عمودی نمایش میدهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: exit command
.\" exit command: mariadb
\fBexit\fR,
\fB\eq\fR
.sp
خروج از
\fBmariadb\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: go command
.\" go command: mariadb
\fBgo\fR,
\fB\eg\fR
.sp
عبارت جاری را برای اجرا به سرور ارسال میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: nopager command
.\" nopager command: mariadb
\fBnopager\fR,
\fB\en\fR
.sp
صفحهبندی خروجی را غیرفعال میکند\&. توضیحات مربوط به
\fBpager\fR
را ببینید\&.
.sp
دستور
\fBnopager\fR
تنها در Unix کار میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: notee command
.\" notee command: mariadb
\fBnotee\fR,
\fB\et\fR
.sp
کپیکردن خروجی در فایل tee را غیرفعال میکند\&. توضیحات مربوط به
\fBtee\fR
را ببینید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: nowarning command
.\" nowarning command: mariadb
\fBnowarning\fR,
\fB\ew\fR
.sp
نمایش هشدارها پس از هر عبارت را فعال میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: pager command
.\" pager command: mariadb
\fBpager [\fR\fB\fIcommand\fR\fR\fB]\fR,
\fB\eP [\fR\fB\fIcommand\fR\fR\fB]\fR
.sp
صفحهبندی خروجی را فعال میکند\&. با استفاده از گزینهٔ
\fB\-\-pager\fR
هنگام فراخوانی
\fBmariadb\fR،
مرور یا جستجوی نتایج پرسوجو در حالت تعاملی با برنامههای Unix مانند
\fBless\fR،
\fBmore\fR
یا هر برنامهٔ مشابه دیگری امکانپذیر است\&. اگر مقداری برای این گزینه مشخص نکنید،
\fBmariadb\fR
مقدار متغیر محیطی
PAGER
را بررسی کرده و صفحهبند را روی آن تنظیم میکند\&. قابلیت صفحهبند تنها در حالت تعاملی کار میکند\&.
.sp
صفحهبندی خروجی را میتوان بهصورت تعاملی با دستور
\fBpager\fR
فعال و با
\fBnopager\fR
غیرفعال کرد\&. این دستور یک آرگومان اختیاری میپذیرد؛ در صورت مشخص شدن، برنامهٔ صفحهبندی روی آن تنظیم میشود\&. بدون هیچ آرگومانی، صفحهبند روی همان صفحهبندی که در خط فرمان تنظیم شده بود، یا اگر هیچ صفحهبندی مشخص نشده باشد روی
stdout
تنظیم میشود\&.
.sp
صفحهبندی خروجی تنها در Unix کار میکند زیرا از تابع
popen()
استفاده میکند که در Windows وجود ندارد\&. برای Windows، میتوان به جای آن از گزینهٔ
\fBtee\fR
برای ذخیرهٔ خروجی پرسوجو استفاده کرد، اگرچه در برخی موقعیتها برای مرور خروجی بهاندازهٔ
\fBpager\fR
راحت نیست\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: print command
.\" print command: mariadb
\fBprint\fR,
\fB\ep\fR
.sp
عبارت ورودی جاری را بدون اجرای آن چاپ میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: prompt command
.\" prompt command: mariadb
\fBprompt [\fR\fB\fIstr\fR\fR\fB]\fR,
\fB\eR [\fR\fB\fIstr\fR\fR\fB]\fR
.sp
اعلان
\fBmariadb\fR
را به رشتهٔ دادهشده تغییر میدهد\&. توالی نویسههای ویژهای که میتوان در اعلان استفاده کرد، در ادامهٔ این بخش شرح داده شدهاند\&..sp
اگر دستور
prompt
را بدون هیچ آرگومانی مشخص کنید،
\fBmariadb\fR
اعلان را به مقدار پیشفرض
mariadb>\&
بازنشانی میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: quit command
.\" quit command: mariadb
\fBquit\fR,
\fB\eq\fR
.sp
خروج از
\fBmariadb\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: rehash command
.\" rehash command: mariadb
\fBrehash\fR,
\fB\e#\fR
.sp
هش تکمیل خودکار را که تکمیل نام پایگاههای داده، جدولها و ستونها را هنگام وارد کردن دستورات فعال میکند، بازسازی میکند\&. (توضیحات مربوط به گزینهٔ
\fB\-\-auto\-rehash\fR
را ببینید\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: source command
.\" source command: mariadb
\fBsource \fR\fB\fIfile_name\fR\fR,
\fB\e\&. \fR\fB\fIfile_name\fR\fR
.sp
فایل نامبرده را میخواند و دستورات موجود در آن را اجرا میکند\&. در Windows، میتوانید جداکنندههای نام مسیر را بهصورت
/
یا
\e\e
مشخص کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: status command
.\" status command: mariadb
\fBstatus\fR,
\fB\es\fR
.sp
اطلاعات وضعیتی دربارهٔ اتصال و سروری که استفاده میکنید ارائه میدهد\&. اگر در حالت
\fB\-\-safe\-updates\fR
اجرا میکنید،
status
همچنین مقادیر متغیرهای
\fBmariadb\fR
را که بر پرسوجوهای شما تأثیر میگذارند چاپ میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: system command
.\" system command: mariadb
\fBsystem \fR\fB\fIcommand\fR\fR,
\fB\e! \fR\fB\fIcommand\fR\fR
.sp
دستور دادهشده را با استفاده از مفسر دستور پیشفرض شما اجرا میکند\&.
.sp
دستور
\fBsystem\fR
تنها در Unix کار میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: tee command
.\" tee command: mariadb
\fBtee [\fR\fB\fIfile_name\fR\fR\fB]\fR,
\fB\eT [\fR\fB\fIfile_name\fR\fR\fB]\fR
.sp
با استفاده از گزینهٔ
\fB\-\-tee\fR
هنگام فراخوانی
\fBmariadb\fR، میتوانید دستورات و خروجی آنها را ثبت کنید\&. تمام دادههای نمایشیافته در صفحه به فایلی مشخص الحاق میشوند\&. این قابلیت برای اهداف اشکالزدایی نیز بسیار مفید است\&.
\fBmariadb\fR
پس از هر دستور، درست پیش از چاپ اعلان بعدی، نتایج را در فایل تخلیه میکند\&. عملکرد tee تنها در حالت تعاملی کار میکند\&.
.sp
میتوانید این ویژگی را بهصورت تعاملی با دستور
\fBtee\fR
فعال کنید\&. بدون پارامتر، از فایل قبلی استفاده میشود\&. فایل
\fBtee\fR
را میتوان با دستور
\fBnotee\fR
غیرفعال کرد\&. اجرای دوبارهٔ
\fBtee\fR
ثبت وقایع را مجدداً فعال میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: use command
.\" use command: mariadb
\fBuse \fR\fB\fIdb_name\fR\fR,
\fB\eu \fR\fB\fIdb_name\fR\fR
.sp
از
\fIdb_name\fR
بهعنوان پایگاه دادهٔ پیشفرض استفاده میکند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb: warnings command
.\" warnings command: mariadb
\fBwarnings\fR,
\fB\eW\fR
.sp
نمایش هشدارها را پس از هر دستور (در صورت وجود هرگونه هشدار) فعال میکند\&.
.RE
.PP
در اینجا چند نکته دربارهٔ دستور
\fBpager\fR
آورده شده است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1.IP \(bu 2.3
.\}
میتوانید از آن برای نوشتن درون یک فایل استفاده کنید و نتایج تنها به درون فایل بروند:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBpager cat > /tmp/log\&.txt\fR
.fi
.if n \{\
.RE
.\}
.sp
همچنین میتوانید هر گزینهای را برای برنامهای که میخواهید به عنوان pager خود استفاده کنید ارسال نمایید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBpager less \-n \-i \-S\fR
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
در مثال پیشین، به گزینهٔ
\fB\-S\fR
توجه کنید\&. ممکن است این گزینه برای مرور نتایج عریض پرسوجو بسیار مفید باشد\&. گاهی اوقات خواندن یک مجموعه نتیجه بسیار عریض بر روی صفحه دشوار است\&. گزینهٔ
\fB\-S\fR
در
\fBless\fR
میتواند مجموعه نتیجه را بسیار خواناتر کند؛ چرا که میتوانید با کلیدهای پیکان چپ و راست آن را به صورت افقی پیمایش کنید\&. همچنین میتوانید از
\fB\-S\fR
به صورت تعاملی درون
\fBless\fR
برای روشن و خاموش کردن حالت مرور افقی استفاده کنید\&. برای اطلاعات بیشتر، صفحهٔ راهنمای
\fBless\fR
را مطالعه کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBman less\fR
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
گزینههای
\fB\-F\fR
و
\fB\-X\fR
میتوانند همراه با
\fBless\fR
استفاده شوند تا در صورتی که خروجی در یک صفحه جا شود، از برنامه خارج شود؛ که در صورت عدم نیاز به پیمایش بسیار راحت و مناسب است:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBpager less \-n \-i \-S \-F \-X\fR
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
میتوانید دستورهای pager بسیار پیچیدهای را برای مدیریت خروجی پرسوجو تعیین کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBpager cat | tee /dr1/tmp/res\&.txt \e\fR
\fB| tee /dr2/tmp/res2\&.txt | less \-n \-i \-S\fR
.fi
.if n \{\
.RE
.\}
.sp
در این مثال، دستور نتایج پرسوجو را به دو فایل در دو پوشهٔ مختلف در دو سیستمفایل مجزا که روی
/dr1
و
/dr2
سوار (mount) شدهاند ارسال میکند، و با این حال همچنان نتایج را از طریق
\fBless\fR
روی صفحه نمایش میدهد\&.
.RE
.PP
همچنین میتوانید قابلیتهای
\fBtee\fR
و
\fBpager\fR
را با یکدیگر ترکیب کنید\&. یک فایل
\fBtee\fR
را فعال کرده و
\fBpager\fR
را روی
\fBless\fR
تنظیم کنید؛ در این صورت قادر خواهید بود نتایج را با استفاده از برنامهٔ
\fBless\fR
مرور کنید و همزمان همه چیز در یک فایل افزوده (append) شود\&. تفاوت میان
\fBtee\fR
یونیکس که با دستور
\fBpager\fR
استفاده میشود و دستور توکار
\fBtee\fR
در
\fBmariadb\fR
این است که دستور توکار
\fBtee\fR
حتی اگر
\fBtee\fR
یونیکس در دسترس نباشد نیز کار میکند\&. همچنین
\fBtee\fR
توکار هر آنچه را که روی صفحه چاپ میشود ثبت میکند، در حالی که
\fBtee\fR
یونیکسِ به کار رفته با
\fBpager\fR
تا این اندازه ثبت نمیکند\&. علاوه بر این، ثبت وقایع در فایل
\fBtee\fR
میتواند به صورت تعاملی از داخل
\fBmariadb\fR
روشن و خاموش شود\&. این ویژگی زمانی مفید است که میخواهید برخی از پرسوجوها را در یک فایل ثبت کنید، اما نه همهٔ آنها را\&.
.\" mariadb prompt command
.PP
دستور
\fBprompt\fR
اعلان پیشفرض
mariadb>
را بازپیکربندی میکند\&. رشتهٔ تعیین اعلان میتواند حاوی توالیهای ویژهٔ زیر باشد\&.
.TS
allbox tab(:);
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l.
T{
\fBگزینه\fR
T}:T{
\fBتوضیحات\fR
T}
T{
\ec
T}:T{
شمارندهای که برای هر گزارهٔ صادر شده افزایش مییابد
T}
T{
\eD
T}:T{
تاریخ کامل جاری
T}
T{
\ed
T}:T{
پایگاهداده پیشفرض
T}
T{
\eh
T}:T{
میزبان کارگزار
T}
T{
\el
T}:T{
جداکنندهٔ جاری (جدید در 5\&.1\&.12)
T}
T{
\em
T}:T{
دقیقه از زمان جاری
T}
T{
\en
T}:T{
یک نویسهٔ خط جدید
T}
T{
\eO
T}:T{
ماه جاری در قالب سهحرفی (Jan، Feb و \&...)
T}
T{
\eo
T}:T{
ماه جاری در قالب عددی
T}
T{
\eP
T}:T{
am/pm
T}
T{
\ep
T}:T{
درگاه TCP/IP یا فایل سوکت جاری
T}
T{
\eR
T}:T{
زمان جاری، در قالب ۲۴ ساعته نظامی (0\(en23)
T}
T{
\er
T}:T{
زمان جاری، زمان استاندارد ۱۲ ساعته (1\(en12)
T}
T{
\eS
T}:T{
نقطهویرگول
T}
T{
\es
T}:T{
ثانیه از زمان جاری
T}
T{
\et
T}:T{
یک نویسهٔ تب
T}
T{
\eU
T}:T{
.PP
نام حساب کاربری کامل شما به صورت
\fIuser_name\fR@\fIhost_name\fR
T}
T{
\eu
T}:T{
نام کاربری شما
T}
T{
\ev
T}:T{
نسخهٔ کارگزار
T}
T{
\ew
T}:T{
روز جاری هفته در قالب سهحرفی (Mon، Tue و \&...)
T}
T{
\eY
T}:T{
سال جاری، چهار رقمی
T}
T{
\ey
T}:T{
سال جاری، دو رقمی
T}
T{
\e_
T}:T{
یک فاصله
T}
T{
\e\ \&
T}:T{
یک فاصله (یک فاصله به دنبال بکاسلش میآید)
T}
T{
\e'
T}:T{
نقلقول تکی
T}
T{
\e"
T}:T{
نقلقول دوتایی
T}
T{
\e\e
T}:T{
نویسهٔ عینی بکاسلش \(lq\e\(rq
T}
T{
\e\fIx\fR
T}:T{
.PP
\fIx\fR، برای هر
\(lq\fIx\fR\(rq
که در بالا فهرست نشده است
T}.TE
.sp 1
.PP
شما میتوانید اعلان را به چندین روش تنظیم کنید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIاستفاده از یک متغیر محیطی\&.\fR
میتوانید متغیر محیطی
MYSQL_PS1
را روی یک رشته اعلان تنظیم کنید\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBexport MYSQL_PS1="(\eu@\eh) [\ed]> "\fR
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIاستفاده از یک گزینه خط فرمان\&.\fR
میتوانید گزینه
\fB\-\-prompt\fR
را در خط فرمان برای
\fBmariadb\fR
تنظیم کنید\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \-\-prompt="(\eu@\eh) [\ed]> "\fR
(user@host) [database]>
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIاستفاده از یک فایل گزینهها\&.\fR
میتوانید گزینه
prompt
را در گروه
[mariadb]
از هر فایل گزینههای MariaDB مانند
/etc/my\&.cnf
یا فایل
\&.my\&.cnf
در دایرکتوری خانگی خود تنظیم کنید\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
[mariadb]
prompt=(\e\eu@\e\eh) [\e\ed]>\e\e_
.fi
.if n \{\
.RE
.\}
.sp
در این مثال، توجه داشته باشید که بکاسلشها دو برابر شدهاند\&. اگر اعلان را با استفاده از گزینه
prompt
در یک فایل گزینهها تنظیم میکنید، توصیه میشود هنگام استفاده از گزینههای ویژه اعلان، بکاسلشها را دو بار تکرار کنید\&. بین مجموعه گزینههای مجاز اعلان و مجموعه توالیهای گریز (escape sequences) ویژه که در فایلهای گزینهها شناخته میشوند، تداخل وجود دارد\&. اگر از بکاسلشهای تکی استفاده کنید، این تداخل ممکن است باعث بروز مشکلاتی شود\&. برای مثال،
\es
به جای مقدار ثانیههای جاری، به عنوان فاصله (space) تفسیر میشود\&. مثال زیر نشان میدهد که چگونه یک اعلان را درون یک فایل گزینهها تعریف کنید تا زمان جاری در قالب
HH:MM:SS>
گنجانده شود:
.sp
.if n \{\
.RS 4
.\}
.nf
[mariadb]
prompt="\e\er:\e\em:\e\es> "
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIتنظیم تعاملی اعلان\&.\fR
میتوانید اعلان خود را بهصورت تعاملی با استفاده از دستور
prompt
(یا
\eR)
تغییر دهید\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBprompt (\eu@\eh) [\ed]>\e_\fR
PROMPT set to '(\eu@\eh) [\ed]>\e_'
(\fIuser\fR@\fIhost\fR) [\fIdatabase\fR]>
(\fIuser\fR@\fIhost\fR) [\fIdatabase\fR]> prompt
Returning to default PROMPT of mariadb>
mariadb>
.fi
.if n \{\
.RE
.\}
.RE.SH "راهنمای سمت سرور MARIADB (MARIADB SERVER-SIDE HELP)"
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBhelp \fR\fB\fIsearch_string\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
اگر آرگومانی به دستور
help
ارائه دهید،
\fBmariadb\fR
از آن بهعنوان یک رشتهٔ جستجو برای دسترسی به راهنمای سمت سرور استفاده میکند\&. عملکرد صحیح این دستور مستلزم آن است که جدولهای راهنما در پایگاهدادهٔ
mysql
با اطلاعات موضوعات راهنما مقداردهی اولیه شده باشند.
.PP
اگر هیچ تطابقی برای رشتهٔ جستجو وجود نداشته باشد، جستجو ناموفق خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBhelp me\fR
Nothing found
Please try to run 'help contents' for a list of all accessible topics
.fi
.if n \{\
.RE
.\}
.PP
برای مشاهدهٔ فهرستی از دستهبندیهای راهنما، از
\fBhelp contents\fR
استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBhelp contents\fR
You asked for help about help category: "Contents"
For more information, type 'help - ', where
- is one of the
following categories:
Account Management
Administration
Data Definition
Data Manipulation
Data Types
Functions
Functions and Modifiers for Use with GROUP BY
Geographic Features
Language Structure
Plugins
Storage Engines
Stored Routines
Table Maintenance
Transactions
Triggers
.fi
.if n \{\
.RE
.\}
.PP
اگر رشتهٔ جستجو با چندین مورد مطابقت داشته باشد،
\fBmariadb\fR
فهرستی از موضوعات منطبق را نمایش میدهد:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBhelp logs\fR
Many help items for your request exist\&.
To make a more specific request, please type 'help
- ',
where
- is one of the following topics:
SHOW
SHOW BINARY LOGS
SHOW ENGINE
SHOW LOGS
.fi
.if n \{\
.RE
.\}
.PP
از یک موضوع بهعنوان رشتهٔ جستجو استفاده کنید تا مدخل راهنمای مربوط به آن را ببینید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBhelp show binary logs\fR
Name: 'SHOW BINARY LOGS'
Description:
Syntax:
SHOW BINARY LOGS
SHOW MASTER LOGS
Lists the binary log files on the server\&. This statement is used as
part of the procedure described in [purge\-binary\-logs], that shows how
to determine which logs can be purged\&.
mariadb> SHOW BINARY LOGS;
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+
| Log_name | File_size |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+
| binlog\&.000015 | 724935 |
| binlog\&.000016 | 733481 |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+
.fi
.if n \{\
.RE
.\}.SH "اجرای دستورات SQL از یک فایل متنی (EXECUTING SQL STATEMENTS FROM A TEXT FILE)"
.\" executing SQL statements from text files
.\" importing: data
.\" data: importing
.\" files: text
.\" text files: importing
.\" source (mariadb client command)
.\" \. (mariadb client command)
.\" mariadb source (command for reading from text files)
.\" mariadb \. (command for reading from text files)
.PP
کلاینت
\fBmariadb\fR
معمولاً به صورت تعاملی استفاده میشود، مانند این:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \fR\fB\fIdb_name\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
با این حال، این امکان نیز وجود دارد که دستورات SQL خود را در یک فایل قرار دهید و سپس به
\fBmariadb\fR
بگویید که ورودی خود را از آن فایل بخواند\&. برای این کار، یک فایل متنی
\fItext_file\fR
ایجاد کنید که حاوی دستوراتی باشد که قصد اجرای آنها را دارید\&. سپس
\fBmariadb\fR
را همانطور که در اینجا نشان داده شده است فراخوانی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \fR\fB\fIdb_name\fR\fR\fB < \fR\fB\fItext_file\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
اگر دستور
USE \fIdb_name\fR
را به عنوان اولین دستور در فایل قرار دهید، نیازی به مشخص کردن نام پایگاهداده در خط فرمان نخواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb < text_file\fR
.fi
.if n \{\
.RE
.\}
.PP
اگر در حال حاضر
\fBmariadb\fR
را اجرا کردهاید، میتوانید یک فایل اسکریپت SQL را با استفاده از دستور
source
یا دستور
\e\&.
اجرا کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBsource \fR\fB\fIfile_name\fR\fR
mariadb> \fB\e\&. \fR\fB\fIfile_name\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
گاهی اوقات ممکن است بخواهید اسکریپت شما اطلاعات پیشرفت فرآیند را به کاربر نمایش دهد\&. برای این کار میتوانید دستوراتی شبیه به این را درج کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT '' AS ' ';
.fi
.if n \{\
.RE
.\}
.PP
دستور نشاندادهشده عبارت
را در خروجی نمایش میدهد\&.
.PP
همچنین میتوانید
\fBmariadb\fR
را با گزینهٔ
\fB\-\-verbose\fR
فراخوانی کنید، که باعث میشود هر دستور پیش از نتیجهای که تولید میکند نمایش داده شود\&.
.PP
\fBmariadb\fR
نویسههای علامت ترتیب بایت یونیکد (BOM) را در ابتدای فایلهای ورودی نادیده میگیرد\&. وجود BOM باعث نمیشود که
\fBmariadb\fR
مجموعه نویسهٔ پیشفرض خود را تغییر دهد\&. برای این کار،
\fBmariadb\fR
را با گزینهای مانند
\fB\-\-default\-character\-set=utf8\fR
فراخوانی کنید\&.
.PP.SH "نکات MARIADB (MARIADB TIPS)"
.PP
این بخش فنونی را شرح میدهد که میتوانند به شما در استفادهٔ مؤثرتر از
\fBmariadb\fR
کمک کنند\&.
.SS "نمایش عمودی نتایج پرسوجو"
.PP
برخی از نتایج پرسوجو هنگامی که به جای قالب جدول افقی معمول، به صورت عمودی نمایش داده شوند بسیار خواناتر هستند\&. پرسوجوها میتوانند با پایان یافتن با \eG به جای یک نقطهویرگول (semicolon)، به صورت عمودی نمایش یابند\&. برای نمونه، مقادیر متنی طولانیتر که شامل خطوط جدید هستند اغلب در خروجی عمودی بسیار سادهتر خوانده میشوند:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBSELECT * FROM mails WHERE LENGTH(txt) < 300 LIMIT 300,1\eG\fR
*************************** 1\&. row ***************************
msg_nro: 3068
date: 2000\-03\-01 23:29:50
time_zone: +0200
mail_from: Monty
reply: monty@no\&.spam\&.com
mail_to: "Thimble Smith"
sbj: UTF\-8
txt: >>>>> "Thimble" == Thimble Smith writes:
Thimble> Hi\&. I think this is a good idea\&. Is anyone familiar
Thimble> with UTF\-8 or Unicode? Otherwise, I'll put this on my
Thimble> TODO list and see what happens\&.
Yes, please do that\&.
Regards,
Monty
file: inbox\-jani\-1
hash: 190402944
1 row in set (0\&.09 sec)
.fi
.if n \{\
.RE
.\}
.SS "استفاده از گزینهٔ \-\-safe\-updates"
.\" safe-updates option
.PP
برای افراد تازهکار، یک گزینهٔ راهاندازی مفید
\fB\-\-safe\-updates\fR
(یا
\fB\-\-i\-am\-a\-dummy\fR
است که اثر یکسانی دارد)\&. این گزینه برای مواردی سودمند است که ممکن است یک دستور
DELETE FROM \fItbl_name\fR
صادر کرده باشید اما عبارت
WHERE
را فراموش کرده باشید\&. در حالت عادی، چنین دستوری همهٔ سطرهای جدول را حذف میکند\&. با
\fB\-\-safe\-updates\fR،
تنها میتوانید با مشخص کردن مقادیر کلیدی که سطرها را مشخص میسازند، آنها را حذف کنید\&. این کار از حوادث ناخواسته جلوگیری میکند\&.
.PP
هنگامی که از گزینهٔ
\fB\-\-safe\-updates\fR
استفاده میکنید،
\fBmariadb\fR
هنگام اتصال به کارساز MariaDB دستور زیر را صادر میکند:
.sp
.if n \{\
.RS 4
.\}
.nf
SET sql_safe_updates=1, sql_select_limit=1000, sql_max_join_size=1000000;
.fi
.if n \{\
.RE
.\}
.PP
دستور
SET
اثرات زیر را دارد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
شما مجاز به اجرای یک دستور
UPDATE
یا
DELETE
نیستید مگر این که یک قید کلید را در عبارت
WHERE
مشخص کرده باشید یا عبارت
LIMIT
(یا هر دو) را ارائه دهید\&. برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE \fItbl_name\fR SET \fInot_key_column\fR=\fIval\fR WHERE \fIkey_column\fR=\fIval\fR;
UPDATE \fItbl_name\fR SET \fInot_key_column\fR=\fIval\fR LIMIT 1;
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
کارساز همهٔ نتایج بزرگ
SELECT
را به 1,000 سطر محدود میکند مگر این که دستور شامل عبارت
LIMIT
باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
کارساز دستورهای چندجدولی
SELECT
را که احتمالاً نیاز به بررسی بیش از 1,000,000 ترکیب سطر دارند متوقف میکند\&.
.RE
.PP
برای تعیین محدودیتهایی متفاوت با 1,000 و 1,000,000، میتوانید با استفاده از گزینههای
\fB\-\-select\-limit\fR
و
\fB\-\-max\-join\-size\fR
مقادیر پیشفرض را بازنویسی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb \-\-safe\-updates \-\-select\-limit=500 \-\-max\-join\-size=10000\fR
.fi
.if n \{\
.RE
.\}.SS "غیرفعالسازی اتصال مجدد خودکار mariadb"
.PP
اگر کلاینت
\fBmariadb\fR
هنگام ارسال یک دستور، اتصال خود به سرور را از دست بدهد، بلافاصله و بهصورت خودکار یکبار تلاش میکند تا مجدداً به سرور متصل شده و دستور را دوباره ارسال کند\&. با این حال، حتی اگر
\fBmariadb\fR
در برقراری مجدد اتصال موفق شود، اتصال اولیهٔ شما پایان یافته است و تمام اشیاء و تنظیمات نشست قبلی شما از دست میروند: جدولهای موقت، حالت autocommit، و متغیرهای تعریفشده توسط کاربر و متغیرهای نشست\&. همچنین، هر تراکنش جاری واگردانی (roll back) میشود\&. این رفتار ممکن است خطرناک باشد، مانند مثال زیر که در آن سرور بدون اطلاع شما بین دستورهای اول و دوم خاموش و دوباره راهاندازی شده است:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb> \fBSET @a=1;\fR
Query OK, 0 rows affected (0\&.05 sec)
mariadb> \fBINSERT INTO t VALUES(@a);\fR
ERROR 2006: MariaDB server has gone away
No connection\&. Trying to reconnect\&.\&.\&.
Connection id: 1
Current database: test
Query OK, 1 row affected (1\&.30 sec)
mariadb> \fBSELECT * FROM t;\fR
+\-\-\-\-\-\-+
| a |
+\-\-\-\-\-\-+
| NULL |
+\-\-\-\-\-\-+
1 row in set (0\&.05 sec)
.fi
.if n \{\
.RE
.\}
.PP
متغیر کاربری
@a
همراه با اتصال از دست رفته است و پس از برقراری مجدد اتصال، تعریفنشده خواهد بود\&. اگر مهم است که در صورت قطع اتصال،
\fBmariadb\fR
با خطا متوقف شود، میتوانید کلاینت
\fBmariadb\fR
را با گزینهٔ
\fB\-\-skip\-reconnect\fR
اجرا کنید\&.
.PP
.SH "کپیرایت و تکثیر (COPYRIGHT)"
.br
.PP
کپیرایت 2007-2008 MySQL AB، 2008-2010 Sun Microsystems, Inc.، 2010-2025 MariaDB Foundation
.PP
این مستندات یک نرمافزار آزاد است؛ شما میتوانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همانطور که توسط بنیاد نرمافزارهای آزاد منتشر شده است؛ نسخهٔ ۲ مجوز، بازتوزیع کرده و/یا تغییر دهید.
.PP
این مستندات با این امید که مفید واقع شود توزیع شده است، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.
.PP
شما باید همراه با این برنامه یک نسخه از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت، با Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA مکاتبه کرده یا به http://www.gnu.org/licenses مراجعه کنید.
.sp
.SH "نکات (NOTES)"
.IP " 1." 4
Bug#25946
.RS 4
\%http://bugs.mysql.com/bug.php?id=25946
.RE
.SH "همچنین ببینید (SEE ALSO)"
برای اطلاعات بیشتر، لطفاً به مستندات MariaDB که بهصورت برخط در https://mariadb.com/docs موجود است مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
MariaDB Foundation (http://www.mariadb.org).