xtrabackup选项参考¶

属性的所有命令行选项的文档xtrabackup二进制文件。

选项¶

-apply-log-only¶

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

- backup¶

做个备份，放进去xtrabackup——target-dir。看到创建备份。

-backup-lock-retry-count =¶

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

-backup-lock-timeout =¶

试图获取元数据锁的超时时间(以秒为单位)。

-binlog-info¶

此选项控制如何雷竞技下载官网Percona XtraBackup应检索对应于备份的服务器二进制日志坐标。可能的值为从，在，无锁的和汽车。看到雷竞技下载官网Percona XtraBackup无锁二进制日志信息手册页获取更多信息。

-check-privileges¶

此选项检查是否雷竞技下载官网Percona XtraBackup拥有所有必需的特权。如果当前操作需要缺少特权，则该操作将终止并打印一条错误消息。如果当前操作不需要丢失特权，但其他一些XtraBackup操作可能需要该特权，则该进程不会中止，并打印警告。

xtrabackup:错误:缺少必要的特权锁表*。* xtrabackup: Warning: missing required privilege of REPLICATION CLIENT on *.* .

请关闭那些文件¶

不要打开文件。当xtrabackup打开一个表空间，它通常不会关闭它的文件句柄来正确地管理DDL操作。但是，如果表空间的数量很大，无法满足任何限制，则可以选择在不再访问文件句柄时关闭它们。雷竞技下载官网Percona XtraBackup启用此选项可产生不一致的备份。使用该选项的风险自负。

紧凑的¶

通过跳过次要索引页创建紧凑备份。

压缩¶

这个选项告诉我们xtrabackup使用指定的压缩算法压缩所有输出数据，包括事务日志文件和元数据文件。目前唯一支持的算法是quicklz。生成的文件具有qpress归档格式。

每一个\ * .qpxtrabackup生成的文件本质上是一个单文件qpress归档文件，可以使用qpress文件存储服务器。

-compress-chunk-size =¶

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

-compress-threads =¶

此选项指定使用的工作线程数xtrabackup用于并行数据压缩。此选项默认为1。平行压缩(xtrabackup——compress-threads)可与并行文件复制(xtrabackup——平行）.例如,——parallel=4——compress——compress-threads=2将创建4个I/O线程来读取数据并将其输送到2个压缩线程。

复制回去¶

将以前备份目录中的所有文件复制到它们的原始位置。此选项不会复制现有文件，除非xtrabackup——force-non-empty-directories选项。

核心文件¶

写核心致命信号。

数据库=¶

此选项指定应备份的数据库和表的列表。该选项接受表单的列表“databasename1。table_name1] databasename2[。Table_name2]……”。

-databases-exclude =名字¶

排除基于名称的数据库。此选项的操作方式与xtrabackup——数据库，但匹配的名称将从备份中排除。注意，该选项的优先级高于xtrabackup——数据库。

-databases-file =¶

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

-datadir =目录¶

备份的源目录。该目录应该与您的MySQL如果存在的话，它应该从my。cnf读取;否则，必须在命令行上指定它。

当与xtrabackup——复制回去或xtrabackup——搬回来选项,xtrabackup——datadir目标目录。

连接到服务器后，要执行备份，您将需要读和执行服务器datadir中文件系统级别的权限。

-debug-sleep-before-unlock =¶

Xtrabackup测试套件使用的仅限调试的选项。

解压缩¶

方法解压所有文件.qp控件的备份中的扩展xtrabackup——压缩选择。的xtrabackup——平行选项将允许多个文件同时解密。要解压缩，必须安装qpress实用程序并在路径内访问。雷竞技下载官网Percona XtraBackup不会自动删除压缩文件。要清理备份目录，用户应该使用xtrabackup——remove-original选择。

解密是加密算法¶

在以前的备份中解密所有扩展名为.xbcrypt的文件xtrabackup——加密选择。的xtrabackup——平行选项将允许多个文件同时解密。雷竞技下载官网Percona XtraBackup不会自动删除加密文件。要清理备份目录，用户应使用xtrabackup——remove-original选择。

-defaults-extra-file =(我的。CNF]¶

读取全局文件后再读取此文件。该文件必须是命令行上的第一个选项。

-defaults-file =(我的。CNF]¶

只从给定文件中读取默认选项。该文件必须是命令行上的第一个选项，并且是一个真实的文件，不能是符号链接。

-defaults-group =组名称¶

此选项设置应从配置文件中读取的组。方法使用该选项——默认组并且是必须的

