从 MySQL Shell 8.0.22 开始，并行表导入实用程序可以从数据文件或文件中捕获列以进行输入预处理，其方式与 LOAD DATA语句相同。可以丢弃所选数据，或者您可以转换数据并将其分配给目标表中的列。

直到 MySQL Shell 8.0.20，数据必须从客户端主机可访问的位置作为本地磁盘导入。从 MySQL Shell 8.0.21 开始，数据也可以从 osBucketName选项指定的 Oracle Cloud Infrastructure 对象存储桶中导入。

在 MySQL Shell 8.0.22 之前，并行表导入实用程序可以将单个输入数据文件导入单个关系表。从 MySQL Shell 8.0.23 开始，该实用程序还能够导入指定的文件列表，并且支持通配符模式匹配以包含来自某个位置的所有相关文件。单次运行该实用程序上传的多个文件被放入一个关系表中，因此，例如，从多个主机导出的数据可以合并到一个表中以用于分析。

在 MySQL Shell 8.0.21 之前，并行表导入实用程序只接受未压缩的输入数据文件。该实用程序分析数据文件，将其分成块，并将块上传到目标 MySQL 服务器中的关系表，在并行连接之间划分块。从 MySQL Shell 8.0.22 开始，该实用程序还可以接受压缩在 gzip( .gz) 和 zstd (.zst)格式，根据文件扩展名自动检测格式。该实用程序以压缩格式从存储中上传压缩文件，从而为该部分传输节省带宽。压缩文件无法分块分发，因此该实用程序使用其并行连接来解压缩多个文件并将其同时上传到目标服务器。如果只有一个输入数据文件，压缩文件的上传只能使用一个连接。

连接的 MySQL 服务器上的目标数据库的名称。如果省略此选项，实用程序将尝试识别和使用当前 MySQL Shell 会话使用的模式名称，如连接 URI 字符串、\use命令或 MySQL Shell 选项中指定的那样。如果未指定架构名称且无法从会话中识别，则返回错误。

目标关系表的名称。如果省略此选项，该实用程序假定表名是不带扩展名的数据文件的名称。目标表必须存在于目标数据库中。

包含来自一个或多个导入文件的列名的字符串数组，按照它们映射到目标关系表中的列的顺序给出。如果导入的数据不包含目标表的所有列，或者导入数据中字段的顺序与表中列的顺序不同，请使用此选项。如果省略此选项，则输入行应包含目标表中每一列的匹配字段。

从 MySQL Shell 8.0.22 开始，您可以使用此选项从一个或多个导入文件中捕获列以进行输入预处理，其方式与 LOAD DATA语句相同。当您使用整数值代替数组中的列名时，导入文件中的该列将被捕获为用户变量 ，例如。可以丢弃所选数据，也可以使用 选项转换数据并将其分配给目标表中的列。 @int@1decodeColumns

在此示例中，在 MySQL Shell 的 JavaScript 模式下，导入文件中的第二列和第四列被分配给用户变量@1和 @2，并且没有 decodeColumns选项将它们分配给目标表中的任何列，因此它们被丢弃。

mysql-js> util.importTable('file.txt', {
            table: 't1',
            columns: ['column1', 1, 'column2', 2, 'column3']
          });

键值对的字典，将通过选项捕获的导入文件列分配给 目标表中的列，并以与语句的子句columns相同的方式为其指定预处理转换。此选项可从 MySQL Shell 8.0.22 获得。 SETLOAD DATA

在 MySQL Shell 的 JavaScript 模式下的这个示例中，数据文件中的第一个输入列用作目标表中的第一列。第二个输入列，@1通过columns选项赋值给变量，经过除法运算后，作为目标表中第二列的值。

mysql-js> util.importTable('file.txt', {
            columns: ['column1', 1],
            decodeColumns: {'column2': '@1 / 100'}
          });

在 MySQL Shell 的 JavaScript 模式下的这个例子中，数据文件中的输入列都被分配给变量，然后以各种方式转换并用于填充目标表的列：

mysql-js> util.importTable('file.txt', {
            table: 't1',
            columns: [1, 2],
            decodeColumns: {
              'a': '@1',
              'b': '@2',
              'sum': '@1 + @2',
              'multiple': '@1 * @2',
              'power': 'POW(@1, @2)'
            }
          });

在导入文件的开头跳过此行数的数据，或者在多个导入文件的情况下，在文件列表中包含的每个文件的开头。您可以使用此选项在上传到表时省略包含列名称的初始标题行。默认是不跳过任何行。

是否应替换 ( true) 或跳过 ( false) 与现有行具有相同主键或唯一索引值的输入行。默认值为 false。

