显示有关在给定指定选项和转储文件的情况下将执行哪些操作的信息，包括将根据转储内容返回的任何错误，但不继续导入。默认值为 false。

将此选项设置为大于 0 的值会在转储仍在生成时激活转储的并发加载。该值是一个超时（以秒为单位），在处理完转储位置中所有上传的数据块后，该实用程序等待进一步的数据。这允许实用程序在转储仍在创建过程中时导​​入转储。数据在可用时进行处理，并且在超过超时且转储位置中不再显示任何数据时停止导入。默认设置，0, 意味着当所有上传的数据块都已处理并且不等待更多数据时，该实用程序将转储标记为完成。使用默认设置，并发加载被禁用。

必须将 MySQL Shell 的转储实用程序生成的转储加载到的目标模式。

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

单个模式转储或导致单个模式的过滤选项支持此加载选项。

从 MySQL Shell 8.0.23 开始，不需要此选项，因为来自表转储实用程序的转储文件包含设置最初包含该表的模式所需的信息。默认情况下，从该版本开始，如果模式不存在，则会在目标 MySQL 实例中重新创建它。或者，您可以指定将schema表加载到目标 MySQL 实例中的替代模式的选项，该模式必须存在于那里。

在 MySQL Shell 8.0.22 中，表转储实用程序的转储文件不包含架构信息，因此目标架构必须存在于目标 MySQL 实例中。在该版本中，默认情况下，全局 shell 会话的当前模式用作目标模式，或者 schema可以使用该选项来命名目标模式。

用于将数据块上传到目标 MySQL 实例的并行线程数。每个线程都有自己的 MySQL 实例连接。默认值为 4。如果转储是在启用分块（默认设置）的情况下创建的，则该实用程序可以使用多个线程为表加载数据；否则一个线程只用于一个表。

用于获取文件内容的后台线程池中的线程数。此选项和线程池可从 MySQL Shell 8.0.27 获得。默认值是从本地服务器加载的转储选项的值，或者是从非本地服务器加载的转储选项 threads 值的四倍。threads

指定用于跟踪加载进度的本地进度状态文件的路径。根据加载操作的类型，允许使用其他值：

从本地存储加载转储时：

使用预验证请求 (PAR) 从 OCI 对象存储加载转储时，该 progressFile选项是必需的。

如果指定了本地进度状态文件或有效的写入 PAR 但进度状态文件不存在，则将创建该文件。

显示 ( true) 或隐藏 ( false) 导入进度信息。默认是trueif stdout是一个终端 ( tty)，例如当 MySQL Shell 处于交互模式时，false否则。进度信息包括活动线程的数量及其操作、到目前为止加载的数据量、完成百分比和吞吐率。当不显示进度信息时，进度状态仍然记录在转储加载实用程序的进度状态文件中。

将此选项设置为true重置进度状态并从头开始重新导入。默认是false. 请注意，使用此选项时，转储加载实用程序不会跳过已创建的对象，也不会管理重复数据删除。如果要使用此选项，以确保正确导入，您必须首先从目标 MySQL 实例中手动删除所有以前加载的对象，包括模式、表、用户、视图、触发器、例程和来自该转储的事件。否则，如果转储文件中的对象已存在于目标 MySQL 实例中，则导入会因错误而停止。在适当谨慎的情况下，您可以使用该 ignoreExistingObjects选项使实用程序报告重复的对象，但跳过它们并继续导入。

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

即使从中转储数据的 MySQL 实例的主版本号与数据将上传到的 MySQL 实例的主版本号不同，也导入转储。默认值为 false，这意味着如果主版本号不同，则会发出错误并且不会继续导入。当此选项设置为 时 true，会发出警告并继续导入。请注意，仅当转储文件中的模式与新的主要版本没有兼容性问题时，导入才会成功。

在尝试使用该 ignoreVersion选项导入之前，请使用 MySQL Shell 的升级检查器实用程序 checkForServerUpgrade()来检查源 MySQL 实例上的模式。在转储模式并将它们导入目标 MySQL 实例之前，修复该实用程序识别的任何兼容性问题。

