显示有关使用指定选项集进行的复制的信息，以及有关 HeatWave 服务兼容性检查结果的信息，但不执行复制。设置此选项使您能够在开始复制之前列出所有兼容性问题。默认值为 false。

显示 (true) 或隐藏 (false) 复制过程的进度信息。默认情况下，如果 stdout 是一个终端 (tty)，例如 MySQL Shell 处于交互模式，则为 true，否则为 false。进度信息包括估计要复制的总行数、已复制的行数、完成百分比以及每秒的行数和字节数的吞吐量。

用于从 MySQL 实例复制数据块的并行线程数。每个线程都与 MySQL 实例有自己的连接。默认值为 4。

复制实用程序需要两倍的线程数，一个线程用于复制，一个线程用于写入。如果 threads 设置为 N，则使用 2N 个线程。

复制过程中数据读取吞吐量每个线程的每秒最大字节数。可以使用单位后缀 k 表示千字节、M 表示兆字节和 G 表示吉字节（例如，设置 100M 将吞吐量限制为每个线程每秒 100 兆字节）。设置 0（这是默认值），或将选项设置为空字符串，表示不设置限制。

在 MySQL Shell 与目标服务器建立的会话连接期间使用的字符集。默认值为 utf8mb4。系统变量 character_set_client、character_set_connection 和 character_set_results 的会话值对于每个连接都设置为该值。字符集必须是 character_set_client 系统变量允许的，并且受 MySQL 实例支持。

如果启用，在转储时，将生成一个元数据文件 @.checksums.json，其中包含复制的校验和数据，从而实现数据验证。

如果在复制过程中 checksum: true，则适用以下条件

如果启用，实用程序将在加载相应数据后检查生成的校验和数据。验证仅限于转储的数据，忽略生成的隐藏主键等数据。

如果校验和不匹配或缺少表并且无法验证，则会返回错误。

如果 checksum: true 但没有加载数据，无论是由于 loadData: false 还是没有转储数据，实用程序都会根据受影响表的当前内容验证转储的校验和信息。

启用 (true) 或禁用 (false) 通过在复制过程中锁定实例以进行备份来执行一致性数据复制。默认值为 true。

当设置为 true 时，实用程序将使用 FLUSH TABLES WITH READ LOCK 语句设置全局读锁（如果用于运行实用程序的用户 ID 具有 RELOAD 权限），或者使用 LOCK TABLES 语句设置一系列表锁（如果用户 ID 没有 RELOAD 权限，但具有 LOCK TABLES 权限）。每个线程的事务使用语句 SET SESSION TRANSACTION ISOLATION LEVEL REPEATABLE READ 和 START TRANSACTION WITH CONSISTENT SNAPSHOT 启动。当所有线程都启动了事务后，实例将被锁定以进行备份（如 LOCK INSTANCE FOR BACKUP 和 UNLOCK INSTANCE 语句 中所述），并且全局读锁将被释放。

如果用户帐户没有 BACKUP_ADMIN 权限，并且无法执行 LOCK INSTANCE FOR BACKUP，则实用程序将在复制过程中进行额外的一致性检查。如果此检查失败，实例复制将停止，但模式或表复制将继续并返回错误消息以提醒用户一致性检查失败。

启用 (true) 或禁用 (false) 当 consistent: true 时执行的额外一致性检查。默认值为 false。

如果 consistent: false，则忽略此选项。

要将复制模式的内容加载到的目标模式。

如果模式不存在，则创建它，并将复制的模式加载到该新模式中。如果新模式名称与复制中的模式名称不同，则将复制加载到新模式中，但不会对加载的数据进行任何更改。也就是说，对旧模式名称的任何引用都保留在数据中。所有存储过程、视图等都引用原始模式，而不是新模式。

此加载选项支持单模式复制，或支持导致单模式的过滤选项。也就是说，如果您使用 copyInstance 将数据复制到新实例，则可以在源仅包含一个模式或定义的过滤器导致单个模式被复制到目标时，将所有数据复制到单个模式中。

通过发出 SET sql_log_bin=0 语句，跳过目标 MySQL 实例上实用程序在复制过程中使用的会话的二进制日志记录。默认值为 false，因此默认情况下二进制日志记录处于活动状态。对于 HeatWave 服务数据库系统，此选项不被使用，如果您尝试将其设置为 true，则导入将停止并出现错误。对于其他 MySQL 实例，如果您在目标 MySQL 实例上应用来自源 MySQL 实例的 gtid_executed GTID 集，无论是使用 updateGtidSet 选项还是手动，都始终将 skipBinlog 设置为 true。当目标 MySQL 实例上使用 GTID 时 (gtid_mode=ON)，将此选项设置为 true 可以防止在执行导入时生成和分配新的 GTID，以便可以使用来自源服务器的原始 GTID 集。用户帐户必须具有设置 sql_log_bin 系统变量所需的权限。

