MARIADB-ADMIN(1) MariaDB Database System MARIADB-ADMIN(1)

mariadb-admin - کلاینتی برای مدیریت سرور MariaDB (دستور mariadb-admin اکنون یک پیوند نمادین به mariadb-admin است)

mariadb-admin [options] command [command-arg] [command [command-arg]] ...

mariadb-admin یک کلاینت برای انجام عملیات مدیریتی است. می‌توانید از آن برای بررسی پیکربندی و وضعیت فعلی سرور، ایجاد و حذف پایگاه‌های داده و موارد دیگر استفاده کنید.

mariadb-admin را این‌گونه فراخوانی کنید:

shell> mariadb-admin [options] command [command-arg] [command [command-arg]] ...

mariadb-admin از دستورهای زیر پشتیبانی می‌کند. برخی از دستورها پس از نام دستور یک آرگومان دریافت می‌کنند.

•create db_name

یک پایگاه داده جدید با نام db_name ایجاد می‌کند.

•debug

به سرور اعلام می‌کند اطلاعات اشکال‌زدایی را در error log بنویسد.

این اطلاعات همچنین شامل مواردی درباره Event Scheduler است.

•drop db_name

پایگاه داده به نام db_name و تمام جدول‌های آن را حذف می‌کند.

•extended-status

متغیرهای وضعیت سرور و مقادیر آن‌ها را نمایش می‌دهد.

•flush-all-statistics

تخلیه و نوسازی تمام جدول‌های آمار (statistics).

•flush-all-status

تخلیه و نوسازی تمام وضعیت‌ها و آمارها.

•flush-binary-log

تخلیه و نوسازی لاگ باینری (binary log).

•flush-client-statistics

تخلیه و نوسازی آمار کلاینت‌ها.

•flush-engine-log

تخلیه و نوسازی لاگ موتور (engine log).

•flush-error-log

تخلیه و نوسازی لاگ خطا (error log).

•flush-general-log

تخلیه و نوسازی لاگ عمومی پرس‌وجوها (general query log).

•flush-hosts

تخلیه تمام اطلاعات موجود در حافظه پنهان میزبان‌ها (host cache).

•flush-index-statistics

تخلیه آمار ایندکس‌ها.

•flush-logs

تخلیه تمام لاگ‌ها.

•flush-privileges

بارگذاری مجدد جدول‌های مجوز (مشابه reload).

•flush-relay-log

تخلیه لاگ رله.

•flush-slow-log

تخلیه لاگ پرس‌وجوهای کُند.

•flush-ssl

تخلیه گواهی‌های SSL.

•flush-status

پاک‌سازی متغیرهای وضعیت.

•flush-table-statistics

تخلیه آمار جدول‌ها.

•flush-tables

تخلیه تمام جدول‌ها.

•flush-threads

تخلیه حافظه موقت (کَش) ریسه‌ها.

•flush-user-resources

تخلیه منابع کاربران.

•kill id,id,...

خاتمه دادن به ریسه‌های سرور. اگر چندین مقدار شناسهٔ ریسه داده شده باشد، نباید هیچ فاصله‌ای در فهرست وجود داشته باشد.

•old-password new-password

این دستور مشابه دستور password است اما گذرواژه را با استفاده از قالب درهم‌سازی (هش) قدیمی گذرواژه (پیش از MySQL 4.1) ذخیره می‌کند.

•password new-password

تنظیم یک گذرواژه جدید. این دستور گذرواژه را برای حسابی که با mariadb-admin جهت اتصال به سرور استفاده می‌کنید به new-password تغییر می‌دهد. بنابراین، دفعه بعد که mariadb-admin (یا هر برنامه کلاینت دیگری) را با استفاده از همان حساب فراخوانی کنید، باید گذرواژه جدید را مشخص کنید.

اگر مقدار new-password شامل فاصله یا نویسه‌های دیگری باشد که برای مفسر دستور شما معنای ویژه‌ای دارند، باید آن را در علامت نقل‌قول قرار دهید. در Windows، حتماً به جای علامت نقل‌قول تکی از جفت‌نقل‌قول (دابل کوتیشن) استفاده کنید؛ علامت‌های نقل‌قول تکی از گذرواژه حذف نمی‌شوند، بلکه به عنوان بخشی از گذرواژه تفسیر خواهند شد. برای مثال:

shell> mariadb-admin password "my new password"