导入转储，即使它包含已存在于 MySQL 实例的目标架构中的对象。默认值为false，这意味着当发现重复对象时会发出错误并停止导入，除非导入是从先前使用进度状态文件的尝试恢复的，在这种情况下会跳过检查。当此选项设置为 true，会报告重复对象但不会生成错误并且导入会继续进行。应谨慎使用此选项，因为该实用程序不会检查目标 MySQL 实例和转储文件中对象的内容是否不同，因此导入结果可能包含不正确或无效的数据。另一种策略是使用excludeTables排除已加载表的选项，您已验证转储文件中的对象与目标 MySQL 实例中的导入对象相同。最安全的选择是在重新启动转储之前从目标 MySQL 实例中删除重复的对象。

从 MySQL Shell 8.0.23 开始，此选项还允许将不使用该 ocimds选项创建的转储导入 MySQL 数据库服务实例。

用于导入到目标 MySQL 实例的字符集，例如在 语句的CHARACTER SET选项中 。LOAD DATA默认值是在由 MySQL Shell 的实例转储实用程序、模式转储实用程序或表转储实用程序创建转储时使用的转储元数据中给出的字符集，默认使用 utf8mb4. 字符集必须是character_set_client 系统变量允许的，并且是MySQL实例支持的。

可以在单个LOAD DATA 语句中从数据文件加载的最大字节数。如果数据文件超过该 maxBytesPerTransaction值，则多个 LOAD DATA语句以小于或等于该 maxBytesPerTransaction值的块从文件中加载数据。此选项可从 MySQL Shell 8.0.27 获得。

k可以使用千字节、 M兆字节和 G千兆字节 的单位后缀。最小值为 4069 字节。如果指定了较小的值，则隐式使用最小 4096 字节。如果maxBytesPerTransaction未设置该选项，则bytesPerChunk用于转储数据的值将用作大于 1.5 * 该bytesPerChunk 值的文件的默认设置。如果maxBytesPerTransaction 未设置该选项并且数据文件小于 1.5 * bytesPerChunk值，则在单个 LOAD DATA 语句中请求数据。

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

如果具有已配置 maxBytesPerTransaction设置的加载操作被中断并恢复执行，则会跳过已加载的块。恢复的加载操作使用当前maxBytesPerTransaction 设置。操作中断前使用的设置不会保存到进度状态文件中。

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

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

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

如果在运行 SQL 语句时发生错误，导入将停止并返回一条错误消息。

为表创建 ( true) 或不创建 ( false) 二级索引。默认值为true。当此选项设置为 时false，二级索引不会在导入过程中创建，您必须在之后创建它们。如果您分别加载 DDL 文件和数据文件，并且如果您想在加载 DDL 文件后更改表结构，这将很有用。之后，您可以通过再次运行转储加载实用程序来创建二级索引 loadIndexesset to true和 deferTableIndexesset to all。

从 8.0.31 开始，MySQL Shell 使用 MySQL Server 的并行索引创建。以前，转储加载实用程序按顺序添加索引，一次一个。从这个版本开始，表中的所有索引都是同时添加的。

有关限制和配置， 请参阅 为在线 DDL 操作配置并行线程。

将二级索引的创建推迟到加载表数据之后。这可以减少加载时间。 off表示所有索引都是在表加载期间创建的。默认设置 fulltext仅延迟全文索引。 all推迟所有二级索引，只在表加载期间创建主索引，以及（从 MySQL Shell 8.0.22 开始）在包含自动增量值的列上定义的索引。all在 MySQL Shell 8.0.21 中，如果您有任何包含自动增量值的唯一键列 ，请不要设置。

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

从源实例中打印gtid_executed GTID 集和二进制日志文件名和位置，取自 MySQL Shell 的实例转储实用程序、模式转储实用程序或表转储实用程序生成的转储中包含的转储元数据。元数据以 YAML 格式打印。此选项可从 MySQL Shell 8.0.24 获得。

