TuGraph-family / tugraph-db

TuGraph: A High Performance Graph Database.
https://tugraph.org
Apache License 2.0
1.44k stars 192 forks source link

OlapBase API document obscure #544

Open CAQ opened 5 months ago

CAQ commented 5 months ago

https://tugraph-db.readthedocs.io/zh-cn/latest/9.olap%26procedure/2.olap/2.olap-base-api.html#id3 TuGraph使用了多线程技术进行批处理操作,在这种情况下可能会出现访存冲突现象。为了保证并行计算时修改操作的正确性,TuGraph实现了原子操作。代码部分见lgraph文件夹下的lgraph_atomic.cpp文件。 TuGraph还自定义了4个常用的原子操作。当我们需要在多线程模式下修改点的数据时,我们都应该使用原子操作来确保并行环境下修改操作的正确性。除了这4个原子操作外,用户也可以使用“cas”来构建自己的原子操作函数。

1, lgraph_atomic.cpp is missing. only .h file. 2, 还自定义了4个常用的原子操作, this is duplicated with 实现了原子操作, plus, is ambiguous. 3, below this paragraph, five operators are listed. I'd suggest list the four (write_min/max/add/sub) first, then use another paragraph to introduce "cas".