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

mariadb-hotcopy - برنامه تهیه نسخه پشتیبان سریع از پایگاه‌داده

mariadb-hotcopy آرگومان‌ها

mariadb-hotcopy یک اسکریپت پرل (Perl) است که در ابتدا توسط Tim Bunce نوشته شد و توسعه یافت. این ابزار از دستورات FLUSH TABLES، LOCK TABLES، و cp یا scp برای تهیه نسخه پشتیبان از پایگاه‌داده استفاده می‌کند. این ابزار راهکاری سریع برای تهیه پشتیبان از پایگاه‌داده یا جداول منفرد است، اما تنها می‌تواند روی همان سیستمی اجرا شود که دایرکتوری‌های پایگاه‌داده در آن قرار دارند. mariadb-hotcopy تنها برای تهیه نسخه پشتیبان از جداول MyISAM و ARCHIVE کاربرد دارد و بر روی سیستم‌های یونیکس و NetWare اجرا می‌شود.

جهت استفاده از mariadb-hotcopy، شما باید دسترسی خواندن پرونده‌های جداولی که از آن‌ها پشتیبان تهیه می‌کنید را داشته باشید؛ همچنین دسترسی SELECT روی آن جداول، دسترسی RELOAD (جهت امکان اجرای FLUSH TABLES)، و دسترسی LOCK TABLES (جهت قفل کردن جداول) الزامی است.

shell> mariadb-hotcopy نام_پایگاه_داده [/path/to/new_directory]
shell> mariadb-hotcopy db_name_1 ... db_name_n /path/to/new_directory

تهیه نسخه پشتیبان از جداول موجود در پایگاه‌داده داده‌شده که با یک عبارت باقاعده مطابقت دارند:

shell> mariadb-hotcopy نام_پایگاه_داده./عبارت_باقاعده/

عبارت باقاعده برای نام جدول را می‌توان با افزودن علامت مدک (“~”) نفی کرد:

shell> mariadb-hotcopy نام_پایگاه_داده./~عبارت_باقاعده/

mariadb-hotcopy از گزینه‌های زیر پشتیبانی می‌کند که می‌توان آن‌ها را در خط فرمان یا در بخش‌های [mariadb-hotcopy] و [client] در پرونده‌های تنظیمات درج نمود:

•--help, -?

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

•--addtodest

عدم تغییر نام دایرکتوری مقصد (در صورت وجود)؛ صرفاً افزودن پرونده‌ها به آن.

•--allowold

عدم توقف عملیات در صورت وجود پوشه مقصد؛ تغییر نام آن با افزودن پسوند _old.

•--checkpoint=db_name.tbl_name

درج رکوردهای چک‌پوینت در پایگاه‌داده db_name و جدول tbl_name تعیین‌شده.

•--chroot=path

دایرکتوری پایه محیط قرنطینه chroot که mariadbd در آن اجرا می‌شود. مقدار path باید مطابق با مقدار گزینه --chroot داده‌شده به mariadbd باشد.

•--debug

فعال‌سازی خروجی اشکال‌زدایی (دیباگ).

•--dryrun, -n

گزارش اقدامات بدون اجرای واقعی آن‌ها (حالت آزمایشی).

•--flushlog

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

•--host=host_name, -h host_name

نام میزبان محلی جهت برقراری اتصال TCP/IP با سرور محلی. به طور پیش‌فرض اتصال با localhost از طریق پرونده سوکت یونیکس انجام می‌شود.

•--keepold

عدم حذف دایرکتوری مقصد پیشین (تغییرنام‌یافته) پس از اتمام فرآیند.

•--method=command

روش کپی پرونده‌ها (cp یا scp). حالت پیش‌فرض cp است.

•--noindices

عدم گنجاندن پرونده‌های کامل نمایه (ایندکس) برای جداول MyISAM در نسخه پشتیبان. این کار پشتیبان‌گیری را کم‌حجم‌تر و سریع‌تر می‌کند. نمایه‌ها برای جداول بازیابی‌شده می‌توانند بعداً توسط دستور myisamchk -rq مجدداً ساخته شوند.

•--old-server

اتصال به سرورهای قدیمی MySQL (پیش از نگارش ۵.۵) که قابلیت FLUSH TABLES WITH READ LOCK در آن‌ها به طور کامل پیاده‌سازی نشده است.

•--password=password, -ppassword

گذرواژه مورد استفاده هنگام اتصال به سرور. مقدار گذرواژه بر خلاف سایر برنامه‌های MariaDB برای این گزینه اختیاری نیست.

تعیین گذرواژه در خط فرمان ناامن تلقی می‌شود. می‌توانید برای جلوگیری از درج گذرواژه در خط فرمان، از پرونده تنظیمات استفاده فرمایید.

•--port=port_num, -P port_num

شماره درگاه TCP/IP برای اتصال به سرور محلی.

•--quiet, -q

سکوت و عدم تولید خروجی به جز در موارد خطا.

•--record_log_pos=db_name.tbl_name

ثبت وضعیت سرور اصلی (master) و رونوشت (slave) در پایگاه‌داده db_name و جدول tbl_name تعیین‌شده.

•--regexp=expr

کپی تمامی پایگاه‌های داده‌ای که نامشان با عبارت باقاعده ارائه‌شده تطابق دارد.

•--resetmaster

بازنشانی وقایع‌نگاری باینری (binary log) پس از قفل کردن تمام جداول.

•--resetslave

بازنشانی پرونده master.info پس از قفل کردن تمام جداول.

•--socket=path, -S path

پرونده سوکت یونیکس مورد استفاده جهت اتصال به localhost.

•--suffix=str

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

•--tmpdir=path

دایرکتوری موقت. مقدار پیش‌فرض /tmp است.

•--user=user_name, -u user_name

نام کاربری MariaDB جهت اتصال به سرور.

جهت مطالعه مستندات تکمیلی mariadb-hotcopy، شامل اطلاعاتی درباره ساختار جداول مورد نیاز برای گزینه‌های --checkpoint و --record_log_pos از ابزار perldoc استفاده فرمایید:

shell> perldoc mariadb-hotcopy

حق نشر 2007-2008 MySQL AB، 2008-2010 Sun Microsystems, Inc.، 2010-2025 MariaDB Foundation

این مستندات نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد؛ نگارش ۲ بازتوزیع نموده یا تغییر دهید.

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

شما باید نسخه‌ای از پروانه عمومی همگانی گنو را به همراه برنامه دریافت کرده باشید؛ در غیر این صورت به نشانی زیر مراجعه فرمایید: http://www.gnu.org/licenses

برای اطلاعات بیشتر، لطفاً به مستندات آنلاین MariaDB مراجعه کنید:

https://mariadb.com/docs

بنیاد ماریا‌دی‌بی (https://www.mariadb.org).

5 March 2025 MariaDB 11.8