第 20 章 mysqlbackup命令行选项

目录

20.1 一般选项
20.2 连接选项
20.3 服务器存储库选项
20.4 备份存储库选项
20.5 元数据选项
20.6 压缩选项
20.7 增量备份选项
20.8 部分备份和恢复选项
20.9 单文件备份选项
20.10 性能/可扩展性/容量选项
20.11 消息记录选项
20.12 进度报告选项
20.13 加密选项
20.14 使用加密 InnoDB 表空间和加密二进制/中继日志的选项
20.15 云存储选项
20.16 特殊备份类型的选项

以下部分描述了mysqlbackup不同操作模式的命令行选项。

下表列出了 mysqlbackup的所有命令选项。使用选项名称处的超链接跳转到选项的详细说明。

笔记

命令选项也可以在配置文件中指定；请参阅 第 21 章配置文件和参数中的说明。 mysqlbackup遵循 MySQL 处理重复选项的标准做法，无论是在配置文件中指定，在命令行中指定，还是在两者中指定。选项首先从配置文件处理，然后从命令行处理。如果多次指定一个选项，则最后一个实例优先。

表 20.1 所有选项列表

选项名称 描述 介绍 弃用 删除
--备份目录 存放备份数据的目录。
--备份图像 指定备份映像的路径名。
--backup_innodb_data_file_path 指定 Innodb 系统表空间文件在备份中的路径和大小。
--backup_innodb_data_home_dir 系统表空间中所有 InnoDB 数据文件的备份基目录。
--backup_innodb_log_group_home_dir InnoDB 日志文件的备份目录。
--backup_innodb_undo_directory InnoDB 为撤消日志创建单独表空间的相对或绝对目录路径。
--字符集目录 字符集文件的目录。
--cloud-access-key 云帐户的访问密钥。 8.0.23
--cloud-access-key-id 用于登录 Amazon S3 的 AWS 访问密钥 ID。
--cloud-aws-region mysqlbackup 访问 S3 的 Amazon Web Services 区域。
--cloud-basicauth-url 用于访问 Swift 的 HTTP 基本身份验证的 URL。
--云桶 备份图片的存储桶。
--云缓冲区大小 云操作的缓冲区大小。
--cloud-ca-info 用于 SSL 连接的主机身份验证的 CA 捆绑文件的绝对路径。
--cloud-ca-路径 CA证书目录，除系统默认文件夹外。
--云块大小 如果启用分块传输，则分块的大小（以兆字节为单位）。 8.0.23
--cloud-chunked-transfer 使用云存储服务的分块传输。
--云容器 备份映像的 Swift 容器。
--云主机 存储服务的主机名。 8.0.22
--cloud-identity-url Keystone 身份服务的 URL。
--云对象 备份映像的存储对象。
--cloud-object-key 备份图像的 Amazon S3 对象键。
--cloud-par-url OCI 对象存储的预认证请求 URL 8.0.22
--云密码 --cloud-user-id 指定的用户密码。
--云代理 用于覆盖环境默认代理设置以访问云服务的代理地址和端口号。
--云区域 --cloud-user-id 指定的用户的 Keystone 区域。
--cloud-secret-access-key AWS 秘密访问密钥。
--cloud-secret-key 云帐户的密钥。 8.0.23
--云服务 用于数据备份或恢复的云服务。
--cloud-tempauth-url 用于使用 Swift 的 TempAuth 身份验证系统验证用户凭据的身份服务的 URL。
--云租户 --cloud-user-id 指定的用户的 Keystone 租户。
--cloud-trace 打印云操作的跟踪信息。
--cloud-user-id 访问 Swift 的用户 ID。
- 注释 指定注释字符串。
--评论文件 指定注释文件的路径。
- 压缩 以压缩格式创建备份。
--压缩级别 指定压缩级别。
--压缩方法 指定压缩算法。
--压缩算法 允许的服务器连接压缩算法 8.0.18
--connect_timeout 连接超时秒数。
--数据目录 mysql 服务器数据目录的路径。
--调试 打印调试信息。
--解密 解密写入 MEB 安全文件的备份映像。
--默认字符集 设置默认字符集。
--defaults-extra-file 在读取全局文件后读取此文件。
--defaults-文件 仅从给定文件中读取默认选项。
--defaults-group-suffix 另请阅读具有常用名称和 str 后缀的选项组。
--禁用清单 禁止为备份操作生成清单文件。
--dst-条目 与单文件备份一起使用，将单个文件或目录提取到用户指定的路径。
--启用明文插件 启用明文身份验证插件。 8.0.22
- 加密 加密备份映像并将其写入 MEB 安全文件。
--加密密码 用户提供的密码，mysqlbackup 用来加密加密 InnoDB 表空间的加密密钥。
- 错误代码 print-message 命令打印相应退出消息的退出代码。
--排除表 在备份或还原表中排除其名称与正则表达式 REGEXP 匹配的表。
--exec-when-locked 在备份操作接近尾声的锁定阶段执行指定的实用程序。
- 力量 根据操作强制覆盖数据、日志或图像文件。 8.0.28
--free-os-buffers 通过同步缓冲区释放文件系统缓存
- 帮助 显示帮助。
- 主持人 要连接的主机名。
- 包括 [Legacy] 仅备份与正则表达式 REGEXP 匹配的每表 innodb 数据文件。 8.0.20
--include-tables 在备份或还原表中包含其名称与正则表达式 REGEXP 匹配的表。
- 增加的 指定关联的备份或备份到映像操作是增量的。
--增量备份目录 指定增量目录备份的位置。
--增量基础 --incremental 选项的基本备份规范。
--incremental-with-redo-log-only 指定 InnoDB 表的增量备份基于将重做日志复制到备份，而不包括备份中的任何 InnoDB 数据文件。
--innodb_data_home_dir 指定共享系统表空间中所有 InnoDB 数据文件的基本目录。
--innodb_log_group_home_dir InnoDB 日志文件的目录路径。
--innodb_undo_directory InnoDB 撤消表空间的目录路径。
- 钥匙 用于加密和解密的对称密钥。
--密钥文件 包含用于加密和解密的对称密钥的文件的路径名。
--limit-内存 可用于 MEB 操作的内存（以 MB 为单位）。
--lock-wait-timeout 为 mysqlbackup 在备份的最后阶段发出的 FLUSH TABLES WITH READ LOCK 语句指定超时（以秒为单位）。 8.0.16
--log-bin 指定要恢复的二进制日志的位置。
--log-bin-index 指定列出所有二进制日志文件的索引文件的绝对路径。
--登录路径 从 .mylogin.cnf 登录文件中的指定登录路径读取选项。
--messages-logdir 指定用于存储消息日志的现有目录的路径名。
--no-defaults 不要从任何给定文件中读取默认选项。
--no-history-logging 即使连接可用，也禁用历史记录。
--无锁定 在备份期间禁用表的所有锁定。
--no-redo-log-archive 在备份期间跳过使用重做日志归档。 8.0.17
--缓冲区数量 指定要用于备份操作的内存缓冲区的确切数量。
--on-disk-full 指定备份进程遇到磁盘已满情况时的行为。
--only-innodb 仅备份 InnoDB 数据和日志文件。
--only-known-file-types 仅包括备份中已知类型列表的文件。
--optimistic-busy-tables 执行乐观备份，使用选项指定的正则表达式来选择将在乐观备份的第一阶段跳过的表。
--乐观时间 使用选项指定的值作为乐观时间执行乐观备份 - 未修改的表被认为是非活动表的时间。
--page-reread-count 页面重新读取的最大次数。
--page-reread-time 重新读取页面之前的等待时间。
- 密码 连接密码。
- 管道 –protocol=pipe 的别名。
--插件目录 指定客户端插件的目录。 8.0.22
- 港口 要连接的 TCP 端口号。
--print-defaults 打印默认文件提供的选项值列表并退出。
--进程线程 指定备份操作的进程线程数。
--进度间隔 进度报告之间的间隔（以秒为单位）。
- 协议 连接协议。
--读线程 指定备份操作的读取线程数。
--中继日志 指定要在副本服务器上恢复的中继日志的位置。
--relay-log-index 指定列出所有中继日志文件的索引文件的绝对路径。
- 改名 当被 --include-tables 选项选中要恢复时重命名单个表
--safe-slave-backup-timeout 备份副本服务器时，等待复制 SQL 线程删除其临时表的超时值。
--sbt-数据库名称 用作介质管理软件 (MMS) 的提示，用于选择介质和磁带备份策略。
--sbt-环境 以逗号分隔的分配给 SBT 库的环境变量列表。
--sbt-lib-路径 管理磁带备份的软件使用的 SBT 库的路径名。
--shared-memory-base-name 它指定 Windows 服务器使用的共享内存名称，以允许客户端使用共享内存进行连接（仅限 Windows）。
--显示进度 指示 mysqlbackup 定期输出称为其操作进度指示器的简短进度报告。
--skip-binlog 备份期间不包含二进制日志文件，或者还原期间不还原二进制日志文件。
--skip-final-rescan 跳过由 DDL 操作修改的 InnoDB 表的最终重新扫描。
--skip-messages-logdir 禁用记录到 teelog 文件。
--skip-relaylog 不要在备份期间包含中继日志文件，或者不要在还原期间恢复中继日志文件。
--skip-unused-pages 备份 InnoDB 表时跳过表空间中未使用的页面。
--slave-info 捕获设置相同副本服务器所需的信息。
- 睡觉 每复制 1MB 数据后的休眠时间（以毫秒为单位）。
- 插座 用于连接的套接字文件。
--src-条目 标识要从单文件备份中提取的文件或目录。
--ssl-ca PEM 格式的 CA 文件（隐含 –ssl）。
--ssl-capath CA 目录（检查 OpenSSL 文档，暗示 --ssl）。
--ssl证书 PEM 格式的 X509 证书（隐含 --ssl）。
--ssl密码 要使用的 SSL 密码（隐含 --ssl）。
--ssl-fips-模式 控制 MEB 是否在 FIPS 模式下运行。 8.0.14
--ssl-密钥 PEM 格式的 X509 密钥（隐含 --ssl）。
--ssl模式 连接到服务器的安全状态。
--start-lsn 指定先前备份中包含的最高 LSN 值。
--暂停结束 当备份过程接近结束时暂停 mysqlbackup 命令。
- 痕迹 mysqlbackup 的消息跟踪级别。
--解压缩 在操作期间解压缩备份。
--use-tts 使用可传输表空间 (TTS) 启用 InnoDB 表的选择性备份。
- 用户 要连接的数据库用户名。
--冗长 打印更详细的信息。
- 版本 显示版本信息。
--带时间戳 在备份目录下创建一个子目录，其名称由备份操作的时间戳组成。
--写线程 指定备份操作的写线程数。
--zstd-压缩级别 使用 ZSTD 压缩的服务器连接的压缩级别 8.0.18