21.5.16 ndb_move_data — NDB Data Copy Utility — MySQL 5.7

21.5.16 ndb_move_data — NDB Data Copy Utility

ndb_move_data copies data from one NDB table to another.

Usage

The program is invoked with the names of the source and target tables; either or both of these may be qualified optionally with the database name. Both tables must use the NDB storage engine.

ndb_move_data options source target

Options that can be used with ndb_move_data are shown in the following table. Additional descriptions follow the table.

Table 21.35 Command-line options used with the program ndb_move_data

Table 21.35 Command-line options used with the program ndb_move_data
Format	Description	Added, Deprecated, or Removed
`--abort-on-error`	Dump core on permanent error (debug option)	(Supported in all NDB releases based on MySQL 5.7)
`--character-sets-dir=path`	Directory where character sets are	(Supported in all NDB releases based on MySQL 5.7)
`--connect-retries=#`	Number of times to retry connection before giving up	(Supported in all NDB releases based on MySQL 5.7)
`--connect-retry-delay=#`	Number of seconds to wait between attempts to contact management server	(Supported in all NDB releases based on MySQL 5.7)
`--connect-string=connection_string`, `-c connection_string`	Same as --ndb-connectstring	(Supported in all NDB releases based on MySQL 5.7)
`--core-file`	Write core file on error; used in debugging	(Supported in all NDB releases based on MySQL 5.7)
`--database=name`, `-d name`	Name of database in which table is found	(Supported in all NDB releases based on MySQL 5.7)
`--defaults-extra-file=path`	Read given file after global files are read	(Supported in all NDB releases based on MySQL 5.7)
`--defaults-file=path`	Read default options from given file only	(Supported in all NDB releases based on MySQL 5.7)
`--defaults-group-suffix=string`	Also read groups with concat(group, suffix)	(Supported in all NDB releases based on MySQL 5.7)
`--drop-source`	Drop source table after all rows have been moved	(Supported in all NDB releases based on MySQL 5.7)
`--error-insert`	Insert random temporary errors (used in testing)	(Supported in all NDB releases based on MySQL 5.7)
`--exclude-missing-columns`	Ignore extra columns in source or target table	(Supported in all NDB releases based on MySQL 5.7)
`--help`, `-?`	Display help text and exit	(Supported in all NDB releases based on MySQL 5.7)
`--login-path=path`	Read given path from login file	(Supported in all NDB releases based on MySQL 5.7)
`--lossy-conversions`, `-l`	Allow attribute data to be truncated when converted to smaller type	(Supported in all NDB releases based on MySQL 5.7)
`--ndb-connectstring=connection_string`, `-c connection_string`	Set connect string for connecting to ndb_mgmd. Syntax: "[nodeid=id;][host=]hostname[:port]". Overrides entries in NDB_CONNECTSTRING and my.cnf	(Supported in all NDB releases based on MySQL 5.7)
`--ndb-mgmd-host=connection_string`, `-c connection_string`	Same as --ndb-connectstring	(Supported in all NDB releases based on MySQL 5.7)
`--ndb-nodeid=#`	Set node ID for this node, overriding any ID set by --ndb-connectstring	(Supported in all NDB releases based on MySQL 5.7)
`--ndb-optimized-node-selection`	Enable optimizations for selection of nodes for transactions. Enabled by default; use --skip-ndb-optimized-node-selection to disable	(Supported in all NDB releases based on MySQL 5.7)
`--no-defaults`	Do not read default options from any option file other than login file	(Supported in all NDB releases based on MySQL 5.7)
`--print-defaults`	Print program argument list and exit	(Supported in all NDB releases based on MySQL 5.7)
`--promote-attributes`, `-A`	Allow attribute data to be converted to larger type	(Supported in all NDB releases based on MySQL 5.7)
`--staging-tries=x[,y[,z]]`	Specify tries on temporary errors; format is x[,y[,z]] where x=max tries (0=no limit), y=min delay (ms), z=max delay (ms)	(Supported in all NDB releases based on MySQL 5.7)
`--usage`, `-?`	Display help text and exit; same as --help	(Supported in all NDB releases based on MySQL 5.7)
`--verbose`	Enable verbose messages	(Supported in all NDB releases based on MySQL 5.7)
`--version`, `-V`	Display version information and exit	(Supported in all NDB releases based on MySQL 5.7)

