MuleRun数据导入有四种方法：一、Web界面上传CSV（<5万行，UTF-8无BOM）；二、CLI工具导入Excel（≤20万行，支持日期格式指定）；三、API接口提交CSV字符串（适合自动化，需API密钥）；四、数据库直连执行SQL插入语句（需DB权限，注意转义与事务）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用MuleRun时需要将结构化数据导入系统，但无法成功上传Excel或CSV文件，则可能是由于文件格式、编码、字段映射或权限配置不匹配所致。以下是实现MuleRun数据导入的多种可行方法：
一、通过Web界面直接上传CSV文件
该方式适用于小批量数据（通常建议低于5万行），且CSV文件符合MuleRun预设的列名与编码规范。系统会自动解析UTF-8编码的逗号分隔文本，并尝试匹配目标数据表字段。
1、登录MuleRun管理后台，进入【数据管理】→【导入中心】页面。
2、点击【选择文件】按钮，从本地选取已准备好的CSV文件（确保无BOM头、无合并单元格、首行为标准字段名）。
3、在字段映射区域确认源列与目标字段是否自动匹配；若存在未识别字段，需手动拖拽关联至对应目标字段。
4、勾选“跳过重复主键记录”或“覆盖同主键数据”选项，根据业务需求选择冲突处理策略。
5、点击【开始导入】，等待进度条完成，查看导入日志中是否有“字段类型校验失败”或“第X行编码异常”提示。
二、使用MuleRun CLI工具批量导入Excel文件
该方式绕过浏览器限制，支持.xlsx格式及多工作表处理，适用于中等规模数据（单次不超过20万行），并可复用配置脚本进行周期性导入。
1、下载并安装MuleRun官方CLI工具包，运行mulerun-cli --version验证环境可用。
2、将Excel文件保存为单张Sheet、无冻结窗格、无公式计算结果的纯数值/文本状态，并确保第一行包含与目标表完全一致的英文字段名。
3、执行命令：mulerun-cli import --file ./data.xlsx --target users --profile prod --encoding utf-8。
4、若出现“日期列解析失败”，在命令末尾追加--date-format "yyyy-MM-dd"参数明确指定格式。
5、导入完成后检查CLI输出中的“成功写入1247条，跳过32条（主键冲突）”统计信息，确认实际生效数量。
三、通过API接口提交CSV内容字符串导入
该方式适合已有自动化流程的场景，可将CSV内容作为HTTP请求体发送至MuleRun开放API，由后端服务异步解析入库，规避前端文件大小限制。
1、在MuleRun开发者控制台申请API密钥，获取Authorization令牌及/v1/import/csv端点地址。
2、使用Python脚本读取本地CSV文件，调用csv.reader逐行处理，拼接为标准换行符分隔的字符串，并确保所有字段值用双引号包裹。
3、构造POST请求，Header中设置Content-Type: text/csv; charset=utf-8与Authorization: Bearer YOUR_API_KEY。
4、在Body中直接传入CSV原始字符串（不含文件头），例如："id","name","email"\n"1001","张三","zhang@demo.com"。
5、接收响应体中的job_id，调用GET /v1/import/status/{job_id}轮询，直至返回状态为“completed”且error_count为0。
四、借助数据库直连方式导入Excel转换后的SQL插入语句
该方式适用于具备数据库操作权限的高级用户，通过将Excel转为INSERT语句集合，绕过MuleRun应用层校验逻辑，直接写入底层存储表。
1、使用Excel插件或Python pandas库将Excel导出为SQL INSERT语句文件，每条语句以INSERT INTO mulerun_users (id, name, email) VALUES (1001, '张三', 'zhang@demo.com');格式生成。
2、确认目标数据库类型（如PostgreSQL或MySQL），调整字符串转义规则：单引号内嵌套需替换为两个单引号，避免语法错误。
3、登录MuleRun所连接的数据库实例，执行BEGIN TRANSACTION;开启事务。
4、粘贴并执行全部INSERT语句块，观察是否报错“违反唯一约束users_pkey”或“列数量与值数量不匹配”。
5、若全部成功，执行COMMIT;提交；若中途失败，立即执行ROLLBACK;回退，防止脏数据残留。
