innobackupex选项参考¶

属性的所有命令行选项innobackupex。

选项¶

运用原木¶

在BACKUP-DIR通过应用事务日志文件命名xtrabackup_logfile位于同一目录中。另外，创建新的事务日志。从文件中读取InnoDB配置backup-my.cnf由innobackupex备份的时间。innobackupex——运用原木使用InnoDB配置frombackup-my.cnf默认情况下，或from——defaults-file，如果指定。在这种情况下，InnoDB配置意味着影响数据格式的服务器变量。innodb_page_size,innodb_log_block_size等。与位置相关的变量，比如innodb_log_group_home_dir或innodb_data_file_path总是被忽略——运用原木，因此准备备份时总是使用备份目录中的数据文件，而不是任何外部文件。

-backup-locks¶

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

-no-backup-locks¶

显式禁用该选项——backup-locks默认启用。

请关闭那些文件¶

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

压缩¶

该选项指示xtrabackup压缩InnoDB数据文件的备份副本。它直接传递给xtrabackup子进程。查看xtrabackup文档获取详细信息。

-compress-threads =¶

此选项指定将用于并行压缩的工作线程的数量。它直接传递给xtrabackup子进程。查看xtrabackup文档获取详细信息。

-compress-chunk-size =¶

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

复制回去¶

将以前备份目录中的所有文件复制到它们的原始位置。雷竞技下载官网Percona XtraBackupinnobackupex——复制回去选项将不会复制现有文件，除非innobackupex——force-non-empty-directories选项。

数据库列表=¶

此选项指定数据库列表innobackupex应该后退。该选项接受字符串参数或包含要备份的数据库列表的文件路径。该列表的形式为“databasename1[”。table_name1] databasename2[。table_name2]…”。如果未指定此选项，则包含MyISAM和InnoDB表将被备份。请确保-databases包含所有的InnoDB数据库和表，这样所有的innodb.frm文件也会备份。如果列表非常长，则可以在文件中指定，并且可以指定文件的完整路径而不是列表。(参见option - table -file。)

解压缩¶

的备份文件中解压扩展名为.qp的所有文件innobackupex——压缩选择。的innobackupex——平行选项将允许多个文件同时解密和/或解压缩。为了解压，qpress实用程序必须在路径中安装和访问。雷竞技下载官网Percona XtraBackup不会自动删除压缩文件。为了清理备份目录，用户应该删除\ * .qp手动文件。

解密是加密算法¶

在之前使用-encrypt选项生成的备份中解密所有扩展名为.xbcrypt的文件。的innobackupex——平行选项将允许多个文件同时解密和/或解压缩。

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

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

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

此选项指定要读取默认值的额外文件MySQL来自标准默认文件之前的选项。必须作为命令行中的第一个选项。

-defaults-group =组名称¶

此选项接受一个字符串参数，该参数指定应从配置文件中读取的组。如果使用mysqld_multi，这是必需的。这也可以用来表示mysqld和xtrabackup之外的组。

加密= ENCRYPTION_ALGORITHM¶

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

目前支持的算法有:AES128,AES192和AES256。

-encrypt-key = ENCRYPTION_KEY¶

该选项指示xtrabackup在使用-encrypt选项时使用给定长度的加密密钥作为ENCRYPTION_KEY。它直接传递给xtrabackup子进程。看到xtrabackup文档欲知详情。

如果可以通过命令行不受控制地访问机器，因此键可以被视为进程信息的一部分，则不建议使用此选项。

-encrypt-key-file = ENCRYPTION_KEY_FILE¶

该选项指示xtrabackup在使用-encrypt选项时使用存储在给定ENCRYPTION_KEY_FILE中的加密密钥。它直接传递给xtrabackup子进程。看到xtrabackup文档欲知详情。

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

-encrypt-threads =¶

此选项指定将用于并行加密的工作线程数。它直接传递给xtrabackup子进程。看到xtrabackup文档欲知详情。

-encrypt-chunk-size =¶

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

出口¶

此选项直接传递给xtrabackup——出口选择。它支持导出单独的表，以便导入到另一个服务器。看到xtrabackup详细信息文档。

-extra-lsndir =目录¶

属性的额外副本所保存的目录xtrabackup_checkpoints文件。它被直接传递给xtrabackup的innobackupex——extra-lsndir选择。详细信息请参阅xtrabackup文档。

