--allow-pk-changes

当此选项设置为时1， ndb_restore允许表定义中的主键与备份中同一表的主键不同。当在一个或多个表上的主键更改的不同模式版本之间备份和恢复时，这可能是可取的，并且看起来使用 ndb_restore 执行恢复操作比 ALTER TABLE在恢复表模式和数据后发出许多语句更简单或更有效。

支持主键定义的以下更改--allow-pk-changes：

这些差异可以与ndb_restore支持的其他模式差异相结合，包括对需要使用暂存表的 blob 和文本列的更改。

此处列出了使用主键架构更改的典型场景中的基本步骤：

扩展主键时， ndb_restore 可能需要 在还原操作期间使用临时辅助唯一索引从旧主键映射到新主键。仅当需要将备份日志中的事件应用到具有扩展主键的表时才创建此类索引。这个索引被命名为 NDB$RESTORE_PK_MAPPING，并在每个需要它的表上创建；如有必要，它可以由 并行运行的多个ndb_restore实例共享。（在恢复过程结束时 运行 ndb_restore会导致该索引被删除。） --rebuild-indexes

--append

当与--tab 和--print-data 选项一起使用时，这会导致数据附加到任何具有相同名称的现有文件。

--backup-path=dir_name

备份目录的路径是必需的；这是使用 选项提供给ndb_restore--backup-path的，并且必须包括与要恢复的备份的 ID 备份对应的子目录。例如，如果数据节点的 DataDir是 /var/lib/mysql-cluster，那么备份目录是 /var/lib/mysql-cluster/BACKUP，ID 为 3 的备份的备份文件可以在 /var/lib/mysql-cluster/BACKUP/BACKUP-3. 该路径可以是绝对路径或相对于ndb_restore可执行文件所在目录的路径，并且可以选择以 backup-path=.

可以将备份恢复到具有与创建时不同的配置的数据库。例如，假设备份 ID 为 的备份 12是在具有两个节点 ID为2和 的存储节点的集群中创建的3，要恢复到具有四个节点的集群。然后ndb_restore必须运行两次——对集群中进行备份的每个存储节点运行一次。但是， ndb_restore不能总是将运行一个版本的 MySQL 的集群所做的备份还原到运行不同 MySQL 版本的集群。看 第 21.3.7 节，“升级和降级 NDB Cluster”，了解更多信息。

为了更快速地恢复，可以并行恢复数据，前提是有足够数量的可用集群连接。也就是说，当并行恢复到多个节点时，您必须 在集群文件中有一个[api]或部分可用于每个并发的ndb_restore 进程。但是，数据文件必须始终在日志之前应用。 [mysqld]config.ini

--backupid= #, -b

此选项用于指定备份的 ID 或序列号，与管理客户端在 备份完成时显示的消息中显示的编号相同。（请参阅 第 21.6.8.2 节，“使用 NDB Cluster Management Client 创建备份”。） Backup backup_id completed

在 NDB 7.5.13 及更高版本以及 NDB 7.6.9 及更高版本中，此选项是必需的。

--character-sets-dir

包含字符集的目录。

--connect,-c

的别名 --ndb-connectstring。

--connect-retries

放弃前重试连接的次数。

--connect-retry-delay

尝试联系管理服务器之间等待的秒数。

--connect-string

与 相同 --ndb-connectstring。

--core-file

写入核心文件出错；在调试中使用。

--defaults-extra-file

读取全局文件后读取给定文件。

--defaults-file

仅从给定文件中读取默认选项。

--defaults-group-suffix

还可以阅读带有 concat(group, suffix) 的组。

--disable-indexes

NDB在从本机备份 恢复数据期间禁用索引恢复。之后，您可以使用 多线程索引构建一次恢复所有表的索引 --rebuild-indexes，这应该比同时为非常大的表重建索引更快。

从 NDB 7.5.24 和 NDB 7.6.20 开始，此选项还会删除备份中指定的任何外键。

--dont-ignore-systab-0,-f

通常，在恢复表数据和元数据时， ndb_restore 会NDB忽略备份中存在的系统表 副本 。--dont-ignore-systab-0导致系统表被恢复。此选项仅供实验和开发使用，不建议在生产环境中使用。

