20.1 一般选项

一般期权是一般性质的期权,或未归入任何其他特定期权组的期权:

  • mysql命令 还存在以下常规选项 。这些选项的完整描述可以在 MySQL 参考手册中找到,例如 服务器选项、系统变量和状态变量参考这些选项必须在任何其他 mysqlbackup选项之前指定,包括其余的常规选项

  • 以下选项在mysqlbackupmysql 之间也是通用 的,它们的完整描述可以在 MySQL 参考手册中找到,可以通过例如 Server Option, System Variable, and Status Variable Reference访问。但是,mysqlbackup不像mysql那样接受这些选项的任何缩写形式 (例如,对于 mysqlbackup--help ,您必须使用 instead of ): -h

    • --help:显示帮助。

    • --version:显示版本信息。

  • mysqlbackup 有更多通用选项 :

    • --verbose:打印更详细的信息。

      对于 8.0.27 版及更高版本: --verbose与 .同义 --trace=1

    • --debug= STRING:打印额外的调试信息。

      对于 8.0.26 版及更早版本:该选项接受以下一个或多个参数:

      • all:打印所有操作的附加调试信息

      • sbt:使用系统备份到磁带 (SBT) 接口 打印操作的附加调试信息

      • null:当为选项指定空字符串或根本没有参数时, mysqlbackup的行为就好像 --verbose使用了该选项一样。

      对于 8.0.27 及更高版本:该选项接受以下一个或多个参数(多个值应以分号 (;) 分隔):

      • all:打印所有操作的附加调试信息

      • sbt:使用系统备份到磁带 (SBT) 接口 打印操作的附加调试信息

      • page_validation:打印验证操作的调试信息。

      • hole_punch:打印备份透明页面压缩的调试信息。

      • tablespace_flags:打印从表空间读取的标志。

      • io_file: 打印读写文件的调试信息。

      • keyring_migration_tool:打印有关密钥环迁移操作的调试信息。

    • --force仅适用于 8.0.27 版及更早版本(自 8.0.28 版以来已弃用和忽略):默认情况下,某些操作会在被告知写入现有文件时停止而不是覆盖任何用户数据或日志文件。 --force允许以下内容:

      警告

      对于任何恢复操作,不要尝试使用该 --force选项将数据恢复到非空数据目录;这样做可能会导致数据损坏和其他意外行为。不要将 --force选项与 a copy-backcopy-back-and-apply-log 操作一起使用。

      • apply-log在and 操作 期间覆盖 InnoDB 数据和日志文件apply-incremental-backup

      • backup-to-image在or backup-dir-to-image操作 期间替换图像文件 。

    • --trace=level

      命令行格式 --trace=LEVEL
      类型 枚举
      默认值 0
      有效值

      0

      1

      2

      3

      mysqlbackup消息 的跟踪级别。按照细度递增的顺序,允许的水平是:

      • 0 - INFO(信息、警告、错误)

      • 1 - 很好(比跟踪级别 0 提供的信息更多)

      • 2 - FINER(比跟踪级别 1 提供更精细的信息级别)

      • 3 - FINEST(可提供的最佳信息级别)

    • --error-code=CODE

      命令行格式 --error-code
      类型 数字
      最小值 0
      最大值 19

      指定 print-message命令打印相应退出消息的退出代码。有关详细信息,请参阅 第 17.1 节,“MySQL 企业备份的退出代码”

    • --enable-cleartext-plugin

      对于 MySQL Enterprise Backup 8.0.22 及更高版本:启用 Client-Side Cleartext Pluggable Authentication。使用简单 LDAP 身份验证时需要。请参阅 第 16 章,使用 LDAP 进行服务器身份验证

    • --plugin-dir =plugin-dir

      对于 MySQL Enterprise Backup 8.0.22 及更高版本: 指定客户端插件的目录。使用基于 SASL 的 LDAP 身份验证时需要 并且客户端插件不在服务器的插件目录中。有关详细信息,请参阅 第 16 章,使用 LDAP 进行服务器身份验证