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

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]`