gtid_executedGTID 集始终作为转储文件中的字段包含在 转储中gtidExecuted。 @.json转储加载实用程序不会自动将 gtid_executed 源 MySQL 实例中的 GTID 集应用到目标 MySQL 实例上。要将这些 GTID 应用于目标 MySQL 实例以用于复制，请使用该 updateGtidSet选项或手动导入它们，具体取决于目标 MySQL 实例的版本。从 MySQL Shell 8.0.23 开始，这在 MySQL 数据库系统实例上受支持。有关详细信息，请参阅 updateGtidSet选项的描述。

如果用于运行转储实用程序的用户帐户具有REPLICATION CLIENT特权，则包括二进制日志文件名和位置。二进制日志文件名和位置可用于设置从未启用 GTID 且未使用基于 GTID 的复制的源服务器到已启用 GTID 的副本的复制，使用语句的 ASSIGN_GTIDS_TO_ANONYMOUS_TRANSACTIONS 选项CHANGE REPLICATION SOURCE TO（这是可从 MySQL 服务器 8.0.23 获得）。

将gtid_executed 转储元数据中记录的源 MySQL 实例的 gtid_purgedGTID 集应用到目标 MySQL 实例上的 GTID 集。gtid_purged GTID 集包含已在服务器上应用但不存在于服务器上的任何二进制日志文件中的所有事务的 GTID。此选项可从 MySQL Shell 8.0.22 获得，但在该版本中，由于权限限制，MySQL 数据库系统不支持它。从 MySQL 8.0.23 开始，该选项也可用于 MySQL 数据库系统实例。默认值为 off，表示不应用 GTID 集。

不要将此选项用于 MySQL Shell 的表转储实用程序生成的转储，仅用于 MySQL Shell 的实例转储实用程序或模式转储实用程序生成的转储。此外，当 Group Replication 在目标 MySQL 实例上运行时，请勿使用此选项。

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

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

您还可以使用replaceMySQL 8.0 中 gtid_purged的目标 MySQL 实例，将目标 MySQL 实例上设置的 GTID 替换gtid_executed为源 MySQL 实例中设置的 GTID。为此， gtid_executed来自源 MySQL 实例的 GTID 集必须是 gtid_purged 目标 MySQL 实例上 GTID 集的超集，并且不得与目标 gtid_executedGTID 集中不在其 gtid_purgedGTID 集中的事务集相交。

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

在 MySQL Shell 8.0.21 中，此选项不可用，您可以在 MySQL 服务器实例上手动应用 GTID 集（使用组复制的情况除外）。对于 MySQL 数据库系统，不支持此方法。要应用 GTID 集，导入后，使用 MySQL Shell 的\sql命令（或进入 SQL 模式）在连接的 MySQL 实例上发出以下语句， 从转储元数据中的转储文件中 的字段 复制gtid_executedGTID 集 ：gtidExecuted@.json

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

此语句从 MySQL 8.0 开始运行，将源 MySQL 服务器实例的 gtid_executedGTID 集添加到目标 MySQL 实例的 gtid_purgedGTID 集。对于 MySQL 5.7，加号 ( +) 必须省略，目标 MySQL 实例上的 gtid_executed和 gtid_purged GTID 设置必须为空。更多详细信息，请参见 gtid_purged目标MySQL实例版本中系统变量的描述。

为转储中不包含主键的每个表在不可见列中添加主键。如果转储是使用MySQL Shell 的实例转储实用程序 、模式转储实用程序或表转储实用程序的选项创建的，则会自动应用该 true设置 。仅当加载转储的 DDL ( ) 时才添加主键。不可见的列（名为“ ”）对使用上传表的应用程序没有影响。 create_invisible_pksutil.dumpInstance()util.dumpSchemas()util.dumpTables()loadDdl: truemy_row_id