mysqld_multi部署。

-defaults-group-suffix =¶

阅读常用的选项组以及带有concat(group, suffix)的组。

-dump-innodb-buffer-pool¶

此选项控制是否应该对缓冲池内容进行新的转储。

与——dump-innodb-buffer-pool，xtrabackup在提供状态变量的备份开始时，向服务器发出启动缓冲池转储的请求(需要一些时间才能完成，并且在后台完成)innodb_buffer_pool_dump_status报告转储已完成。

美元xtrabackup——备份——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数据。

-dump-innodb-buffer-pool-timeout¶

此选项包含所需的秒数xtrabackup应该监控的价值raybet雷竞技竞猜在线官网innodb_buffer_pool_dump_status以确定缓冲池转储是否已完成。

此选项与——dump-innodb-buffer-pool。缺省值是10秒。

-dump-innodb-buffer-pool-pct¶

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

如果-dump-innodb-buffer-pool option设置为ON，该选项生效。如果该选项包含一个值，xtrabackup设置MySQL系统变量innodb_buffer_pool_dump_pct。一旦缓冲池转储完成或停止(参见-dump-innodb-buffer-pool-timeout)，MySQL恢复系统变量。

加密= ENCRYPTION_ALGORITHM¶

该选项指示xtrabackup使用ENCRYPTION_ALGORITHM中指定的算法加密InnoDB数据文件的备份副本。它直接传递给xtrabackup子进程。看到xtrabackup文档欲知详情。

-encrypt-key = ENCRYPTION_KEY¶

该选项指示xtrabackup使用给定的ENCRYPTION_KEY当使用xtrabackup——加密选择。它直接传递给xtrabackup子进程。查看xtrabackup文档欲知详情。

-encrypt-key-file = ENCRYPTION_KEY_FILE¶

该选项指示xtrabackup使用存储在给定ENCRYPTION_KEY_FILE当使用xtrabackup——加密选择。它直接传递给xtrabackup子进程。查看xtrabackup文档欲知详情。

-encrypt-threads =¶

此选项指定用于并行加密/解密的工作线程的数量。查看xtrabackup文档欲知详情。

-encrypt-chunk-size =¶

此选项指定每个加密线程的内部工作缓冲区的大小，以字节为单位。它直接传递给xtrabackup子进程。看到xtrabackup文档欲知详情。

出口¶

创建导出表所需的文件。看到恢复单个表。

-extra-lsndir =目录¶

(for -backup):保存一个额外的xtrabackup_checkpoints和xtrabackup_info该目录下的文件。

-force-non-empty-directories¶

当指定时，它使:option ' xtrabackup -copy-back '和xtrabackup——搬回来选项传输文件到非空目录。现有文件不会被覆盖。如果需要从备份目录复制/移动的文件已经存在于目标目录中，它仍然会失败并报错。

-ftwrl-wait-timeout =秒¶

该选项指定xtrabackup应该等待将阻塞查询的时间(以秒为单位)用读锁刷新表在运行之前。如果超时到期时仍然存在这样的查询，xtrabackup将终止并报错。默认为0，在这种情况下，它不会等待查询完成并开始用读锁刷新表立即。哪里支持(Percona Serv雷竞技下载官网er 5.6+) xtrabackup将自动使用备份锁作为轻量级的替代品用读锁刷新表复制非InnoDB数据以避免阻塞修改InnoDB表的DML查询。

-ftwrl-wait-threshold =秒¶

该选项指定查询运行时阈值，xtrabackup使用该阈值检测xtrabackup -ftwrl-wait-timeout值非零的长时间运行的查询。用读锁刷新表直到存在此类长时间运行的查询时才启动。如果xtrbackup -ftwrl-wait-timeout为，则此选项无效0。默认值为60秒。哪里支持(Percona Serv雷竞技下载官网er 5.6+) xtrabackup将自动使用备份锁作为轻量级的替代品用读锁刷新表复制非InnoDB数据以避免阻塞修改InnoDB表的DML查询。

-ftwrl-wait-query-type = |更新¶

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

-galera-info¶

此选项创建xtrabackup_galera_info包含备份时本地节点状态的文件。选项在执行Percona XtraDB Cluster备份时应使用。雷竞技下载官网当使用备份锁创建备份时，此选项无效。

-generate-new-master-key¶

在执行复制回操作时生成一个新的主密钥。

历史=名字¶

中的备份历史记录雷竞技下载官网PERCONA_SCHEMA.xtrabackup_history表格可以指定一个可选的历史系列名称，该名称将与正在进行备份的历史记录放在一起。

