xtrabackup 选项参考

#--------- 配置 xtrabackup  ---------#

所有的xtrabackup配置都是通过选项完成的，这些选项的行为与标准的MySQL程序选项完全一样：它们可以在命令行中指定，也可以通过诸如/etc/my.cnf.

该xtrabackup二进制读取[mysqld]和[xtrabackup]从任何配置文件的部分，按照这个顺序。这样它就可以从您现有的MySQL安装中读取其选项，例如datadir或某些InnoDB选项。如果你想覆盖这些，只需在[xtrabackup]节中指定它们，因为它是稍后阅读的，所以它会优先。

my.cnf如果你不想，你不需要在你的配置中放入任何配置。您可以简单地在命令行上指定选项。通常，您可能会觉得放在文件[xtrabackup]部分方便的唯一选项是默认放置备份的目录my.cnf的target_dir选项，例如：

[xtrabackup] 

target_dir = /data/backups/mysql/

本手册将假设您没有任何基于文件的xtrabackup配置 ，因此它将始终显示显式使用的命令行选项。有关所有配置选项的详细信息，请参阅选项和变量参考。

该xtrabackup二进制不完全接受在相同的语法 my.cnf为文件的mysqld服务器二进制文件没有。由于历史原因，mysqld服务器二进制文件接受带有xtrabackup不理解的--set-variable=<variable>=<value>语法的参数 。如果你的文件有这样的配置指令，你应该在语法中重写它们。my.cnf--variable=value

系统配置和 NFS 卷

该xtrabackup工具需要在大多数系统上没有特殊的配置。但是， 所在的存储在被调用--target-dir时必须正确运行fsync()。特别是，我们注意到未使用该sync选项挂载的 NFS 卷可能不会真正同步数据。因此，如果您备份到使用 async 选项挂载的 NFS 卷，然后尝试从也挂载该卷的其他服务器准备备份，则数据可能看起来已损坏。您可以使用 syncmount 选项来避免这个问题。

#--------- 该xtrabackup选项参考-------------#

此页面记录了xtrabackup二进制文件的所有命令行选项 。

操作模式

您可以在以下模式之一中调用xtrabackup：

--backup 在目标目录中进行备份的模式

--prepare从备份中恢复数据的--backup模式（以模式创建）

--copy-back将数据从备份复制到包含原始数据的位置；移动数据而不是复制使用交替--move-back模式。

--stats 模式扫描指定的数据文件并打印出索引统计信息。

当您打算以这些模式中的任何一种运行xtrabackup时，请使用以下语法：

