批量插入 action

使用批量插入 action 从 CSV 或文本文件读取行，并将其批量插入目标数据库表。 通过此操作，您可以高效加载大型数据集，并捕获总插入行数。

在执行大规模数据插入操作时，例如将成千上万条记录从文件加载到数据库中，请使用批量插入 action。

设置

  • 在会话名称字段中，输入您在连接 action 中用于连接到数据库服务器的会话名称。 有关更多详情，请参阅 对数据库使用连接action。
  • 在源文件字段中输入要读取的源文件路径。
    注： 您只能指定 .csv 和 .txt 文件。
  • 在表名称字段中，输入要插入行的目标数据库表。
  • 输入分隔符值，以指定源文件列的分隔方式。
    注： 逗号是默认分隔符值。 其他支持的值包括逗号、制表符、换行符。
  • 指定 specificDelimiter。 当分隔符设置为其他时，这是一个自定义分隔符字符。 例如，使用 |。
  • 在起始行号字段中，输入要从源文件读取的第一行数据。
    注： 默认值为 2，并且必须为 2 或大于默认值，因为文件包含一个标题行。
  • 在列映射字段中，单击添加映射，将源文件列映射到目标表列。 确保列名和数据类型匹配。
    • 指定文件列名，即在源文件中与映射条目完全一致的列标题。
    • 输入与目标表列名匹配的表列名，用于映射条目。
    注：
    • 列映射是可选的。
    • 如果未添加列映射，则源文件中的所有列将映射到目标表的所有列。
    • 确保目标表在数据库中存在，并包含所需的列。 此外，请验证列名的大小写敏感性，以确保字段的一对一映射。

    • 此 action 针对高吞吐量场景进行了优化，与逐行插入相比可显著提升性能。

    • 对于较小的数据量，标准插入操作（例如，使用 Loop action）更为合适且配置更为简单。

  • 指定在批量大小字段中每批要插入的行数。
    注： 默认的批量大小为 1000。 必须在 200 - 500000 之间
  • 输入一个超时值，用于指定每个批次的最大等待时间。 默认值为 1800。 必须在 1 到 3600 秒之间。
    注： 如果一个批处理超时，action 会返回成功插入的总行数。 要恢复处理，请将此计数加 1，并将该值作为下一步运行的起始行号。

结果： 当您使用此 action 时，您可以批量插入记录，并且它会以数字的形式返回插入记录的总数。

总体而言，此 action 无需 Loop 即可执行批量插入，并以同步方式运行，直至所有行插入完成或发生错误为止。对于大型数据集，其性能远优于逐行插入。