增量¶

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

-incremental-basedir =目录¶

此目录包含完全备份，这是用于增量备份的基本数据集。

-incremental-dir =目录¶

在准备增量备份时，此目录是将增量备份与完全备份合并以生成新的完全备份的目录。

-incremental-force-scan¶

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

-incremental-history-name =名字¶

中存储的备份系列的名称雷竞技下载官网PERCONA_SCHEMA.xtrabackup_history增量备份所依据的历史记录。xtrabackup在历史表中搜索系列中最近的(最高的innodb_to_lsn)、成功的备份，并将to_lsn的值作为增量备份的起始LSN。这将是相互排斥的xtrabackup——incremental-history-uuid，xtrabackup——incremental-basedir和xtrabackup——incremental-lsn。如果无效LSN(没有该名称的系列，没有该名称的成功备份)xtrabackup返回一个错误。它与the连用xtrabackup——增量选择。

-innodb-checksum-algorithm =名字¶

InnoDB用来计算页面校验和的算法。可选算法有:CRC32、INNODB、NONE、STRICT_CRC32、STRICT_INNODB、STRICT_NONE

-incremental-history-uuid = UUID¶

此选项指定UUID中存储的特定历史记录雷竞技下载官网PERCONA_SCHEMA.xtrabackup_history增量备份的基础xtrabackup——incremental-history-name，xtrabackup——incremental-basedir和xtrabackup——incremental-lsn。如果没有找到有效的LSN(没有该UUID的成功记录)xtrabackup返回一个错误。选项一起使用xtrabackup——增量选择。

-incremental-lsn = LSN¶

创建增量备份时，可以指定日志序列号(LSN)，而不是详细说明xtrabackup——incremental-basedir。对于在5.1及更高版本中创建的数据库，将LSN指定为单个64位整数。注意:如果指定了错误的LSN值(用户错误雷竞技下载官网Percona XtraBackup无法检测)，备份将不可用。小心!

-innodb-log-arch-dir =目录¶

此选项用于指定存放归档日志的目录。它只能与xtrabackup——准备选择。

-innodb-miscellaneous¶

大量的InnoDB选项通常从my.cnf配置文件，以便xtrabackup以与当前服务器相同的配置启动嵌入式InnoDB。通常不需要显式地指定这些参数。这些选项与它们在InnoDB或XtraDB中的行为相同。具体如下:

——innodb-adaptive-hash-index——innodb- addial -mem-pool-size——innodb-autoextend-increment——innodb-buffer-pool-size——innodb-checksum——innodb-data-file-path——innodb-data-home-dir——innodb-doublewrite-file——innodb-extra-undoslots——innodb-fast-checksum——innodb-file-io-threads——innodb-file-per-table——innodb-flush-log-at-trx-commit——innodb-flush-method——innodb-force-recovery——innodb-io-capacity——innodb-lock-wait-timeout——innodb-log-buffer-size——innodb-log-files-in-group——innodb-log-file-size——innodb-log-group-home-dir——innodb-max-dirty-pages-pct——innodb-open-files——innodb-page-size——innodb-read-io-threads——innodb-write-io-threads

-innodb-undo-directory =名字¶

undo表空间的目录位置。路径是绝对的。

-innodb-undo-tablespace =¶

要使用的undo表空间的数量。

-keyring-file-data =文件名¶

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

-kill-long-queries-timeout =¶

这个选项指定了启动FLUSH TABLES WITH READ LOCK和杀死那些阻塞它的查询之间xtrabackup等待的秒数。默认为0(0)秒，这意味着xtrabackup不会试图终止任何查询。

-kill-long-query-type =选择|¶

此选项指定应该杀死哪些类型的查询以解除全局锁的阻塞。默认值为选择。

-lock-ddl¶

问题为备份锁定表如果备份开始时服务器支持，则阻止所有DDL操作。

-lock-ddl-per-table¶

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

-lock-ddl-timeout¶

如果为备份锁定表在给定超时内未返回，则中止备份。

-log-bin[=名称]¶

日志序列的基名称。

-log-copy-interval =¶

此选项指定日志复制线程检查之间的时间间隔，单位为毫秒(默认为1秒)。

登录路径=¶

从登录文件中读取此路径。

向后移动¶

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

-no-backup-locks¶

此选项控制是否使用备份锁而不是用读锁刷新表在备份阶段。服务器上必须支持备份锁，该选项才会起作用。

