XLSX 增量追加器

增量追加新数据并生成上次处理游标(按时间/主键列)

支持时间游标与主键游标,输出更新工作簿和 cursor JSON。

示例结果

1 个示例

增量追加并生成下一游标

仅追加游标之后的新行,并输出更新游标文件

xlsx-append-incremental-example1.zip 查看文件
查看输入参数
{ "baseWorkbookFile": "/public/samples/xlsx/workbook-sales.xlsx", "incrementalWorkbookFile": "/public/samples/xlsx/workbook-sales.xlsx", "targetSheetName": "Tools API", "cursorMode": "primary-key", "cursorColumn": "id", "lastCursorValue": "5" }

Click to upload file or drag and drop file here

Maximum file size: 200MB Supported formats: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

Click to upload file or drag and drop file here

Maximum file size: 200MB Supported formats: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

关键信息

分类
转换与编码
输入类型
file, text, number, select
输出类型
file
样本覆盖
4
支持 API
Yes

概览

XLSX 增量追加器是一款高效的 Excel 数据处理工具,旨在帮助用户通过时间戳或主键列,将新数据自动追加到现有工作簿中,并同步生成最新的处理游标,从而实现简易的 ETL 数据同步流程。

适用场景

  • 需要将每日导出的新数据合并到总表,且仅需追加新增记录时。
  • 在进行数据同步时,需要通过主键 ID 识别并过滤掉已处理过的旧数据。
  • 需要根据时间戳(如 updated_at)自动筛选并更新工作簿中的增量信息时。

工作原理

  • 上传基础工作簿与包含新数据的增量工作簿。
  • 选择游标模式(时间或主键)并指定对应的游标列名称。
  • 输入上次处理的游标值,系统将自动对比并追加符合条件的新行。
  • 下载合并后的 Excel 文件及包含最新游标值的 JSON 文件。

使用场景

电商平台每日订单数据的自动汇总与追加。
财务报表按月度更新,仅追加本月新增的流水记录。
CRM 系统导出数据与本地客户总表的增量同步。

用户案例

1. 电商订单每日增量汇总

数据运营专员
背景原因
每天需要将 ERP 导出的最新订单 Excel 合并到总销售表中,手动复制粘贴容易出错。
解决问题
通过订单 ID 实现增量追加,避免重复导入已存在的订单。
如何使用
上传总表和今日订单表,设置游标模式为“主键列”,游标列为“id”,填入昨日最后一条订单 ID。
示例配置
cursorMode: primary-key, cursorColumn: id, lastCursorValue: 5000
效果
系统自动过滤掉 ID 小于 5000 的旧订单,仅将新增订单追加至总表,并输出新的最大 ID 游标。

2. 按时间戳更新客户跟进记录

销售主管
背景原因
销售团队每天更新客户跟进情况,需要将更新时间在昨日之后的记录同步到总表。
解决问题
基于时间戳进行增量追加,确保总表数据实时更新。
如何使用
上传基础表和增量表,设置游标模式为“时间列”,游标列为“updated_at”,填入上次同步的时间点。
示例配置
cursorMode: time, cursorColumn: updated_at, lastCursorValue: 2026-03-01T00:00:00Z
效果
成功将 2026-03-01 之后更新的记录追加至总表,并生成包含最新时间戳的游标文件。

用 Samples 测试

xml, xlsx, xls

相关专题

常见问题

什么是游标模式?

游标模式用于定义如何识别新数据。时间模式通过日期时间列判断,主键模式通过唯一标识符(如 ID)判断。

如果我不确定上次的游标值怎么办?

若不填写上次游标值,工具将默认处理增量文件中的所有数据,或根据您提供的列进行全量比对。

该工具支持哪些 Excel 格式?

支持标准的 .xlsx 和 .xls 格式文件。

追加数据时会覆盖原有数据吗?

不会,该工具仅执行追加操作,将符合游标条件的新行添加到基础工作簿的末尾。

输出的 Cursor JSON 有什么用?

它记录了本次处理后的最大游标值,方便您在下次执行任务时直接填入,实现自动化增量更新。

API 文档

请求端点

POST /zh/api/tools/xlsx-append-incremental

请求参数

参数名 类型 必填 描述
baseWorkbookFile file (需要先上传) -
incrementalWorkbookFile file (需要先上传) -
targetSheetName text -
headerRow number -
cursorMode select -
cursorColumn text -
lastCursorValue text -

文件类型参数需要先通过 POST /upload/xlsx-append-incremental 上传获取 filePath,然后将 filePath 传递给对应的文件字段。

响应格式

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
文件: 文件

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-xlsx-append-incremental": {
      "name": "xlsx-append-incremental",
      "description": "增量追加新数据并生成上次处理游标(按时间/主键列)",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-append-incremental",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

支持 URL 文件链接或 Base64 编码作为文件参数。

如果遇见问题,请联系我们:[email protected]