-force-non-empty-directories¶

当指定时，它使innobackupex——复制回去选择或innobackupex——搬回来选项传输文件到非空目录。现有文件不会被覆盖。如果-copy-back或-move-back必须从目标目录中已经存在的备份目录复制文件，则仍然会失败并报错。

-galera-info¶

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

-¶

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

历史=名字¶

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

主机=主机¶

此选项接受一个字符串参数，用于指定使用TCP/IP连接数据库服务器时使用的主机。它被传递给mysql子进程而不作修改。看到mysql——帮助获取详细信息。

-ibbackup = IBBACKUP-BINARY¶

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

包括= REGEXP¶

中表名匹配的正则表达式databasename.tablename格式。它直接传递给xtrabackupxtrabackup——表选择。详细信息请参阅xtrabackup文档。

增量¶

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

-incremental-basedir =目录¶

此选项接受一个字符串参数，该参数指定包含完整备份(增量备份的基本数据集)的目录。它与the连用innobackupex——增量选择。

-incremental-dir =目录¶

此选项接受一个字符串参数，该参数指定将在其中将增量备份与完全备份结合以生成新的完全备份的目录。它与the连用innobackupex——增量选择。

-incremental-history-name =名字¶

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

-incremental-history-uuid = UUID¶

对象中存储的特定历史记录的UUID雷竞技下载官网PERCONA_SCHEMA.xtrabackup_history增量备份的基础。innobackupex——incremental-history-name,innobackupex——incremental-basedir \和innobackupex——incremental-lsn。如果找不到有效的lsn(没有该uuid的成功记录)，xtrabackup将返回一个错误。它与the连用innobackupex——增量选择。

-incremental-lsn = LSN¶

此选项接受一个字符串参数，该参数指定日志序列号(LSN)用于增量备份。它与the连用innobackupex——增量选择。它被用来代替指定innobackupex——incremental-basedir。对于由MySQL和雷竞技下载官网Percona服务器5.0系列版本，以high:low格式指定为两个32位整数。对于在5.1及更高版本中创建的数据库，将LSN指定为单个64位整数。

-kill-long-queries-timeout =秒¶

该选项指定innobackupex在启动之间等待的秒数用读锁刷新表并杀死那些阻止它的查询。默认值为0秒，这意味着innobackupex不会尝试终止任何查询。为了使用这个选项，xtrabackup用户应该有过程和超级特权。哪里支持(Percona Serv雷竞技下载官网er 5.6+) xtrabackup将自动使用备份锁作为轻量级的替代品用读锁刷新表复制非InnoDB数据以避免阻塞修改InnoDB表的DML查询。

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

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

-ftwrl-wait-timeout =秒¶

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

-ftwrl-wait-threshold =秒¶

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

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

该选项指定在innobackupex发出全局锁之前允许完成哪些类型的查询。违约就是一切。

-log-copy-interval =¶

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

向后移动¶

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

没有锁¶

使用此选项禁用表锁定用读锁刷新表。只有当你所有的表都是InnoDB和你的时候才使用它不在乎关于备份二进制日志的位置。如果有，则不应使用此选项DDL语句正在被执行，或者是否有任何更新发生在非innodb表上(这包括系统中的MyISAM表)mysql数据库)，否则可能导致不一致的备份。哪里支持(Percona Serv雷竞技下载官网er 5.6+) xtrabackup将自动使用备份锁作为轻量级的替代品用读锁刷新表复制非InnoDB数据以避免阻塞修改InnoDB表的DML查询。如果您正在考虑使用Innobackupex——无锁，因为您的备份无法获得锁，这可能是因为传入的复制事件阻止了锁的成功。请尝试使用innobackupex——safe-slave-backup为了暂时停止复制副本线程，这可能有助于备份成功，然后您不需要使用此选项。xtrabackup_binlog_info使用-no-lock选项时不创建(因为显示主机状态可能不一致)，但在某些条件下xtrabackup_binlog_pos_innodb可用于获得一致的binlog坐标，如在使用二进制日志。

-no-timestamp¶

类的带有时间戳的子目录的创建BACKUP-ROOT-DIR在命令行中给出。当指定该参数时，备份就会完成BACKUP-ROOT-DIR代替。

-no-version-check¶