احتیاط
اگر سرور با گزینهٔ --skip-grant-tables راه‌اندازی شده است، از این دستور استفاده نکنید. هیچ تغییری در گذرواژه اعمال نخواهد شد. این امر حتی در صورتی که در همان خط فرمان، پیش از دستور password از flush-privileges استفاده کنید تا جدول‌های مجوز مجدداً فعال شوند نیز صادق است، زیرا عملیات تخلیه (flush) پس از اتصال شما رخ می‌دهد. با این حال، می‌توانید از mariadb-admin flush-privileges برای فعال‌سازی مجدد جدول‌های مجوز استفاده کنید و سپس با استفاده از یک دستور جداگانهٔ mariadb-admin password گذرواژه را تغییر دهید.
•ping

بررسی فعال بودن سرور. وضعیت بازگشتی از mariadb-admin در صورت در حال اجرا بودن سرور 0، و در صورت فعال نبودن 1 است. این مقدار حتی در صورت بروز خطایی مانند Access denied نیز 0 است، زیرا نشان می‌دهد سرور در حال اجراست اما اتصال را نپذیرفته است، که با اجرا نشدن سرور تفاوت دارد.

•processlist

نمایش فهرستی از ریسه‌های (threads) فعال سرور. این دستور خروجی‌ای شبیه به عبارت SHOW PROCESSLIST تولید می‌کند. اگر گزینهٔ --verbose مشخص شده باشد، خروجی مشابه عبارت SHOW FULL PROCESSLIST خواهد بود.

•reload

بارگذاری مجدد جدول‌های مجوز (grant tables).

•refresh

تخلیهٔ (flush) همهٔ جدول‌ها و بستن و باز کردن مجدد فایل‌های گزارش (log).

•shutdown

متوقف کردن سرور.

•start-all-slaves

راه‌اندازی تمام کارسازهای پیرو (slaves).

•start-slave

شروع همگام‌سازی (replication) روی یک سرور پیرو (slave).

•status

نمایش یک پیام کوتاه از وضعیت سرور.

•stop-all-slaves

متوقف کردن تمام کارسازهای پیرو (slaves).

•stop-slave

توقف همگام‌سازی (replication) روی یک سرور پیرو (slave).

•variables

نمایش متغیرهای سیستمی سرور و مقادیر آن‌ها.

•version

نمایش اطلاعات نگارش از سرور.

تمام دستورات را می‌توان به هر پیشوند یکتایی کوتاه کرد. برای نمونه:

shell> mariadb-admin proc stat
+----+-------+-----------+----+---------+------+-------+------------------+
| Id | User  | Host      | db | Command | Time | State | Info             |
+----+-------+-----------+----+---------+------+-------+------------------+
| 51 | monty | localhost |    | Query   | 0    |       | show processlist |
+----+-------+-----------+----+---------+------+-------+------------------+
Uptime: 1473624  Threads: 1  Questions: 39487
Slow queries: 0  Opens: 541  Flush tables: 1
Open tables: 19  Queries per second avg: 0.0268

نتیجهٔ دستور mariadb-admin status مقادیر زیر را نمایش می‌دهد:

•Uptime

مدت زمانی (به ثانیه) که سرور MariaDB در حال اجرا بوده است.

•ریسه‌ها (Threads)

تعداد ریسه‌های (کلاینت‌های) فعال.

•پرسش‌ها (Questions)

تعداد پرسش‌های (پرس‌وجوهای) کلاینت‌ها از زمان راه‌اندازی سرور.

•پرس‌وجوهای کند (Slow queries)

تعداد پرس‌وجوهایی که بیش از log_slow_query_time ثانیه طول کشیده‌اند.

•جدول‌های بازشده (Opens)

تعداد جدول‌هایی که سرور باز کرده است.

•تخلیه جدول‌ها (Flush tables)

تعداد دستورهای flush-*، refresh و reload که سرور اجرا کرده است.

•جدول‌های باز (Open tables)

تعداد جدول‌هایی که در حال حاضر باز هستند.

•حافظه در حال استفاده (Memory in use)

مقدار حافظه‌ای که مستقیماً توسط mariadbd تخصیص یافته است. این مقدار تنها زمانی نمایش داده می‌شود که MariaDB با --with-debug=full کامپایل شده باشد.

•حداکثر حافظه استفاده‌شده (Maximum memory used)

حداکثر مقدار حافظه‌ای که مستقیماً توسط mariadbd تخصیص یافته است. این مقدار تنها زمانی نمایش داده می‌شود که MariaDB با --with-debug=full کامپایل شده باشد.