使用一组适合指定文件格式的字段和行处理选项。您可以使用所选方言作为进一步自定义的基础，方法是指定 、 、 、 和 选项中的一个或 linesTerminatedBy多个 fieldsTerminatedBy来 fieldsEnclosedBy更改 fieldsOptionallyEnclosed设置 fieldsEscapedBy。默认方言映射到使用创建的文件 SELECT...INTO OUTFILE语句与该语句的默认设置。这是 MySQL Shell 的表导出实用程序生成的输出文件的默认值。其他方言适用于 CSV 文件（在 DOS 或 UNIX 系统上创建）、TSV 文件和 JSON 数据。适用于每种方言的设置如下：

终止输入数据文件中每一行的一个或多个字符（或空字符串）。\n默认值与指定的方言相同，如果省略方言选项，则为换行符 ( )。此选项等同于 语句的LINES TERMINATED BY选项 。请注意，该实用程序不为语句的选项 LOAD DATA提供等效 项，该选项设置为空字符串。 LINES STARTING BYLOAD DATA

终止输入数据文件中每个字段的一个或多个字符（或空字符串）。默认值与指定的方言相同，\t如果省略方言选项，则为制表符 ( )。此选项等同于 语句 的FIELDS TERMINATED BY选项 。LOAD DATA

包含输入数据文件或文件中每个字段的单个字符（或空字符串）。默认值与指定的方言相同，如果省略方言选项，则为空字符串。此选项等同于语句 的FIELDS ENCLOSED BY选项。LOAD DATA

给定的字符是 fieldsEnclosedBy包含一个或多个输入数据文件中的所有字段 ( false)，还是仅在某些情况下包含字段 ( true)。默认为指定的方言，或者false方言选项被省略。此选项使该 fieldsEnclosedBy选项等同于 语句 的FIELDS OPTIONALLY ENCLOSED BY 选项。LOAD DATA

在一个或多个输入数据文件中开始转义序列的字符。如果未提供，则不会进行转义序列解释。默认值与指定的方言相同，如果省略方言选项，则为反斜杠 (\)。此选项等同于语句 的FIELDS ESCAPED BY选项 。LOAD DATA

在 MySQL Shell 8.0.21 中添加。此选项指定一种字符集编码，在导入过程中使用该编码解释输入数据。将选项设置为 binary意味着在导入期间不进行任何转换。当您省略此选项时，导入使用 character_set_database 系统变量指定的字符集来解释输入数据。

对于多个输入数据文件的列表，此选项不可用。对于单个输入数据文件，此选项指定线程为每次LOAD DATA调用目标服务器发送的字节数（加上到达行末所需的任何额外字节）。该实用程序将数据分发到此大小的块中，供线程拾取并发送到目标服务器。块大小可以指定为字节数，或使用后缀 k（千字节）、M（兆字节）、G（千兆字节）。例如， bytesPerChunk="2k"使线程发送大约 2 KB 的块。最小块大小为 131072 字节，默认块大小为 50M。

用于将输入文件中的数据发送到目标服务器的最大并行线程数。如果您未指定线程数，则默认最大值为 8。对于多个输入数据文件的列表，该实用程序会创建指定或最大线程数。对于单个输入数据文件，该实用程序使用以下公式计算要创建的线程的适当数量，直至达到此最大值：

min{max{1, threads}, chunks}}

其中threads是最大线程chunks数， 是数据将被拆分成的 chunk 数，计算方法是将文件大小除以 bytesPerChunk大小然后加 1。计算确保如果最大线程数超过 number实际发送的块的数量，该实用程序不会创建不必要的线程。

压缩文件无法分块分发，因此该实用程序使用其并行连接一次上传多个文件。如果只有一个输入数据文件，压缩文件的上传只能使用一个连接。

每个线程每秒字节数的最大数据吞吐量限制。如果您需要避免使客户端主机或目标服务器的网络或 I/O 或 CPU 饱和，请使用此选项。最大速率可以指定为字节数，或使用后缀 k（千字节）、M（兆字节）、G（千兆字节）。例如， maxRate="5M"将每个线程限制为每秒 5MB 的数据，对于八个线程，传输速率为 40MB/秒。默认值为 0，表示没有限制。

显示 ( true) 或隐藏 ( false) 导入进度信息。默认是true如果 stdout 是终端 (tty)，false 否则。

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

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

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

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

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

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

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

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

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

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

在 MySQL Shell 8.0.30 中添加。用于连接的 s3 CLI 配置文件的配置文件名称，而不是用于连接 default的 AWS CLI 配置文件中的配置文件。

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

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

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

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