### 23.5.15 ndb\_move\_data — NDB Data Copy Utility

[]()

[**ndb\_move\_data**](mysql-cluster-programs-ndb-move-data.html) 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**](mysql-cluster-programs-ndb-move-data.html) are shown in the following table. Additional descriptions follow the table.

[]()

**Table 23.37 Command-line options used with the program ndb\_move\_data**

|                                                                                                                      Format                                                                                                                      |                                                                  Description                                                                   |           Added, Deprecated, or Removed           |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|
|                                                                      ` [--abort-on-error](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_abort-on-error) `                                                                       |                                                  Dump core on permanent error (debug option)                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                ` [--character-sets-dir=path](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_character-sets-dir) `                                                                |                                                       Directory where character sets are                                                       | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                    ` [--connect-retries=#](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_connect-retries) `                                                                     |                                              Number of times to retry connection before giving up                                              | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                ` [--connect-retry-delay=#](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_connect-retry-delay) `                                                                 |                                    Number of seconds to wait between attempts to contact management server                                     | (Supported in all NDB releases based on MySQL 8.0)|
|    `[--connect-string=connection_string](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_connect-string)`,<br/><br/>` [-c connection_string](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_connect-string) `     |                                                          Same as --ndb-connectstring                                                           | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                           ` [--core-file](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_core-file) `                                                                            |                                                  Write core file on error; used in debugging                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                          `[--database=name](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_database)`,<br/><br/>` [-d name](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_database) `                           |                                                    Name of database in which table is found                                                    | (Supported in all NDB releases based on MySQL 8.0)|
|                                                               ` [--defaults-extra-file=path](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_defaults-extra-file) `                                                               |                                                  Read given file after global files are read                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                     ` [--defaults-file=path](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_defaults-file) `                                                                     |                                                   Read default options from given file only                                                    | (Supported in all NDB releases based on MySQL 8.0)|
|                                                            ` [--defaults-group-suffix=string](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_defaults-group-suffix) `                                                            |                                                  Also read groups with concat(group, suffix)                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                         ` [--drop-source](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_drop-source) `                                                                          |                                                Drop source table after all rows have been moved                                                | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                        ` [--error-insert](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_error-insert) `                                                                         |                                                Insert random temporary errors (used in testing)                                                | (Supported in all NDB releases based on MySQL 8.0)|
|                                                             ` [--exclude-missing-columns](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_exclude-missing-columns) `                                                              |                                                 Ignore extra columns in source or target table                                                 | (Supported in all NDB releases based on MySQL 8.0)|
|                                     `[--help](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_help)`,<br/><br/>` [-?](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_help) `                                      |                                                           Display help text and exit                                                           | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                        ` [--login-path=path](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_login-path) `                                                                        |                                                        Read given path from login file                                                         | (Supported in all NDB releases based on MySQL 8.0)|
|                  `[--lossy-conversions](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_lossy-conversions)`,<br/><br/>` [-l](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_lossy-conversions) `                  |                                      Allow attribute data to be truncated when converted to smaller type                                       | (Supported in all NDB releases based on MySQL 8.0)|
|`[--ndb-connectstring=connection_string](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_ndb-connectstring)`,<br/><br/>` [-c connection_string](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_ndb-connectstring) `|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.0)|
|      `[--ndb-mgmd-host=connection_string](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_ndb-mgmd-host)`,<br/><br/>` [-c connection_string](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_ndb-mgmd-host) `      |                                                          Same as --ndb-connectstring                                                           | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                         ` [--ndb-nodeid=#](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_ndb-nodeid) `                                                                          |                                    Set node ID for this node, overriding any ID set by --ndb-connectstring                                     | (Supported in all NDB releases based on MySQL 8.0)|
|                                                        ` [--ndb-optimized-node-selection](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_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 8.0)|
|                                                                         ` [--no-defaults](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_no-defaults) `                                                                          |                                     Do not read default options from any option file other than login file                                     | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                      ` [--print-defaults](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_print-defaults) `                                                                       |                                                      Print program argument list and exit                                                      | (Supported in all NDB releases based on MySQL 8.0)|
|                `[--promote-attributes](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_promote-attributes)`,<br/><br/>` [-A](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_promote-attributes) `                 |                                              Allow attribute data to be converted to larger type                                               | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                  ` [--staging-tries=x[,y[,z]]](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_staging-tries) `                                                                   |           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.0)|
|                                    `[--usage](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_usage)`,<br/><br/>` [-?](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_usage) `                                    |                                                   Display help text and exit; same as --help                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                             ` [--verbose](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_verbose) `                                                                              |                                                            Enable verbose messages                                                             | (Supported in all NDB releases based on MySQL 8.0)|
|                                 `[--version](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_version)`,<br/><br/>` [-V](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_version) `                                 |                                                      Display version information and exit                                                      | (Supported in all NDB releases based on MySQL 8.0)|

* []() `--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`](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_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`](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_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`](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_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`](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_help).

* []() `--verbose`

  []()[]()

  |Command-Line Format|`--verbose`|
  |-------------------|-----------|

   Enable verbose messages.

* []() `--version`

  []()[]()

  |Command-Line Format|`--version`|
  |-------------------|-----------|

   Display version information and exit.

