25.5.17 ndb_print_backup_file — Print NDB Backup File Contents (original) (raw)

25.5.17 ndb_print_backup_file — Print NDB Backup File Contents

ndb_print_backup_file obtains diagnostic information from a cluster backup file.

Table 25.39 Command-line options used with the program ndb_print_backup_file

Usage

ndb_print_backup_file [-P password] file_name

filename is the name of a cluster backup file. This can be any of the files (.Data, .ctl, or.log file) found in a cluster backup directory. These files are found in the data node's backup directory under the subdirectoryBACKUP-_`#`_, where_#_ is the sequence number for the backup. For more information about cluster backup files and their contents, seeSection 25.6.8.1, “NDB Cluster Backup Concepts”.

Like ndb_print_schema_file andndb_print_sys_file (and unlike most of the other NDB utilities that are intended to be run on a management server host or to connect to a management server) ndb_print_backup_file must be run on a cluster data node, since it accesses the data node file system directly. Because it does not make use of the management server, this utility can be used when the management server is not running, and even when the cluster has been completely shut down.

In NDB 8.0, this program can also be used to read undo log files.

Options

Prior to NDB 8.0.24, ndb_print_backup_file supported only the -P option. Beginning with NDB 8.0.24, the program supports a number of options, which are described in the following list.

• --backup-key,-K

  Command-Line Format	--backup-key=key
  Introduced	8.0.31-ndb-8.0.31
  Specify the key needed to decrypt an encrypted backup.

• --backup-key-from-stdin

  Command-Line Format	--backup-key-from-stdin
  Introduced	8.0.31-ndb-8.0.31
  Allow input of the decryption key from standard input, similar to entering a password after invokingmysql --password with no password supplied.

• --backup-password

  Command-Line Format	--backup-password=password
  Introduced	8.0.22-ndb-8.0.22
  Type	String
  Default Value	[none]
  Specify the password needed to decrypt an encrypted backup.
  The long form of this option is available beginning with NDB 8.0.24.

• --backup-password-from-stdin

  Command-Line Format	--backup-password-from-stdin
  Introduced	8.0.24-ndb-8.0.24
  Allow input of the password from standard input, similar to entering a password after invoking mysql --password with no password supplied.

• --control-directory-number

  Command-Line Format	--control-directory-number=#
  Introduced	8.0.24-ndb-8.0.24
  Type	Integer
  Default Value	0
  Control file directory number. Used together with--print-restored-rows.

• --defaults-extra-file

  Command-Line Format	--defaults-extra-file=path
  Type	String
  Default Value	[none]
  Read given file after global files are read.

• --defaults-file

  Command-Line Format	--defaults-file=path
  Type	String
  Default Value	[none]
  Read default options from given file only.

• --defaults-group-suffix

  Command-Line Format	--defaults-group-suffix=string
  Type	String
  Default Value	[none]
  Also read groups with concat(group, suffix).

• --fragment-id

  Command-Line Format	--fragment-id=#
  Introduced	8.0.24-ndb-8.0.24
  Type	Integer
  Default Value	0
  Fragment ID. Used together with--print-restored-rows.

• --help

  Command-Line Format	--help--usage
  Introduced	8.0.24-ndb-8.0.24
  Print program usage information.

• --login-path

  Command-Line Format	--login-path=path
  Type	String
  Default Value	[none]
  Read given path from login file.

• --no-defaults

  Command-Line Format	--no-defaults
  Do not read default options from any option file other than login file.

• --no-print-rows

  Command-Line Format	--no-print-rows
  Introduced	8.0.24-ndb-8.0.24
  Do not include rows in output.

• --print-defaults

  Command-Line Format	--print-defaults
  Print program argument list and exit.

• --print-header-words

  Command-Line Format	--print-header-words
  Introduced	8.0.24-ndb-8.0.24
  Include header words in output.

• --print-restored-rows

  Command-Line Format	--print-restored-rows
  Introduced	8.0.24-ndb-8.0.24
  Include restored rows in output, using the fileLCP/_`c`_/T_`t`_F_`f`_.ctl, for which the values are set as follows:

  • c is the control file number set using--control-directory-number
  • t is the table ID set using--table-id
  • f is the fragment ID set using--fragment-id
• --print-rows

  Command-Line Format	--print-rows
  Introduced	8.0.24-ndb-8.0.24
  Print rows. This option is enabled by default; to disable it, use--no-print-rows.

• --print-rows-per-page

  Command-Line Format	--print-rows-per-page
  Introduced	8.0.24-ndb-8.0.24
  Print rows per page.

• --rowid-file

  Command-Line Format	--rowid-file=path
  Introduced	8.0.24-ndb-8.0.24
  Type	File name
  Default Value	[none]
  File to check for row ID.

• --show-ignored-rows

  Command-Line Format	--show-ignored-rows
  Introduced	8.0.24-ndb-8.0.24
  Show ignored rows.

• --table-id

  Command-Line Format	--table-id=#
  Introduced	8.0.24-ndb-8.0.24
  Type	Integer
  Default Value	[none]
  Table ID. Used together with--print-restored-rows.

• --usage

  Command-Line Format	--usage
  Display help text and exit; same as--help.

• --verbose

  Command-Line Format	--verbose[=#]
  Introduced	8.0.24-ndb-8.0.24
  Type	Integer
  Default Value	0
  Verbosity level of output. A greater value indicates increased verbosity.

• --version

  Command-Line Format	--version
  Display version information and exit.