--exclude-databases=db-list

不应恢复的一个或多个数据库的逗号分隔列表。

此选项通常与 --exclude-tables;结合使用 有关更多信息和示例，请参阅该选项的描述。

--exclude-intermediate-sql-tables[=TRUE|FALSE]

执行复制ALTER TABLE操作时，mysqld 创建中间表（其名称以 为前缀 #sql-）。当 时TRUE，该 --exclude-intermediate-sql-tables选项会阻止ndb_restore恢复这些操作可能遗留下来的此类表。这个选项是TRUE默认的。

--exclude-missing-columns

可以使用此选项仅还原选定的表列，这会导致ndb_restore忽略与备份中找到的那些表的版本相比，正在还原的表中丢失的任何列。此选项适用于所有正在恢复的表。如果您希望仅将此选项应用于选定的表或数据库，您可以将它与本节其他地方描述的一个或多个选项结合使用--include-*， --exclude-*然后使用这些的补充集将数据恢复到其余表选项。

--exclude-missing-tables

可以使用此选项仅还原选定的表，这会导致ndb_restore忽略备份中未在目标数据库中找到的任何表。

--exclude-tables=table-list

要排除的一个或多个表的列表；每个表引用必须包含数据库名称。常与 一起使用 --exclude-databases。

使用--exclude-databasesor 时--exclude-tables，只排除选项命名的那些数据库或表；所有其他数据库和表都由 ndb_restore恢复。

此 table 显示了 ndb_restore usng --exclude-*选项的几个调用（为清楚起见，省略了可能需要的其他选项），以及这些选项对从 NDB Cluster 备份恢复的影响：

您可以同时使用这两个选项。例如，以下会导致所有数据库中的所有表 被恢复 ，除了数据库 db1和，以及数据库中的db2表t1和：t2db3

$> ndb_restore [...] --exclude-databases=db1,db2 --exclude-tables=db3.t1,db3.t2

（同样，为了清楚和简洁起见，我们从刚刚显示的示例中省略了其他可能必要的选项。）

您可以一起使用--include-*和 --exclude-*选项，但要遵守以下规则：

例如，以下选项集导致 ndb_restore从数据库中恢复所有表，db1除了 db1.t1，同时不从任何其他数据库恢复其他表：

--include-databases=db1 --exclude-tables=db1.t1

然而，颠倒刚刚给出的选项的顺序只会导致数据库 db1中的所有表被恢复（包括 db1.t1，但不包括任何其他数据库中的表），因为 --include-databases 最右边的选项是与数据库的第一个匹配项db1，因此需要优先于匹配的任何其他选项 db1或任何表 db1：

--exclude-tables=db1.t1 --include-databases=db1

--fields-enclosed-by=char

每个列值都包含在传递给此选项的字符串中（无论数据类型如何；请参阅 的说明 --fields-optionally-enclosed-by）。

--fields-optionally-enclosed-by

传递给此选项的字符串用于包含包含字符数据（例如 CHAR、 VARCHAR、 BINARY、 TEXT或 ENUM）的列值。

--fields-terminated-by=char

传递给此选项的字符串用于分隔列值。默认值为制表符 ( \t)。

--help

显示帮助文本并退出。

--hex

如果使用此选项，所有二进制值都以十六进制格式输出。

--ignore-extended-pk-updates

使用该 --allow-pk-changes 选项时，在进行备份时不得更新成为表主键一部分的列；这些列应该保持相同的值，从时间值插入到它们，直到包含值的行被删除。如果ndb_restore 在还原备份时遇到对这些列的更新，则还原失败。因为某些应用程序可能会在更新行时为所有列设置值，即使某些列值未更改，备份也可能包括看似更新列但实际上并未修改的日志事件。在这种情况下，您可以设置 --ignore-extended-pk-updates为 1，强制ndb_restore 忽略此类更新。

有关详细信息，请参阅 的说明 --allow-pk-changes。

--include-databases=db-list

要恢复的一个或多个数据库的逗号分隔列表。经常与 --include-tables;一起使用 有关更多信息和示例，请参阅该选项的描述。