createInvisiblePKs从 MySQL Shell 8.0.24 开始出现，当true 设置生效时，目标 MySQL 实例必须是 MySQL Server 8.0.24 或更高版本，否则加载失败。MySQL Server 8.0.23 提供了不可见列，但该版本中对它们的限制阻止了此功能的使用。MySQL Shell 8.0.24 之前的 MySQL Shell 版本中的转储加载实用程序会自动忽略转储元数据标志并且不会添加主键，因此请确保使用最新版本的实用程序。

以这种方式添加主键还不能将修改后的表入站复制到 MySQL 数据库服务高可用性数据库系统，因为该功能目前需要主键同时存在于源服务器和副本服务器中。如果可能，请考虑在源服务器上的表中创建主键，而不是使用此选项，然后再次转储它们。从 MySQL 8.0.23 开始，您可以通过使用不可见的列来保存主键来执行此操作，而不会影响应用程序。这是性能和可用性的最佳实践，有助于转储数据库与 MySQL 数据库服务无缝协作。

转储文件所在的 Oracle Cloud Infrastructure 对象存储桶的名称。默认情况下， [DEFAULT]位于 的 Oracle Cloud Infrastructure CLI 配置文件中的配置文件 ~/.oci/config用于建立与存储桶的连接。ociConfigFile您可以使用和 ociProfile选项替换要用于连接的替代配置文件 。有关设置 CLI 配置文件的说明，请参阅 SDK 和 CLI 配置文件。

by 命名的对象存储桶所在的 Oracle Cloud Infrastructure 命名空间osBucketName。对象存储桶的命名空间显示在 Oracle Cloud Infrastructure 控制台中桶详细信息页面的 Bucket Information 选项卡中，或者可以使用 Oracle Cloud Infrastructure 命令行界面获取。

一个 Oracle Cloud Infrastructure CLI 配置文件，其中包含用于连接的配置文件，而不是默认位置中的配置文件 ~/.oci/config。

用于连接的 Oracle Cloud Infrastructure 配置文件的配置文件名称，而不是用于连接 [DEFAULT]的 Oracle Cloud Infrastructure CLI 配置文件中的配置文件。

转储文件所在的 S3 存储桶的名称。默认情况下，default Amazon Web Services (AWS) CLI 中 的配置文件config和 credentials位于的文件 ~/.aws/用于建立与 S3 存储桶的连接。s3ConfigFile您可以使用和 s3CredentialsFile选项替换连接的替代配置和凭据。有关安装和配置 AWS CLI 的说明，请参阅 AWS CLI 入门。

包含用于连接的用户凭据的凭据文件，而不是默认位置中的凭据，~/.aws/credentials. 通常，凭据文件包含 用于连接 的aws_access_key_id和 。aws_secret_access_key

一个 AWS CLI 配置文件，其中包含用于连接的配置文件，而不是默认位置中的配置文件~/.aws/config。通常，配置文件包含用于连接的区域和输出类型。

用于连接的 s3 CLI 配置文件的配置文件名称，而不是用于连接default 的 AWS CLI 配置文件中的配置文件。

要使用的端点的 URL 而不是默认值。

连接到 Oracle Cloud Infrastructure S3 兼容性 API 时，端点采用以下格式： . 替换为对象存储命名空间和 您的区域标识符。例如，美国东部（阿什本）区域的区域标识符是。 https://namespace.compat.objectstorage.region.oraclecloud.comnamespaceregionus-ashburn-1

对于美国东部（阿什本）区域中名为 axaxnpcrorw5 的命名空间：

https://axaxnpcrorw5.compat.objectstorage.us-ashburn-1.oraclecloud.com.

将此选项设置为false从加载中排除转储中的 DDL 文件。默认值为 true，表示加载 DDL 文件。

将此选项设置为false从加载中排除转储中的数据文件。默认值为 true，表示加载数据文件。

