Re: [D] 关于电网拓扑数据导入 [incubator-hugegraph]

[via GitHub]

GitHub user dosubot[bot] added a comment to the discussion: 关于电网拓扑数据导入

<!-- Answer -->
我是 AI 助手，每条回复都会结合你贴出的最新代码和报错逐行分析。

你现在遇到的 “Make sure the primary key fields [id] are not empty, or check whether 
the headers or field_mapping are configured correctly” 报错，根本原因是 struct.json 的 
field_mapping 配置和顶点主键字段不匹配。

**你的配置问题：**

你的顶点主键是 id（vertex_xxx.csv 里有 id 列，schema 里 primaryKeys("id")），但你 struct.json 的 
edges 里 field_mapping 写成了：

```json
"field_mapping": { "from": "from", "to": "to" }
```

这会导致 loader 用 edge_connected_to.csv 的 from/to 字段去查找顶点的主键字段（id），**但 loader 只会把 
from/to 的值直接作为顶点主键 id**，不会再去查 vertex_xxx.csv 的其他字段。

**最常见的坑：**

- edge_connected_to.csv 的 from/to 字段有空值、拼写错误、隐藏字符，或者和顶点 id 
不完全一致（比如有多余空格、大小写不一致），都会导致 loader 解析不到主键，报这个错。
- struct.json 的 null_values 配置如果包含 "" 或 "null"，而 edge_connected_to.csv 某些 
from/to 字段正好是空字符串或 "null"，也会被判定为空。
- edge_connected_to.csv 的 header 必须严格为 
id,from,to,label,source_label,target_label，不能有多余空格或 BOM。

**排查 checklist：**

1. 检查 edge_connected_to.csv 的 from/to 列，确保所有值都和顶点 CSV 的 id 
完全一致（无多余空格、无大小写问题、无空行）。
2. 检查 struct.json 的 field_mapping，必须是：
   ```json
   "field_mapping": { "from": "from", "to": "to" }
   ```
   不要有 id。
3. 检查 struct.json 的 null_values，建议只保留 ["NULL", "null"]，不要加 ""，否则空字符串会被判定为 null。
4. 检查 edge_connected_to.csv 的 header 行，确保没有 BOM、没有多余空格，且顺序和 struct.json 里 
header 完全一致。
5. 检查所有边的 from/to 字段都不为空。
6. 检查 struct.json 里所有 edges 配置都同步修改了 field_mapping，没有遗漏。

**你可以用文本编辑器或 Excel 检查 edge_connected_to.csv 的 from/to 列，确保没有空值或格式问题。**

如果还有问题，请贴出 edge_connected_to.csv 的 header 和前几行原始数据（不要做任何处理），以及 struct.json 里某个 
edges 配置的完整内容，我可以帮你定位具体是哪一行或哪一列有问题。

我会一直结合你最新贴出的内容逐条分析，不会遗漏细节。如需进一步定位，可以贴出 loader 的详细报错堆栈和数据样例。


