显示有关使用指定选项集将转储的内容以及 HeatWave Service 兼容性检查结果（如果指定了 ocimds 选项）的信息，但不继续进行转储。设置此选项可以使您在开始转储之前列出所有兼容性问题。默认值为 false。

显示 (true) 或隐藏 (false) 转储的进度信息。默认值为 true（如果 stdout 是一个终端 (tty)，例如，当 MySQL Shell 处于交互模式时）或 false（否则）。进度信息包括估计要转储的总行数、到目前为止转储的行数、完成百分比以及每秒的行数和字节数的吞吐量。

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

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

MySQL Shell 打开到服务器的连接以进行转储时要使用的字符集。默认值为 utf8mb4。对于每个连接，系统变量 character_set_client、character_set_connection 和 character_set_results 的会话值将设置为该值。字符集必须由 character_set_client 系统变量允许并受 MySQL 实例支持。

通过在转储过程中锁定实例进行备份来启用 (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 语句启动。当所有线程都启动了交易后，实例将被锁定以进行备份（如 锁定实例以进行备份和解锁实例语句 中所述），并且全局读锁将被释放。

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

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

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

默认值为 false。启用此选项可禁用在 ocimds: true 时默认运行的升级检查。不会检查与 MySQL 版本升级相关的兼容性问题。仅在单独执行升级检查器时使用此选项。

在转储的开头包含一个语句以将时区设置为 UTC。转储输出中的所有时间戳数据都将转换为此时区。默认值为 true，因此时间戳数据默认情况下会转换。将时区设置为 UTC 方便在时区不同的服务器之间移动数据或处理具有多个时区的数据集。如果需要，将此选项设置为 false 以保留原始时间戳。

创建转储文件时使用的压缩类型和压缩级别。以下压缩选项可用

如果启用，则会使用转储生成一个元数据文件 @.checksums.json。此文件包含转储的校验和数据，允许在加载转储时进行数据验证。请参阅 加载控制选项。

如果 checksum: true，则适用以下条件

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

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

设置在启用块化时写入每个 data 文件的大致字节数。可以使用 k（千字节）、M（兆字节）和 G（千兆字节）作为单位后缀。默认值为 64 MB。指定此选项会隐式将 chunking 设置为 true。实用程序旨在将每个表的 data 块化成文件，每个文件在应用压缩之前都包含此数量的数据。块大小是平均值，它是根据表统计信息和 explain 计划估算值计算的。

为导出 data 文件的格式指定一组字段和行处理选项。您可以使用选定的方言作为进一步自定义的基础，也可以通过指定一个或多个 linesTerminatedBy、fieldsTerminatedBy、fieldsEnclosedBy、fieldsOptionallyEnclosed 和 fieldsEscapedBy 选项来更改设置。

默认方言生成的 data 文件与使用 SELECT...INTO OUTFILE 语句并使用该语句的默认设置创建的文件相匹配。.txt 是为这些输出文件分配的适当文件扩展名。其他方言可用于导出适用于 DOS 或 UNIX 系统的 CSV 文件 (.csv) 以及 TSV 文件 (.tsv)。

对每种方言应用的设置如下

一个或多个字符（或空字符串），实用程序使用它们来终止导出 data 文件中的每一行。默认值与指定的方言相同，或者如果省略了方言选项，则为换行符 (\n)。此选项等效于 SELECT...INTO OUTFILE 语句的 LINES TERMINATED BY 选项。请注意，实用程序没有提供 SELECT...INTO OUTFILE 语句的 LINES STARTING BY 选项的等效项，该选项设置为空字符串。

一个或多个字符（或空字符串），实用程序使用它们来终止导出 data 文件中的每个字段。默认值与指定的方言相同，或者如果省略了方言选项，则为制表符 (\t)。此选项等效于 SELECT...INTO OUTFILE 语句的 FIELDS TERMINATED BY 选项。

单个字符（或空字符串），实用程序使用它们来包围导出 data 文件中的每个字段。默认值与指定的方言相同，或者如果省略了方言选项，则为空字符串。此选项等效于 SELECT...INTO OUTFILE 语句的 FIELDS ENCLOSED BY 选项。

是否为 fieldsEnclosedBy 给出的字符包围导出 data 文件中的所有字段 (false)，还是仅在字段具有字符串数据类型（例如 CHAR、BINARY、TEXT 或 ENUM）时包围字段 (true)。默认值与指定的方言相同，或者如果省略了方言选项，则为 false。此选项使 fieldsEnclosedBy 选项等效于 SELECT...INTO OUTFILE 语句的 FIELDS OPTIONALLY ENCLOSED BY 选项。

用于在导出 data 文件中开始转义序列的字符。默认值与指定的方言相同，或者如果省略了方言选项，则为反斜杠 (\\)。此选项等效于 SELECT...INTO OUTFILE 语句的 FIELDS ESCAPED BY 选项。如果将此选项设置为空字符串，则不会转义任何字符，这是不推荐的，因为 SELECT...INTO OUTFILE 使用的特殊字符必须转义。

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

在以下示例中，where 仅导出表 sakila.actor 和 sakila.actor_info 中 actor_id 值大于 150 的行，并将这些行导出到名为 out 的本地文件夹中

 util.dumpTables("sakila", ["actor","actor_info"], "out", {"where" : 
   {"sakila.actor": "actor_id > 150", "sakila.actor_info": "actor_id > 150"}})

一个有效的 partition 名称列表，它将导出限制为指定的 partition。

例如，要仅导出表 schema.table 中名为 p1 和 p2 的 partition：partitions: {schema.table:["p1", "p2"]}。

以下示例导出 table1 中的 partition p1 和 p2 以及 table2 中的 partition p2

              util.dumpTables("schema", ["table","table2"], "out", {"partitions" : 
              { "schema.table1":  ["p1", "p2"],"schema.table2":  ["p1"]}})

将此选项设置为 true 将仅包含转储项目 DDL 文件，而不是转储 data。默认值为 false。

将此选项设置为 true 将仅包含转储项目 data 文件，而不是包含 DDL 文件。默认值为 false。

(仅限实例转储实用程序) 在转储中包含 (true) 或排除 (false) 用户及其角色和授权。默认值为 true，因此默认情况下包含用户。schema 转储实用程序和表转储实用程序不会在转储中包含用户、角色和授权。

您可以使用 excludeUsers 或 includeUsers 选项指定要从转储文件中排除或包含的单个用户帐户。这些选项也可以与 MySQL Shell 的转储加载实用程序 util.loadDump() 一起使用，以便根据目标 MySQL 实例的要求在导入时排除或包含单个用户帐户。

(仅限实例转储实用程序) 从转储文件中排除命名的用户帐户。您可以使用它来排除无法导入 HeatWave Service DB 系统的用户帐户，或者已经存在或不需要在目标 MySQL 实例上的用户帐户。对于使用用户名和主机名定义的帐户，请使用格式 "'user_name'@'host_name'" 指定每个用户帐户字符串；对于仅使用用户名定义的帐户，请使用格式 "'user_name'" 指定每个用户帐户字符串。如果您没有提供主机名，则将排除所有具有该用户名名的帐户。

(仅限实例转储实用程序) 仅在转储文件中包含命名的用户帐户。指定每个用户帐户字符串，就像 excludeUsers 选项一样。如果转储中只需要几个用户帐户，此选项是 excludeUsers 的替代方案。您也可以同时指定这两个选项，以包含某些帐户并排除其他帐户。

(仅限实例转储实用程序) 从转储中排除命名的模式。请注意，information_schema、mysql、ndbinfo、performance_schema 和 sys 模式始终从实例转储中排除。

(仅限实例转储实用程序) 仅在转储中包含命名的模式。您不能通过在此选项中命名来包含 information_schema、mysql、ndbinfo、performance_schema 或 sys 模式。如果要转储其中一个或多个模式，可以使用模式转储实用程序 util.dumpSchemas() 执行此操作。

(仅限实例转储实用程序和模式转储实用程序) 从转储中排除命名的表。表名必须使用有效的模式名限定，并在需要时用反引号引起来。由 excludeTables 选项命名的表在转储中没有 DDL 文件或数据文件。请注意，mysql.apply_status、mysql.general_log、mysql.schema 和 mysql.slow_log 表 的数据始终从模式转储中排除，尽管它们的 DDL 语句已包含在内，您也不能通过在另一个选项或实用程序中命名表来包含该数据。

(仅限实例转储实用程序和模式转储实用程序) 仅在转储中包含命名的表。表名必须使用有效的模式名限定，并在需要时用反引号引起来。

(仅限实例转储实用程序和模式转储实用程序) 包含 (true) 或排除 (false) 转储中每个模式的事件。默认值为 true。

(仅限实例转储实用程序和模式转储实用程序) 从转储中排除命名的事件。事件的名称必须使用有效的模式名限定，并在需要时用反引号引起来。

(仅限实例转储实用程序和模式转储实用程序) 仅在转储中包含命名的事件。事件的名称必须使用有效的模式名限定，并在需要时用反引号引起来。

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

(仅限实例转储实用程序和模式转储实用程序) 从转储中排除命名的函数和存储过程。例程的名称必须使用有效的模式名限定，并在需要时用反引号引起来。

(仅限实例转储实用程序和模式转储实用程序) 仅在转储中包含命名的函数和存储过程。例程的名称必须使用有效的模式名限定，并在需要时用反引号引起来。

(仅限表转储实用程序) 将此选项设置为 true 将在转储中包含指定模式中的所有视图和表。默认值为 false。使用此选项时，将 tables 参数设置为空数组，例如

shell-js> util.dumpTables("hr", [], "emp", { "all": true })

(所有转储实用程序) 包含 (true) 或排除 (false) 转储中每个表的触发器。默认值为 true。

(所有转储实用程序) 从转储中排除命名的触发器。触发器的名称必须使用有效的模式名和表名限定 (schema.table.trigger)，并在需要时用反引号引起来。您可以通过使用此选项指定模式名和表名来排除特定表的全部触发器 (schema.table)。

(所有转储实用程序) 仅在转储中包含命名的触发器。触发器的名称必须使用有效的模式名和表名限定 (schema.table.trigger)，并在需要时用反引号引起来。您可以通过使用此选项指定模式名和表名来包含特定表的全部触发器 (schema.table)。

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

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

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

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

将此选项设置为 true 将启用与 HeatWave 服务兼容性的检查和修改。默认值为 false。

将此选项设置为 true 时，DATA DIRECTORY、INDEX DIRECTORY 和 ENCRYPTION 选项在 CREATE TABLE 语句中被注释掉，以确保所有表都位于 MySQL 数据目录中并使用默认模式加密。对 CREATE TABLE 语句中的任何存储引擎（除 InnoDB 之外）执行检查，以查看是否将不合适的权限授予用户或角色，以及其他兼容性问题。如果发现任何不符合的 SQL 语句，则会引发异常并停止转储。使用 dryRun 选项列出转储中所有项目的全部问题，然后再启动转储过程。使用 compatibility 选项自动修复转储输出中的问题。

此选项默认设置为 false，并且仅在显式设置为 true 时才会启用。

以 n.n.n 格式定义目标 MySQL 实例的版本。例如，8.1.0。如果未设置值，则使用 MySQL Shell 版本。

根据 targetVersion 的值调整兼容性检查。

对转储输出中的所有表应用与 HeatWave 服务兼容性的指定要求，根据需要更改转储文件。

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

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

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

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

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

用于连接的区域的名称。

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

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

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

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

必需。要写入转储的 Azure 容器的名称。该容器必须存在。

可选。包含存储连接参数的配置文件，而不是默认位置的配置文件，例如 ~/.azure/config。如果未定义，则使用默认配置文件。

azureContainerName 必须定义，并且不能为空。

可选。用于操作的 Azure 存储帐户的名称。

可选。Azure 共享访问签名 (SAS) 令牌，用于操作的身份验证，而不是密钥。