--include-tables=table-list

要恢复的表的逗号分隔列表；每个表引用必须包含数据库名称。

当使用--include-databases或 时--include-tables，只恢复那些以该选项命名的数据库或表；所有其他数据库和表都被 ndb_restore排除，并且不会被恢复。

下表显示了 使用 选项的ndb_restore--include-*的几个调用（为清楚起见，省略了可能需要的其他选项），以及这些对从 NDB Cluster 备份恢复的影响：

您也可以同时使用这两个选项。例如，以下导致数据库 db1和中的所有表以及 数据库db2中的表和表都被还原（而不是其他数据库或表）： t1t2db3

$> ndb_restore [...] --include-databases=db1,db2 --include-tables=db3.t1,db3.t2

（在刚刚显示的示例中，我们再次省略了其他可能需要的选项。）

也可以仅恢复选定的数据库或从单个数据库中选定的表，而无需任何 --include-*（或 --exclude-*）选项，使用此处显示的语法：

ndb_restore other_options db_name,[db_name[,...] | tbl_name[,tbl_name][,...]]

换句话说，您可以指定要恢复的以下任一项：

--lines-terminated-by=char

指定用于结束每行输出的字符串。默认为换行符 ( \n)。

--login-path

从登录文件中读取给定路径。

--lossy-conversions,-L

该选项旨在补充该 --promote-attributes 选项。使用--lossy-conversions允许在从备份恢复数据时对列值进行有损转换（类型降级或符号更改）。除了一些例外，管理降级的规则与 MySQL 复制相同；有关属性降级当前支持的特定类型转换的信息， 请参阅 第 16.4.1.10.2 节，“具有不同数据类型的列的复制” 。

从 NDB 7.5.23 和 NDB 7.6.19 开始，此选项还可以将NULL 列还原为NOT NULL. 该列不得包含任何NULL条目；否则 ndb_restore会因错误而停止。

ndb_restore报告它在每个属性和列的有损转换期间执行的任何数据截断。

--ndb-connectstring

设置用于连接到 ndb_mgmd 的连接字符串。语法：“[nodeid=id;][host=]hostname[:port]”。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目。

--ndb-mgmd-host

与 相同 --ndb-connectstring。

--ndb-nodegroup-map= map, -z

旨在将一个节点组的备份恢复到另一个节点组，但从未完全实现；不受支持。

--ndb-nodeid

为此节点设置节点 ID，覆盖由 设置的任何 ID --ndb-connectstring。

--ndb-optimized-node-selection

为交易节点的选择启用优化。默认启用；用于 --skip-ndb-optimized-node-selection禁用。

--no-binlog

此选项可防止任何连接的 SQL 节点将ndb_restore恢复的数据写入其二进制日志。

--no-defaults

不要从登录文件以外的任何选项文件中读取默认选项。

--no-restore-disk-objects, -d

此选项阻止ndb_restore恢复任何 NDB Cluster 磁盘数据对象，例如表空间和日志文件组；有关这些的更多信息， 请参阅 第 21.6.11 节，“NDB Cluster 磁盘数据表” 。

--no-upgrade,-u

当使用ndb_restore恢复备份时，VARCHAR使用旧的固定格式创建的列将使用现在使用的可变宽度格式调整大小并重新创建。可以通过指定来覆盖此行为 --no-upgrade。

--nodeid= #, -n

指定在其上进行备份的数据节点的节点 ID。

当还原到具有与进行备份的数据节点数量不同的数据节点的集群时，此信息有助于识别要还原到给定节点的正确的一组或多组文件。（在这种情况下，通常需要将多个文件恢复到单个数据节点。）有关 其他信息和示例， 请参阅第 21.5.24.2 节，“恢复到不同数量的数据节点” 。

在 NDB 7.5.13 及更高版本以及 NDB 7.6.9 及更高版本中，此选项是必需的。

--num-slices=#

按切片还原备份时，此选项设置要将备份划分为的切片数。这允许ndb_restore的多个实例 并行恢复不相交的子集，从而可能减少执行恢复操作所需的时间。