此选项将禁用版本检查。如果您没有通过此选项，则自动版本检查将隐式启用xtrabackup运行在——备份模式。若要禁用版本检查，请显式传递——no-version-check选项。xtrabackup。当启用自动版本检查时，|程序|在创建服务器连接后，在备份阶段对服务器执行版本检查。

xtrabackup向服务器发送以下信息:

• MySQL风格和版本

• 操作系统名称

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

• Perl版本

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

平行=数量的线程¶

此选项接受一个整数参数，该参数指定线程数xtrabackup子进程应该用来并发备份文件。注意，这个选项工作在文件级别，也就是说，如果您有几个.ibd文件，它们将被并行复制。如果您的表存储在一个单独的表空间文件中，它将没有任何影响。该选项将允许多个文件同时解密和/或解压缩。为了解压，qpress实用程序必须在路径内安装和访问。这个过程将删除原始的压缩/加密文件，并将结果保留在相同的位置。它直接传递给xtrabackupxtrabackup——平行选择。看到xtrabackup详细资料

密码=密码¶

此选项接受一个字符串参数，指定连接到数据库时使用的密码。它被传递给mysql没有修改的子进程。看到mysql——帮助获取详细信息。

- PORT =港口¶

此选项接受一个字符串参数，该参数指定使用TCP/IP连接数据库服务器时使用的端口。它被传递给mysql子进程。它被传递给mysql没有修改的子进程。看到mysql——帮助获取详细信息。

-rebuild-indexes¶

此选项仅在与——apply-log 选项，并直接传递给xtrabackup。使用时，使xtrabackup在应用日志后重新构建所有二级索引。此选项通常用于准备压缩备份。看到xtrabackup文档获取更多信息。

-rebuild-threads =数量的线程¶

此选项仅在与innobackupex——运用原木和innobackupex——rebuild-indexes选项，并直接传递给xtrabackup。使用xtrabackup时，在重建索引时与指定数量的线程并行处理表空间。看到xtrabackup文档获取更多信息。

-redo-only¶

在准备基本完全备份和合并除最后一个增量之外的所有增量时，应该使用此选项。它直接传递给xtrabackupxtrabackup——apply-log-only选择。这就迫使xtrabackup跳过“回滚”阶段，只执行“重做”。如果备份稍后将应用增量更改，则这是必要的。看到xtrabackup文档获取详细信息。

rsync¶

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

-safe-slave-backup¶

当指定innobackupex时，innobackupex将在运行之前停止副本SQL线程用读锁刷新表并等待开始备份，直到Slave_open_temp_tables在显示状态是零。如果没有打开的临时表，将进行备份，否则将启动和停止SQL线程，直到没有打开的临时表为止。备份将失败Slave_open_temp_tables以后不变成零吗innobackupex——safe-slave-backup-timeout秒。备份完成后，将重新启动副本SQL线程。

-safe-slave-backup-timeout =秒¶

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

-slave-info¶

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

套接字¶

此选项接受一个字符串参数，该参数指定在使用UNIX域套接字连接到本地数据库服务器时使用的套接字。它被传递给mysql子进程而不作修改。看到mysql——帮助获取详细信息。

流= STREAMNAME¶

此选项接受一个字符串参数，该参数指定执行流备份的格式。备份将被执行STDOUT在指定的格式。目前支持的格式为焦油和xbstream。使用xbstream，可在雷竞技下载官网Percona XtraBackup分布。如果在此选项后指定路径，则该路径将被解释为的值tmpdir

文件=文件¶

此选项接受一个字符串参数，该参数指定包含表单名称列表的文件database.table，每行一个。该选项被直接传递给xtrabackup的innobackupex——文件选择。

节流=¶

此选项限制每秒复制的数据块数量。块大小为10 MB。将带宽限制为10 MB /秒，设置为1：——节流= 1。

tmpdir =目录¶

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

使用内存=¶

此选项接受一个字符串参数，用于指定以字节为单位的内存量xtrabackup在准备备份时用于崩溃恢复。多重支持提供单位(例如1MB, 1M, 1GB, 1G)。它只与选项一起使用innobackupex——运用原木。它直接传递给xtrabackupxtrabackup——使用内存选择。看到xtrabackup详细信息文档。

用户=用户¶

此选项接受一个字符串参数，用于指定用户(即MySQL连接到服务器时使用的用户名)登录，如果不是当前用户。它被传递给mysql子进程而不作修改。看到mysql——帮助获取详细信息。

- version¶

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