اگر هنگام اتصال به سرور محلی با استفاده از یک فایل سوکت یونیکس، دستور mariadb-admin shutdown را اجرا کنید، mariadb-admin تا زمان حذف شدن فایل شناسه فرایند (PID) سرور منتظر می‌ماند تا اطمینان حاصل کند که سرور به‌درستی متوقف شده است.

دستور mariadb-admin از گزینه‌های زیر پشتیبانی می‌کند که می‌توان آن‌ها را در خط فرمان یا در گروه‌های [mariadb-admin] و [client] فایل تنظیمات (option file) مشخص کرد.

•--help، -?

نمایش راهنما و خروج.

•--character-sets-dir=path

دایرکتوری محل نصب مجموعه‌های نویسه (character sets).

•--compress، -C

فشرده‌سازی تمام اطلاعات ارسالی میان کلاینت و سرور در صورتی که هر دو از فشرده‌سازی پشتیبانی کنند.

•--connect-timeout=timeout

معادل --connect_timeout است؛ به انتهای این بخش مراجعه کنید.

•--count=N, -c N

تعداد دفعات تکرار برای اجرای مکرر دستور، در صورتی که گزینهٔ --sleep مشخص شده باشد.

•--debug[=debug_options], -# [debug_options]

نوشتن یک لاگ اشکال‌زدایی. یک رشتهٔ معمول debug_options به‌صورت 'd:t:o,file_name' است. مقدار پیش‌فرض 'd:t:o,/tmp/mariadb-admin.trace' است.

•--debug-check

بررسی میزان مصرف حافظه و فایل‌های باز هنگام خروج.

•--debug-info

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

•--default-auth

پلاگین احراز هویت پیش‌فرض سمت کلاینت برای استفاده.

•--default-character-set=charset_name

استفاده از charset_name به‌عنوان مجموعه‌نویسهٔ پیش‌فرض.

•--defaults-extra-file=filename

تنظیم filename به‌عنوان فایلی برای خواندن گزینه‌های پیش‌فرض، پس از اینکه فایل‌های پیش‌فرض سراسری خوانده شدند. باید به‌عنوان نخستین گزینه مشخص شود.

•--defaults-file=filename

تنظیم filename به‌عنوان فایلی برای خواندن گزینه‌های پیش‌فرض و جایگزینی فایل‌های پیش‌فرض سراسری. باید به‌عنوان نخستین گزینه مشخص شود.

•--force, -f

عدم درخواست تأیید برای دستور drop db_name. در صورت وجود چندین دستور، حتی در صورت بروز خطا نیز ادامه می‌دهد.

•--host=host_name, -h host_name

اتصال به سرور MariaDB روی میزبان مشخص‌شده.

•--local, -l

جلوگیری از نوشته شدن دستور(ات) SQL در لاگ باینری (binary log) با استفاده از FLUSH LOCAL یا فعال کردن sql_log_bin=0 برای نشست.

•--no-beep, -b

قطع بوق هشداری که به‌طور پیش‌فرض برای خطاهایی مانند عدم موفقیت در اتصال به سرور پخش می‌شود.

•--no-defaults

از هیچ فایل تنظیمی گزینه‌های پیش‌فرض را نخواند. این باید به‌عنوان نخستین آرگومان داده شود.

•--password[=password], -p[password]

گذرواژه‌ای که هنگام اتصال به سرور استفاده می‌شود. اگر از فرم کوتاه گزینه (-p) استفاده می‌کنید، نباید بین گزینه و گذرواژه فاصله باشد. اگر مقدار password را پس از گزینهٔ --password یا -p در خط فرمان وارد نکنید، mariadb-admin آن را درخواست می‌کند.

مشخص کردن گذرواژه در خط فرمان ناامن تلقی می‌شود.

•--pipe, -W

در Windows، اتصال به سرور از طریق یک named pipe برقرار می‌شود. این گزینه تنها در صورتی کاربرد دارد که سرور از اتصالات named-pipe پشتیبانی کند.

•--port=port_num, -P port_num

شماره درگاه TCP/IP برای استفاده در اتصال، یا 0 برای استفاده از پیش‌فرض بر اساس اولویت: my.cnf، سپس $MYSQL_TCP_PORT، سپس /etc/services و در نهایت پیش‌فرض توکار (3306). هنگامی که بدون سایر ویژگی‌های اتصال در خط فرمان مشخص شود، استفاده از --protocol=tcp را تحمیل می‌کند.

•--print-defaults

چاپ فهرست آرگومان‌های برنامه و خروج. این گزینه باید به عنوان نخستین آرگومان داده شود.

•--protocol={TCP|SOCKET|PIPE|MEMORY}