切片是给定备份中数据的子集 ；也就是说，它是一组具有相同切片 ID 的片段，使用 --slice-id选项指定。这两个选项必须始终一起使用，并且设置的值--slice-id必须始终小于切片数。

ndb_restore遇到片段并为每个片段分配一个片段计数器。按分片恢复时，为每个分片分配一个分片ID；此切片 ID 在 0 到 1 的范围内，小于切片数。对于不是表的 BLOB表，使用此处显示的公式确定给定片段所属的切片：

[slice_ID] = [fragment_counter] % [number_of_slices]

对于BLOB表，不使用分片计数器；而是使用片段号以及表的主表 ID BLOB（回想一下， 在内部NDB将 BLOB值存储在单独的表中）。在这种情况下，给定片段的切片 ID 的计算方式如下所示：

[slice_ID] =
([main_table_ID] + [fragment_ID]) % [number_of_slices]

因此，通过N切片恢复意味着运行ndb_restoreN的实例 ，所有实例都带有 （连同任何其他必要的选项）并且每个都带有 , , , 等等 。 --num-slices=N--slice-id=1--slice-id=2--slice-id=3slice-id=N-1

--parallelism= #, -p

ndb_restore使用单行事务同时应用多行。此参数确定ndb_restore实例尝试使用的并行事务（并发行）的数量默认情况下，这是 128；最小为 1，最大为 1024。

执行插入的工作在所涉及的数据节点中的线程之间并行进行。该机制用于从 .Data文件中恢复批量数据——即数据的模糊快照；它不用于构建或重建索引。更改日志是串行应用的；索引删除和构建是 DDL 操作并单独处理。还原的客户端没有线程级并行性。

--preserve-trailing-spaces, -P

CHAR在将固定宽度字符数据类型提升为其等价的可变宽度字符数据类型时，即在将列值提升为 VARCHAR，或将 BINARY列值 提升为 时，导致保留尾随空格 VARBINARY。否则，在将这些列值插入新列时，将从这些列值中删除任何尾随空格。

--print

导致ndb_restore将所有数据、元数据和日志打印到stdout. 相当于同时使用 --print-data、 --print-meta和 --print-log选项。

--print-data

导致ndb_restore将其输出定向到 stdout. 通常与--tab、 --fields-enclosed-by、 --fields-optionally-enclosed-by、 --fields-terminated-by、 --hex和 中的一个或多个一起使用--append。

TEXT并且 BLOB列值总是被截断。此类值在输出中被截断为前 256 个字节。这在使用时目前不能被覆盖--print-data。

--print-defaults

打印程序参数列表并退出。

--print-log

导致ndb_restore将其日志输出到 stdout.

--print-meta

将所有元数据打印到stdout.

print-sql-log

将 SQL 语句记录到stdout. 使用选项启用；通常此行为被禁用。该选项在尝试记录之前检查是否所有正在恢复的表都明确定义了主键；对仅具有隐藏主键的表的查询NDB无法转换为有效的 SQL。

此选项不适用于具有 BLOB列的表。

该--print-sql-log 选项是在 NDB 7.5.4 中添加的。（漏洞 #13511949）

--progress-frequency=N

N 在备份过程中每秒钟 打印一份状态报告。0（默认值）导致不打印状态报告。最大值为 65535。

--promote-attributes,-A

ndb_restore支持有限 属性提升，其方式与 MySQL 复制支持的方式大致相同；也就是说，从给定类型的列备份的数据通常可以恢复到使用“更大、相似”类型的列。例如， CHAR(20)列中的数据可以恢复到声明为VARCHAR(20)、 VARCHAR(30)或 CHAR(30)；列中的数据 MEDIUMINT可以恢复到类型为 INT或 BIGINT。请参阅 第 16.4.1.10.2 节，“复制具有不同数据类型的列”，对于属性提升当前支持的类型转换表。

从 NDB 7.5.23 和 NDB 7.6.19 开始，此选项还可以将NOT NULL 列还原为NULL.

必须显式启用ndb_restore 的属性提升，如下所示：