$ xtrabackup [ --defaults-file = #] --backup|--prepare|--copy-back|--stats [选项]

例如，--prepare模式应用如下：

$ xtrabackup --prepare --target-dir = /data/backup/mysql/

对于所有模式，默认选项是按给定顺序从以下文件的xtrabackup和 mysqld配置组中读取的：

/etc/my.cnf

/etc/mysql/my.cnf

/usr/etc/my.cnf

~/.my.cnf.

作为xtrabackup的第一个参数（代替--defaults-file，您可以提供以下之一：

--print-defaults让xtrabackup打印参数列表并退出。

--no-defaults 禁止从除登录文件之外的任何文件中读取选项。

--defaults-file 从给定文件中读取默认选项。

--defaults-extra-file 在读取全局文件后读取指定的附加文件。

--defaults-group-suffix读取具有给定后缀的配置组。有效组名是通过将默认配置组（xtrabackup和mysqld）与给定后缀连接起来构造的。

--login-path 从登录文件中读取给定的路径。

InnoDB 选项

有一大组 InnoDB 选项通常从my.cnf配置文件中读取 ，以便xtrabackup以与当前服务器相同的配置启动其嵌入式 InnoDB。您通常不需要明确指定它们。这些选项在 InnoDB 和 XtraDB 中具有相同的行为。有关--innodb-miscellaneous更多信息，请参阅。

选项

--apply-log-only

此选项导致在准备备份时仅执行重做阶段。这对于增量备份非常重要。

--backup

进行备份并将其放入--target-dir. 请参阅 创建备份。

--backup-lock-timeout

尝试获取元数据锁的超时时间（以秒为单位）。

--backup-lock-retry-count

尝试获取元数据锁的次数。

--backup-locks

此选项控制是否应使用备份锁而不是在备份阶段使用。当服务器不支持备份锁时，该选项无效。默认情况下启用此选项，禁用。FLUSH TABLES WITH READ LOCK--no-backup-locks

--check-privileges

此选项检查Percona XtraBackup是否具有所有必需的权限。如果当前操作需要缺少权限，它将终止并打印出错误消息。如果当前操作不需要缺少权限，但某些其他 XtraBackup 操作可能需要缺少权限，则不会中止该过程并打印警告。

xtrabackup：错误：缺少 *.* 上所需的特权 LOCK TABLES

xtrabackup：警告：缺少 *.* 上所需的权限 REPLICATION CLIENT

--close-files

不要让文件保持打开状态。当xtrabackup打开表空间时，它通常不会关闭其文件句柄以正确处理 DDL 操作。但是，如果表空间的数量确实很大并且无法满足任何限制，则可以选择在不再访问文件句柄时关闭它们。启用此选项后，Percona XtraBackup可能会生成不一致的备份。使用风险自负。

--compress

此选项告诉xtrabackup使用quicklz或 lz4压缩算法压缩所有输出数据，包括事务日志文件和元数据文件。quicklz默认选择。

使用--compress=quicklz或 时--compress，生成的文件具有 qpress 存档格式，即xtrabackup*.qp生成的每个文件本质上都是单文件 qpress 存档，可以由qpress文件存档器提取和解压缩。

--compress=lz4产生*.lz4文件。您可以使用诸如lz4.

也可以看看

快速LZ

http://www.quicklz.com

LZ4

https://lz4.gi​​thub.io/lz4/

--compress-chunk-size=#

压缩线程的工作缓冲区大小（以字节为单位）。默认值为 64K。

--compress-threads=#

此选项指定xtrabackup用于并行数据压缩的工作线程数。此选项默认为1。并行压缩 ( --compress-threads) 可以与并行文件复制 ( --parallel)一起使用。例如， 将创建 4 个 I/O 线程，这些线程将读取数据并将其通过管道传输到 2 个压缩线程。--parallel=4 --compress --compress-threads=2

--copy-back

将先前备份中的所有文件从备份目录复制到其原始位置。除非--force-non-empty-directories指定选项，否则此选项不会复制现有文件。

--core-file

在致命信号上写核心。

--databases=#

此选项指定应备份的数据库和表的列表。该选项接受表单的列表。"databasename1[.table_name1] databasename2[.table_name2] . . ."

--databases-exclude=name

根据名称排除数据库，操作方式与 相同--databases，但匹配的名称从备份中排除。请注意，此选项的优先级高于 --databases。

--databases-file=#

此选项指定包含应备份的数据库和表列表的文件的路径。该文件可以包含表单的列表元素，databasename1[.table_name1]每行一个元素。

--datadir=DIRECTORY

备份的源目录。这应该与您的MySQL服务器的 datadir 相同，因此my.cnf如果存在，应该从中读取它；否则您必须在命令行中指定它。

与--copy-back或 --move-back选项结合使用时，--datadir 指的是目标目录。

一旦连接到服务器，以执行备份你需要 READ和EXECUTE在服务器的文件系统级权限的datadir。

--debug-sleep-before-unlock=#

这是xtrabackup测试套件使用的仅调试选项。

--debug-sync=name

调试同步点。此选项仅由xtrabackup测试套件使用。

--decompress

解压缩.qp之前使用该--compress选项创建的备份中带有扩展名的所有文件。该 --parallel选项将允许同时解密多个文件。为了解压，必须在路径中安装和访问 qpress 实用程序。Percona XtraBackup不会自动删除压缩文件。为了清理备份目录用户应该使用--remove-original选项。

该--decompress选项可与xbstream一起使用以解压缩单个 qpress 文件。

如果您使用lz4压缩算法来压缩文件 ( --compress=lz4)，请相应地更改--decompress参数：--decompress=lz4.

--decompress-threads=#

强制xbstream使用指定数量的线程进行解压缩。

--decrypt=ENCRYPTION-ALGORITHM

解密.xbcrypt之前使用--encrypt选项创建的备份中带有扩展名的所有文件。该 --parallel选项将允许同时解密多个文件。Percona XtraBackup不会自动删除加密文件。为了清理备份目录用户应该使用--remove-original选项。

--defaults-extra-file=[MY.CNF]

读取全局文件后读取此文件。必须作为命令行上的第一个选项给出。

--defaults-file=[MY.CNF]

仅从给定文件中读取默认选项。必须作为命令行上的第一个选项给出。必须是真实文件；它不能是符号链接。

--defaults-group=GROUP-NAME

该选项用于设置应该从配置文件中读取的组。如果您使用该选项，则由xtrabackup使用 --defaults-group。mysqld_multi部署需要它 。

--defaults-group-suffix=#

还读取带有 concat(group, suffix) 的组。

--dump-innodb-buffer-pool

此选项控制是否应完成缓冲池内容的新转储。

使用--dump-innodb-buffer-pool，如果 状态变量innodb_buffer_pool_dump_status报告转储已完成，xtrabackup会在备份开始时向服务器发出请求以启动缓冲池转储（需要一些时间才能完成并在后台 完成）。

$ xtrabackup --backup --dump-innodb-buffer-pool --target-dir = /home/user/backup

默认情况下，此选项设置为OFF。

如果innodb_buffer_pool_dump_status报告有正在运行的缓冲池转储，则xtrabackup使用的值等待转储完成--dump-innodb-buffer-pool-timeout

该文件ib_buffer_pool存储用于更快预热缓冲​​池的表空间 ID 和页面 ID 数据。

也可以看看

MySQL文档：保存和恢复缓冲池状态

https://dev.mysql.com/doc/refman/5.7/en/innodb-preload-buffer-pool.html

--dump-innodb-buffer-pool-timeout

此选项包含xtrabackup应监视的值innodb_buffer_pool_dump_status以确定缓冲池转储是否已完成的秒数。

此选项与 结合使用 --dump-innodb-buffer-pool。默认情况下，它设置为10 秒。

--dump-innodb-buffer-pool-pct

此选项包含要转储的最近使用的缓冲池页面的百分比。

如果--dump-innodb-buffer-pool选项设置为ON ，则此选项有效。如果此选项包含一个值，则xtrabackup设置MySQL 系统变量innodb_buffer_pool_dump_pct。一旦缓冲池转储完成或停止（请参阅 参考资料 --dump-innodb-buffer-pool-timeout），MySQL系统变量的值就会恢复。

也可以看看

更改缓冲池转储的超时时间

--dump-innodb-buffer-pool-timeout

MySQL文档：innodb_buffer_pool_dump_pct 系统变量

https://dev.mysql.com/doc/refman/8.0/en/innodb-parameters.html#sysvar_innodb_buffer_pool_dump_pct

--encrypt=ENCRYPTION_ALGORITHM

此选项指示 xtrabackup 使用 ENCRYPTION_ALGORITHM 中指定的算法加密 InnoDB 数据文件的备份副本。目前支持的算法有：AES128,AES192和AES256

--encrypt-key=ENCRYPTION_KEY

要使用的适当长度的加密密钥。不建议在对机器进行不受控制的访问作为命令行的情况下使用此选项，因此可以将密钥视为进程信息的一部分。

--encrypt-key-file=ENCRYPTION_KEY_FILE

可以从中读取适当长度的原始密钥的文件的名称。该文件必须是一个简单的二进制（或文本）文件，其中包含要使用的密钥。

它直接传递给 xtrabackup 子进程。有关更多详细信息，请参阅 xtrabackup 文档。

--encrypt-threads=#

此选项指定将用于并行加密/解密的工作线程数。有关更多详细信息，请参阅xtrabackup 文档。

--encrypt-chunk-size=#

此选项指定每个加密线程的内部工作缓冲区的大小，以字节为单位。它直接传递给 xtrabackup 子进程。有关更多详细信息，请参阅xtrabackup 文档。

--export

创建导出表所需的文件。请参阅恢复单个表。

--extra-lsndir=DIRECTORY

（用于 –backup）：在此目录中保存xtrabackup_checkpoints 和xtrabackup_info文件的额外副本。

--force-non-empty-directories

指定后，它会将文件--copy-back和 --move-back选项传输到非空目录。不会覆盖现有文件。如果目标目录中已经存在需要从备份目录复制/移动的文件，它仍然会失败并显示错误。

--ftwrl-wait-timeout=SECONDS

此选项以秒为单位指定 xtrabackup在运行它之前应等待会阻塞的查询的时间。如果超时到期时仍有此类查询，则 xtrabackup 会因错误而终止。默认为，在这种情况下，它不会等待查询完成并 立即开始。支持的xtrabackup将自动使用备份锁 作为复制非 InnoDB 数据的轻量级替代方案，以避免阻塞修改 InnoDB 表的 DML 查询。FLUSH TABLES WITH READ LOCK0FLUSH TABLES WITH READ LOCKFLUSH TABLES WITH READ LOCK

--ftwrl-wait-threshold=SECONDS

此选项指定查询运行时间阈值，xtrabackup 使用该阈值来检测具有非零值的长时间运行的查询 --ftwrl-wait-timeout。 在存在此类长时间运行的查询之前不会启动。如果是 ，则此选项无效。默认值为秒。支持的 xtrabackup 将自动使用备份锁 作为复制非 InnoDB 数据的轻量级替代方案，以避免阻塞修改 InnoDB 表的 DML 查询。FLUSH TABLES WITH READ LOCK--ftwrl-wait-timeout060FLUSH TABLES WITH READ LOCK

--ftwrl-wait-query-type=all|update

此选项指定在 xtrabackup 发出全局锁之前允许完成哪些类型的查询。默认为all。

--galera-info

此选项创建xtrabackup_galera_info包含备份时本地节点状态的文件。执行Percona XtraDB Cluster的备份时应使用 Option 。当使用备份锁创建备份时，它不起作用。

--generate-new-master-key

进行回拷时生成新的主密钥。

--generate-transition-key

xtrabackup需要在准备和复制期间访问相同的密钥环文件或保管库服务器，但不应依赖于服务器密钥是否已被清除。

--generate-transition-key如果找不到用于加密的主密钥，因为它已被轮换和清除，则为 xtrabackup创建并添加到密钥环中使用的转换密钥。

--get-server-public-key

获取服务器公钥

也可以看看

MySQL文档：–get-server-public-key 选项

https://dev.mysql.com/doc/refman/5.7/en/connection-options.html#option_general_get-server-public-key

--help

当使用此选项或不使用任何选项运行时，xtrabackup会显示有关如何在命令行上运行程序的信息以及所有支持的选项和变量，并在适当的情况下使用默认值。

--history=NAME

此选项启用跟踪PERCONA_SCHEMA.xtrabackup_history表中的备份历史记录 。可以指定一个可选的历史系列名称，该名称将与正在执行的当前备份的历史记录一起放置。

--host=HOST

此选项接受一个字符串参数，该参数指定在使用 TCP/IP 连接到数据库服务器时要使用的主机。它被传递给 mysql 子进程而不做任何更改。有关详细信息，请参阅mysql --help。

--incremental

此选项告诉xtrabackup创建增量备份。它被传递给xtrabackup子进程。指定此选项时， 也可以给出--incremental-lsn或--incremental-basedir。如果两个选项都没有给出，--incremental-basedir则默认情况下将选项传递给xtrabackup，设置为备份基目录中第一个带时间戳的备份目录。

也可以看看

有关增量备份的更多信息

请参阅增量备份部分

--incremental-basedir=DIRECTORY

创建增量备份时，这是包含作为增量备份基础数据集的完整备份的目录。

--incremental-dir=DIRECTORY

准备增量备份时，此目录是增量备份与全量备份相结合进行新的全量备份的目录。

--incremental-force-scan

创建增量备份时，即使完整更改的页面位图数据可用，也强制对正在备份的实例中的数据页面进行全面扫描。

--incremental-history-name=name

此选项指定存储在PERCONA_SCHEMA.xtrabackup_history历史记录中的备份系列的名称， 以作为增量备份的基础。xtrabackup将搜索历史记录表，寻找innodb_to_lsn系列中最近（最高）、成功的备份，并将 to_lsn 值用作lsn增量备份的起始值。这将与--incremental-history-uuid、--incremental-basedir和 互斥 --incremental-lsn。如果找不到有效的 lsn（没有该名称的系列，该名称没有成功的备份）xtrabackup将返回错误。它与--incremental选项一起使用。

--incremental-history-uuid=name

此选项指定存储在增量备份中的特定历史记录 的UUIDPERCONA_SCHEMA.xtrabackup_history。 --incremental-history-name，--incremental-basedir和 --incremental-lsn。如果找不到有效的 lsn（该UUID没有成功记录），xtrabackup将返回错误。它与 –incremental 选项一起使用。

--incremental-lsn=LSN

创建增量备份时，您可以指定日志序列号 ( LSN ) 而不是指定 --incremental-basedir. 对于在 5.1 及更高版本中创建的数据库，请将LSN指定为单个 64 位整数。注意：如果指定了错误的 LSN 值（Percona XtraBackup无法检测到的用户错误），备份将无法使用。当心！

--innodb[=name]

出于 MySQL 选项兼容性的考虑，将忽略此选项。

--innodb-miscellaneous

有一大组 InnoDB 选项通常从my.cnf配置文件中读取 ，以便xtrabackup以与当前服务器相同的配置启动其嵌入式 InnoDB。您通常不需要明确指定这些。这些选项在 InnoDB 和 XtraDB 中具有相同的行为：

–innodb-adaptive-hash-index

–innodb-additional-mem-pool-size

–innodb-autoextend-increment

–innodb-buffer-pool-size

–innodb-buffer-pool-filename

–innodb-校验和算法

–innodb-校验和

–innodb-data-file-path

–innodb-data-home-dir

–innodb 目录

–innodb-doublewrite-file

–innodb-doublewrite

–innodb-extra-undoslots

–innodb-fast-checksum

–innodb-file-io-threads

–innodb-file-per-table

–innodb-flush-log-at-trx-commit

–innodb-flush-method

–innodb-io-容量

–innodb-lock-wait-timeout

–innodb-log-block-size

–innodb-log-buffer-size

–innodb-log-checksums

–innodb-log-files-in-group

–innodb-log-file-size

–innodb-log-group-home-dir

–innodb-max-dirty-pages-pct

–innodb-打开文件

–innodb 页面大小

–innodb-read-io-threads

–innodb-redo-log-encrypt

–innodb-撤消目录

–innodb-undo-log-encrypt

–innodb-undo-tablespaces`

–innodb-use-native-aio

–innodb-write-io-threads

--keyring-file-data=FILENAME

密钥环文件的路径。将此选项与 --xtrabackup-plugin-dir.

--kill-long-queries-timeout=SECONDS

此选项指定xtrabackup在启动和终止阻止它的那些查询之间等待的秒数。默认为 0 秒，这意味着xtrabackup不会尝试终止任何查询。要使用此选项，xtrabackup 用户应具有 和权限。在支持的情况下，xtrabackup 自动使用备份锁 作为复制非 InnoDB 数据的轻量级替代方案，以避免阻塞修改 InnoDB 表的 DML 查询。FLUSH TABLES WITH READ LOCKPROCESSSUPERFLUSH TABLES WITH READ LOCK

--kill-long-query-type=all|select

此选项指定应终止哪些类型的查询以解除对全局锁的阻塞。默认为“全部”。

--lock-ddl

问题如果它是由服务器支持（否则使用 ），并在备份开始阻止所有DDL操作。LOCK TABLES FOR BACKUPLOCK INSTANCE FOR BACKUP

笔记

在Percona XtraBackup 8.0.22-15.0之前，使用安全从属备份会在 InnoDB 表之后和非 InnoDB 表备份之前停止 SQL 副本线程。

从Percona XtraBackup 8.0.22-15.0 开始，使用安全从属备份选项会在复制 InnoDB 文件之前停止 SQL 副本线程。

--lock-ddl-per-table

在 xtrabackup 开始复制每个表之前锁定每个表的 DDL，直到备份完成。

从Percona XtraBackup 8.0.15 开始，不推荐使用–lock-ddl-per-table选项。请改用 –lock-ddl选项。

--lock-ddl-timeout

如果或未在给定超时内返回，则中止备份。LOCK TABLES FOR BACKUPLOCK INSTANCE FOR BACKUP

--log

MySQL忽略此选项

--log-bin

日志序列的基本名称。

--log-bin-index=name

保存二进制日志文件名称的文件。

--log-copy-interval=#

此选项以毫秒为单位指定日志复制线程完成的检查之间的时间间隔（默认为 1 秒）。

--login-path

从登录文件中读取给定的路径。

--move-back

将先前备份中的所有文件从备份目录移动到其原始位置。由于此选项会删除备份文件，因此必须谨慎使用。

--no-backup-locks

Explicity 禁用--backup-locks默认启用的选项。

--no-defaults

默认选项仅从登录文件中读取。

--no-lock

使用此选项禁用表锁定。仅当您的所有表都是 InnoDB 并且您不关心 备份的二进制日志位置时才使用它。如果正在执行任何语句或在非 InnoDB 表（这包括mysql数据库中的系统 MyISAM 表）上发生任何更新，则 不应使用此选项，否则可能导致不一致的备份。支持的xtrabackup将自动使用备份锁 作为轻量级的替代方案FLUSH TABLES WITH READ LOCKDDLFLUSH TABLES WITH READ LOCK复制非 InnoDB 数据以避免阻塞修改 InnoDB 表的 DML 查询。如果您因为备份无法获取锁而考虑使用它，这可能是因为传入的复制事件阻止了锁的成功。请尝试使用--safe-slave-backup暂时停止复制副本线程，这可能有助于备份成功，您不需要使用此选项。

xtrabackup_binlog_info不会在使用 –no-lock 选项时创建（因为可能不一致），但在某些条件下可以改为使用以获得一致的二进制日志坐标，如使用二进制日志中所述。SHOW MASTER STATUSxtrabackup_binlog_pos_innodb

--no-version-check

此选项禁用版本检查。如果不传递此选项，则在该模式下运行xtrabackup时，会隐式启用自动版本检查--backup。要禁用版本检查，您应该--no-version-check在调用 xtrabackup时明确传递该选项。

启用自动版本检查后，xtrabackup在创建服务器连接后在备份阶段对服务器执行版本检查。xtrabackup向服务器发送以下信息：

MySQL 风格和版本

操作系统名称

Percona 工具包版本

Perl 版本

每条信息都有一个唯一的标识符。这是一个 MD5 哈希值，Percona Toolkit 使用它来获取有关如何使用它的统计信息。这是一个随机的 UUID；不会收集或存储客户信息。

--open-files-limit=#

使用 setrlimit() 保留的最大文件描述符数。

--parallel=#

此选项指定创建备份时用于并发复制多个数据文件的线程数。默认值为 1（即无并发传输）。在Percona XtraBackup 2.3.10 和更新版本中，此选项可以与--copy-back并行复制用户数据文件的选项一起使用（重做日志和系统表空间在主线程中复制）。

--password=PASSWORD

此选项指定连接到数据库时使用的密码。它接受一个字符串参数。有关详细信息，请参阅mysql --help。

--plugin-load

要加载的插件列表。

--port=PORT

此选项接受一个字符串参数，该参数指定使用 TCP/IP 连接到数据库服务器时要使用的端口。它被传递给 mysql子进程而不做任何更改。有关详细信息，请参阅mysql --help。

--prepare

使xtrabackup对使用 创建的备份执行恢复 --backup，以便它可以使用。请参阅 准备备份。

--print-defaults

打印程序参数列表并退出。必须作为命令行上的第一个选项给出。

--print-param

使xtrabackup打印出可用于将数据文件复制回其原始位置以恢复它们的参数。

--read-buffer-size

设置数据文件读取缓冲区大小，给定值按比例放大到页面大小。默认值为 10Mb。

--rebuild-indexes

在紧凑备份中重建索引。此选项仅在提供--prepare和--rebuild-threads选项时有效 。

--rebuild-threads=#

使用给定数量的线程在紧凑备份中重建索引。此选项仅对--prepare和 --rebuild-indexes选项有效。

--remove-original

在Percona XtraBackup 2.4.6 中实现，指定此选项将删除解密和解压后的.qp,.xbcrypt和.qp.xbcrypt文件。

--rocksdb-datadir

RocksDB 数据目录

--rocksdb-wal-dir

RocksDB WAL 目录。

--rocksdb-checkpoint-max-age

备份完成时，检查点不能早于此秒数。

--rocksdb-checkpoint-max-count

即使在此数量的检查点之后仍未满足检查点年龄要求，也请完成备份。

--rollback-prepared-trx

强制回滚准备好的 InnoDB 事务。

--rsync

使用rsync实用程序来优化本地文件传输。指定此选项时，xtrabackup使用rsync复制所有非 InnoDB 文件，而不是为每个文件生成单独的cp，这对于具有大量数据库或表的服务器来说会快得多。此选项不能与 一起使用--stream。

--safe-slave-backup

当指定时，xtrabackup 将在运行前停止副本 SQL 线程并等待开始备份，直到 in为零。如果没有打开的临时表，则进行备份，否则将启动和停止 SQL 线程，直到没有打开的临时表。如果几秒钟后没有变为零， 备份将失败。备份完成后，复制 SQL 线程将重新启动。此选项是为了处理复制临时表 而实现的，对于 Row-Based-Replication 不是必需的。FLUSH TABLES WITH READ LOCKSlave_open_temp_tablesSHOW STATUSSlave_open_temp_tables--safe-slave-backup-timeout

--safe-slave-backup-timeout=SECONDS

--safe-slave-backup应该等待 多少秒Slave_open_temp_tables变为零。默认为 300 秒。

--secure-auth

如果客户端使用旧的（4.1.1 之前的）协议，则拒绝客户端连接到服务器。（默认启用；使用 –skip-secure-auth 禁用。）

--server-id=#

正在备份的服务器实例。

--server-public-key-path

PEM 格式的服务器公共 RSA 密钥的文件路径。

也可以看看

MySQL文档：–server-public-key-path 选项

https://dev.mysql.com/doc/refman/8.0/en/connection-options.html#option_general_server-public-key-path

--skip-tables-compatibility-check

见--tables-compatibility-check。

--slave-info

此选项在备份复制副本服务器时很有用。它打印源服务器的二进制日志位置。它还将二进制日志坐标xtrabackup_slave_info作为 命令写入文件。可以通过在此备份上启动副本服务器并使用保存在文件中的二进制日志位置发出命令来设置此源的新副本。CHANGE MASTERCHANGE MASTERxtrabackup_slave_info

--socket

此选项接受一个字符串参数，该参数指定在使用 UNIX 域套接字连接到本地数据库服务器时要使用的套接字。它被传递给 mysql 子进程而不做任何更改。有关详细信息，请参阅mysql --help。

--ssl

启用安全连接。更多信息可以在–ssl MySQL 服务器文档中找到。

--ssl-ca

包含受信任 SSL CA 列表的文件的路径。更多信息可以在–ssl-ca MySQL 服务器文档中找到。

--ssl-capath

包含 PEM 格式的可信 SSL CA 证书的目录路径。更多信息可以在–ssl-capath MySQL 服务器文档中找到。

--ssl-cert

包含 PEM 格式的 X509 证书的文件的路径。更多信息可以在–ssl-cert MySQL 服务器文档中找到。

--ssl-cipher

用于连接加密的允许密码列表。更多信息可以在–ssl-cipher MySQL 服务器文档中找到。

--ssl-crl

包含证书吊销列表的文件的路径。更多信息可以在–ssl-crl MySQL 服务器文档中找到。

--ssl-crlpath

包含证书吊销列表文件的目录路径。更多信息可以在–ssl-crlpath MySQL 服务器文档中找到。

--ssl-fips-mode

SSL FIPS 模式（仅适用于 OpenSSL）；允许的值为：OFF、ON、 STRICT。

--ssl-key

包含 PEM 格式的 X509 密钥的文件路径。更多信息可以在–ssl-key MySQL 服务器文档中找到。

--ssl-mode

连接到服务器的安全状态。更多信息可以在 –ssl-mode MySQL 服务器文档中找到。

--ssl-verify-server-cert

根据连接到服务器时使用的主机名验证服务器证书公用名值。更多信息可以在 –ssl-verify-server-cert MySQL 服务器文档中找到。

--stats

使xtrabackup扫描指定的数据文件并打印出索引统计信息。

--stream=FORMAT

以指定格式将所有备份文件流式传输到标准输出。目前，此选项仅支持xbstream格式。

--strict

如果指定了此选项，则在传递无效参数时xtrabackup 会失败并显示错误。

--tables=name

与databasename.tablename格式中的完整表名匹配的正则表达式 。如果名称匹配，则备份该表。请参阅部分备份。

--tables-compatibility-check

启用引擎兼容性警告。默认值为开。要禁用引擎兼容性警告，请使用 --skip-tables-compatibility-check.

--tables-exclude=name

按正则表达式过滤表名。操作方式与 相同--tables，但匹配的名称从备份中排除。请注意，此选项的优先级高于 --tables。

--tables-file=name

每行包含一个表名的文件，采用 databasename.tablename 格式。备份将限于指定的表。

--target-dir=DIRECTORY

此选项指定备份的目标目录。如果该目录不存在，则xtrabackup会创建它。如果目录确实存在并且为空，则xtrabackup将成功。 但是，xtrabackup不会覆盖现有文件；它将失败并显示操作系统错误 17, 。file exists

如果此选项是相对路径，则它被解释为相对于执行xtrabackup的当前工作目录。

为了进行备份，你需要READ，WRITE以及EXECUTE 在该目录文件系统级别的权限，您提供的价值--target-dir。

--innodb-temp-tablespaces-dir=DIRECTORY

临时表空间文件所在的目录，此路径可以是绝对路径。

--throttle=#

此选项限制每秒复制的块数。块大小为 10 MB。要将带宽限制为10 MB/s，请将选项设置为1 : –throttle=1。

也可以看看

有关如何限制备份的更多信息

限制备份

--tls-ciphersuites

要使用的 TLS v1.3 密码。

--tls-version

要使用的 TLS 版本，允许的值为：TLSv1、TLSv1.1、 TLSv1.2、TLSv1.3。

--tmpdir=name

指定备份期间将用于存储临时文件的目录

--transition-key=name

此选项用于在不访问密钥环保管库服务器的情况下启用备份处理。在这种情况下，xtrabackup从指定的密码派生 AES 加密密钥，并使用它来加密正在备份的表空间的表空间密钥。

如果--transition-key没有任何值，xtrabackup会要求它。应为--prepare命令指定相同的密码。

--use-memory

此选项会影响为准备备份--prepare或使用 分析统计信息而分配的内存 量 --stats。它的目的类似于innodb_buffer_pool_size。它与 Oracle 的 InnoDB 热备份工具中类似命名的选项的作用不同。默认值是 100MB，如果你有足够的可用内存，1GB 到 2GB 是一个很好的推荐值。支持多个提供单位（例如 1MB、1M、1GB、1G）。

--user=USERNAME

如果不是当前用户，此选项指定连接到服务器时使用的 MySQL 用户名。该选项接受一个字符串参数。有关详细信息，请参阅 mysql –help。

-v

看 --version

--version

此选项打印xtrabackup版本并退出。

--xtrabackup-plugin-dir=DIRNAME

包含keyring插件的目录的绝对路径。

也可以看看