INSERT EDGE 文档中关于“原子性”的部分需要改进一下表述。

[xtcyclist]

Introduction

https://docs.nebula-graph.com.cn/3.4.0/3.ngql-guide/13.edge-statements/1.insert-edge/

目前还不能保证操作的原子性，如果失败请重试，否则会发生部分写入。此时读取该数据的行为是未定义的。

这句话中的“原子性”比较含糊，从文字上看，不清楚说的是插入单个边时插入正反边的原子性，还是一条语句插入多个边时这多条边的原子性，还是两者兼有。同理，“部分写入”是指的正反边中的部分写入，还是多条边范围内的部分写入，还是两者兼有。

“失败请重试”没有问题。但是如果成功，具体代表什么意思呢？

论坛中这个问题就是来源于没看明白这句话：
https://discuss.nebula-graph.com.cn/t/topic/12318

Contents

确认一下 INSERT EDGE 语句的各种情形，准确表达“原子性”及返回值的意义。

Related work

[cooper-lzy]

#2665