导入 ( true) 或不导入 ( false) 用户及其角色和授权到目标 MySQL 实例。默认为 false，因此默认不导入用户。跳过当前用户的语句。从 MySQL Shell 8.0.22 开始，如果用户已存在于目标 MySQL 实例中，则会返回错误，并且不会应用转储文件中的用户授权。从 MySQL Shell 8.0.22 开始，您可以使用转储加载实用程序中的 excludeUsers或 includeUsers选项来指定要排除或包含在导入中的用户帐户。

MySQL Shell 的模式转储实用程序和表转储实用程序不包括转储中的用户、角色和授权，但实例转储实用程序可以并且默认情况下包含。从 MySQL Shell 8.0.22 开始，excludeUsers 和includeUsers选项也可以在实例转储实用程序中使用，以从转储文件中排除或包含指定的用户帐户。

如果您指定true但提供的转储文件不包含用户帐户，则在 MySQL Shell 8.0.23 之前，该实用程序将返回错误并停止导入。从 MySQL Shell 8.0.23 开始，该实用程序改为返回警告并继续。

从导入中排除指定的用户帐户。此选项可从 MySQL Shell 8.0.22 获得，您可以使用它来排除不接受导入 MySQL 数据库系统、目标 MySQL 实例上已经存在或不需要的用户帐户。 为用用户名和主机名定义的帐户或 为仅用用户名定义的帐户指定格式的每个用户帐户字符串 。如果您不提供主机名，则将排除具有该用户名的所有帐户。 "'user_name'@'host_name'""'user_name'"

在导入中仅包括指定的用户帐户。为 excludeUsers选项指定每个用户帐户字符串。excludeUsers此选项可从 MySQL Shell 8.0.22 获得，如果目标 MySQL 实例中只需要几个用户帐户，您可以将其用作替代方法。您还可以同时指定这两个选项以包含一些帐户并排除其他帐户。

从导入中排除命名模式。请注意， information_schema、 mysql、ndbinfo、 performance_schema和 sysschemas 始终从 MySQL Shell 的实例转储实用程序创建的转储中排除。

仅加载转储文件中的命名模式。您可以指定这两个选项以包括一些模式并排除其他模式。

从导入中排除指定的表，这样它们就不会上传到目标 MySQL 实例。表名必须用有效的模式名限定，并在需要时用反引号引用。请注意mysql.apply_status， mysql.general_log、 mysql.schema、 和 的数据mysql.slow_log tables始终不包括在由 MySQL Shell 的模式转储实用程序创建的转储中，尽管包含它们的 DDL 语句。

仅加载转储文件中的命名表。表名必须用有效的模式名限定，并在需要时用反引号引用。您可以指定这两个选项以包含一些表并排除其他表。

从导入中排除命名事件。此选项可从 MySQL Shell 8.0.28 获得。事件名称必须使用有效的模式名称进行限定，并在需要时用反引号字符引用。

仅加载转储文件中的命名事件。此选项可从 MySQL Shell 8.0.28 获得。事件名称必须用有效的模式名称限定，并在需要时用反引号字符引用。

从导入中排除指定的函数和存储过程。此选项可从 MySQL Shell 8.0.28 获得。例程的名称必须用有效的模式名称限定，并在需要时用反引号字符引用。

仅加载转储文件中的命名函数和存储过程。此选项可从 MySQL Shell 8.0.28 获得。例程的名称必须用有效的模式名称限定，并在需要时用反引号字符引用。

从导入中排除命名触发器。此选项可从 MySQL Shell 8.0.28 获得。触发器的名称必须使用有效的架构名称和表名称 ( schema.table.trigger) 进行限定，并在需要时用反引号字符引用。schema.table您可以通过使用此选项 ( ) 指定架构名称和表名称来排除特定表的所有触发器。

仅加载转储文件中的命名触发器。此选项可从 MySQL Shell 8.0.28 获得。触发器的名称必须使用有效的架构名称和表名称 ( schema.table.trigger) 进行限定，并在需要时用反引号字符引用。schema.table您可以通过使用此选项 ( ) 指定架构名称和表名称来包括特定表的所有触发器。