SuperAPI AI 工具集

neo4j-import-skill

数据与分析

查看项目

更新于 10-16 06:50

技能介绍

用途:把结构化数据(CSV、JSON、Parquet)导入 Neo4j,包括批量 upsert 节点与关系、关系型数据迁移到图、离线大批量加载,以及在线(Cypher)与离线(admin)导入方式的选择和导入完整性校验。不适用于非结构化文档/PDF/向量块、应用实时写入、备份恢复配置、GDS 算法投影等场景。

主要能力:LOAD CSV 支持表头、类型转换(toIntegerOrNull、toFloatOrNull)、空值处理、自定义分隔符、压缩文件与云存储(S3/GCS/Azure,企业版);CALL IN TRANSACTIONS 支持批大小、并发事务、ON ERROR 的 CONTINUE/BREAK/FAIL/RETRY 及 REPORT STATUS;neo4j-admin database import full 用于离线批量导入,支持节点/关系头文件、类型标注、--schema 建约束索引、--dry-run 校验,企业版支持 incremental 三阶段导入;APOC 提供 apoc.periodic.iterate、apoc.load.csv、apoc.load.json;驱动批量写入模式适用于 API 响应等非文件来源。

使用方式:导入前先建唯一性约束(供 MERGE 使用),导入后再建非唯一索引并轮询 populationPercent 至 100;先导入全部节点再导入关系;确认目标为 PRIMARY;校验 UTF-8 编码。示例命令:neo4j-admin database import full --nodes=Person="persons_header.csv,persons.csv" --relationships=ACTED_IN="acted_in_header.csv,acted_in.csv" --delimiter=, --id-type=STRING --bad-tolerance=0 --threads=$(nproc) --high-parallel-io=on neo4j。

限制:Aura 仅支持 https:// URL,neo4j-admin import 仅限自管理实例;PERIODIC COMMIT 在 Cypher 25 已移除,应改用 CALL IN TRANSACTIONS;增量导入需企业版与 block 存储格式;批量过大可能堆溢出。具体版本特性与参数细节以官方文档为准。