该选项默认启用。使用——no-backup-locks。

就不会发生违约¶

不要从任何选项文件中读取默认选项。必须作为命令行中的第一个选项。

没有锁¶

此选项自动使用备份锁，并禁用表锁，作为一种轻量级的替代方案用读锁刷新表复制非InnoDB数据以避免阻塞修改InnoDB表的DML查询。

仅在以下情况下使用此选项所有表是InnoDB和你不在乎关于备份二进制日志的位置。

如果任何DDL语句将被执行或任何非innodb表正在被更新(包括mysql数据库中的MyISAM表)，请不要使用此选项。在这些条件下使用此选项可能会导致不一致的备份。

如果备份无法获得锁，而您计划使用此选项，则失败可能是由于传入的复制事件阻止了锁的成功。试——safe-slave-backup暂时停止复制从线程。

的xtrabackup-binlog-info时未创建——没有锁使用是因为显示主机状态可能不一致。在某些条件下，xtrabackup_binlog_pos_innodb可用于获得一致的binlog坐标，如在使用二进制日志。

-no-version-check¶

此选项将禁用版本检查。中运行xtrabackup时，自动版本检查将隐式启用——备份模式。若要禁用版本检查，请显式传递——no-version-check调用xtrabackup时的选项。

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

• MySQL风格和版本

• 操作系统名称

• 雷竞技下载官网Percona Toolkit版本

• Perl版本

每条信息都有一个唯一的标识符，它是一个MD5哈希值，Percona Toolkit使用它来获取关于它如何使用的统计信息。雷竞技下载官网该值是一个随机UUID;没有收集或存储客户端信息。

-open-files-limit =¶

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

平行=¶

此选项指定在创建备份时用于并发复制多个数据文件的线程数。默认值为1(即没有并发传输)。在雷竞技下载官网Percona XtraBackup2.3.10或更新版本，此选项可用于xtrabackup——复制回去并行复制用户数据文件的选项(重做日志和系统表空间在主线程中复制)。

密码=密码¶

此选项指定连接到数据库时使用的密码。它接受一个字符串参数。看到mysql——帮助获取详细信息。

准备¶

使xtrabackup对创建的备份执行恢复xtrabackup——备份，这样就可以使用了。看到准备备份。

-print-defaults¶

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

-print-param¶

使xtrabackup打印出将数据文件复制回原始位置以恢复它们的参数。看到使用xtrabackup进行脚本备份。