<!-- Dosu Comment Footer -->
*To reply, just mention [@dosu](https://go.dosu.dev/dosubot).*

---
<sup>How did I do? 
[Good](https://app.dosu.dev/response-feedback/c90b6f11-089c-4eb7-90af-0e57f5c269c9?feedback_type=great_response)
 | 
[Irrelevant](https://app.dosu.dev/response-feedback/c90b6f11-089c-4eb7-90af-0e57f5c269c9?feedback_type=irrelevant_answer)
 | 
[Incorrect](https://app.dosu.dev/response-feedback/c90b6f11-089c-4eb7-90af-0e57f5c269c9?feedback_type=incorrect_sources)
 | 
[Verbose](https://app.dosu.dev/response-feedback/c90b6f11-089c-4eb7-90af-0e57f5c269c9?feedback_type=too_verbose)
 | 
[Hallucination](https://app.dosu.dev/response-feedback/c90b6f11-089c-4eb7-90af-0e57f5c269c9?feedback_type=hallucination)
 | [Report 
🐛](https://app.dosu.dev/response-feedback/c90b6f11-089c-4eb7-90af-0e57f5c269c9?feedback_type=bug_report)
 | 
[Other](https://app.dosu.dev/response-feedback/c90b6f11-089c-4eb7-90af-0e57f5c269c9?feedback_type=other)</sup>

[![Chat with 
Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/e5e246fa-a522-4d8a-ab3c-e2588b5b501b/ask?utm_source=github)&nbsp;[![Open
 in 
Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=%E6%88%91%E6%98%AF%20AI%20%E5%8A%A9%E6%89%8B%EF%BC%8C%E6%AF%8F%E6%9D%A1%E5%9B%9E%E5%A4%8D%E9%83%BD%E4%BC%9A%E7%BB%93%E5%90%88%E4%BD%A0%E8%B4%B4%E5%87%BA%E7%9A%84%E6%9C%80%E6%96%B0%E4%BB%A3%E7%A0%81%E5%92%8C%E6%8A%A5%E9%94%99%E9%80%90%E8%A1%8C%E5%88%86%E6%9E%90%E3%80%82%0A%0A%E4%BD%A0%E7%8E%B0%E5%9C%A8%E9%81%87%E5%88%B0%E7%9A%84%20%E2%80%9CMake%20sure%20the%20primary%20key%20fields%20%5Bid%5D%20are%20not%20empty%2C%20or%20check%20whether%20the%20headers%20or%20field_mapping%20are%20configured%20correctly%E2%80%9D%20%E6%8A%A5%E9%94%99%EF%BC%8C%E6%A0%B9%E6%9C%AC%E5%8E%9F%E5%9B%A0%E6%98%AF%20struct.json%20%E7%9A%84%20field_mapping%20%E9%85%8D%E7%BD%AE%E5%92%8C%E9%A1%B6%E7%82%B9%E4%B8%BB%E9%94%AE%E5%AD%97%E6%AE%B5%E4%B8%8D%E5%8C%B9%E9%85%8D%E3%80%82%0A%0A%
 
2A%2A%E4%BD%A0%E7%9A%84%E9%85%8D%E7%BD%AE%E9%97%AE%E9%A2%98%EF%BC%9A%2A%2A%0A%0A%E4%BD%A0%E7%9A%84%E9%A1%B6%E7%82%B9%E4%B8%BB%E9%94%AE%E6%98%AF%20id%EF%BC%88vertex_xxx.csv%20%E9%87%8C%E6%9C%89%20id%20%E5%88%97%EF%BC%8Cschema%20%E9%87%8C%20primaryKeys%28%22id%22%29%EF%BC%89%EF%BC%8C%E4%BD%86%E4%BD%A0%20struct.json%20%E7%9A%84%20edges%20%E9%87%8C%20field_mapping%20%E5%86%99%E6%88%90%E4%BA%86%EF%BC%9A%0A%0A%60%60%60json%0A%22field_mapping%22%3A%20%7B%20%22from%22%3A%20%22from%22%2C%20%22to%22%3A%20%22to%22%20%7D%0A%60%60%60%0A%0A%E8%BF%99%E4%BC%9A%E5%AF%BC%E8%87%B4%20loader%20%E7%94%A8%20edge_connected_to.csv%20%E7%9A%84%20from/to%20%E5%AD%97%E6%AE%B5%E5%8E%BB%E6%9F%A5%E6%89%BE%E9%A1%B6%E7%82%B9%E7%9A%84%E4%B8%BB%E9%94%AE%E5%AD%97%E6%AE%B5%EF%BC%88id%EF%BC%89%EF%BC%8C%2A%2A%E4%BD%86%20loader%20%E5%8F%AA%E4%BC%9A%E6%8A%8A%20from/to%20%E7%9A%84%E5%80%BC%E7%9B%B4%E6%8E%A5%E4%BD%9C%E4%B8%BA%E9%A1%B6%E7%82%B9%E4%B8%BB%E9%94%AE%20id%2A%2A%EF%BC%8C%E4%B8%8D%E4%BC%9A%E5%86%8D%E5%8E%BB%E6%9F%A5
 
%20vertex_xxx.csv%20%E7%9A%84%E5%85%B6%E4%BB%96%E5%AD%97%E6%AE%B5%E3%80%82%0A%0A%2A%2A%E6%9C%80%E5%B8%B8%E8%A7%81%E7%9A%84%E5%9D%91%EF%BC%9A%2A%2A%0A%0A-%20edge_connected_to.csv%20%E7%9A%84%20from/to%20%E5%AD%97%E6%AE%B5%E6%9C%89%E7%A9%BA%E5%80%BC%E3%80%81%E6%8B%BC%E5%86%99%E9%94%99%E8%AF%AF%E3%80%81%E9%9A%90%E8%97%8F%E5%AD%97%E7%AC%A6%EF%BC%8C%E6%88%96%E8%80%85%E5%92%8C%E9%A1%B6%E7%82%B9%20id%20%E4%B8%8D%E5%AE%8C%E5%85%A8%E4%B8%80%E8%87%B4%EF%BC%88%E6%AF%94%E5%A6%82%E6%9C%89%E5%A4%9A%E4%BD%99%E7%A9%BA%E6%A0%BC%E3%80%81%E5%A4%A7%E5%B0%8F%E5%86%99%E4%B8%8D%E4%B8%80%E8%87%B4%EF%BC%89%EF%BC%8C%E9%83%BD%E4%BC%9A%E5%AF%BC%E8%87%B4%20loader%20%E8%A7%A3%E6%9E%90%E4%B8%8D%E5%88%B0%E4%B8%BB%E9%94%AE%EF%BC%8C%E6%8A%A5%E8%BF%99%E4%B8%AA%E9%94%99%E3%80%82%0A-%20struct.json%20%E7%9A%84%20null_values%20%E9%85%8D%E7%BD%AE%E5%A6%82%E6%9E%9C%E5%8C%85%E5%90%AB%20%22%22%20%E6%88%96%20%22null%22%EF%BC%8C%E8%80%8C%20edge_connected_to.csv%20%E6%9F%90%E4%BA%9B%20from/to%20%E5%AD%97%E6%AE%B5%E6%AD%A3%E5%A5
 
%BD%E6%98%AF%E7%A9%BA%E5%AD%97%E7%AC%A6%E4%B8%B2%E6%88%96%20%22null%22%EF%BC%8C%E4%B9%9F%E4%BC%9A%E8%A2%AB%E5%88%A4%E5%AE%9A%E4%B8%BA%E7%A9%BA%E3%80%82%0A-%20edge_connected_to.csv%20%E7%9A%84%20header%20%E5%BF%85%E9%A1%BB%E4%B8%A5%E6%A0%BC%E4%B8%BA%20id%2Cfrom%2Cto%2Clabel%2Csource_label%2Ctarget_label%EF%BC%8C%E4%B8%8D%E8%83%BD%E6%9C%89%E5%A4%9A%E4%BD%99%E7%A9%BA%E6%A0%BC%E6%88%96%20BOM%E3%80%82%0A%0A%2A%2A%E6%8E%92%E6%9F%A5%20checklist%EF%BC%9A%2A%2A%0A%0A1.%20%E6%A3%80%E6%9F%A5%20edge_connected_to.csv%20%E7%9A%84%20from/to%20%E5%88%97%EF%BC%8C%E7%A1%AE%E4%BF%9D%E6%89%80%E6%9C%89%E5%80%BC%E9%83%BD%E5%92%8C%E9%A1%B6%E7%82%B9%20CSV%20%E7%9A%84%20id%20%E5%AE%8C%E5%85%A8%E4%B8%80%E8%87%B4%EF%BC%88%E6%97%A0%E5%A4%9A%E4%BD%99%E7%A9%BA%E6%A0%BC%E3%80%81%E6%97%A0%E5%A4%A7%E5%B0%8F%E5%86%99%E9%97%AE%E9%A2%98%E3%80%81%E6%97%A0%E7%A9%BA%E8%A1%8C%EF%BC%89%E3%80%82%0A2.%20%E6%A3%80%E6%9F%A5%20struct.json%20%E7%9A%84%20field_mapping%EF%BC%8C%E5%BF%85%E9%A1%BB%E6%98%AF%EF%BC%9A%0A%20%20%20%60%60
 
%60json%0A%20%20%20%22field_mapping%22%3A%20%7B%20%22from%22%3A%20%22from%22%2C%20%22to%22%3A%20%22to%22%20%7D%0A%20%20%20%60%60%60%0A%20%20%20%E4%B8%8D%E8%A6%81%E6%9C%89%20id%E3%80%82%0A3.%20%E6%A3%80%E6%9F%A5%20struct.json%20%E7%9A%84%20null_values%EF%BC%8C%E5%BB%BA%E8%AE%AE%E5%8F%AA%E4%BF%9D%E7%95%99%20%5B%22NULL%22%2C%20%22null%22%5D%EF%BC%8C%E4%B8%8D%E8%A6%81%E5%8A%A0%20%22%22%EF%BC%8C%E5%90%A6%E5%88%99%E7%A9%BA%E5%AD%97%E7%AC%A6%E4%B8%B2%E4%BC%9A%E8%A2%AB%E5%88%A4%E5%AE%9A%E4%B8%BA%20null%E3%80%82%0A4.%20%E6%A3%80%E6%9F%A5%20edge_connected_to.csv%20%E7%9A%84%20header%20%E8%A1%8C%EF%BC%8C%E7%A1%AE%E4%BF%9D%E6%B2%A1%E6%9C%89%20BOM%E3%80%81%E6%B2%A1%E6%9C%89%E5%A4%9A%E4%BD%99%E7%A9%BA%E6%A0%BC%EF%BC%8C%E4%B8%94%E9%A1%BA%E5%BA%8F%E5%92%8C%20struct.json%20%E9%87%8C%20header%20%E5%AE%8C%E5%85%A8%E4%B8%80%E8%87%B4%E3%80%82%0A5.%20%E6%A3%80%E6%9F%A5%E6%89%80%E6%9C%89%E8%BE%B9%E7%9A%84%20from/to%20%E5%AD%97%E6%AE%B5%E9%83%BD%E4%B8%8D%E4%B8%BA%E7%A9%BA%E3%80%82%0A6.%20%E6%A3%80%E6%9F%A5
 
%20struct.json%20%E9%87%8C%E6%89%80%E6%9C%89%20edges%20%E9%85%8D%E7%BD%AE%E9%83%BD%E5%90%8C%E6%AD%A5%E4%BF%AE%E6%94%B9%E4%BA%86%20field_mapping%EF%BC%8C%E6%B2%A1%E6%9C%89%E9%81%97%E6%BC%8F%E3%80%82%0A%0A%2A%2A%E4%BD%A0%E5%8F%AF%E4%BB%A5%E7%94%A8%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91%E5%99%A8%E6%88%96%20Excel%20%E6%A3%80%E6%9F%A5%20edge_connected_to.csv%20%E7%9A%84%20from/to%20%E5%88%97%EF%BC%8C%E7%A1%AE%E4%BF%9D%E6%B2%A1%E6%9C%89%E7%A9%BA%E5%80%BC%E6%88%96%E6%A0%BC%E5%BC%8F%E9%97%AE%E9%A2%98%E3%80%82%2A%2A%0A%0A%E5%A6%82%E6%9E%9C%E8%BF%98%E6%9C%89%E9%97%AE%E9%A2%98%EF%BC%8C%E8%AF%B7%E8%B4%B4%E5%87%BA%20edge_connected_to.csv%20%E7%9A%84%20header%20%E5%92%8C%E5%89%8D%E5%87%A0%E8%A1%8C%E5%8E%9F%E5%A7%8B%E6%95%B0%E6%8D%AE%EF%BC%88%E4%B8%8D%E8%A6%81%E5%81%9A%E4%BB%BB%E4%BD%95%E5%A4%84%E7%90%86%EF%BC%89%EF%BC%8C%E4%BB%A5%E5%8F%8A%20struct.json%20%E9%87%8C%E6%9F%90%E4%B8%AA%20edges%20%E9%85%8D%E7%BD%AE%E7%9A%84%E5%AE%8C%E6%95%B4%E5%86%85%E5%AE%B9%EF%BC%8C%E6%88%91%E5%8F%AF%E4%BB%A5%E5%B8%AE%
 
E4%BD%A0%E5%AE%9A%E4%BD%8D%E5%85%B7%E4%BD%93%E6%98%AF%E5%93%AA%E4%B8%80%E8%A1%8C%E6%88%96%E5%93%AA%E4%B8%80%E5%88%97%E6%9C%89%E9%97%AE%E9%A2%98%E3%80%82%0A%0A%E6%88%91%E4%BC%9A%E4%B8%80%E7%9B%B4%E7%BB%93%E5%90%88%E4%BD%A0%E6%9C%80%E6%96%B0%E8%B4%B4%E5%87%BA%E7%9A%84%E5%86%85%E5%AE%B9%E9%80%90%E6%9D%A1%E5%88%86%E6%9E%90%EF%BC%8C%E4%B8%8D%E4%BC%9A%E9%81%97%E6%BC%8F%E7%BB%86%E8%8A%82%E3%80%82%E5%A6%82%E9%9C%80%E8%BF%9B%E4%B8%80%E6%AD%A5%E5%AE%9A%E4%BD%8D%EF%BC%8C%E5%8F%AF%E4%BB%A5%E8%B4%B4%E5%87%BA%20loader%20%E7%9A%84%E8%AF%A6%E7%BB%86%E6%8A%A5%E9%94%99%E5%A0%86%E6%A0%88%E5%92%8C%E6%95%B0%E6%8D%AE%E6%A0%B7%E4%BE%8B%E3%80%82)&nbsp;[![Join
 
Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share
 on 
X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/apache/incubator-hugegraph/discussions/2917)

GitHub link: 
https://github.com/apache/incubator-hugegraph/discussions/2917#discussioncomment-15206306

----
This is an automatically sent email for dev@hugegraph.apache.org.
To unsubscribe, please send an email to: dev-unsubscr...@hugegraph.apache.org