字符数据类型和 TEXT或BLOB之间转换时，只能同时进行字符类型（CHARand VARCHAR）和二进制类型（BINARYand VARBINARY）之间的转换。例如，您不能 在对ndb_restore 的同一调用中将列提升INT到 的BIGINT同时将 VARCHAR列提升到。 TEXT

不支持在使​​用不同字符集的列之间进行转换TEXT ，并且明确禁止这样做。

当执行字符或二进制类型到 ndb_restoreTEXT或BLOB使用 ndb_restore的转换时，您可能会注意到它创建并使用一个或多个名为 . 之后不需要这些表，并且通常在成功恢复 后由ndb_restore删除。table_name$STnode_id

--rebuild-indexes

NDB在恢复本机备份 时启用有序索引的多线程重建。使用此选项 的ndb_restore用于构建有序索引的线程数 由BuildIndexThreads 数据节点配置参数和 LDM 数控制。

仅在首次运行ndb_restore 时才需要使用此选项 ；--rebuild-indexes这会导致在恢复后续节点时无需再次使用而重建所有有序索引 。您应该在将新行插入数据库之前使用此选项；否则，插入的行可能会在稍后尝试重建索引时导致违反唯一约束。

默认情况下，有序索引的构建与 LDM 的数量并行。BuildIndexThreads 使用数据节点配置参数可以更快地在节点和系统重启期间执行离线索引构建 ；此参数对联机执行的ndb_restore删除和重建索引没有影响 。

唯一索引的重建使用磁盘写入带宽进行重做日志记录和本地检查点。此带宽量不足会导致重做缓冲区过载或日志过载错误。在这种情况下，您可以再次运行 ndb_restore --rebuild-indexes；该过程从发生错误的地方恢复。您也可以在遇到临时错误时执行此操作。您可以无限期地重复执行ndb_restore --rebuild-indexes；您可以通过减小 的值来阻止此类错误 --parallelism。如果问题是空间不足，可以增加重做日志的大小（FragmentLogFileSize 节点配置参数），或者您可以提高执行 LCP 的速度（MaxDiskWriteSpeed 以及相关参数），以便更快地释放空间。

--remap-column=db.tbl.col:fn:args

当与 一起使用时 --restore-data，此选项将函数应用于指定列的值。此处列出了参数字符串中的值：

当您希望使用 NDB 本机备份将存储在 NDB Cluster 的多个源实例（全部使用相同模式）中的数据合并到单个目标 NDB Cluster 时，此选项可能很有用（请参阅 第 21.6.8.2 节，“使用 NDB Cluster 管理客户端创建备份”）和ndb_restore合并数据，其中主键值和唯一键值在源集群之间重叠，并且作为过程的一部分，有必要将这些值重新映射到不重叠的范围。可能还需要保留表之间的其他关系。为了满足这些要求，可以在同 一次 ndb_restore调用中多次使用该选项来重新映射不同表的列，如下所示：

$> ndb_restore --restore-data --remap-column=hr.employee.id:offset:1000 \
    --remap-column=hr.manager.id:offset:1000 --remap-column=hr.firstaiders.id:offset:1000

（也可以使用此处未显示的其他选项。）

--remap-column也可用于更新同一个表的多个列。多个表和列的组合是可能的。同一张表的不同列也可以使用不同的偏移值，像这样：

$> ndb_restore --restore-data --remap-column=hr.employee.salary:offset:10000 \
    --remap-column=hr.employee.hours:offset:-10

当源备份包含不应合并的重复表时，您可以通过在应用程序中使用 、 或其他方式来处理此 --exclude-tables问题 --exclude-databases。

可以使用 ; 获取有关要合并的表的结构和其他特征的信息 SHOW CREATE TABLE；ndb_desc 工具；和 MAX()、 MIN()、 LAST_INSERT_ID()和其他 MySQL 函数。

不支持在 NDB Cluster 的单独实例中将更改从合并表复制到未合并表，或从未合并表复制到合并表。

--restore-data,-r

输出NDB表数据和日志。

--restore-epoch,-e

向集群复制状态表添加（或恢复）纪元信息。这对于在 NDB 副本集群上启动复制很有用。使用此选项时，如果列中的 mysql.ndb_apply_statushaving 0中的行id已经存在，则更新；如果该行尚不存在，则插入该行。（请参阅 第 21.7.9 节，“使用 NDB Cluster 复制的 NDB Cluster 备份”。）

