20.3 服务器存储库选项

这些存储库选项指定与备份恢复到的数据库服务器相关的各种参数。

这些选项仅用于还原操作，即 copy-back和 copy-back-and-apply-log。下面的描述解释了这些选项如何与 mysqlbackup一起使用；有关这些选项如何与 MySQL 服务器一起使用的信息，请单击选项名称以查看 MySQL 参考手册中的说明。

  • datadir=PATH

    这是恢复的 MySQL 服务器的数据目录。它应该与 datadir用于恢复的目标服务器的值一起提供。

    必须为任何恢复操作指定此选项，部分恢复除外（有关详细信息，请参阅 第 5.1.4 节“表级恢复 (TLR)”）。

  • log-bin[= basename]

    指定要恢复的二进制日志的位置。默认情况下，在还原期间，二进制日志将还原到它在备份服务器上找到的相同位置。使用此选项为二进制日志指定不同的目标位置。--log-bin该选项在确定二进制日志文件的位置和名称方面与 MySQL 服务器 的选项类似 ——有关详细信息，请参阅服务器 --log-bin 选项的描述。作为总结：

    • 在不提供 a 的情况下使用此选项 basename 会将二进制日志放入目标服务器的数据目录中，并使用默认的 basename host_name-bin。

    • 在提供 a 时使用此选项 basename 会将二进制日志放入具有指定基本名称的目标服务器的数据目录中。

    • 在提供 basename 包含完整文件路径（例如 ）的同时使用此选项会使用提供的基本名称 ( )/home/admin/db/binlogdir/binlog将二进制日志放在目标服务器上的指定文件夹 ( ) 中。 /home/admin/db/binlogdir/binlog

    该选项仅适用于 copy-back-and-apply-logand copy-back操作。将它与任何其他操作一起使用会使命令失败。

  • relay-log[= basename]

    指定要在副本服务器上恢复的中继日志的位置。默认情况下，在副本服务器还原期间，中继日志将还原到它在备份副本服务器上找到的相同位置。使用此选项为中继日志指定不同的目标位置。--relay-log该选项在确定中继日志文件的位置和名称方面与 MySQL 服务器 的选项类似 ——有关详细信息，请参阅服务器 --relay-log 选项的描述。作为总结：

    • 在不提供 a 的情况下使用此选项 basename 会将中继日志放入目标服务器的数据目录中，并使用默认的 basename host_name-relay-bin。

    • 在提供 a 时使用此选项 basename 会将中继日志放入具有指定基本名称的目标服务器的数据目录中。

    • 在提供 basename 包含完整文件路径（例如 ）的同时使用此选项，使用提供的基本名称 ( )/home/admin/db/relaylogdir/relaylog将中继日志放在目标服务器上的指定文件夹 ( ) 中。 /home/admin/db/relaylogdir/relaylog

    该选项仅适用于 copy-back-and-apply-logand copy-back操作。将它与任何其他操作一起使用会使命令失败。

  • log-bin-index[= PATH]

    指定用于恢复列出所有二进制日志文件的索引文件的绝对路径（包括文件名和扩展名），如果它与下面给出的默认路径不同。

    默认值： . data_dir/host_name-bin.index

  • relay-log-index[= PATH]

    指定用于恢复列出所有中继日志文件的索引文件的绝对路径（包括文件名和扩展名），如果它与下面给出的默认路径不同。

    默认值： . data_dir/host_name-relay-bin.index

  • innodb_data_home_dir=PATH

    指定 InnoDB 数据文件所在的目录。通常与 相同 datadir，但可以不同。此参数与 innodb_data_file_path=一起SIZE确定 InnoDB 数据文件（如 ibdata1、ibdata2等）在 MySQL 服务器中的位置。

    对于备份：您不需要指定此选项，因为它的值是使用数据库连接自动检索的。

    对于恢复：要恢复 InnoDB 数据文件的目录。仅当要在服务器数据目录之外恢复 InnoDB 数据文件时才指定该选项。对于 8.0.16 及更高版本：指定的目录必须不存在或为空，否则还原操作将失败。

  • innodb_log_group_home_dir=PATH

    指定 InnoDB 重做日志在服务器存储库中的驻留位置。通常与 相同datadir，但可以不同。

    对于备份：您不需要指定此选项，因为它的值是使用数据库连接自动检索的。

    对于恢复：要恢复 InnoDB 重做日志文件的目录。仅当 InnoDB 重做日志文件要在服务器数据目录之外恢复时才指定该选项。对于 8.0.16 及更高版本：指定的目录必须不存在或为空，否则还原操作将失败。

  • innodb_undo_directory=PATH

    指定 InnoDB 撤消日志在服务器存储库中的驻留位置。通常与 相同 datadir，但可以不同。

    对于备份：您不需要指定此选项，因为它的值是使用数据库连接自动检索的。

    对于恢复：

    • 对于 8.0.16 及更高版本：要还原默认 InnoDB 撤消表空间以及驻留在备份服务器数据目录中的任何非默认撤消表空间的目录。（外部撤消表空间默认恢复到它们在备份服务器上找到的位置；有关详细信息，请参阅 撤消日志文件的描述。） 指定的目录必须不存在或为空，否则恢复操作将失败。

    • 对于 8.0.15 及更早版本：要还原 InnoDB 撤消日志文件的目录。仅当撤消日志文件要在服务器数据目录之外恢复时才指定该选项。

    其值推导如下：

    警告

    使用此选项时，请确保撤消日志位置不会在完整备份和增量备份或两个增量备份的连续还原之间发生变化。否则，恢复将失败。