与 LOAD DATA 语句一样，并行表导入实用程序可以从数据文件中捕获列进行输入预处理。可以选择丢弃所选数据，也可以转换数据并将其分配给目标表中的列。

数据必须从客户端主机可以作为本地磁盘访问的位置导入，或者可以从 Oracle 云基础设施对象存储桶导入数据，并使用 osBucketName 选项指定存储桶名称。

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

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

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

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

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

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

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

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

一个键值对字典，它将 columns 选项捕获为用户变量的导入文件列分配给目标表中的列，并以与 LOAD DATA 语句的 SET 子句相同的方式为它们指定预处理转换。

在以下 MySQL Shell JavaScript 模式示例中，数据文件中的第一个输入列用作目标表中的第一列。 第二个输入列（已由 columns 选项分配给变量 @1）在用作目标表中第二列的值之前要进行除法运算。

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 数据。 为每种方言应用的设置如下

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

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

用于将一个或多个输入数据文件中的每个字段括起来的单个字符（或空字符串）。 默认值为指定方言的默认值，如果省略 dialect 选项，则为空字符串。 此选项等效于 LOAD DATA 语句的 FIELDS ENCLOSED BY 选项。

为 fieldsEnclosedBy 指定的字符是将一个或多个输入数据文件中的所有字段括起来 (false)，还是仅在某些情况下将字段括起来 (true)。 默认值为指定方言的默认值，如果省略 dialect 选项，则为 false。 此选项使 fieldsEnclosedBy 选项等效于 LOAD DATA 语句的 FIELDS OPTIONALLY ENCLOSED BY 选项。

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

此选项指定在导入期间解释输入数据时使用的字符集编码。 将此选项设置为 binary 意味着在导入期间不进行任何转换。 如果省略此选项，则导入将使用 character_set_database 系统变量指定的字符集来解释输入数据。

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

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

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

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

压缩文件不能被分配到多个块中，因此该实用程序使用其并行连接来一次上传多个文件。如果只有一个输入数据文件，则压缩文件的上传只能使用一个连接。

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

显示 (true) 或隐藏 (false) 导入的进度信息。默认值为 true（如果标准输出是终端 (tty)）和 false（否则）。

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

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

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

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

osBucketName 命名的对象存储桶所在的 Oracle 云基础设施命名空间。对象存储桶的命名空间显示在 Oracle 云基础设施控制台中存储桶详细信息页面的“存储桶信息”选项卡中，也可以使用 Oracle 云基础设施命令行界面获取。

包含用于连接的配置文件（而不是默认位置 ~/.oci/config 中的配置文件）的 Oracle 云基础设施 CLI 配置文件。

用于连接的 Oracle 云基础设施配置文件的配置文件名称，而不是用于连接的 Oracle 云基础设施 CLI 配置文件中的 [DEFAULT] 配置文件。

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

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

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

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

用于连接的区域的名称。

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

连接到 Oracle 云基础设施 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) 令牌，而不是密钥。