--restore-meta,-m

此选项导致ndb_restore打印 NDB表元数据。

第一次运行ndb_restore 恢复程序时，还需要恢复元数据。换句话说，您必须重新创建数据库表——这可以通过使用 --restore-meta( -m) 选项运行它来完成。恢复元数据只需要在单个数据节点上完成；这足以将其恢复到整个集群。

在旧版本的 NDB Cluster 中，使用此选项恢复模式的表使用与原始集群相同数量的分区，即使它与新集群的数据节点数量不同。在 NDB 7.5.2 及更高版本中，恢复元数据时，这不再是问题；ndb_restore现在使用目标集群的默认分区数，除非本地数据管理器线程的数量也从原始集群中的数据节点改变。

--restore-privilege-tables

ndb_restore默认情况下不恢复分布式 MySQL 权限表。此选项导致 ndb_restore恢复特权表。

这仅在权限表转换为 NDB备份之前有效。有关详细信息，请参阅 第 21.6.13 节，“使用共享授权表的分布式权限”。

--rewrite-database=olddb,newdb

此选项可以恢复到与备份中使用的名称不同的数据库。例如，如果备份由名为 的数据库组成 products，您可以将其包含的数据恢复到名为 的数据库inventory，使用此选项如下所示（省略可能需要的任何其他选项）：

$> ndb_restore --rewrite-database=product,inventory

该选项可以在一次ndb_restore调用中多次使用。因此，可以同时从一个名为 的数据库恢复到一个名为 db1的数据库 db2，以及从一个名为 的 数据库恢复db3到一个名为db4 using的数据库--rewrite-database=db1,db2 --rewrite-database=db3,db4。其他 ndb_restore选项可以在多次出现之间使用--rewrite-database。

如果多个选项之间发生冲突 --rewrite-database，则最后 --rewrite-database使用的选项（从左到右阅读）生效。例如，如果--rewrite-database=db1,db2 --rewrite-database=db1,db3被使用，则只有 --rewrite-database=db1,db3被尊重， --rewrite-database=db1,db2被忽略。也可以从多个数据库还原到单个数据库，以便--rewrite-database=db1,db3 --rewrite-database=db2,db3将所有表和数据从数据库还原db1到 db2数据库db3中。

--skip-broken-objects

此选项导致ndb_restore在读取本机备份时忽略损坏的表 NDB，并继续恢复任何剩余的表（未损坏的表）。目前，该 --skip-broken-objects选项仅在缺少 blob 部分表的情况下有效。

--skip-table-check,-s

可以在不恢复表元数据的情况下恢复数据。默认情况下，如果在表数据和表模式之间发现不匹配， 则ndb_restore 会失败并出现错误；此选项会覆盖该行为。

放宽了使用ndb_restore 恢复数据时对列定义不匹配的一些限制；当遇到其中一种类型的不匹配时，ndb_restore不会像以前那样因错误而停止，而是接受数据并将其插入到目标表中，同时向用户发出警告，表明正在这样做。无论是否正在使用任一选项 --skip-table-check或 ，都会出现此行为--promote-attributes。列定义中的这些差异具有以下类型：

--skip-unknown-objects

此选项导致ndb_restoreNDB在读取本机备份时忽略它无法识别的任何模式对象。这可用于恢复从运行（例如）NDB 7.6 的集群到运行 NDB Cluster 7.5 的集群的备份。

--slice-id=#

按切片恢复时，这是要恢复的切片的 ID。此选项始终与 一起使用 --num-slices，并且其值必须始终小于 的值 --num-slices。

更多信息请参见 --num-slices本节其他部分的描述。

--tab= dir_name, -T dir_name

导致--print-data创建转储文件，每个表一个，每个名为 tbl_name.txt. 它需要将文件保存目录的路径作为参数；用于.当前目录。

--usage

显示帮助文本并退出；一样 --help。

--verbose=#

设置输出的详细级别。最小为0；最大值为 255。默认值为 1。

--version

显示版本信息并退出。