-read-buffer-size (= #)¶

设置读缓冲区大小。给定的值被放大到页面大小。默认为10MB。

使用此变量将xbcloud/xbstream块大小从默认值10MB增加。

请注意:当您使用加密时，要调整xbcloud/xbstream块大小，请同时调整——encrypt-chunk-size和——read-buffer-size变量。

美元xtrabackup…——read-buffer-size=1G | xbcloud put…

-rebuild-indexes¶

应用日志后，在InnoDB表中重建二级索引。只能和-prepare一起使用。

-rebuild-threads =¶

此选项定义了在压缩备份中重新构建索引的线程数。仅与——准备和——rebuild-indexes。

-redo-log-version =¶

备份的重做日志版本。仅用于——准备。

-reencrypt-for-server-id = ¶

使用此选项以不同于加密备份所在服务器的server_id启动服务器实例，如复制副本或Galera节点。当使用此选项时，xtrabackup将作为准备步骤，根据新的server_id生成一个带有ID的新主密钥，将其存储到keyring文件中，并重新加密表空间头中的表空间密钥。应该传递该选项——准备(最后一步)。

-remove-original¶

中实现雷竞技下载官网Percona XtraBackup2.4.6，指定此选项时将删除.qp，.xbcrypt和.qp.xbcrypt解密解压缩后的文件。

rsync¶

使用rsync实用程序优化本地文件传输。

当指定此选项时，xtrabackup使用rsync复制所有非innodb文件，而不是为每个文件生成一个单独的复制命令。对于具有大量数据库或表的服务器，此选项更快。

此选项不能用于——流。

-safe-slave-backup¶

指定后，xtrabackup将在运行之前停止副本SQL线程用读锁刷新表并等待开始备份，直到Slave_open_temp_tables在显示状态是零。如果没有打开的临时表，就会发生备份;否则SQL线程将被启动和停止，直到没有打开的临时表。备份将失败Slave_open_temp_tables在xtrbackupup -safe-slave-backup-timeout秒后不会变为零。备份完成后，将重新启动副本SQL线程。实现此选项是为了处理复制临时表并且在基于行的复制中不是必需的。

-safe-slave-backup-timeout =秒¶

多少秒xtrabackup——safe-slave-backup应该等待Slave_open_temp_tables变成零。缺省值是300秒。

-secure-auth¶

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

服务器id =¶

正在备份的服务器实例。

-server-public-key-path =名字¶

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

-skip-tables-compatibility-check¶

该选项禁用引擎兼容性警告。

-slave-info¶

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

ssl¶

启用安全连接。有关详情，请参阅sslMySQL服务器文档。

-ssl-ca¶

文件的路径，其中包含受信任SSL ca的列表。有关详情，请参阅-ssl-caMySQL服务器文档。

-ssl-capath¶

PEM格式的受信任SSL CA证书所在的路径。有关详情，请参阅-ssl-capathMySQL服务器文档。

-ssl-cert¶

PEM格式的X509证书所在文件的路径。有关详情，请参阅-ssl-certMySQL服务器文档。

ssl cipher¶

用于连接加密的允许密码列表。有关详情，请参阅ssl cipherMySQL服务器文档。

-ssl-crl¶

包含证书吊销列表的文件路径。有关详情，请参阅-ssl-crlMySQL服务器文档。

-ssl-crlpath¶

证书吊销列表文件所在目录的路径。有关详情，请参阅-ssl-crlpathMySQL服务器文档。

ssl密钥¶

PEM格式的X509密钥所在文件路径。有关详情，请参阅ssl密钥MySQL服务器文档。

-ssl-mode¶

连接到服务器的安全状态。有关详情，请参阅-ssl-modeMySQL服务器文档。

-ssl-verify-server-cert¶

验证服务器证书Common Name值与连接到服务器时使用的主机名。有关详情，请参阅-ssl-verify-server-certMySQL服务器文档。

统计数据¶

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

流=名字¶

将所有备份文件以指定格式流到标准输出。目前支持的格式为xbstream和焦油。

表=名字¶

一个正则表达式，完整的表名，在databasename.tablename格式，表示匹配。如果名称匹配，则备份该表。看到部分备份。

-tables-compatibility-check¶

此选项启用引擎兼容性警告。

默认值为在。使用——skip-tables-compatibility-check禁用。

-tables-exclude =名字¶

通过regexp筛选表名。操作方式与xtrabackup——表，但匹配的名称将不进行备份。注意，该选项的优先级高于xtrabackup——表。

文件名称=¶

在databasename中每行包含一个表名的文件。表的格式。备份将仅限于指定的表。看到使用xtrabackup进行脚本备份。

-target-dir =目录¶

此选项指定备份的目标目录。如果目录不存在，xtrabackup创建它。如果目录存在且为空，xtrabackup会成功。xtrabackup不会覆盖现有文件;但是它会因为操作系统错误17而失败，文件是否存在。

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

为了执行备份，您需要读，写,执行的值提供的目录的文件系统级权限——target-dir。

节流=¶

此选项限制每秒复制的数据块数量。块大小为10 MB。

将带宽限制为10 MB /秒，设置为1：——节流= 1。

tls =名字¶

要使用的TLS版本。允许的值如下:

• TLSv1

• TLSv1.1

• TLSv1.2

tmpdir =名字¶

此选项目前除了打印正确的tmpdir参数外，没有用于其他任何事情xtrabackup——print-param使用。

-to-archived-lsn = LSN¶

此选项用于指定准备备份时应用日志的LSN。它只能与xtrabackup——准备选择。

-transition-key¶

此选项用于启用在不访问密匙环保险库服务器的情况下处理备份。此时，xtrabackup将从指定的passphrase中导出AES加密密钥，用于加密所备份表空间的表空间密钥。

如果——transition-key < xtrbackup -transition-key > .使用实例没有任何值，xtrabackup会请求它。属性指定相同的密码短语xtrabackup——准备命令。

使用内存=¶

此选项会影响分配多少内存，类似于通过innodb_buffer_pool_size。此选项仅与——准备阶段或在分析统计数据时使用——统计数据。默认值为100MB。建议设置为1GB ~ 2GB。支持多个单位(例如，1MB, 1M, 1GB, 1G)。

用户=用户名¶

此选项指定连接到服务器时使用的MySQL用户名(如果不是当前用户)。该选项接受一个字符串参数。详见mysql -help。

- version¶

这个选项打印xtrabackup版本并退出。

-xtrabackup-plugin-dir =目录名¶

控件所在目录的绝对路径密匙环插件。