--abort-on-error

Command-Line Format --abort-on-error

Dump core on permanent error (debug option).
--character-sets-dir=name

Command-Line Format --character-sets-dir=path

Type String

Default Value [none]

Directory where character sets are.
--connect-retry-delay

Command-Line Format --connect-retry-delay=#

Type Integer

Default Value 5

Minimum Value 0

Maximum Value 5

Number of seconds to wait between attempts to contact management server.
--connect-retries

Command-Line Format --connect-retries=#

Type Integer

Default Value 12

Minimum Value 0

Maximum Value 12

Number of times to retry connection before giving up.
--connect-string

Command-Line Format --connect-string=connection_string

Type String

Default Value [none]

Same as --ndb-connectstring.
--core-file

Command-Line Format --core-file

Write core file on error; used in debugging.
--database=dbname, -d

Command-Line Format --database=name

Type String

Default Value TEST_DB

Name of the database in which the table is found.
--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).
--drop-source

Command-Line Format --drop-source

Drop source table after all rows have been moved.
--error-insert

Command-Line Format --error-insert

Insert random temporary errors (testing option).
--exclude-missing-columns

Command-Line Format --exclude-missing-columns

Ignore extra columns in source or target table.
--help

Command-Line Format --help

Display help text and exit.
--login-path

Command-Line Format --login-path=path

Type String

Default Value [none]

Read given path from login file.
--lossy-conversions, -l

Command-Line Format --lossy-conversions

Allow attribute data to be truncated when converted to a smaller type.
--ndb-connectstring

Command-Line Format --ndb-connectstring=connection_string

Type String

Default Value [none]

Set connect string for connecting to ndb_mgmd. Syntax: "[nodeid=id;][host=]hostname[:port]". Overrides entries in NDB_CONNECTSTRING and my.cnf.
--ndb-mgmd-host

Command-Line Format --ndb-mgmd-host=connection_string

Type String

Default Value [none]

Same as --ndb-connectstring.
--ndb-nodeid

Command-Line Format --ndb-nodeid=#

Type Integer

Default Value [none]

Set node ID for this node, overriding any ID set by --ndb-connectstring.
--ndb-optimized-node-selection

Command-Line Format --ndb-optimized-node-selection

Enable optimizations for selection of nodes for transactions. Enabled by default; use --skip-ndb-optimized-node-selection to disable.
--no-defaults

Command-Line Format --no-defaults

Do not read default options from any option file other than login file.
--print-defaults

Command-Line Format --print-defaults

Print program argument list and exit.
--promote-attributes, -A

Command-Line Format --promote-attributes

Allow attribute data to be converted to a larger type.
--staging-tries=x[,y[,z]]

Command-Line Format --staging-tries=x[,y[,z]]

Type String

Default Value 0,1000,60000

Specify tries on temporary errors. Format is x[,y[,z]] where x=max tries (0=no limit), y=min delay (ms), z=max delay (ms).
--usage

Command-Line Format --usage

Display help text and exit; same as --help.
--verbose

Command-Line Format --verbose

Enable verbose messages.
--version

Command-Line Format --version

Display version information and exit.

Command-Line Format	`--character-sets-dir=path`
Type	String
Default Value	`[none]`

Command-Line Format	`--connect-string=connection_string`
Type	String
Default Value	`[none]`

Command-Line Format	`--database=name`
Type	String
Default Value	`TEST_DB`

Command-Line Format	`--ndb-connectstring=connection_string`
Type	String
Default Value	`[none]`

Command-Line Format	`--ndb-mgmd-host=connection_string`
Type	String
Default Value	`[none]`