20.9 单文件备份选项

这些选项与单文件备份相关联。您可以将它们与mysqlbackup 命令结合使用backup-to-imageimage-to-backup-dir, backup-dir-to-image, copy-back-and-apply-log, list-image, 和 extract(尽管并非所有选项都适用于所有这些命令)。有关用法示例,请参阅第 4.3.1 节,“制作单个文件备份”

  • --backup-image=IMAGE

    请参阅 第 20.4 节 “备份存储库选项”中的选项说明

  • --src-entry=STRING

    命令行格式 --src-entry=STRING
    类型 路径名

    标识其路径名包含要从单个文件备份中提取的 STRING 的文件或目录。该选项与extract andimage-to-backup-dir 命令一起使用。或者,您还可以指定将 --dst-entry文件或目录提取到与其原始路径名不同的位置的选项。

    例如:src-entry=d1/f2仅提取一个文件,f2同时 src-entry=d1/提取文件夹的整个目录树(请注意参数末尾的d1斜杠 ( ),如果没有斜杠,所有在其路径名中包含该字符串的文件或文件夹都将被提取)。 /d1

    默认值:提取所有条目。

    笔记
    • 以下项目总是从备份中提取,无论值如何 --src-entry(并且它们的提取位置不受该 --dst-entry选项的影响):

      • 文件backup-my.cnf

      • 文件datadir夹(仅包含与 --src-entry选项匹配的项目)。

      • 一个meta文件夹,其中包含文件 backup_variables.txt、提取操作的日志文件以及与--src-entry 选项匹配的项目。

    • 云备份命令目前不支持该选项 extract,只能完整提取。

  • --dst-entry=PATH

    命令行格式 --dst-entry=PATH
    类型 路径名

    与单文件备份一起使用,将文件或目录提取到用户指定的路径。使用此选项需要指定--src-entry 选项。此选项指定从备份图像中选择的条目的目标路径 --src-entry。该条目可以指向单个文件或单个目录。例如,要从备份图像中检索评论文件并将其存储为/tmp/my-comments.txt,请使用如下命令:

    mysqlbackup --src-entry=meta/comments.txt \
      --dst-entry=/tmp/my-comments.txt \
      --backup-image=/var/myimage.bki  extract

    datadir/pets/同样,要将单个文件备份中目录的 所有内容提取 为/pets-extracted/,请使用如下命令:

    mysqlbackup --src-entry=datadir/pets/ \
      --dst-entry=/pets-extracted/ \
      --backup-image=/var/myimage.bki  extract

    指定的路径是没有任何通配符扩展或正则表达式的简单路径名。

    如果 for 的参数 --src-entry匹配多个文件或文件夹,它们将全部提取到一个文件夹中,该文件夹的路径名相对于目标文件夹由参数 of 给出--dst-entry (除非该参数指定绝对路径)。

    默认值:原始路径名用于在目标文件夹下创建文件。

  • --sbt-database-name=NAME

    命令行格式 --sbt-database-name=NAME
    类型 细绳
    默认值 MySQL

    对于磁带备份,此选项可用作介质管理软件 (MMS) 的提示以选择介质和策略。此名称与 MySQL 数据库名称无关。这是 MMS 使用的术语。有关使用详细信息,请参见 第 4.3.1.2 节“备份到磁带”

  • --sbt-lib-path=PATH

    命令行格式 --sbt-lib-path=PATH
    类型 文件名

    管理磁带备份的软件使用的 SBT 库的路径名。如果未指定,则使用特定于操作系统的搜索方法来定位 libobk.so(UNIX) 或 orasbt.dll(Windows)。有关使用详细信息,请参见 第 4.3.1.2 节“备份到磁带”

  • --sbt-environment= VAR= value,...

    命令行格式 --sbt-environment=VAR1=value1[,VAR2=value2[,...]] SBT API provider)
    类型 细绳

    将特定于产品的环境变量传递给 Oracle Secure Backup 或其他符合 SBT 的备份管理产品,作为在每次mysqlbackup调用 之前和之后设置和取消设置环境变量的替代方法 。

    此选项的参数是以逗号分隔的键值对列表,使用类似于 Oracle 数据库的 RMAN 工具的语法。例如, --sbt-environment=VAR1=val1,VAR2=val2,VAR3=val3

    请查阅备份管理产品的文档,了解其哪些功能可以通过环境变量进行控制。例如,Oracle Secure Backup 产品 定义了、 和 等 环境变量。您可以通过指定选项(例如 . OB_MEDIA_FAMILYOB_DEVICEOB_RESOURCE_WAIT_TIME--sbt-environment="OB_MEDIA_FAMILY=my_mf,OB_DEVICE=my_tape"

    如果参数字符串包含命令 shell 可识别的任何空格或特殊字符,请将整个参数字符串括在引号中。要转义等号或逗号,请使用\字符。例如,--sbt-environment="VAR1=multiple words,VAR2=<angle_brackets>,VAR3=2+2\=4"

  • --disable-manifest

    禁止为备份操作 生成 清单backup_create.xml文件, 这些文件backup_content.xml存在于 meta子目录中。