MySQL 8.0 Reference Manual Including MySQL NDB Cluster 8.0
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
| Format | Description | Added, Deprecated, or Removed |
|---|---|---|
| Use this password to decrypt file | ADDED: NDB 8.0.31 |
|
| Get decryption key in a secure fashion from STDIN | ADDED: NDB 8.0.31 |
|
| Use this password to decrypt file | ADDED: NDB 8.0.22 |
|
| Get decryption password in a secure fashion from STDIN | ADDED: NDB 8.0.24 |
|
| Control directory number | ADDED: NDB 8.0.24 |
|
| Read given file after global files are read | (Supported in all NDB releases based on MySQL 8.0) |
|
| Read default options from given file only | (Supported in all NDB releases based on MySQL 8.0) |
|
| Also read groups with concat(group, suffix) | (Supported in all NDB releases based on MySQL 8.0) |
|
| Fragment ID | ADDED: NDB 8.0.24 |
|
|
Print usage information | ADDED: NDB 8.0.24 |
| Read given path from login file | (Supported in all NDB releases based on MySQL 8.0) |
|
| Do not read default options from any option file other than login file | (Supported in all NDB releases based on MySQL 8.0) |
|
| Do not print rows | ADDED: NDB 8.0.24 |
|
| Print program argument list and exit | (Supported in all NDB releases based on MySQL 8.0) |
|
| Print header words | ADDED: NDB 8.0.24 |
|
| Print restored rows | ADDED: NDB 8.0.24 |
|
| Print rows. Enabled by default; disable with --no-print-rows | ADDED: NDB 8.0.24 |
|
| Print rows per page | ADDED: NDB 8.0.24 |
|
| File containing row ID to check for | ADDED: NDB 8.0.24 |
|
| Show ignored rows | ADDED: NDB 8.0.24 |
|
| Table ID; used with --print-restored rows | ADDED: NDB 8.0.24 |
|
| Display help text and exit; same as --help | (Supported in all NDB releases based on MySQL 8.0) |
|
| Verbosity level | ADDED: NDB 8.0.24 |
|
| Display version information and exit | (Supported in all NDB releases based on MySQL 8.0) |
ndb_print_backup_file [-Ppassword]file_name
file_name 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 subdirectory
BACKUP-, where
## is the sequence number for the
backup. For more information about cluster backup files and
their contents, see
Section 25.6.8.1, “NDB Cluster Backup Concepts”.
Like ndb_print_schema_file and
ndb_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.
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.
| 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 invoking
mysql
--password with no password
supplied.
| 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.
| 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.
| 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.
| Command-Line Format | --defaults-extra-file=path |
|---|---|
| Type | String |
| Default Value | [none] |
Read given file after global files are read.
| Command-Line Format | --defaults-file=path |
|---|---|
| Type | String |
| Default Value | [none] |
Read default options from given file only.
| Command-Line Format | --defaults-group-suffix=string |
|---|---|
| Type | String |
| Default Value | [none] |
Also read groups with concat(group, suffix).
| 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.
| Command-Line Format |
|
|---|---|
| Introduced | 8.0.24-ndb-8.0.24 |
Print program usage information.
| Command-Line Format | --login-path=path |
|---|---|
| Type | String |
| Default Value | [none] |
Read given path from login file.
| Command-Line Format | --no-defaults |
|---|
Do not read default options from any option file other than login file.
| Command-Line Format | --no-print-rows |
|---|---|
| Introduced | 8.0.24-ndb-8.0.24 |
Do not include rows in output.
| Command-Line Format | --print-defaults |
|---|
Print program argument list and exit.
| Command-Line Format | --print-header-words |
|---|---|
| Introduced | 8.0.24-ndb-8.0.24 |
Include header words in output.
| Command-Line Format | --print-restored-rows |
|---|---|
| Introduced | 8.0.24-ndb-8.0.24 |
Include restored rows in output, using the file
LCP/,
for which the values are set as follows:
c/TtFf.ctl
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
| 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.
| Command-Line Format | --print-rows-per-page |
|---|---|
| Introduced | 8.0.24-ndb-8.0.24 |
Print rows per page.
| 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.
| Command-Line Format | --show-ignored-rows |
|---|---|
| Introduced | 8.0.24-ndb-8.0.24 |
Show ignored rows.
| 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.
| Command-Line Format | --usage |
|---|
Display help text and exit; same as
--help.
| 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.
| Command-Line Format | --version |
|---|
Display version information and exit.