即使复制数据的源的主要版本号与目标的主要版本号不连续，例如 5.6 到 8.1，也要复制。默认值为 false，这意味着如果主要版本号不同，则会发出错误并停止复制。当此选项设置为 true 时，将发出警告并继续复制。请注意，只有当复制的模式与新的主要版本没有兼容性问题时，复制才会成功。

在尝试使用 ignoreVersion 选项进行复制之前，请使用 MySQL Shell 的升级检查器实用程序 checkForServerUpgrade() 检查源实例并在尝试复制之前修复实用程序识别出的任何兼容性问题。

即使复制包含目标实例中已经存在的对象，也要复制。默认值为 false，这意味着当找到重复对象时，会发出错误并停止复制。当此选项设置为 true 时，会报告重复对象，但不会生成错误，复制将继续。应谨慎使用此选项，因为实用程序不会检查目标 MySQL 实例中对象的內容与转储文件中的內容是否不同，因此最终复制可能包含不正确或无效的数据。另一种策略是使用 excludeTables 选项排除已经复制的表，您已经验证转储文件中的对象与目标 MySQL 实例中的导入对象相同。最安全的选择是在重新启动复制之前从目标 MySQL 实例中删除重复对象。

在与 GRANT 或 REVOKE 相关的错误发生时采取的操作。

可以在单个 LOAD DATA 语句中从数据块复制的最大字节数。如果数据文件超过 maxBytesPerTransaction 值，则多个 LOAD DATA 语句将从该文件中以小于或等于 maxBytesPerTransaction 值的块加载数据。

可以使用单位后缀 k 表示千字节、M 表示兆字节和 G 表示吉字节。最小值为 4096 字节。如果指定了更小的值，则会抛出异常。如果未设置 maxBytesPerTransaction 选项，则使用 bytesPerChunk 值。

如果数据文件包含一个大于 maxBytesPerTransaction 设置的行，则该行的數據将在单个 LOAD DATA 语句中请求。对于遇到的第一个超过 maxBytesPerTransaction 设置的行，会发出警告。

此选项的预期用途是在数据文件对于目标服务器的限制（例如服务器定义的 group_replication_transaction_size_limit 或 max_binlog_cache_size 设置）过大时，以较小的块加载数据。例如，如果您在加载数据时收到错误 "MySQL 错误 1197 (HY000)：多语句事务需要的存储空间超过了 'max_binlog_cache_size' 字节"，请将 maxBytesPerTransaction 设置为小于或等于服务器实例的 max_binlog_cache_size 设置的值。

在每个用于将数据复制到目标 MySQL 实例的客户端会话开始时运行的一系列 SQL 语句。您可以使用此选项更改会话变量。例如，以下语句跳过目标 MySQL 实例上用于实用程序在导入过程中使用的会话的二进制日志记录，并增加可用于索引创建的线程数

sessionInitSQL: ["SET SESSION sql_log_bin=0;", "SET SESSION innodb_ddl_threads=8,"]

如果在运行 SQL 语句时发生错误，复制将停止并返回错误消息。

在复制开始时包含一条语句，将时区设置为 UTC。输出中的所有时间戳数据都将转换为此时区。默认值为 true。将时区设置为 UTC 有助于在时区不同的服务器之间移动数据，或处理具有多个时区的数据集。如果您希望保留原始时间戳，请将此选项设置为 false。

启用 (true) 或禁用 (false) 表数据的块分割，这将把每个表的 data 分割成多个文件。默认值为 true。使用 bytesPerChunk 指定块大小。如果您将块分割选项设置为 false，则不会进行块分割，实用程序会为每个表创建一个 data 文件。

如果一个表没有主键或唯一索引，则块分割将根据表中的行数、平均行长和 bytesPerChunk 值进行。

设置启用块分割时写入每个 data 文件的大致字节数。可以使用 k 表示千字节、M 表示兆字节和 G 表示千兆字节的单位后缀。默认值为 64 MB (64M)，最小值为 128 KB (128k)。指定此选项会隐式将 chunking 设置为 true。

