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

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

خلاصه دستور (SYNOPSIS)
       mariadb-hotcopy آرگومان‌ها

توضیحات (DESCRIPTION)
       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

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

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

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

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


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

       <https://mariadb.com/docs>

نویسنده (AUTHOR)
       بنیاد ماریا‌دی‌بی (<https://www.mariadb.org>).

MariaDB 11.8                     5 March 2025               MARIADB-HOTCOPY(1)