第 16 章 mysqlbackup命令行选项

目录

16.1 标准选项
16.2 连接选项
16.3 服务器存储库选项
16.4 备份存储库选项
16.5 元数据选项
16.6 压缩选项
16.7 增量备份选项
16.8 部分备份和恢复选项
16.9 单文件备份选项
16.10 性能/可扩展性/容量选项
16.11 消息记录选项
16.12 进度报告选项
16.13 加密选项
16.14 使用加密 InnoDB 表空间的选项
16.15 云存储选项
16.16 特殊备份类型的选项
16.17 其他选项

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

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

笔记

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

表 16.1 所有选项列表

选项名称 描述 介绍 弃用
--备份目录 存放备份数据的目录。
--备份图像 指定备份映像的路径名。
--backup_innodb_checksum_algorithm 用于验证 InnoDB 表空间的校验和算法的名称。
--backup_innodb_data_file_path 指定 Innodb 系统表空间文件在备份中的路径和大小。
--backup_innodb_data_home_dir 系统表空间中所有 InnoDB 数据文件的备份基目录。
--backup_innodb_log_file_size 每个 InnoDB 备份日志文件的大小（以字节为单位）。
--backup_innodb_log_files_in_group 备份中的 InnoDB 日志文件数。
--backup_innodb_log_group_home_dir InnoDB 日志文件的备份目录。
--backup_innodb_page_size MySQL 实例中所有 InnoDB 表空间的页面大小。
--backup_innodb_undo_directory InnoDB 为撤消日志创建单独表空间的相对或绝对目录路径。
--backup_innodb_undo_logs InnoDB 在事务中使用的系统表空间中的回滚段数。
--backup_innodb_undo_tablespaces 当使用非零 innodb_undo_logs 设置时，撤消日志被划分的表空间文件数。
--字符集目录 字符集文件的目录。
--cloud-access-key-id 用于登录 Amazon S3 的 AWS 访问密钥 ID。
--cloud-aws-region mysqlbackup 访问 S3 的 Amazon Web Services 区域。
--cloud-basicauth-url 用于访问 Swift 的 HTTP 基本身份验证的 URL。 4.1.1
--云桶 备份图片的存储桶。
--云缓冲区大小 云操作的缓冲区大小。 4.1.1
--cloud-ca-info 用于 SSL 连接的主机身份验证的 CA 捆绑文件的绝对路径。
--cloud-ca-路径 CA证书目录，除系统默认文件夹外。
--cloud-chunked-transfer 使用云存储服务的分块传输。 4.1.1
--云容器 备份映像的 Swift 容器。
--cloud-identity-url Keystone 身份服务的 URL。
--云对象 备份映像的存储对象。
--cloud-object-key 备份图像的 Amazon S3 对象键。
--云密码 --cloud-user-id 指定的用户密码。
--云代理 用于覆盖环境默认代理设置以访问云服务的代理地址和端口号。
--云区域 --cloud-user-id 指定的用户的 Keystone 区域。
--cloud-secret-access-key AWS 秘密访问密钥。
--云服务 用于数据备份或恢复的云服务。
--cloud-tempauth-url 用于使用 Swift 的 TempAuth 身份验证系统验证用户凭据的身份服务的 URL。
--云租户 --cloud-user-id 指定的用户的 Keystone 租户。
--cloud-trace 打印云操作的跟踪信息。
--cloud-user-id 访问 Swift 的用户 ID。
- 注释 指定注释字符串。
--评论文件 指定注释文件的路径。
- 压缩 以压缩格式创建备份。
--压缩级别 指定压缩级别。
--压缩方法 指定压缩算法。
--connect-if-online 仅在可用时使用连接。
--connect_timeout 连接超时秒数。
--数据库 [Legacy] 指定要备份的非 InnoDB 表的列表。
--数据库列表文件 [Legacy] 指定列出要备份的非 InnoDB 表的文件的路径名。
--数据目录 mysql 服务器数据目录的路径。
--调试 打印调试信息。
--解密 解密写入 MEB 安全文件的备份映像。
--默认字符集 设置默认字符集。
--defaults-extra-file 在读取全局文件后读取此文件。
--defaults-文件 仅从给定文件中读取默认选项。
--defaults-group-suffix 另请阅读具有常用名称和 str 后缀的选项组。
--禁用清单 禁止为备份操作生成清单文件。
--dst-条目 与单文件备份一起使用，将单个文件或目录提取到用户指定的路径。
- 加密 加密备份映像并将其写入 MEB 安全文件。
--加密密码 用户提供的密码，mysqlbackup 用来加密加密 InnoDB 表空间的加密密钥。
- 错误代码 print-message 命令打印相应退出消息的退出代码。
--排除表 在备份或还原表中排除其名称与正则表达式 REGEXP 匹配的表。
--exec-when-locked 在备份操作接近尾声的锁定阶段执行指定的实用程序。
- 力量 根据操作强制覆盖数据、日志或图像文件。
--free-os-buffers 通过同步缓冲区释放文件系统缓存
--generate-new-master-key 为加密的 InnoDB 表空间生成新的主密钥。
- 帮助 显示帮助。
- 主持人 要连接的主机名。
- 包括 [Legacy] 仅备份与正则表达式 REGEXP 匹配的每表 innodb 数据文件。
--include-tables 在备份或还原表中包含其名称与正则表达式 REGEXP 匹配的表。
- 增加的 指定关联的备份或备份到映像操作是增量的。
--增量备份目录 指定增量目录备份的位置。
--增量基础 --incremental 选项的基本备份规范。
--incremental-with-redo-log-only 指定 InnoDB 表的增量备份基于将重做日志复制到备份，而不包括备份中的任何 InnoDB 数据文件。
--innodb_checksum_algorithm 用于验证 InnoDB 表空间的校验和算法的名称。
--innodb_data_file_path 指定 InnoDB 系统表空间文件的路径和大小。
--innodb_data_home_dir 指定共享系统表空间中所有 InnoDB 数据文件的基本目录。
--innodb_log_file_size 日志组中每个 InnoDB 日志文件的大小（以字节为单位）。
--innodb_log_files_in_group InnoDB 日志文件的数量。
--innodb_log_group_home_dir InnoDB 日志文件的目录路径。
--innodb_page_size MySQL 实例中所有 InnoDB 表空间的页面大小。
--innodb_undo_directory InnoDB 撤消表空间的目录路径。
- 钥匙 用于加密和解密的对称密钥。
--密钥文件 包含用于加密和解密的对称密钥的文件的路径名。
- 钥匙圈 用于主加密密钥管理的密钥环插件类型。
--keyring_file_data 密钥环文件的路径。
--keyring_okv_conf_dir Oracle Key Vault (OKV) 端点目录的路径。
--limit-内存 可用于 MEB 操作的内存（以 MB 为单位）。
--lock-wait-retry-count 指定在 FLUSH TABLES WITH READ LOCK 语句由于超时而失败后，mysqlbackup 尝试的最大重试次数。 4.1.4
--lock-wait-timeout 为 mysqlbackup 在备份的最后阶段发出的 FLUSH TABLES WITH READ LOCK 语句指定超时（以秒为单位）。
--log-bin 指定要恢复的二进制日志的位置。 4.1.2
--log-bin-index 指定列出所有二进制日志文件的索引文件的绝对路径。
--登录路径 从 .mylogin.cnf 登录文件中的指定登录路径读取选项。
--master-info-file 指定信息文件的绝对路径，副本在其中记录有关其源的信息（仅适用于副本服务器的脱机备份）。
--messages-logdir 指定用于存储消息日志的现有目录的路径名。
- 没有关联 不要连接到服务器。
--no-defaults 不要从任何给定文件中读取默认选项。
--no-history-logging 即使连接可用，也禁用历史记录。
--无锁定 在备份期间禁用表的所有锁定。
--缓冲区数量 指定要用于备份操作的内存缓冲区的确切数量。
--on-disk-full 指定备份进程遇到磁盘已满情况时的行为。
--only-innodb 仅备份 InnoDB 数据和日志文件。
--only-innodb-with-frm [Legacy] 仅备份 InnoDB 数据、日志文件和与 InnoDB 表关联的 .frm 文件。
--only-known-file-types 仅包括备份中已知类型列表的文件。
--optimistic-busy-tables 执行乐观备份，使用选项指定的正则表达式来选择将在乐观备份的第一阶段跳过的表。
--乐观时间 使用选项指定的值作为乐观时间执行乐观备份 - 未修改的表被认为是非活动表的时间。
--page-reread-count 页面重新读取的最大次数。
--page-reread-time 重新读取页面之前的等待时间。
- 密码 连接密码。
- 管道 –protocol=pipe 的别名。
- 港口 要连接的 TCP 端口号。
--print-defaults 打印默认文件提供的选项值列表并退出。
--进程线程 指定备份操作的进程线程数。
--进度间隔 进度报告之间的间隔（以秒为单位）。
- 协议 连接协议。
--读线程 指定备份操作的读取线程数。
--中继日志 指定要在副本服务器上恢复的中继日志的位置。 4.1.2
--relay-log-index 指定列出所有中继日志文件的索引文件的绝对路径。
--relaylog-信息文件 指定副本记录中继日志信息的信息文件的绝对路径（仅用于副本服务器的离线备份）。
- 改名 当被 --include-tables 选项选中要恢复时重命名单个表
--safe-slave-backup-timeout 备份副本服务器时，等待复制 SQL 线程删除其临时表的超时值。
--sbt-数据库名称 用作介质管理软件 (MMS) 的提示，用于选择介质和磁带备份策略。
--sbt-环境 以逗号分隔的分配给 SBT 库的环境变量列表。
--sbt-lib-路径 管理磁带备份的软件使用的 SBT 库的路径名。
--secure-auth 如果客户端使用旧的（4.1.1 之前的）协议，则拒绝客户端连接到服务器。
--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 为连接启用 SSL（使用其他 --ssl- 标志自动启用）。 是的
--ssl-ca PEM 格式的 CA 文件（隐含 –ssl）。
--ssl-capath CA directory (check OpenSSL docs,implies --ssl).
--ssl-cert X509 cert in PEM format (implies --ssl).
--ssl-cipher SSL cipher to use (implies --ssl).
--ssl-key X509 key in PEM format (implies --ssl).
--ssl-mode Security state of connection to server.
--ssl-verify-server-cert Verify server's "Common Name" in its cert against hostname used when connecting. Yes
--start-lsn Specifies the highest LSN value included in a previous backup.
--suspend-at-end Pauses the mysqlbackup command when the backup procedure is close to ending.
--trace Trace level of messages by mysqlbackup.
--uncompress Uncompress a backup during an operation.
--use-tts Enable selective backup of InnoDB tables using transportable tablespaces (TTS).
--user Database user name to connect.
--verbose Print more verbose information.
--version Display version information.
--with-timestamp 在备份目录下创建一个子目录，其名称由备份操作的时间戳组成。
--写线程 指定备份操作的写线程数。