文档主页
MySQL 9.0 参考手册
相关文档 下载本手册
PDF (US Ltr) - 40.0Mb
PDF (A4) - 40.1Mb
手册页 (TGZ) - 258.2Kb
手册页 (Zip) - 365.3Kb
信息 (Gzip) - 4.0Mb
信息 (Zip) - 4.0Mb


MySQL 9.0 参考手册  /  ...  /  ndbxfrm — 压缩、解压缩、加密和解密 NDB 集群创建的文件

25.5.32 ndbxfrm — 压缩、解压缩、加密和解密 NDB 集群创建的文件

ndbxfrm 实用程序可用于解压缩、解密和输出由 NDB 集群创建的已压缩、加密或同时进行这两种操作的文件的信息。它也可用于压缩或加密文件。

用法

ndbxfrm --info file[ file ...]

ndbxfrm --compress input_file output_file

ndbxfrm --decrypt-password=password input_file output_file

ndbxfrm [--encrypt-ldf-iter-count=#] --encrypt-password=password input_file output_file

input_fileoutput_file 不能是同一个文件。

选项

  • --compress, -c

    命令行格式 --compress

    使用与压缩 NDB 集群备份相同的方法压缩输入文件,并将输出写入输出文件。要解压缩未加密的压缩 NDB 备份文件,只需使用压缩文件的名称和输出文件的名称调用 ndbxfrm(无需任何选项)。

  • --decrypt-key=key, -K key

    命令行格式 --decrypt-key=key

    使用提供的密钥解密由 NDB 加密的文件。

    注意

    此选项不能与 --decrypt-password 一起使用。

  • --decrypt-key-from-stdin

    命令行格式 --decrypt-key-from-stdin

    使用从 stdin 提供的密钥解密由 NDB 加密的文件。

  • --decrypt-password=password

    命令行格式 --decrypt-password=password
    类型 字符串
    默认值 [无]

    使用提供的密码解密由 NDB 加密的文件。

    注意

    此选项不能与 --decrypt-key 一起使用。

  • --decrypt-password-from-stdin[=TRUE|FALSE]

    命令行格式 --decrypt-password-from-stdin

    使用从标准输入提供的密码解密由 NDB 加密的文件。这类似于在调用 mysql --password 后输入密码,但该选项后没有密码。

  • --defaults-extra-file

    命令行格式 --defaults-extra-file=路径
    类型 字符串
    默认值 [无]

    读取全局文件后读取给定文件。

  • --defaults-file

    命令行格式 --defaults-file=路径
    类型 字符串
    默认值 [无]

    仅从给定文件读取默认选项。

  • --defaults-group-suffix

    命令行格式 --defaults-group-suffix=字符串
    类型 字符串
    默认值 [无]

    同时读取具有 CONCAT(group, suffix) 的组。

  • --detailed-info

    命令行格式 --encrypt-block-size=#
    类型 布尔值
    默认值 FALSE

    打印出文件信息,如 --info,但包括文件的标头和尾部。

    示例

    $> ndbxfrm --detailed-info S0.sysfile
    File=/var/lib/cluster-data/ndb_7_fs/D1/NDBCNTR/S0.sysfile, compression=no, encryption=yes
    header: {
      fixed_header: {
        magic: {
          magic: { 78, 68, 66, 88, 70, 82, 77, 49 },
          endian: 18364758544493064720,
          header_size: 32768,
          fixed_header_size: 160,
          zeros: { 0, 0 }
        },
        flags: 73728,
        flag_extended: 0,
        flag_zeros: 0,
        flag_file_checksum: 0,
        flag_data_checksum: 0,
        flag_compress: 0,
        flag_compress_method: 0,
        flag_compress_padding: 0,
        flag_encrypt: 18,
        flag_encrypt_cipher: 2,
        flag_encrypt_krm: 1,
        flag_encrypt_padding: 0,
        flag_encrypt_key_selection_mode: 0,
        dbg_writer_ndb_version: 524320,
        octets_size: 32,
        file_block_size: 32768,
        trailer_max_size: 80,
        file_checksum: { 0, 0, 0, 0 },
        data_checksum: { 0, 0, 0, 0 },
        zeros01: { 0 },
        compress_dbg_writer_header_version: { ... },
        compress_dbg_writer_library_version: { ... },
        encrypt_dbg_writer_header_version: { ... },
        encrypt_dbg_writer_library_version: { ... },
        encrypt_key_definition_iterator_count: 100000,
        encrypt_krm_keying_material_size: 32,
        encrypt_krm_keying_material_count: 1,
        encrypt_key_data_unit_size: 32768,
        encrypt_krm_keying_material_position_in_octets: 0,
      },
      octets: {
         102, 68, 56, 125, 78, 217, 110, 94, 145, 121, 203, 234, 26, 164, 137, 180,
         100, 224, 7, 88, 173, 123, 209, 110, 185, 227, 85, 174, 109, 123, 96, 156,
      }
    }
    trailer: {
      fixed_trailer: {
        flags: 48,
        flag_extended: 0,
        flag_zeros: 0,
        flag_file_checksum: 0,
        flag_data_checksum: 3,
        data_size: 512,
        file_checksum: { 0, 0, 0, 0 },
        data_checksum: { 226, 223, 102, 207 },
        magic: {
          zeros: { 0, 0 }
          fixed_trailer_size: 56,
          trailer_size: 32256,
          endian: 18364758544493064720,
          magic: { 78, 68, 66, 88, 70, 82, 77, 49 },
        },
      }
    }
  • --encrypt-block-size=#

    命令行格式 --encrypt-block-size=#
    类型 整数
    默认值 0
    最小值 0
    最大值 2147483647

    作为单元加密的输入数据块的大小。与 XTS 一起使用;对于 CBC 模式,设置为 0(默认值)。

  • --encrypt-cipher=#

    命令行格式 --encrypt-cipher=#
    类型 整数
    默认值 1
    最小值 0
    最大值 2147483647

    用于加密的密码。对于 CBC 模式(默认值),设置为 1,对于 XTS,设置为 2

  • --encrypt-kdf-iter-count=#, -k #

    命令行格式 --encrypt-kdf-iter-count=#
    类型 整数
    默认值 0
    最小值 0
    最大值 2147483647

    加密文件时,指定用于加密密钥的迭代次数。需要 --encrypt-password 选项。

  • --encrypt-key=key

    命令行格式 --encrypt-key=key

    使用提供的密钥加密文件。

    注意

    此选项不能与 --encrypt-password 一起使用。

  • --encrypt-key-from-stdin

    命令行格式 --encrypt-key-from-stdin

    使用从 stdin 提供的密钥加密文件。

  • --encrypt-password=password

    命令行格式 --encrypt-password=password
    类型 字符串
    默认值 [无]

    使用该选项提供的密码加密备份文件。密码必须满足此处列出的要求

    • 使用除 !'"$%\`^ 之外的任何可打印 ASCII 字符

    • 长度不超过 256 个字符

    • 用单引号或双引号括起来

    注意

    此选项不能与 --encrypt-key 一起使用。

  • --encrypt-password-from-stdin[=TRUE|FALSE]

    命令行格式 --encrypt-password-from-stdin

    使用从标准输入提供的密码加密文件。这类似于在调用 mysql --password 后输入密码,但该选项后没有密码。

  • --help, -?

    命令行格式 --help

    打印程序的使用信息。

  • --info, -i

    命令行格式 --info

    打印有关一个或多个输入文件的以下信息

    • 文件名

    • 文件是否已压缩(compression=yescompression=no

    • 文件是否已加密(encryption=yesencryption=no

    示例

    $> ndbxfrm -i BACKUP-10-0.5.Data BACKUP-10.5.ctl BACKUP-10.5.log
    File=BACKUP-10-0.5.Data, compression=no, encryption=yes
    File=BACKUP-10.5.ctl, compression=no, encryption=yes
    File=BACKUP-10.5.log, compression=no, encryption=yes

    您还可以使用 --detailed-info 选项查看文件的标头和尾部。

  • --login-path

    命令行格式 --login-path=路径
    类型 字符串
    默认值 [无]

    从登录文件读取给定路径。

  • --no-login-paths

    命令行格式 --no-login-paths

    跳过从登录路径文件读取选项。

  • --no-defaults

    命令行格式 --no-defaults

    除了登录文件外,不要从任何选项文件读取默认选项。

  • --print-defaults

    命令行格式 --print-defaults

    打印程序参数列表并退出。

  • --usage, -?

    命令行格式 --usage

    --help 的同义词。

  • --version, -V

    命令行格式 --version

    打印出版本信息。

ndbxfrm 可以加密由任何版本的 NDB 集群创建的备份。构成备份的 .Data.ctl.log 文件必须单独加密,并且这些文件必须为每个数据节点单独加密。加密后,此类备份只能由 ndbxfrmndb_restorendb_print_backup 解密。

可以使用 --encrypt-password--decrypt-password 选项一起使用新密码重新加密加密文件,如下所示

ndbxfrm --decrypt-password=old --encrypt-password=new input_file output_file

在刚显示的示例中,oldnew 分别是旧密码和新密码;这两个密码都必须用引号括起来。输入文件被解密,然后作为输出文件加密。输入文件本身不会更改;如果您不希望使用旧密码访问它,则必须手动删除输入文件。