innobackupex2.4选项参考

该innobackupex2.4选项参考¶

此页面记录了innobackupex的所有命令行选项。

选项

--apply-log

BACKUP-DIR通过应用xtrabackup_logfile位于同一目录中的名为的事务日志文件来 准备备份。此外，创建新的事务日志。在进行备份时，从innobackupexbackup-my.cnf创建的文件中读取InnoDB配置 。innobackupex -apply-log 默认使用InnoDB配置 ，如果指定，则使用-defaults-file。在这种情况下InnoDB的配置是指影响数据格式的服务器变量，即，等位置相关的变量，如或innodb_data_file_path`总是被-apply日志忽略，所以准备一个备份总是从备份目录中的数据文件的工作，而不是任何外部的。backup-my.cnfinnodb_page_sizeinnodb_log_block_sizeinnodb_log_group_home_dir

--backup-locks

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

--no-backup-locks

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

--close-files

不要保持文件打开。此选项直接传递给xtrabackup。当xtrabackup打开表空间时，它通常不会关闭其文件句柄以正确处理DDL操作。但是，如果表空间的数量非常大并且不能满足任何限制，则可以选择在不再访问文件句柄时关闭它们。Percona XtraBackup 可以在启用此选项的情况下生成不一致的备份。使用风险由您自己承担。

--compact

创建一个紧凑的备份，省略所有二级索引页。此选项直接传递给xtrabackup。有关详细信息，请参阅xtrabackup 文档。

--compress

此选项指示xtrabackup压缩InnoDB数据文件的备份副本。它直接传递给xtrabackup子进程。有关详细信息，请参阅 xtrabackup 文档。

--compress-threads=#

此选项指定将用于并行压缩的工作线程数。它直接传递给xtrabackup子进程。有关详细信息，请参阅xtrabackup 文档。

--compress-chunk-size=#

此选项指定每个压缩线程的内部工作缓冲区的大小（以字节为单位）。它直接传递给xtrabackup子进程。默认值为64K。有关详细信息，请参阅 xtrabackup 文档。

--copy-back

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

--databases=LIST

此选项指定innobackupex应备份的数据库列表。该选项接受包含要备份的数据库列表的字符串参数或文件路径。该列表的格式为“databasename1 [.table_name1] databasename2 [.table_name2]”。。”。如果未指定此选项， 则将备份包含MyISAM和InnoDB表的所有数据库。请确保-databases包含所有InnoDB数据库和表，以便还备份所有innodb.frm文件。如果列表很长，可以在文件中指定，并且可以指定文件的完整路径而不是列表。（参见选项-tables-file。）

--decompress

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

--decrypt=ENCRYPTION-ALGORITHM

在先前使用-encrypt选项创建的备份中解密具有.xbcrypt扩展名的所有文件。该选项将允许同时解密和/或解压缩多个文件。innobackupex --parallel

--defaults-file=[MY.CNF]

此选项接受一个字符串参数，该参数指定要从中读取默认MySQL选项的文件。必须作为命令行上的第一个选项。

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

此选项指定从标准defaults-file之前读取默认MySQL选项的额外文件。必须作为命令行上的第一个选项。

--defaults-group=GROUP-NAME

此选项接受一个字符串参数，该参数指定应从配置文件中读取的组。如果您使用mysqld_multi，则需要这样做。这也可用于指示除mysqld和xtrabackup之外的组。

--encrypt=ENCRYPTION_ALGORITHM

此选项指示xtrabackup使用ENCRYPTION_ALGORITHM中指定的算法加密InnoDB数据文件的备份副本。它直接传递给xtrabackup子进程。有关更多详细信息，请参阅xtrabackup 文档。

目前，以下算法的支持：AES128， AES192和AES256。

--encrypt-key=ENCRYPTION_KEY

当使用-encrypt选项时，此选项指示xtrabackup使用给定的适当长度的加密密钥作为ENCRYPTION_KEY。它直接传递给xtrabackup子进程。有关更多详细信息，请参阅xtrabackup 文档。

如果命令行无法控制访问机器，则不建议使用此选项，因此可以将密钥视为流程信息的一部分。

--encrypt-key-file=ENCRYPTION_KEY_FILE

使用-encrypt选项时，此选项指示xtrabackup使用存储在给定ENCRYPTION_KEY_FILE中的加密密钥。它直接传递给xtrabackup子进程。有关更多详细信息，请参阅xtrabackup 文档。

该文件必须是一个简单的二进制（或文本）文件，其中包含要使用的密钥。

--encrypt-threads=#

此选项指定将用于并行加密的工作线程数。它直接传递给xtrabackup子进程。有关更多详细信息，请参阅xtrabackup 文档。

--encrypt-chunk-size=#

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

--export

此选项直接传递给选项。它允许导出单个表以导入到另一个服务器。有关详细信息，请参阅 xtrabackup文档。xtrabackup --export

--extra-lsndir=DIRECTORY

此选项接受字符串参数，该参数指定用于保存xtrabackup_checkpoints文件的额外副本的目录。它直接传递给xtrabackup的选项。有关详细信息，请参阅 xtrabackup文档。innobackupex --extra-lsndir

--force-non-empty-directories

指定后，它会将选项或 选项传输到非空目录。不会覆盖现有文件。如果-copy-back或-move-back必须从目标目录中已存在的备份目录中复制文件，它仍将失败并显示错误。innobackupex --copy-backinnobackupex --move-back

--galera-info

此选项创建xtrabackup_galera_info包含备份时本地节点状态的文件。在执行Percona-XtraDB-Cluster备份时应使用选项。使用备份锁创建备份时无效。

--help

此选项显示帮助屏幕并退出。

--history=NAME

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

--host=HOST

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

--ibbackup=IBBACKUP-BINARY

此选项指定应使用哪个xtrabackup二进制文件。该选项接受字符串参数。IBBACKUP-BINARY应该是用于运行Percona XtraBackup的命令 。如果xtrabackup二进制文件不在您的搜索路径或工作目录中，则该选项很有用。如果未指定此选项，innobackupex将尝试确定要自动使用的二进制文件。

--include=REGEXP

此选项是要与databasename.tablename格式的表名匹配的正则表达式 。它直接传递给xtrabackup的 选项。有关 详细信息，请参阅xtrabackup文档。xtrabackup --tables

--incremental

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

--incremental-basedir=DIRECTORY

此选项接受字符串参数，该参数指定包含完整备份的目录，该完整备份是增量备份的基础数据集。它与选项一起使用。innobackupex --incremental

--incremental-dir=DIRECTORY

此选项接受字符串参数，该参数指定将增量备份与完整备份组合在一起的目录，以进行新的完整备份。它与选项一起使用。innobackupex--incremental

--incremental-history-name=NAME

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

--incremental-history-uuid=UUID

此选项指定存储在PERCONA_SCHEMA.xtrabackup_history中的特定历史记录的UUID， 以基于增量备份。，：optionL`innobackupex -incremental-basedir`和 。如果找不到有效的lsn（没有该uuid的成功记录）xtrabackup将返回错误。它与选项一起使用。innobackupex --incremental-history-nameinnobackupex --incremental-lsninnobackupex --incremental

--incremental-lsn=LSN

此选项接受字符串参数，该参数指定用于增量备份的日志序列号（LSN）。它与 选项一起使用。它用于代替指定 。对于由MySQL和Percona Server 5.0系列版本创建的数据库，请指定为高：低格式的两个32位整数。对于在5.1及更高版本中创建的数据库，请将LSN指定为单个64位整数。innobackupex --incrementalinnobackupex --incremental-basedir

--kill-long-queries-timeout=SECONDS

此选项指定innobackupex在启动和终止阻止它的查询之间等待的秒数。默认值为0秒，这意味着innobackupex不会尝试终止任何查询。为了使用这个选项xtrabackup用户应该 和特权。如果支持（Percona Server 5.6+），则xtrabackup将自动使用备份锁 作为复制非InnoDB数据的轻量级替代方法，以避免阻止修改InnoDB表的DML查询。FLUSH TABLES WITH READ LOCKPROCESSSUPERFLUSH TABLESWITH READ LOCK

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

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

--ftwrl-wait-timeout=SECONDS

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

--ftwrl-wait-threshold=SECONDS

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

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

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

--log-copy-interval=#

此选项指定日志复制线程执行的检查之间的时间间隔（以毫秒为单位）。

--move-back

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

--no-lock

使用此选项可禁用表锁定。仅当所有表都是InnoDB并且您不关心 备份的二进制日志位置时才使用它。如果正在执行任何语句或者在非InnoDB表上发生任何更新（这包括mysql数据库中的系统MyISAM表 ），则不应使用此选项，否则可能导致备份不一致。如果支持（Percona Server 5.6+），则xtrabackup将自动使用备份锁 作为复制非InnoDB数据的轻量级替代方法，以避免阻止修改InnoDB表的DML查询。如果你正在考虑使用FLUSH TABLES WITH READ LOCKDDLFLUSH TABLES WITH READ LOCKinnobackupex --no-lock因为您的备份无法获取锁定，这可能是因为传入的复制事件阻止了锁定成功。请尝试使用 暂时停止复制从属线程，这可能有助于备份成功，然后您不需要求助于使用此选项。 使用-no-lock选项时不会创建（因为可能不一致），但在某些条件下 可以使用它来获取一致的binlog坐标，如使用二进制日志中所述。innobackupex --safe-slave-backupxtrabackup_binlog_infoSHOW MASTERSTATUSxtrabackup_binlog_pos_innodb

--no-timestamp

此选项可防止BACKUP-ROOT-DIR在命令行上创建给定时间戳的子目录 。指定后，将完成备份BACKUP-ROOT-DIR。

--no-version-check

此选项禁用版本检查。如果未通过此选项，则innobackupex在--backup模式下运行时会隐式启用自动版本检查。要禁用版本检查，应--no-version-check在envoking innobackupex时显式传递该选项。

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

• MySQL的味道和版本
• 操作系统名称
• Percona Toolkit版本
• Perl版本

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

--parallel=NUMBER-OF-THREADS

此选项接受一个整数参数，该参数指定xtrabackup子进程用于同时备份文件的线程数。请注意，此选项适用于文件级别，即，如果您有多个.ibd文件，则它们将并行复制。如果表一起存储在单个表空间文件中，则它将无效。此选项将允许同时解密和/或解压缩多个文件。为了解压缩，必须在路径中安装和访问qpress实用程序。此过程将删除原始压缩/加密文件，并将结果保留在同一位置。它直接传递给xtrabackup的选项。有关详细信息，请参阅xtrabackup文档xtrabackup --parallel

--password=PASSWORD

此选项接受字符串参数，该参数指定连接到数据库时要使用的密码。它被传递给mysql子进程而不做任何改动。有关详细信息，请参阅mysql --help。

--port=PORT

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

--rebuild-indexes

此选项仅在与--apply-log 选项一起使用时才有效，并直接传递给xtrabackup。使用时，使xtrabackup在应用日志后重建所有二级索引。此选项通常用于准备紧凑备份。有关更多信息，请参阅xtrabackup文档。

--rebuild-threads=NUMBER-OF-THREADS

此选项仅在与 and 选项一起使用时才有效，并直接传递给xtrabackup。使用时，xtrabackup在重建索引时与指定数量的线程并行处理表空间。有关更多信息，请参阅 xtrabackup文档。innobackupex --apply-loginnobackupex --rebuild-indexes

--redo-only

准备基本完全备份和合并除最后一个之外的所有增量备份时，应使用此选项。它直接传递给xtrabackup的选项。这迫使 xtrabackup跳过“回滚”阶段并仅执行“重做”。如果备份稍后将对其应用增量更改，则必须执行此操作。有关详细信息，请参阅xtrabackup 文档。xtrabackup --apply-log-only

--rsync

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

--safe-slave-backup

指定后，innobackupex将在运行之前停止从属SQL线程，并等待启动备份直到 in 为零。如果没有打开的临时表，则会进行备份，否则将启动并停止SQL线程，直到没有打开的临时表为止。如果在几秒钟后没有变为零， 则备份将失败。备份完成后，将重新启动从属SQL线程。FLUSH TABLES WITH READ LOCKSlave_open_temp_tablesSHOW STATUSSlave_open_temp_tablesinnobackupex --safe-slave-backup-timeout

--safe-slave-backup-timeout=SECONDS

应该等待 多少秒才能变为零。默认为300秒。innobackupex --safe-slave-backupSlave_open_temp_tables

--scpopt = SCP-OPTIONS

此选项接受一个字符串参数，该参数指定要传递给scp的命令行选项。默认选项是。-Cp -c arcfour

--slave-info

备份复制从属服务器时，此选项很有用。它打印二进制日志位置和主服务器的名称。它还将此信息xtrabackup_slave_info作为 命令写入文件。可以通过在此备份上启动从属服务器并发出保存在文件中的二进制日志位置的命令来设置此主站的新从站。CHANGE MASTERCHANGEMASTERxtrabackup_slave_info

--socket

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

--sshopt=SSH-OPTIONS

此选项接受一个字符串参数，该参数指定要传递给ssh的命令行选项。

--stream=STREAMNAME

此选项接受一个字符串参数，该参数指定执行流式备份的格式。备份将以STDOUT指定的格式完成。目前，支持的格式是tar和xbstream。使用 xbstream，它在Percona XtraBackup 发行版中可用。如果在此选项后指定路径，则将其解释为值tmpdir

--tables-file=FILE

此选项接受一个字符串参数，该参数指定存在表单名称列表的文件database.table，每行一个。该选项直接传递给xtrabackup的 选项。innobackupex --tables-file

--throttle=#

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

也可以看看

有关如何限制备份的详细信息

限制备份

--tmpdir=DIRECTORY

此选项接受一个字符串参数，该参数指定临时文件的存储位置。指定时可以使用它。对于这些选项，在流式传输或复制到远程主机之前，事务日志将首先存储到临时文件中。此选项指定临时文件的存储位置。如果未指定该选项，则默认使用服务器配置中的read 值。innobackupex将my.cnf中指定的tmpdir值作为-target-dir选项传递给xtrabackup二进制文件。[mysqld]和[xtrabackup]组都是从my.cnf中读取的。如果两者都有tmpdir，那么使用的值取决于my.cnf中这些组的顺序。innobackupex --streamtmpdir

--use-memory=#

此选项接受一个字符串参数，该参数指定xtrabackup在准备备份时用于崩溃恢复的内存量（以字节为单位）。提供单元支持倍数（例如1MB，1M，1GB，1G）。它仅与选项一起使用。它直接传递给xtrabackup的选项。有关详细信息，请参阅 xtrabackup文档。innobackupex --apply-logxtrabackup --use-memory

--user=USER

此选项接受一个字符串参数，该参数指定用户（即，连接到服务器时使用的 MySQL用户名）登录，如果不是当前用户。它被传递给mysql子进程而不做任何改动。有关详细信息，请参阅mysql --help。

--version

此选项显示innobackupex版本和版权声明，然后退出