-v, --version
输出 xtrabackup 的版本信息
-?, --help
输出, 显示帮助信息然后退出
--defaults-file
默认配置文件的路径, 如果不指定该参数, xtrabackup 将从依次从以下位置查找配置文件 / etc/my.cnf,/etc/mysql/my.cnf,/usr/local/etc/my.cnf,~/.my.cnf, 并读取配置文件中的 [mysqld] 和[xtrabackup]配置段.[mysqld]中只需要指定 datadir,innodb_data_home_dir,innodb_data_file_path,innodb_log_group_home_dir,innodb_log_files_in_group,innodb_log_file_size6 个参数即可让 xtrabackup 正常工作.
注意: 指定要备份的 mysql 实例的 my.cnf 文件, 必须为第一个选项
--apply-log
该参数是对 xtrabackup 的参数 --prepare 的封装. 一般情况下, 在备份完成后, 数据尚且不能用于恢复操作, 因为备份的数据中可能会包含尚未提交的事务或已经提交但尚未同步至数据文件中的事务. 因此, 此时数据文件仍处理不一致状态.--apply-log 的作用是通过回滚未提交的事务及同步已经提交的事务至数据文件使数据文件处于一致性状态.
--redo-only
这个选项在 prepare base full backup, 往其中 merge 增量备份 (但不包括最后一个) 时候使用. This forces xtrabackup to skip the "rollback" phase and do a "redo" only
--copy-back
做数据恢复时将备份数据文件拷贝到 MySQL 服务器的 datadir 目录;
--move-back
将所有文件从以前创建的备份目录移动到事情数据目录, 使用此选项必须小心, 因为它会删除备份文件.
--galera-info
该选项创建 xtrabackup_galera_info 文件, 其中包含备份当时的本地节点状态. 执行 Percona-XtraDB-Cluster 备份时应使用此选项.
--slave-info
该选项表示对 slave 进行备份的时候使用, 打印出 master 的名字和 binlog pos, 同样将这些信息以 change master 的命令写入 xtrabackup_slave_info 文件. 可以通过基于这份备份启动一个从库.
--incremental
建立增量备份
--no-lock
该选项表示关闭 FTWRL 的表锁, 只有在所有表都是 Innodb 表并且不关心 backup 的 binlog pos 点, 如果有任何 DDL 语句正在执行或者非 InnoDB 正在更新时(包括 mysql 库下的表), 都不应该使用这个选项, 后果是导致备份数据不一致, 如果考虑备份因为获得锁失败, 可以考虑 --safe-slave-backup 立刻停止复制线程.
不允许使用 flush tables with read lock 表锁. 如果你的所有表示 INNODB 并且你不关心二进制日志备份的位置. 如果有任何 DDL 语句被执行或任何非 INNODB 表上的 update 操作, 这个选项就不能使用
--safe-slave-backup
停止从 SQL 进程并等待启动备份直到 slave_open_temp_tables 的值为 0. 如果没有打开临时表, 备份会进行, 否则 SQL 进程将启动并直到没有打开的临时表时停止. 如果 slave_open_temp_tables 在 --
safe-slave-backup-timeout 秒后没有变成 0, 则备份会失败. 备份结束后, 从 SQL 进程将重新启动.
--rsync
表示通过 rsync 工具优化本地传输, 当指定这个选项, innobackupex 使用 rsync 拷贝非 Innodb 文件而替换 cp, 当有很多 DB 和表的时候会快很多, 不能 --stream 一起使用.
--force-non-empty-directories
使用此选项, 就可以通过 --copy-back 或 --move-back 将文件拷贝或移动到非空目录.
- This option, when specified, makes --copy-back or
- --move-back transfer files to non-empty directories. Note
- that no existing files will be overwritten. If
- --copy-back or --nove-back has to copy a file from the
- backup directory which already exists in the destination
- directory, it will still fail with an error.
- --no-timestamp
该选项可以表示要不要创建一个时间戳目录来存储备份, 指定到自己想要的备份文件夹. 指定了这个选项, 备份会直接备份在 BACKUP-DIR, 不再创建时间戳文件夹
--no-version-check
禁止版本检查
- --no-backup-locks
- --decompress -u, --user=name
该选项表示备份账号.
-H, --host=
该选项表示备份数据库的地址.
-p, --password
该选项表示备份账号的密码.
-P, --port=#
该选项表示当前需要备份数据库的使用的端口.
-S, --socket
此选项指定连接本地数据库时使用的套接字, 此选项接受一个字符串参数.
--incremental-history-name=name
该选项表示存储在 PERCONA_SCHEMA.xtrabackup_history 基于增量备份的历史记录的名字. Percona Xtrabackup 搜索历史表查找最近 (innodb_to_lsn) 成功备份并且将 to_lsn 值作为增量备份启动出事 lsn. 与 innobackupex--incremental-history-uuid 互斥. 如果没有检测到有效的 lsn,xtrabackup 会返回 error.
- --incremental-history-uuid=name
- --decrypt=name
- --ftwrl-wait-query-type=name
- --kill-long-query-type=name
- --history[=name] --include=name --databases
该选项表示需要备份的数据库, 如果没有指定该参数, 表示备份全部数据库. 如果要指定多个数据库, 彼此间需要以空格隔开; 如:"mydb1 mydb2", 同时, 在指定某数据库时, 也可以只指定其中的某张表. 如:"mydatabase.mytable". 该选项对 innodb 引擎表无效, 还是会备份所有 innodb 表. 此外, 此选项也可以接受一个文件为参数, 文件中每一行为一个要备份的对象.
- --kill-long-queries-timeout=#
- --ftwrl-wait-timeout=#
- --ftwrl-wait-threshold=#
- --debug-sleep-before-unlock=#
- --safe-slave-backup-timeout=#
- --close-files --compact
该选项表示创建一份没有辅助索引的紧凑的备份.
指在备份 InnoDB tables 时, 可以不备份二级索引 (Secondary index) 数据页, 这样使得备份更加紧凑, 从而可以减少备份的大小. 缺点是备份准备过程 (Prepare) 需要更长的时间才能重建这些二级索引(secondary indexes).
--compress[=name]
对备份数据进行行压缩
--compress-threads=#
指定备份压缩的线程数量.
- --compress-chunk-size=#
- --encrypt=name
- --encrypt-key=name
- --encrypt-key-file=name
- --encrypt-threads=#
- --encrypt-chunk-size=#
- --export
- --extra-lsndir=name
- --incremental-basedir=name
指定一个全库备份的目录作为增量备份的基础数据库 .
与 --incremental 同时使用.
--incremental-dir=name
该选项表示增量备份的目录.
--incremental-force-scan
该选项表示创建一份增量备份时, 强制扫描所有增量备份中的数据页.
- --log-copy-interval=#
- --incremental-lsn=name
该选项表示指定增量备份的 LSN, 与 --incremental 选项一起使用.
- --parallel
- --rebuild-indexes
- --rebuild-threads=#
- --stream
该选项表示流式备份的格式, backup 完成之后以指定格式到 STDOUT, 目前只支持 tar 和 xbstream.
备份文件输出格式, tar 时使用 tar4ibd , 该文件可在 XtarBackup binary 文件中获得. 如果备份时有指定 --stream=tar, 则 tar4ibd 文件所处目录一定要在 $PATH 中(因为使用的是 tar4ibd 去压缩, 在 XtraBackup 的 binary 包中可获得该文件).
在使用参数 stream=tar 备份的时候, 你的 xtrabackup_logfile 可能会临时放在 / tmp 目录下, 如果你备份的时候并发写入较大的话 xtrabackup_logfile 可能会很大(5G+), 很可能会撑满你的 / tmp 目录, 可以通过参数 --tmpdir 指定目录来解决这个问题.
--tables-file
该选项表示指定含有表列表的文件, 格式为 database.table, 该选项直接传给 --tables-file.
--throttle
每秒 IO 次数, 限制 backup 时使用的 I/O 操作量, 使备份对数据库正常业务的影响最小化
- -t, --tmpdir=name
- --use-memory
指定备份所用内存大小.
来源: http://www.bubuko.com/infodetail-2662217.html