创建 (true) 或不创建 (false) 表的二级索引。默认值为 true。当此选项设置为 false 时，在导入期间不会创建二级索引，您必须之后创建它们。如果您要分别加载 DDL 文件和 data 文件，并且希望在加载 DDL 文件后更改表结构，这将非常有用。之后，您可以通过再次运行转储加载实用程序来创建二级索引，将 loadIndexes 设置为 true，并将 deferTableIndexes 设置为 all。

MySQL Shell 使用 MySQL 服务器的并行索引创建。表中的所有索引都会同时添加。

有关限制和配置，请参见 为联机 DDL 操作配置并行线程。

将二级索引的创建延迟到表 data 加载之后。这可以缩短加载时间。 off 表示所有索引都在表加载期间创建。默认设置 fulltext 仅延迟全文索引。 all 延迟所有二级索引，并且仅在表加载期间创建主键，以及为包含自增值的列定义的索引。

加载表后，为表执行 ANALYZE TABLE。 on 分析所有表，histogram 仅分析在转储中存储了直方图信息的表。默认值为 off。即使 data 已加载，您也可以使用此选项运行转储加载实用程序来分析表。

将源 MySQL 实例中的 gtid_executed GTID 集（如转储元数据中记录的那样）应用于目标 MySQL 实例上的 gtid_purged GTID 集。 gtid_purged GTID 集保存已在服务器上应用但不在服务器上任何二进制日志文件中存在的、所有事务的 GTID。默认值为 off，表示不应用 GTID 集。

当目标 MySQL 实例上运行群组复制时，请勿使用此选项。

对于不是 HeatWave Service DB 系统实例的 MySQL 实例，当您设置 append 或 replace 以更新 GTID 集时，还应将 skipBinlog 选项设置为 true。这确保源服务器上的 GTID 与目标服务器上的 GTID 相匹配。对于 HeatWave Service DB 系统实例，不使用此选项。

对于来自 MySQL 8.0 的目标 MySQL 实例，您可以将选项设置为 append，这会将源 MySQL 实例中的 gtid_executed GTID 集追加到目标 MySQL 实例上的 gtid_purged GTID 集。要应用的 gtid_executed GTID 集（显示在转储文件 @.json 中的 gtidExecuted 字段中）不得与目标 MySQL 实例上已存在的 gtid_executed 集相交。例如，您可以在将模式从另一个源 MySQL 实例导入到已从其他源服务器拥有模式的目标 MySQL 实例时使用此选项。

您也可以对来自 MySQL 8.0 的目标 MySQL 实例使用 replace，以用源 MySQL 实例中的 gtid_executed GTID 集替换目标 MySQL 实例上的 gtid_purged GTID 集。要执行此操作，源 MySQL 实例中的 gtid_executed GTID 集必须是目标 MySQL 实例上 gtid_purged GTID 集的超集，并且不得与目标的 gtid_executed GTID 集中不存在于其 gtid_purged GTID 集中的事务集相交。

对于在 MySQL 5.7 上的目标 MySQL 实例，将选项设置为 replace，这会用源 MySQL 实例中的 gtid_executed GTID 集替换目标 MySQL 实例上的 gtid_purged GTID 集。在 MySQL 5.7 中，要执行此操作，目标 MySQL 实例上的 gtid_executed 和 gtid_purged GTID 集必须为空，因此实例必须是未使用的，没有先前导入的 GTID 集。

要应用 GTID 集，在导入后，使用 MySQL Shell 的 \sql 命令（或进入 SQL 模式）在连接的 MySQL 实例上发出以下语句，从转储元数据中 @.json 转储文件的 gtidExecuted 字段中复制 gtid_executed GTID 集

shell-js> \sql SET @@GLOBAL.gtid_purged= "+gtidExecuted_set";

此语句（适用于 MySQL 8.0 及更高版本）将源 MySQL 服务器实例的 gtid_executed GTID 集添加到目标 MySQL 实例的 gtid_purged GTID 集。对于 MySQL 5.7，必须省略加号 (+)，并且目标 MySQL 实例上的 gtid_executed 和 gtid_purged GTID 集必须为空。有关更多详细信息，请参见目标 MySQL 实例版本中 gtid_purged 系统变量的说明。

对复制中的所有表应用与 HeatWave Service 的兼容性相关的指定要求，根据需要更改转储文件。

以下修改可以指定为字符串数组