پروتکل اتصال برای وصل شدن به سرور. این گزینه زمانی مفید است که سایر پارامترهای اتصال معمولاً باعث انتخاب پروتکلی غیر از پروتکل مورد نظر شما شوند.

•--relative, -r

هنگام استفاده همراه با گزینهٔ --sleep، تفاوت بین مقادیر فعلی و قبلی را نشان می‌دهد. در حال حاضر، این گزینه تنها با دستور extended-status کار می‌کند.

•--shutdown-timeouttimeout

معادل --shutdown_timeout است؛ انتهای این بخش را ببینید.

•--silent, -s

در صورتی که امکان برقراری ارتباط با سرور وجود نداشته باشد، بدون نمایش پیام خطا خارج می‌شود.

•--sleep=delay, -i delay

اجرای مکرر دستورها با وقفهٔ delay ثانیه‌ای در میان آن‌ها. گزینهٔ --count تعداد تکرارها را تعیین می‌کند. اگر --count داده نشود، mariadb-admin دستورها را تا زمان متوقف شدن، به طور نامحدود اجرا می‌کند.

•--socket=path, -S path

برای اتصال به localhost، فایل سوکت یونیکس (Unix socket) مورد استفاده، یا در Windows، نام named pipe جهت استفاده. هنگامی که بدون سایر مشخصات اتصال در خط فرمان قید شود، استفاده از --protocol=socket را تحمیل می‌کند؛ در Windows، استفاده از --protocol=pipe را اجباری می‌کند.

•--ssl

فعال‌سازی SSL برای اتصال (به صورت خودکار با پرچم‌های دیگر فعال می‌شود). غیرفعال‌سازی با --skip-ssl.

•--ssl-ca=name

فایل CA در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-capath=name

دایرکتوری CA (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-cert=name

گواهی X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-cipher=name

سایفر SSL مورد استفاده (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-key=name

کلید X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-crl=name

فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-crlpath=name

مسیر فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-verify-server-cert

«Common Name» سرور در گواهی آن را با نام میزبان مورد استفاده هنگام اتصال تطبیق داده و اعتبارسنجی می‌کند. این گزینه به‌طور پیش‌فرض غیرفعال است.

•--tls-version=name,

فهرستی از نسخه‌های پروتکل TLS را که با کاما از هم جدا شده‌اند می‌پذیرد. یک نسخه پروتکل TLS تنها در صورتی فعال خواهد شد که در این فهرست وجود داشته باشد. سایر نسخه‌های پروتکل TLS مجاز نخواهند بود.

•--user=user_name, -u user_name

نام کاربری MariaDB برای استفاده هنگام اتصال به سرور.

•--verbose, -v

حالت پرگو (verbose). چاپ اطلاعات بیشتر درباره آنچه برنامه انجام می‌دهد.

•--version, -V

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

•--vertical, -E

خروجی را به صورت عمودی چاپ می‌کند. این شبیه به --relative است، اما خروجی را به صورت عمودی نمایش می‌دهد.

•--wait[=count], -w[count]

اگر برقراری اتصال ممکن نباشد، به جای لغو عملیات منتظر مانده و دوباره تلاش می‌کند. اگر مقداری برای count مشخص شود، بیانگر تعداد دفعات تلاش مجدد است. مقدار پیش‌فرض یک بار است.

•--wait-for-all-slaves

پیش از خاموش شدن، منتظر ارسال آخرین رویداد binlog به تمام slaveهای متصل می‌ماند. این گزینه به‌طور پیش‌فرض غیرفعال است.

همچنین می‌توانید متغیرهای زیر را با استفاده از --var_name=value تنظیم کنید

•connect_timeout

حداکثر زمان به ثانیه پیش از اتمام مهلت اتصال (timeout). مقدار پیش‌فرض 43200 (12 ساعت) است.

•shutdown_timeout

حداکثر زمان به ثانیه برای انتظار جهت خاموش شدن سرور. مقدار پیش‌فرض 3600 (1 ساعت) است.

Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2025 MariaDB Foundation

این مستندات یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده یا تغییر دهید؛ نسخه ۲ از این مجوز.

این مستندات به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به نشانی زیر بنویسید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA یا به http://www.gnu.org/licenses مراجعه کنید.

برای اطلاعات بیشتر، لطفاً به مستندات MariaDB مراجعه کنید که به‌صورت برخط در https://mariadb.com/docs در دسترس است.

بنیاد MariaDB ‏(http://www.mariadb.org).

5 March 2025 MariaDB 11.8