5.15 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 5.14 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 8.3)
--connect-retries=#	Number of times to retry connection before giving up	(Supported in all NDB releases based on MySQL 8.3)
--connect-retry-delay=#	Number of seconds to wait between attempts to contact management server	(Supported in all NDB releases based on MySQL 8.3)
--connect-string=connection_string, -c connection_string	Same as --ndb-connectstring	(Supported in all NDB releases based on MySQL 8.3)
--database=name, -d name	Name of database in which table is found	(Supported in all NDB releases based on MySQL 8.3)
--defaults-extra-file=path	Read given file after global files are read	(Supported in all NDB releases based on MySQL 8.3)
--defaults-file=path	Read default options from given file only	(Supported in all NDB releases based on MySQL 8.3)
--defaults-group-suffix=string	Also read groups with concat(group, suffix)	(Supported in all NDB releases based on MySQL 8.3)
--drop-source	Drop source table after all rows have been moved	(Supported in all NDB releases based on MySQL 8.3)
--error-insert	Insert random temporary errors (used in testing)	(Supported in all NDB releases based on MySQL 8.3)
--exclude-missing-columns	Ignore extra columns in source or target table	(Supported in all NDB releases based on MySQL 8.3)
--help, -?	Display help text and exit	(Supported in all NDB releases based on MySQL 8.3)
--login-path=path	Read given path from login file	(Supported in all NDB releases based on MySQL 8.3)
--no-login-paths	Do not read login paths from the login path file	(Supported in all NDB releases based on MySQL 8.3)
--lossy-conversions, -l	Allow attribute data to be truncated when converted to smaller type	(Supported in all NDB releases based on MySQL 8.3)
--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 8.3)
--ndb-mgm-tls=level	ndb_mgm client TLS requirement level	ADDED: 8.3.0
--ndb-mgmd-host=connection_string, -c connection_string	Same as --ndb-connectstring	(Supported in all NDB releases based on MySQL 8.3)
--ndb-nodeid=#	Set node ID for this node, overriding any ID set by --ndb-connectstring	(Supported in all NDB releases based on MySQL 8.3)
--ndb-tls-search-path=list	List of directories containing TLS keys and certificates	ADDED: 8.3.0
--no-defaults	Do not read default options from any option file other than login file	(Supported in all NDB releases based on MySQL 8.3)
--print-defaults	Print program argument list and exit	(Supported in all NDB releases based on MySQL 8.3)
--promote-attributes, -A	Allow attribute data to be converted to larger type	(Supported in all NDB releases based on MySQL 8.3)
--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 8.3)
--usage, -?	Display help text and exit; same as --help	(Supported in all NDB releases based on MySQL 8.3)
--verbose	Enable verbose messages	(Supported in all NDB releases based on MySQL 8.3)
--version, -V	Display version information and exit	(Supported in all NDB releases based on MySQL 8.3)

• --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.

• --no-login-paths

  Command-Line Format	--no-login-paths

  Skips reading options from the login path 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 connection string for connecting to ndb_mgmd. Syntax: [nodeid=id;][host=]hostname[:port]. Overrides entries in NDB_CONNECTSTRING and my.cnf.

• --ndb-mgm-tls

  Command-Line Format	--ndb-mgm-tls=level
  Type	Enumeration
  Default Value	relaxed
  Valid Values	relaxed strict

  Sets the level of TLS support required to connect to the management server; one of relaxed or strict. relaxed (the default) means that a TLS connection is attempted, but success is not required; strict means that TLS is required to connect.

• --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.

• --ndb-tls-search-path

  Command-Line Format	--ndb-tls-search-path=list
  Type	Path name
  Default Value (Unix)	$HOME/ndb-tls
  Default Value (Windows)	$HOMEDIR/ndb-tls

  Specify a list of directories to search for a CA file. On Unix platforms, the directory names are separated by colons (:); on Windows systems, the semicolon character (;) is used as the separator. A directory reference may be relative or absolute; it may contain one or more environment variables, each denoted by a prefixed dollar sign ($), and expanded prior to use.

  Searching begins with the leftmost named directory and proceeds from left to right until a file is found. An empty string denotes an empty search path, which causes all searches to fail. A string consisting of a single dot (.) indicates that the search path limited to the current working directory.

  If no search path is supplied, the compiled-in default value is used. This value depends on the platform used: On Windows, this is \ndb-tls; on other platforms (including Linux), it is $HOME/ndb-tls. This can be overridden by compiling NDB Cluster using -DWITH_NDB_TLS_SEARCH_PATH.

• --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.