一个键值对，包含一个有效的表标识符（格式为 schemaName.tableName）和一个用于过滤要复制数据的有效 SQL 条件表达式。

一个键值对，包含一个有效的表标识符（格式为 schemaName.tableName）和一个有效分区列表。

例如，要仅复制表 schema.table 中名为 p1 和 p2 的分区：partitions: {'schema.table':["p1", "p2"]}

将此选项设置为 true 仅包含复制项的 DDL 文件，而不复制数据。默认值为 false。

将此选项设置为 true 仅包含复制项的数据文件，而不包含 DDL 文件。默认值为 false。

(仅实例复制工具) 在复制中包含 (true) 或排除 (false) 用户及其角色和授权。默认值为 true。模式和表复制工具不会在复制中包含用户、角色或授权。

您可以使用 excludeUsers 或 includeUsers 选项指定要从复制中排除或包含的单个用户帐户。

(仅实例复制工具) 从复制中排除指定的用户名帐户。用于排除无法导入到 HeatWave Service 数据库系统或已存在于目标 MySQL 实例或不需要的目标 MySQL 实例中的用户名帐户。为定义了用户名和主机名的帐户，在 "'user_name'@'host_name'" 格式中指定每个用户名帐户字符串，或者为仅定义了用户名的帐户，在 "'user_name'" 格式中指定每个用户名帐户字符串。如果您没有提供主机名，则所有具有该用户名的帐户都将被排除。

(仅实例复制工具) 仅在复制中包含指定的用户名帐户。为 excludeUsers 选项指定每个用户名帐户字符串。如果复制中只需要几个用户名帐户，则可以用作 excludeUsers 的替代方案。您也可以同时指定这两个选项，以包含一些帐户并排除其他帐户。

(仅实例复制工具) 从复制中排除指定的模式。请注意，information_schema、mysql、ndbinfo、performance_schema 和 sys 模式始终从实例复制中排除。

(仅实例复制工具) 仅在复制中包含指定的模式。您无法通过在此选项中命名它们来包含 information_schema、mysql、ndbinfo、performance_schema 或 sys 模式。如果您要复制一个或多个这些模式，可以使用模式复制工具 util.copySchemas() 来执行此操作。

(实例和模式复制工具) 从复制中排除指定的表（DDL 和数据）。表名必须用有效的模式名限定，如果需要，用反引号字符引用。请注意，mysql.apply_status、mysql.general_log、mysql.schema 和 mysql.slow_log tables 的数据始终从模式复制中排除，尽管其 DDL 语句已包含在内，并且您不能通过在另一个选项或工具中命名表来包含该数据。

(实例和模式复制工具) 仅在复制中包含指定的表。表名必须用有效的模式名限定，如果需要，用反引号字符引用。

(实例和模式复制工具) 在复制中包含 (true) 或排除 (false) 每个模式的事件。默认值为 true。

(实例和模式复制工具) 从复制中排除指定的事件。事件的名称必须用有效的模式名限定，如果需要，用反引号字符引用。

(实例和模式复制工具) 仅在复制中包含指定的事件。事件的名称必须用有效的模式名限定，如果需要，用反引号字符引用。

(实例和模式复制工具) 在复制中包含 (true) 或排除 (false) 每个模式的函数和存储过程。默认值为 true。请注意，即使 routines 设置为 true，也不会包含用户定义的函数。

(实例和模式复制工具) 从复制中排除指定的函数和存储过程。例程的名称必须用有效的模式名限定，如果需要，用反引号字符引用。

(实例和模式复制工具) 仅在复制中包含指定的函数和存储过程。例程的名称必须用有效的模式名限定，如果需要，用反引号字符引用。

(表复制工具) 将此选项设置为 true 会在复制中包含指定模式中的所有视图和表。默认值为 false。使用此选项时，请将 tables 参数设置为一个空数组。

(所有复制工具) 在复制中包含 (true) 或排除 (false) 每个表的触发器。默认值为 true。

(所有复制工具) 从复制中排除指定的触发器。触发器的名称必须用有效的模式名和表名限定 (schema.table.trigger)，如果需要，用反引号字符引用。您可以通过在此选项中指定模式名和表名 (schema.table) 来排除特定表的所以触发器。

(所有复制工具) 仅在复制中包含指定的触发器。触发器的名称必须用有效的模式名和表名限定 (schema.table.trigger)，如果需要，用反引号字符引用。您可以通过在此选项中指定模式名和表名 (schema.table) 来包含特定表的所以触发器。